Difference between pages "Install/pt-br/Configuring" and "Package:AMD Catalyst Video Drivers"

< Install‎ | pt-br(Difference between pages)
(Localization)
 
 
Line 1: Line 1:
=== Configurando seu sistema ===
+
{{Ebuild
Como é esperado de uma distribuição Linux, Funtoo Linux tem seu compartilhamento de arquivos de configuração. O arquivo que absolutamente requer que você edite de forma a assegurar que o Funtoo Linux inicialize com sucesso é <code>/etc/fstab</code>. Os outros são opcionais.
+
|Summary=Accelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.
 +
|CatPkg=x11-drivers/ati-drivers
 +
|Maintainer=Drobbins
 +
|Homepage=
 +
|Repository=Funtoo Overlay
 +
|Overlay=Funtoo
 +
}}
  
==== Utilizando o Nano ====
+
{{Important|Version 14.12-r3 and above now include ATI GLESv2 and EGL libraries, which should improve stabilty with GNOME.}}
  
O editor padrão incluso no ambiente chroot é chamado de <code>nano</code>. Para editar um dos arquivos abaixo, chame o nano como a seguir:
+
== Introduction ==
  
<console>
+
<tt>x11-drivers/ati-drivers</tt> (often referred to as "<tt>fglrx</tt>", the name of its kernel module) is the proprietary, accelerated driver for AMD (ATI) graphics cards.
(chroot) # ##i##nano /etc/fstab
+
</console>
+
  
Quando estiver no editor, você pode utilizar as teclas de cetas para mover o cursor, e teclas comuns como backspace e delete funcionarão como esperado. Para salvar o arquivo, pressione Control-X, e responda <code>y</code> quando solicitado para salvar o buffer modificado se você gostaria de salvar suas alterações.
+
== Preparing to Install ==
  
==== Configuration Files ====
+
=== Blacklist Radeon and DRM Modules ===
  
Aqui estão uma lista completa de arquivos que você pode queres editar, dependendo de suas necessidades:
+
To avoid having the open source Radeon drivers automatically load and ruin your day, create a blacklist file as follows:
{{TableStart}}
+
<tr class="active"><th>Arquivo</th>
+
<th>Preciso alter-á-lo?</th>
+
<th>Descrição</th>
+
</tr><tr  class="danger">
+
<td><code>/etc/fstab</code></td>
+
<td>'''SIM - exigido'''</td>
+
<td>Pontos de montagem para todos os filesystems a serem utilizados no momento do boot. Esse arquivo deve refletir sua configuação de partição de disco. Vamos lhe guiar através da modificação desse arquivo abaixo.</td>
+
</tr><tr>
+
<td><code>/etc/localtime</code></td>
+
<td>''Talvez - recomendável''</td>
+
<td>Seu fuso horário (timezone), que será padrão ao UTC se não definido. Esse deve ser um link simbólico para algo localizado sob /usr/share/zoneinfo (ex. /usr/share/zoneinfo/America/Montreal) </td>
+
</tr><tr>
+
<td><code>/etc/make.conf</code> (symlink) - also known as:<br/><code>/etc/portage/make.conf</code></td>
+
<td>''Talvêz - recomendado''</td>
+
<td>Parâmetros utilizado pelo gcc (compilador), pelo portage, e pelo make. É uma boa ideia definir o MAKEOPTS. Isso é coberto mais para frente nessa documentação.</td>
+
</tr><tr>
+
<td><code>/etc/conf.d/hostname</code></td>
+
<td>''Talvez - recomendado''</td>
+
<td>Utilizado para definir o hostname do sistema. Defina a variável <code>hostname</code> como nome fully-qualified (com pontos, ex. <code>foo.funtoo.org</code>) se você tiver um. Caso contrário, defina para o hostname do sistema local (sem pontos, ex. <code>foo</code>). Padrões para <code>localhost</code> se não definido.</td>
+
</tr><tr>
+
<td><code>/etc/hosts</code></td>
+
<td>''Não''</td>
+
<td> Você não precisa mais definir manual o hostname nesse arquivo. Esse arquivo é gerado manualmente pelo <code>/etc/init.d/hostname</code>.</td>
+
</tr><tr>
+
<td><code>/etc/conf.d/keymaps</code></td>
+
<td>Opcional</td>
+
<td>Arquivo de configuração de mapeamento do teclado (fara console pseudo terminais). Configure se você não possui um teclado no padrão americano (non-US). Veja [[Pt-br/Funtoo_Linux_Localization|Localização do Funtoo Linux]].</td>
+
</tr><tr>
+
<td><code>/etc/conf.d/hwclock</code></td>
+
<td>Opcional</td>
+
<td>Como o tempo de clock do hardware mantido pela bateria (battery-backed) do sistema é interpretado [UTC ou hora local (local time)]. Linux utiliza o clock do hardware mantido pela bateria para inicializar a hora do sistema quando o sistema é inicializado.</td>
+
</tr><tr>
+
<td><code>/etc/conf.d/modules</code></td>
+
<td>Opcional</td>
+
<td>Módulos do Kernel para carregar automaticamente na inicialização do sistema. Tipicamente não exigido. Veja [[Additional Kernel Resources]] para mais informações.</td>
+
</tr><tr>
+
<td><code>/etc/conf.d/consolefont</code></td>
+
<td>Opcional</td>
+
<td>Lhe permite especificar a font padrão do console. Para aplicar essa font, habilite o serviço consolefont ao executar rc-update add consolefont.</td>
+
</tr><tr>
+
<td><code>profiles</code></td>
+
<td>Opcional</td>
+
<td>Algumas configurações úteis para o portage que podem ajudar a acelerar a configuração inicial.</td>
+
</tr>
+
{{TableEnd}}
+
  
Se você estiver instalando uma versão em Inglês do Funtoo Linux, você está com sorte desde que muitos dos arquivos de configuração pode ser utilizadas como é. Se estiver instalando para outra localidade, não se preocupe. Vamos lhe orientar através dos passos para a configuração necessária na página [[Pt-br/Funtoo_Linux_Localization|Localização do Funtoo Linux]], e se necessário, sempre há muito suporte amigável e útil. (Veja [[#Community portal|Community]])
+
{{file|name=/etc/modprobe.d/radeon.conf|desc=Prevent open source DRM and radeon drivers from loading|body=
 +
blacklist radeon
 +
blacklist drm
 +
}}
  
Vamos seguir em frente e ver o que temos que fazer. Utilize <code>nano -w <name_of_file></code> para editar os arquivos -- o "<code>-w</code>" desabilita empacotamento de palavras (word-wrapping), que útil quando editar arquivos de configurações. Você pode copiar e colar a partir dos exemplos.
+
=== Configuring the kernel ===
  
{{fancywarning|É importante editar seu arquivo <code>/etc/fstab</code> antes de você reinicializar! Você precisará modificar ambas as colunas  "fs" e "type" para equiparar as configurações para as suas partições e filesystems que você criou com o <code>gdisk</code> ou <code>fdisk</code>. Pulando esses podem impedir que o Funtoo Linux de inicializar com sucesso.}}
+
Configure the kernel as follows. Note that the Direct Rendering Manager is '''not''' enabled. It's possible to have it selected as a kernel module, but should not be built-in to your kernel.  
  
==== /etc/fstab ====
+
{{kernelop|desc=
 +
[*] Enable loadable module support
 +
Processor type and features --->
 +
      [*] MTRR (Memory Type Range Register) support
 +
Bus options (PCI etc.) --->
 +
      [*] PCI Express Port Bus Support
 +
      [*] Message Signaled Interrupts (MSI and MSI-X)
 +
Device Drivers --->
 +
      Graphics support --->
 +
            < > Direct Rendering Manager (xFree86 4.1.0 and higher DRI support) --->
 +
}}
  
<code>/etc/fstab</code> é utilizado pelo comando <code>mount</code> que é executado quando seu sistema inicializa. Afirmações desse arquivo informam <code>mount</code> a respeito das partições a serem montadas e como elas são montadas. No intuito que o sistema inicialize devidamente, você deve editar <code>/etc/fstab</code> e assegurar de que isso reflita a configuração de partições que você utilizou anteriormente:
+
{{note|If you need support for AGP cards, enable the following kernel options:}}
 +
{{kernelop|desc=
 +
Device Drivers --->
 +
      Graphics support --->
 +
            <*> /dev/agpgart (AGP Support) --->
 +
                  Select an appropriate AGP driver:
 +
                  <*> AMD Opteron/Athlon64 on-CPU GART support
 +
}}
  
 +
=== Editing make.conf ===
 +
 +
Add the following to your <code>/etc/make.conf</code>:
 
<console>
 
<console>
(chroot) # ##i##nano -w /etc/fstab
+
# ##i##nano /etc/make.conf
 +
VIDEO_CARDS="fglrx"
 
</console>
 
</console>
 +
=== Enabling AMD Catalyst Control Center ===
  
<pre>
+
Then, add the following to <code>/etc/portage/package.use</code> if you would like to enable support for AMD Catalyst Control Center:
# The root filesystem should have a pass number of either 0 or 1.
+
<console>
# All other filesystems should have a pass number of 0 or greater than 1.
+
###i## nano /etc/portage/package.use
#
+
x11-drivers/ati-drivers qt4
# NOTE: If your BOOT partition is ReiserFS, add the notail option to opts.
+
</console>
#
+
# See the manpage fstab(5) for more information.
+
#
+
# <fs>     <mountpoint>  <type>  <opts>        <dump/pass>
+
  
/dev/sda1    /boot        ext2    noauto,noatime 1 2
+
{{Note|If you are using a desktop or workstation profile, this USE flag will be enabled by default.}}
/dev/sda2    none          swap    sw            0 0
+
/dev/sda3    /            ext4    noatime        0 1
+
#/dev/cdrom  /mnt/cdrom    auto    noauto,ro      0 0
+
</pre>
+
  
{{Note|Atualmente, noso <code>/etc/fstab</code> padrão tem o filesystem root como <code>/dev/sda4</code> e a partição swap como <code>/dev/sda3</code>. Esses precisarão ser alterados para <code>/dev/sda3</code> e <code>/dev/sda2</code>, respectivamente.}}
+
== Installing ==
  
{{Note|Se você estiver utilizando UEFI para inicializar (boot), altere a linha <code>/dev/sda1</code> então ela diz <code>vfat</code> ao invés de <code>ext2</code>. Similarmente, certifique-se de que a linha <code>/dev/sda3</code> especifica ou <code>xfs</code> ou <code>ext4</code>, dependendo de qual filesystem você escolher em filesystem-creation time.}}
+
=== Emerging the package ===
  
==== /etc/localtime ====
+
If you allready have emerged xorg-server, all you need to install the drivers is running the following command:
 
+
<console>
<code>/etc/localtime</code> é utilizado para especificar o fuso horário (timezone) em que sua sua máquina está, e os padrões para o UTC. Se você quiser que seu sistema Funtoo Linux utilize fuso horário, você deve substituir <code>/etc/localtime</code> por um link simbólico para o fuso horário que você deseja utilizar.
+
###i## emerge -av --changed-use --deep @world
 +
</console>
  
 +
otherwise you may install the drivers with
 
<console>
 
<console>
(chroot) # ##i##ln -sf /usr/share/zoneinfo/MST7MDT /etc/localtime
+
###i## emerge -av x11-drivers/ati-drivers
 
</console>
 
</console>
  
O comando acima define o fuso horário para montar o horário padrão (com horário de verão). Digite <code>ls /usr/share/zoneinfo</code> para verificar quais fuso horários estão disponíveis. Há também subdiretórios contendo fuso horários descritos por local.
+
Before using the driver, ensure that the "fglrx" module has been loaded -- run {{c|modprobe fglrx}} as root  -- it should return with no error. If the module can't be found, run {{c|depmod -a}} as root -- then the modprobe command should work. If you are switching from the open source Radeon driver, then shutting down your desktop and rebooting your system (be sure to disable xdm) may be required to get the new "fglrx" module to load cleanly.
  
==== /etc/make.conf ====
+
== Configuring ==
  
MAKEOPTS pode ser utilizado para definir quantas compilações paralelas devem ocorrer quando você compilar um pacote, que pode acelerar compilação significativamente. uma regra de thumb é o número de CPUs (ou CPU threads) em seu sistema mais um (plus one). Se por exemplo você possui um processador dual core sem [[wikipedia:Hyper-threading|hyper-threading]], então você definiria MAKEOPTS para 3:
+
Next, set ati-drivers to manage the system's OpenGL and OpenCL implementations:  
 
+
<console>
<pre>
+
###i## eselect opengl set ati
MAKEOPTS="-j3"
+
###i## eselect opencl set amd
</pre>
+
</console>
  
Se você não estiver certo sobre quantos processadores/threads você possui, então utilize nproc para ajudá-lo.
+
Afterwards, run <code>aticonfig</code> to modify the X-server configuration file to work with the ati-drivers:
 
<console>
 
<console>
(chroot) # ##i##nproc
+
###i## aticonfig --initial
16
+
 
</console>
 
</console>
  
Defina MAKEOPTS para esse número mais um:
+
{{tip|If you would like to have a full-resolution framebuffer with ati-drivers, check out [[uvesafb| uvesafb]]}}
  
<pre>
+
=== Multi-Head Display ===
MAKEOPTS="-j17"
+
</pre>
+
  
Flgas USE definem qual funcionalidade está habilitada quando pacotes são construídos. Não é recomendado adicionar um monte dele durante a instalação; Você deve esperar até que obtenha um, sistema inicializável, funcional antes de alterar suas flags USE. Uma flag USE prefixada com um sinal de menos ("<code>-</code>") diz ao Portage para não utilizar a flag quando compilar. Um guia do Funtoo para as flags USE estarão disponíveis no futuro. Por hora, você pode descobrir mais informações sobre as flags USE no [http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=2&chap=2 Gentoo Handbook].
+
There are a couple of options for setting up a multi-head display. For some systems, all you need to do is plug in your additional monitor, and it will be detected by your desktop environment, and will work.
  
LINGUAS diz ao Portage em qual idioma local compilar o sistema e as aplicações (aqueles que utilizam variável LINGUAS como o OpenOffice). Geralmente não é necessário definir essa se você utiliza em inglês. Se você quiser um outro idioma tal qual francês (fr) ou Alemão (de), defina LINGUAS apropriadamente:
+
If your second monitor does not display anything at all, then play around with your X configuration. Try using the following command to generate a new X config:
  
<pre>
+
{{console|body=
LINGUAS="fr"
+
# ##i##aticonfig --initial=dual-head
</pre>
+
}}
 +
 
 +
You can use the {{c|--screen-layout={left|right|above|below}}} option to specify the relationship of the second screen to the first.
 +
 
 +
For more than two heads, or multiple cards, you can use the following approach to generate an appropriate X config. First, list adapters to see what adapters are available:
 +
 
 +
{{console|body=
 +
# ##i##aticonfig --list-adapters
 +
}}
 +
 
 +
Now, a variant of one of the following commands to generate an X configuration for your needs:
 +
 
 +
{{console|body=
 +
# ##i##aticonfig --initial --heads=4 --adapter=1
 +
# ##i##aticonfig --adapter=0,2 --initial
 +
# ##i##aticonfig --adapter=all --initial
 +
# ##i##aticonfig --xinerama=on
 +
}}
 +
 
 +
One you have your displays enabled so that your mouse pointer can move to all displays, you still may not be able to drag windows to certain monitors. In this situation, each monitor is probably configured as a separate X screen, and you'll need to use the Catalyst Control Center {{c|amdcccle}} GUI configuration tool to tie them together. The Catalyst Control Center is installed when the {{c|qt4}} USE variable is enabled.
 +
 
 +
Open up a graphical terminal, and become root by typing {{c|su -}} -- your user will need to be in the {{c|wheel}} group to do this:
 +
 
 +
{{console|body=
 +
$ ##i##su -
 +
Password: ##i##*******
 +
# source /etc/profile
 +
# amdcccle
 +
}}
 +
 
 +
[[File:amdcccle.png|class=img-responsive|center]]
 +
Navigate to Display Manager, and choose the option {{c|Multi-display desktop with display(s) X}} for each display. Then, drag and drop the blue displays to arrange them to match how they are arranged in front of you. Click {{c|OK}}. The Catalyst Control Center will tell you that you will need to restart your system for the changes to take effect. Simply log out if you are running {{c|xdm}}, or end your X session, and start it up again. You should now have a fully-functioning multi-head display.
 +
 
 +
=== Troubleshooting ===
 +
==== I am using a HDMI connection, and my monitor's display has a black border around it. ====
 +
Disable overscan using the following command, as root:
  
==== /etc/conf.d/hwclock ====
 
Se você realizar dual-boot com Windows, você precisará editar esse arquivo e alterar o valor de '''clock''' de '''UTC''' para '''local''', por que o Windows definirá seu hardware clock para a hora local toda vêz que inicializar (boot) o Windows. Caso contrário você normalmente não precisaria editar esse arquivo.
 
 
<console>
 
<console>
(chroot) # ##i##nano -w /etc/conf.d/hwclock
+
# ##i##aticonfig --set-pcs-val=MCIL,DigitalHDTVDefaultUnderscan,0
 
</console>
 
</console>
  
==== Localização ====
+
You will need to restart your X session for the changes to take effect. If you are using a display manager, logging out and back in again should cause the new settings to be visible.
 +
 
 +
==== The tabs in Google Chrome are becoming garbled/corrupted ====
 +
 
 +
New versions of Google Chrome use hardware acceleration by default which appears to have rendering issues with AMD's drivers. To work around this, disable hardware acceleration in Google Chrome by going to {{c|Settings}}, {{c|Show advanced settings...}} and then uncheck the {{c|Use hardware acceleration when available (requires Chrome restart)}}. Once Chrome is restarted, the rendering problem should be resolved.
 +
 
 +
==== Compton with backend glx does not work well with ati-drivers ====
 +
Try running compton with the following switches:
 +
<console>
 +
###i## compton --backend glx --vsync none --paint-on-overlay
 +
</console>
  
Por padrão, o Funtoo Linux é configurado com o Unicode (UTF-8) habilitado, e para a localidade e teclado em inglês americano (US English locale and keyboard). Se você gostaria de configurar seu sistema para utilizar uma localidade ou teclado não em inglês (non-English locale or keyboard), veja [[Pt-br/Funtoo_Linux_Localization|Localização do Funtoo Linux]].
+
[[Category:Video Cards]]
 +
[[Category:First Steps]]
 +
{{EbuildFooter}}

Revision as of 16:03, February 20, 2015

x11-drivers/ati-drivers


Current Maintainer(s):Daniel Robbins
Source Repository:Repository:Funtoo Overlay


Summary: Accelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.

Use Flags

qt4
Install qt4 dependent optional tools (e.g Catalyst Control Panel)
modules
Build the kernel modules
disable-watermark
Do a potentially dangerous binary search and replace to disable watermark
pax_kernel
Enable pax kernel specific patches
vaapi
Enabled Video Acceleration API

News

Drobbins

Perl Updates

Gentoo has bumped perl from 5.20 to 5.22. Be sure to run perl-cleaner --all after the upgrade.
2015-07-25 by Drobbins
Drobbins

ARM Rebuild

ARM systems will use new stage3's that are not compatible with earlier versions.
2015-06-27 by Drobbins
Drobbins

ABI X86 64 and 32

Funtoo Linux has new 32-bit compatibility libraries inherited from Gentoo. Learn about them here.
2015-06-18 by Drobbins
More...

AMD Catalyst Video Drivers

Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.


Important

Version 14.12-r3 and above now include ATI GLESv2 and EGL libraries, which should improve stabilty with GNOME.

Introduction

x11-drivers/ati-drivers (often referred to as "fglrx", the name of its kernel module) is the proprietary, accelerated driver for AMD (ATI) graphics cards.

Preparing to Install

Blacklist Radeon and DRM Modules

To avoid having the open source Radeon drivers automatically load and ruin your day, create a blacklist file as follows:

/etc/modprobe.d/radeon.conf - Prevent open source DRM and radeon drivers from loading
blacklist radeon
blacklist drm

Configuring the kernel

Configure the kernel as follows. Note that the Direct Rendering Manager is not enabled. It's possible to have it selected as a kernel module, but should not be built-in to your kernel.


[*] Enable loadable module support
Processor type and features --->
      [*] MTRR (Memory Type Range Register) support
Bus options (PCI etc.) --->
      [*] PCI Express Port Bus Support
      [*] Message Signaled Interrupts (MSI and MSI-X)
Device Drivers --->
      Graphics support --->
            < > Direct Rendering Manager (xFree86 4.1.0 and higher DRI support) --->
Note

If you need support for AGP cards, enable the following kernel options:

Device Drivers --->
      Graphics support --->
            <*> /dev/agpgart (AGP Support) --->
                  Select an appropriate AGP driver:
                  <*> AMD Opteron/Athlon64 on-CPU GART support

Editing make.conf

Add the following to your /etc/make.conf:

# nano /etc/make.conf
VIDEO_CARDS="fglrx"

Enabling AMD Catalyst Control Center

Then, add the following to /etc/portage/package.use if you would like to enable support for AMD Catalyst Control Center:

# nano /etc/portage/package.use
x11-drivers/ati-drivers qt4
Note

If you are using a desktop or workstation profile, this USE flag will be enabled by default.

Installing

Emerging the package

If you allready have emerged xorg-server, all you need to install the drivers is running the following command:

# emerge -av --changed-use --deep @world

otherwise you may install the drivers with

# emerge -av x11-drivers/ati-drivers

Before using the driver, ensure that the "fglrx" module has been loaded -- run modprobe fglrx as root -- it should return with no error. If the module can't be found, run depmod -a as root -- then the modprobe command should work. If you are switching from the open source Radeon driver, then shutting down your desktop and rebooting your system (be sure to disable xdm) may be required to get the new "fglrx" module to load cleanly.

Configuring

Next, set ati-drivers to manage the system's OpenGL and OpenCL implementations:

# eselect opengl set ati
# eselect opencl set amd

Afterwards, run aticonfig to modify the X-server configuration file to work with the ati-drivers:

# aticonfig --initial
Tip

If you would like to have a full-resolution framebuffer with ati-drivers, check out uvesafb

Multi-Head Display

There are a couple of options for setting up a multi-head display. For some systems, all you need to do is plug in your additional monitor, and it will be detected by your desktop environment, and will work.

If your second monitor does not display anything at all, then play around with your X configuration. Try using the following command to generate a new X config:

# aticonfig --initial=dual-head


You can use the right} option to specify the relationship of the second screen to the first.

For more than two heads, or multiple cards, you can use the following approach to generate an appropriate X config. First, list adapters to see what adapters are available:

# aticonfig --list-adapters


Now, a variant of one of the following commands to generate an X configuration for your needs:

# aticonfig --initial --heads=4 --adapter=1 
# aticonfig --adapter=0,2 --initial
# aticonfig --adapter=all --initial
# aticonfig --xinerama=on


One you have your displays enabled so that your mouse pointer can move to all displays, you still may not be able to drag windows to certain monitors. In this situation, each monitor is probably configured as a separate X screen, and you'll need to use the Catalyst Control Center amdcccle GUI configuration tool to tie them together. The Catalyst Control Center is installed when the qt4 USE variable is enabled.

Open up a graphical terminal, and become root by typing su - -- your user will need to be in the wheel group to do this:

$ su -
Password: *******
# source /etc/profile
# amdcccle


Amdcccle.png

Navigate to Display Manager, and choose the option Multi-display desktop with display(s) X for each display. Then, drag and drop the blue displays to arrange them to match how they are arranged in front of you. Click OK. The Catalyst Control Center will tell you that you will need to restart your system for the changes to take effect. Simply log out if you are running xdm, or end your X session, and start it up again. You should now have a fully-functioning multi-head display.

Troubleshooting

I am using a HDMI connection, and my monitor's display has a black border around it.

Disable overscan using the following command, as root:

# aticonfig --set-pcs-val=MCIL,DigitalHDTVDefaultUnderscan,0

You will need to restart your X session for the changes to take effect. If you are using a display manager, logging out and back in again should cause the new settings to be visible.

The tabs in Google Chrome are becoming garbled/corrupted

New versions of Google Chrome use hardware acceleration by default which appears to have rendering issues with AMD's drivers. To work around this, disable hardware acceleration in Google Chrome by going to Settings, Show advanced settings... and then uncheck the Use hardware acceleration when available (requires Chrome restart). Once Chrome is restarted, the rendering problem should be resolved.

Compton with backend glx does not work well with ati-drivers

Try running compton with the following switches:

# compton --backend glx --vsync none --paint-on-overlay