From 32c1a386ed4a775d947e57813491441cc6059a56 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Tue, 11 Mar 2014 05:58:42 +0100 Subject: info: doc backlight MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- info/blueshift.texinfo | 59 +++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 51 insertions(+), 8 deletions(-) diff --git a/info/blueshift.texinfo b/info/blueshift.texinfo index 58b2ec6..157a481 100644 --- a/info/blueshift.texinfo +++ b/info/blueshift.texinfo @@ -297,14 +297,15 @@ Disables or enables Blueshift. @chapter Configuration API @menu -* Configuration variables:: Configuration variables -* Colour curve manipulators:: Configuration functions colour adjustments -* Custom colour curve manipulators:: Creating custom colour adjustment functions -* Preexisting adjustments:: Using preexisting adjustment, in use and ICC -* Applying colour curves:: Appying colour adjustments to the video drivers -* Hardware detection:: Detecting connected monitors -* Continuous mode:: Creating continuous mode configurations -* Solar time:: Solar functions, such as elevation calcuation +* Configuration variables:: Configuration variables. +* Colour curve manipulators:: Configuration functions colour adjustments. +* Custom colour curve manipulators:: Creating custom colour adjustment functions. +* Preexisting adjustments:: Using preexisting adjustment, in use and ICC. +* Applying colour curves:: Appying colour adjustments to the video drivers. +* Hardware detection:: Detecting connected monitors. +* Backlight:: Adjusting monitor backlight. +* Continuous mode:: Creating continuous mode configurations. +* Solar time:: Solar functions, such as elevation calcuation. @end menu @@ -866,6 +867,48 @@ These functions returns a list of matching found. +@node Backlight +@section Backlight + +@command{blueshift} offers support for adjusting +the backlight on monitors through Linux's sysfs. +When available this preferable to adjusting the +brightness. It does however have two drawbacks: +it interferes with manual adjustments and depending +on the backlight controller you may have very +few backlight levels available. + +To list the available backlight controllers, run the +function @code{list_backlights}, has ho parameters, +it returns a list of controller names. + +To use a backlight controller, invoke the contructor +of the class @code{Backlight}. It takes one manditory +argument, the backlight controller either by name or +path, and two optional arguments: @code{adjbacklight} +and @code{minimum}. @code{adjbacklight} is booleanic, +if @code{True} the command @command{adjbacklight} from +the package with the same name will be used to set the +backlight, rather than @command{blueshift} setting it +by itself; this lets you adjust the backlight without +root permissions and without the administrator justing +the permission of @file{/sys/class/backlight/*/brightness} +files. @code{minimum} is an integer and is zero by default, +which is the lowest logical value to have. @code{minimum} +raises the minimum value from zero to avaoid the backlight +from getting stuck at zero when reached, as happens on +some controllers. + +Instances of the class @code{Backlight} have one +variable: @code{maximum}. @code{maximum} is an integer +and is the highest inclusive brightness level. Instances +also have two properties: @code{actual} and +@code{brightness}. @code{actual} is read-only and gets +the current actual backlight level. @code{brightness} +can both be read and write and gets or sets the current +backlight level. Both are integer properties. + + @node Continuous mode @section Continuous mode -- cgit v1.2.3-70-g09d2