aboutsummaryrefslogtreecommitdiffstats
path: root/doc/info
diff options
context:
space:
mode:
Diffstat (limited to 'doc/info')
-rw-r--r--doc/info/chap/clut-manipulation.texinfo31
-rw-r--r--doc/info/content.texinfo2
2 files changed, 33 insertions, 0 deletions
diff --git a/doc/info/chap/clut-manipulation.texinfo b/doc/info/chap/clut-manipulation.texinfo
new file mode 100644
index 0000000..3a10939
--- /dev/null
+++ b/doc/info/chap/clut-manipulation.texinfo
@@ -0,0 +1,31 @@
+@node CLUT Manipulation
+@chapter CLUT Manipulation
+
+@command{libclut} has a number of function-like macros
+for manipulating colour lookup tables. These have
+3 common initial parameters, that describe the
+colour lookup table that shall be manipulated.
+@table @code
+@item clut
+Pointer to the gamma ramps. This must be a pointer
+to an instance of a @code{struct} that must at least
+have the array members @code{red}, @code{green}, and
+@code{blue}, whose elements shall be of the time
+specified by the parameter @code{type}. The struct
+must also have the scalar members @code{red_size},
+@code{green_size}, and @code{blue_size}, and shall be
+of the type @code{size_t}; they shall specify the
+number of stops (elements) in the arrays @code{.red},
+@code{.green}, and @code{.blue}, respectively, which
+shall be the gamma ramp for the ``red'', green, and
+blue channels respectively.
+@item max
+The maximum value on each stop in the ramps.
+@item type
+The data type used for each stop in the ramps.
+@end table
+@noindent
+Additionally, these macros do not allow that arguments
+have side-effects. None, if the macros have a return
+value.
+
diff --git a/doc/info/content.texinfo b/doc/info/content.texinfo
index 0eeeac9..737e457 100644
--- a/doc/info/content.texinfo
+++ b/doc/info/content.texinfo
@@ -9,6 +9,7 @@
@menu
* Overview:: Brief overview of @command{libclut}.
+* CLUT Manipulation:: Function-like macros for CLUT manipulation.
* Free Software Needs Free Documentation:: Why free documentation is important.
* GNU General Public License:: Copying and sharing @command{libclut}.
@@ -18,6 +19,7 @@
@include chap/overview.texinfo
+@include chap/clut-manipulation.texinfo
@include appx/free-software-needs-free-documentation.texinfo