summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--TODO2
-rw-r--r--info/blueshift.texinfo54
2 files changed, 52 insertions, 4 deletions
diff --git a/TODO b/TODO
index a33bc5b..b65f46a 100644
--- a/TODO
+++ b/TODO
@@ -4,7 +4,7 @@ High priority:
Medium priority:
Test, demo and document _ICC_PROFILE
- Demo and document functionise, store and restore
+ Demo functionise, store and restore
Make it possible to have settings depend on sky condicitions.
(I have a GPL3 implmenetion of wheter observation in xpybar.)
diff --git a/info/blueshift.texinfo b/info/blueshift.texinfo
index ffcd814..f87729a 100644
--- a/info/blueshift.texinfo
+++ b/info/blueshift.texinfo
@@ -12,7 +12,8 @@
@dircategory Ergonomy
@direntry
-* blueshift: (blueshift). Automatically adjust the colour temperature
+@c * blueshift: (blueshift). Automatically adjust the colour temperature
+* blueshift: (blueshift). The grand unified dynamic colour adjustment framework
@end direntry
@@ -31,7 +32,8 @@ Texts. A copy of the license is included in the section entitled
@ifnottex
@node Top
-@top blueshift -- Automatically adjust the colour temperature
+@c @top blueshift -- Automatically adjust the colour temperature
+@top blueshift -- The grand unified dynamic colour adjustment framework
@insertcopying
@end ifnottex
@@ -314,6 +316,7 @@ Disables or enables Blueshift.
* Continuous mode:: Creating continuous mode configurations.
* Solar time:: Solar functions, such as elevation calcuation.
* Running without X:: Configuration options for running without X.
+* Optimising:: Functions that can be used to optimise performance.
@end menu
@@ -1385,6 +1388,47 @@ for API compatibility with the RandR
version) by be different.
+@node Optimising
+@section Optimising
+
+If you have adjustments that reused, perhaps
+between adjustments or shared between monitors.
+You can reduce the amount of calculates your
+script needs to do my reusing made adjustments.
+
+To snapshot the current state of the working
+colour curves (those that are not applied yet)
+you can use the function @code{store}. It is
+parameterless and returns a 3-tuple of the
+colour curves. To reset the to curves stored
+by @code{store} you can use the function
+@code{restore}:
+
+@example
+stored = store()
+# To stuff ...
+restore(stored)
+@end example
+
+You can also make a function of the stored
+settings. A function like this will apply the
+adjustments on top of current adjustments.
+To do this input the output of @code{store}
+into the function @code{functionise}:
+
+@example
+brightness(0.75)
+stored = functionise(store())
+stored()
+stored()
+# Now the brightness is 0,75 to the power of 3 = 0,421875.
+@end example
+
+Note that the @code{functionise(stored)()}
+might be heavier than applying the adjustments
+by invoking them.
+
+
@node Related software
@chapter Related software
@@ -1429,7 +1473,7 @@ does not interfere with another user's adjustments.
@end table
If you want to extend the capabilities of Blueshift
-for your configuration scripts their are some library
+for your configuration scripts there are some library
packages that can be of particular interest:
@table @command
@@ -1477,6 +1521,10 @@ Python bindings for D-Bus.
@item python-networkmanager
Python interface to NetworkManager.
+
+@item locateme
+(Under development)@*
+A command to get your geographical position.
@end table