|
|
| Line 1: |
Line 1: |
| {{Ebuild
| | == Example and Usage == |
| |Summary=A compositor for X.
| | Example: |
| |CatPkg=x11-misc
| | <pre> |
| |Maintainer=
| | {{Fancynote| Note }} |
| |Homepage=https://www.github.com/chjj/compton/
| | </pre> |
| }}
| |
| == History and background == | |
| Compton was originally created as a fork of Dana Jansen's fork of Xcompmgr. It was refactored and bugs were fixed as it grew into a standalone project. Today it has many improvements and unique features when compared with other lightweight compositors such as Xcompmgr. Here are some of them:
| |
| * OpenGL backend
| |
| * Inactive window transparency
| |
| * Create your own blur kernel and use it to blur unopaque window backgrounds
| |
| * Custom-colored window drop shadows
| |
|
| |
|
| == Installation ==
| | Will produce: |
| To install compton, just emerge it:
| | {{Fancynote| Note }} |
| <console>
| |
| ###i## emerge -av compton
| |
| </console>
| |
|
| |
|
| == Configuration == | | == See also == |
| === Creating a custom blur kernel ===
| | * [[Template:Fancywarning]] |
| The version of compton in the Funtoo repositories comes with another application called <code>compton-convgen</code>. <code>compton-convgen</code> allows you to generate custom blurs for the backgrounds of transparent window borders, menus, etc.
| | * [[Template:Fancytip]] |
| <code>compton-convgen</code> takes the following switches:
| | * [[Template:Fancyimportant]] |
| * <code>-f</code>: This option allows you to changes factors such as the sigma (standard deviation) of the blur kernel. A sigma of three to five looks nice and generates blurs similar to those seen in Windows 7 Aero and in the Ubuntu Unity launcher. To set the sigma value, enter something like: <code>-f sigma=3</code> | |
| * <code>--dump-compton</code>: If you add this switch, <code>compton-convgen</code> will format the output in a way that can be used with compton. This is recommended. | |
| * <code>type</code>: The type of blur kernel to use. Options include box and gaussian.
| |
| * <code>width</code>: The width of the blur kernel. As mentioned earlier, if you want an appearance like that of Windows Aero or Ubuntu Unity, a sigma of three to five accompanied by a gaussian with a width and height of 13 does the trick.
| |
| * <code>height</code>: Not required if you enter height (so long as you want width and height to be equivalent). | |
| {{fancynote|The <code>height</code> and <code>width</code> parameters must be odd-numbered.}}
| |
| | |
| To build a blur (convolution) kernel of type gaussian with a sigma of three and a height of 13, run the following:
| |
| <console>
| |
| $##i## compton-convgen -f sigma=3 --dump-compton gaussian 13
| |
| </console>
| |
| | |
| This should output some long string of values that begins with:
| |
| <console>
| |
| 13,13,0.018316,0.033746,0.055638,0.082085,0.108368,0.128022,0.135335,0.128022,0.108368,0.082085,0.055638,0.033746,0.018316,0.033746,0.062177,0.102512,0.151240,0.199666,0.235877,0.249352,0.235877,0.199666,0.151240,0.102512,0.062177,
| |
| </console>
| |
| | |
| ==== Applying the custom blur kernel to compton ====
| |
| Now that we have generated our own custom blur kernel, we can add it to our <code>.config/compton.conf</code> so that our transparent windows have blurred backgrounds. To do this, create a line of text in your compton.conf that says:
| |
| {{file|name=~/.config/compton.conf|desc=|body=
| |
| blur-kern = "
| |
| }}
| |
| Then, copy the output of <code>compton-convgen</code> (minus the trailing comma at the end) to the right side of this line in your <code>.config/compton.conf</code>. After you have copied it over, go back into your <code>compton.conf</code> and add a quote and semicolon to the end of the <code>blur-kern</code> entry. For example:
| |
| {{file|name=~/.config/compton.conf|desc=|body=
| |
| blur-kern = "a bunch of numbers and commas that you have pasted in.........";
| |
| }}
| |
| Now that the blur-kern is in our <code>compton.conf</code>, we can test it out. Go into your <code>compton.conf</code> again and add the following lines to make window borders transparent:
| |
| {{file|name=~/.config/compton.conf|desc=|body=
| |
| blur-kern = "a bunch of numbers and commas that you have pasted in.........";
| |
| frame-opacity = 0.50;
| |
| blur-background = true;
| |
| }}
| |
| After adding these lines, try launching compton. If you see that the borders of windows are now transparent and blurred, congratulations! If the borders are transparent, but not blurred, check that you entered the lines correctly and then relaunch compton. If that does not work, try adding the line <code>backend = "glx";</code> to your <code>compton.conf</code>. If, after relaunching compton, this does not fix the issue, you may need to look into if your graphics drivers support such actions.
| |
| | |
| [[Category:Desktop]] | |
| {{EbuildFooter}}
| |