Difference between pages "Welcome" and "Package:Compton"

(Difference between pages)
 
m (spaces right after the | in fancynote will cause things to look pre-formatted; fixing.)
 
Line 1: Line 1:
<div class="container"><div class="row"><div class="col-xs-12 col-md-8 col-lg-8">
+
{{Ebuild
{{Slideshow}}
+
|Summary=A compositor for X.
Want to submit a screenshot? [http://forums.funtoo.org/index.php?/topic/180-screenshots/ See here.]
+
|CatPkg=x11-misc
</div><div class="col-xs-12 col-md-4 col-lg-4">
+
|Maintainer=
'''Funtoo Linux''' is a Linux-based operating system that is a variant of [http://www.gentoo.org Gentoo Linux]. Funtoo Linux is:
+
|Homepage=https://www.github.com/chjj/compton/
* ...'''fun!''' Our priority is to create a ''great, supportive and responsive'' user community.
+
* ...'''user-centric and collaborative'''. Everyone is considered a '''user''' of Funtoo, first and foremost. You don't need any special privileges to collaborate with us.
+
* ...'''production-oriented''': Our goal is to have Funtoo be useful for ''real-world tasks''. We use Funtoo to do stuff, like host our infrastructure. It needs to work.__NOTOC__
+
* ...'''creative''': We seek creative, elegant and maintainable solutions to problems of all kinds.
+
 
+
'''View the [[Funtoo Linux FAQ]] for answers to common questions.'''
+
 
+
{{#ask: [[Category:People]] [[Email::+]]
+
| ?Email
+
| limit=22
+
| order=random
+
| format=template
+
| template=GravatarDisplay
+
| link=none
+
| searchlabel=
+
 
}}
 
}}
 +
== 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
  
Join us - {{CreateAccount}}, and then add yourself to our [[Usermap]]!
+
== Installation ==
 +
To install compton, just emerge it:
 +
<console>
 +
###i## emerge -av compton
 +
</console>
  
{{fancynote|Please be patient and expect some visual hiccups as we transition to a new mobile-friendly wiki skin -- [http://forums.funtoo.org/index.php?/topic/179-new-wwwfuntooorg-skin/ more info here]. Thanks!}}
+
== Configuration ==
</div>
+
=== Creating a custom blur kernel ===
</div><div class="row">
+
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.
<div class="col-xs-12 col-md-4 col-lg-4">
+
<code>compton-convgen</code> takes the following switches:
== Resources ==
+
* <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.}}
  
{{fancyimportant|1=
+
To build a blur (convolution) kernel of type gaussian with a sigma of three and a height of 13, run the following:
[[Support Funtoo]] to help our project grow! '''Donate $15 per month and get a free [[Funtoo Hosting|Funtoo Virtual Container]].'''}}
+
<console>
 +
$##i## compton-convgen -f sigma=3 --dump-compton gaussian 13
 +
</console>
  
Our community has a number of excellent resources for communication and collaboration:
+
This should output some long string of values that begins with:
* '''{{CreateAccount}}''' to log in to the wiki, forums and bug tracker. See [[Funtoo Authentication FAQ]].
+
<console>
* '''[http://forums.funtoo.org forums.funtoo.org]''' - our new forums!
+
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,
* [https://groups.google.com/forum/#!forum/funtoo-dev funtoo-dev] mailing list
+
</console>
* '''[http://bugs.funtoo.org bugs.funtoo.org]''', our bug tracker ([[Reporting Bugs|Instructions]]).
+
* [http://larrythecow.org larrythecow.org], our Gentoo blog aggregation service.
+
* [http://kernel-seeds.org kernel-seeds.org], resources for building your kernel from scratch.
+
* [http://git.funtoo.org git.funtoo.org], our cgit repository browser.
+
* '''[[Support Funtoo]]''' to help our project grow.
+
* '''[[Funtoo Hosting|Get a Funtoo Virtual Container]]'''.
+
</div><div class="col-sm-12 col-xs-12 col-md-4 col-lg-4">
+
== Getting Started ==
+
  
We encourage you to [[Funtoo Linux Installation|install Funtoo Linux]], and get involved in our user community. Get to know fellow Funtoo Linux users on our [http://forums.funtoo.org forums]. If you have any improvements or find any bugs in Funtoo Linux, you are strongly encouraged to report them on our [http://bugs.funtoo.org bug tracker]. We take all bugs seriously, and all work performed on Funtoo Linux is tracked on our bug tracker, for purposes of transparency.
+
==== 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:
Funtoo Linux has a very active [http://en.wikipedia.org/wiki/IRC IRC] community on Freenode, in the <code>#funtoo</code> channel, and you are encouraged to hang out online with us.
+
{{file|name=~/.config/compton.conf|desc=|body=
</div><div class="col-sm-12 col-xs-12 col-md-4 col-lg-4">
+
blur-kern = "
== Distinctives ==
+
}}
 
+
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:
Funtoo Linux packages are installed from source code, automatically, thanks to the [http://en.wikipedia.org/wiki/Portage_(software) Portage ports system.], inspired by the FreeBSD ports system, but written in Python and with full advanced package management functionality. Funtoo Linux is a meta-distribution, which means it is built (fully automatically) with the functionality and optimizations that ''you'' want, not what some distro maintainer thought was best for you.
+
{{file|name=~/.config/compton.conf|desc=|body=
 
+
blur-kern = "a bunch of numbers and commas that you have pasted in.........";
We use [http://en.wikipedia.org/wiki/Git_(software) Git] for all our development, and we also use Git to deliver our ports tree to you.
+
}}
 
+
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:
In contrast to Gentoo Linux, we offer a number of innovations, including our extensive use of git, [[Funtoo 1.0 Profile|our profile system]], [[Package:Boot-Update|boot-update]] boot management tool, our incredibly flexible [[Funtoo Linux Networking|template-based networking scripts]], [[Metro Quick Start Tutorial|Metro]] distribution build system, support of Debian, RHEL and other kernels, [[Creating_Python-related_Ebuilds|enhanced Python support]], Portage mini-manifests, user-centric distribution model, and a large number of community infrastructure improvements.
+
{{file|name=~/.config/compton.conf|desc=|body=
</div></div><div class="row">
+
blur-kern = "a bunch of numbers and commas that you have pasted in.........";
<div class="col-xs-12 col-sm-8 col-md-8 col-lg-8">
+
frame-opacity = 0.50;
== Expand the wiki! ==
+
blur-background = true;
 
+
}}
The [[:Help:Funtoo_Editing_Guidelines | How to 'wiki']] sidebar link has several formatting examples.  Have a look at [[Requested-Documents]] and [[:Category:Needs_Updates | pages that need to be updated.]]  Please search the wiki before creating pages to ensure that you are not duplicating efforts.
+
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.
 
+
We need help adding documentation for ebuilds to our wiki. See [[:Category:Ebuilds|Ebuilds]] for a list of all ebuild pages.
+
 
+
'''Add an Ebuild page:''' (see [[Adding an Ebuild to the Wiki]] for instructions)
+
 
+
{{#forminput:form=Ebuild|size=|default value=|button text=Add Package|autocomplete on namespace=Package|remote autocompletion|placeholder=Descriptive name|query string=namespace=Package}}
+
 
+
</div><div class="col-xs-12 col-sm-4 col-md-4 col-lg-4">
+
== Project Structure ==
+
 
+
Funtoo Linux is led by [http://en.wikipedia.org/wiki/Daniel_Robbins_(computer_programmer) Daniel Robbins], the creator and former Chief Architect of [http://en.wikipedia.org/wiki/Gentoo_Linux Gentoo Linux], who serves as benevolent dictator for life (BDFL) of the project. Our organizational structure consists of BDFL and a small number of support staff, as well as members of our user community who are involved in improving Funtoo Linux. Development efforts are driven by the BDFL as well as our users, and efforts are under way to implement various mechanisms to allow supporters of Funtoo Linux to chart the future direction of the project.
+
 
+
'''Learn more about Funtoo Linux's [[staff]] and [[Funtoo Linux Vision|development vision]].'''
+
</div></div></div>
+
 
+
__NOTITLE__
+
__NOEDITSECTION__
+
{{#subobject:|slideIndex=0|slideCaption=
+
== [[User:Drobbins|drobbins]] ==
+
 
+
[[GNOME First Steps|GNOME 3.12]]
+
([[Funtoo_Linux_FAQ#Do_you_support_systemd.3F|without systemd]], because that's how we roll.)
+
 
+
Note: Badgers optional.
+
|slideImage=/slideshow/gnome3122.jpg}}
+
{{#subobject:|slideIndex=1|slideCaption=
+
== [[User:Anak1n|anak1n]] ==
+
 
+
fluxbox
+
|slideImage=/slideshow/fluxbox-09.02.14.png}}
+
{{#subobject:|slideIndex=2|slideCaption=
+
== spectromas ==
+
 
+
[[Package:Awesome_(Window_Manager)|Awesome WM]]
+
|slideImage=/slideshow/7maK2R7.png}}
+
{{#subobject:|slideIndex=3|slideCaption=
+
== [[User:Anak1n|anak1n]] ==
+
  
KDE
+
[[Category:Desktop]]
|slideImage=/slideshow/mvXkeT4.png}}
+
{{EbuildFooter}}

Revision as of 04:58, September 25, 2014

x11-misc


Source Repository:Gentoo Portage Tree
Homepage

Summary: A compositor for X.

Compton

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

To install compton, just emerge it:

# emerge -av compton

Configuration

Creating a custom blur kernel

The version of compton in the Funtoo repositories comes with another application called compton-convgen. compton-convgen allows you to generate custom blurs for the backgrounds of transparent window borders, menus, etc. compton-convgen takes the following switches:

  • -f: 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: -f sigma=3
  • --dump-compton: If you add this switch, compton-convgen will format the output in a way that can be used with compton. This is recommended.
  • type: The type of blur kernel to use. Options include box and gaussian.
  • width: 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.
  • height: Not required if you enter height (so long as you want width and height to be equivalent).

Note

The height and width 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:

$ compton-convgen -f sigma=3 --dump-compton gaussian 13

This should output some long string of values that begins with:

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,

Applying the custom blur kernel to compton

Now that we have generated our own custom blur kernel, we can add it to our .config/compton.conf so that our transparent windows have blurred backgrounds. To do this, create a line of text in your compton.conf that says:

~/.config/compton.conf
blur-kern = "

Then, copy the output of compton-convgen (minus the trailing comma at the end) to the right side of this line in your .config/compton.conf. After you have copied it over, go back into your compton.conf and add a quote and semicolon to the end of the blur-kern entry. For example:

~/.config/compton.conf
blur-kern = "a bunch of numbers and commas that you have pasted in.........";

Now that the blur-kern is in our compton.conf, we can test it out. Go into your compton.conf again and add the following lines to make window borders transparent:

~/.config/compton.conf
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 backend = "glx"; to your compton.conf. If, after relaunching compton, this does not fix the issue, you may need to look into if your graphics drivers support such actions.