docs: start adding a glossary
authorØyvind Kolås <pippin@gimp.org>
Tue, 23 Jul 2019 09:13:20 +0000 (11:13 +0200)
committerØyvind Kolås <pippin@gimp.org>
Tue, 23 Jul 2019 09:13:20 +0000 (11:13 +0200)
docs/CMYK-static.html
docs/CMYK.html
docs/ColorManagement-static.html
docs/ColorManagement.html
docs/Glossary-static.html [new file with mode: 0644]
docs/Makefile.am
docs/Reference-static.html
docs/SymmetricAlpha-static.html
docs/SymmetricAlpha.html
docs/meson.build
docs/toc

index 27cbe665d7425fb1dfbe47d2a132b95ad55abae6..473049479a196c2ee64c237b7983fc9619ea28f1 100644 (file)
@@ -47,7 +47,7 @@ and float:</p>
   </dl>
 
 
-  <a href='graphics/index.html'><img class='BablFish' alt='/babl-0.1.67' title='babl-0.1.67' src='graphics/babl-48x48.png'/></a>
+  <a href='graphics/index.html'><img class='BablFish' alt='/babl' title='babl' src='graphics/babl-48x48.png'/></a>
   </div>
   </div>
 
index 852c46a12c7c3a0705e9d93ea75d3f7ee903ce31..25ea9437b5fca0ef7ef58cf88744a1436b26c9ca 100644 (file)
       <ul>
         <li><a href='index.html#Download'>&nbsp;&nbsp;Download</a></li>
         <li><a href='index.html#Features'>&nbsp;&nbsp;Features</a></li>
+        <li><a href='Reference.html'>&nbsp;&nbsp;Reference</a></li>
+        <li><a href='Glossary.html'>&nbsp;&nbsp;Glossary</a></li>
         <li><a href='ColorManagement.html'>&nbsp;&nbsp;Color Management</a></li>
         <li><a href='SymmetricAlpha.html'>&nbsp;&nbsp;Symmetric-Alpha</a></li>
         <li><a href='CMYK.html'>&nbsp;&nbsp;CMYK</a></li>
         <!--<li><a href='#Background'>Background</a></li>-->
         <li><a href='index.html#Usage'>&nbsp;&nbsp;Usage</a></li>
-        <li><a href='Reference.html'>&nbsp;&nbsp;Reference</a></li>
         <!--<li><a href='index.html#Data-types'>&nbsp;&nbsp;&nbsp;&nbsp;Data types</a></li>
         <li><a href='index.html#Color-models'>&nbsp;&nbsp;&nbsp;&nbsp;Color models</a></li>
         <li><a href='#Pixel-formats'>&nbsp;&nbsp;&nbsp;&nbsp;Pixel formats</a></li>-->
@@ -73,7 +74,7 @@ and float:</p>
   </dl>
 
 
-  <a href='graphics/index.html'><img class='BablFish' alt='/babl-0.1.67' title='babl-0.1.67' src='graphics/babl-48x48.png'/></a>
+  <a href='graphics/index.html'><img class='BablFish' alt='/babl' title='babl' src='graphics/babl-48x48.png'/></a>
   </div>
   </div>
 
index 57c55169445ffe790b2d1c615957c6668585f647..5a8f913c80d06b0b7e49ac4868ddbd5c056927e2 100644 (file)
@@ -50,7 +50,7 @@
 
   <p>Handling of <a href='CMYK.html'>CMYK is in a separate document</a>.</p>
 
-  <a href='graphics/index.html'><img class='BablFish' alt='/babl-0.1.67' title='babl-0.1.67' src='graphics/babl-48x48.png'/></a>
+  <a href='graphics/index.html'><img class='BablFish' alt='/babl' title='babl' src='graphics/babl-48x48.png'/></a>
   </div>
   </div>
 
index aecef94d7b7cafb1e112946a18c46781d053e8a0..50c0460410f4d87a08fc969762c099291bd7c5a9 100644 (file)
       <ul>
         <li><a href='index.html#Download'>&nbsp;&nbsp;Download</a></li>
         <li><a href='index.html#Features'>&nbsp;&nbsp;Features</a></li>
+        <li><a href='Reference.html'>&nbsp;&nbsp;Reference</a></li>
+        <li><a href='Glossary.html'>&nbsp;&nbsp;Glossary</a></li>
         <li><a href='ColorManagement.html'>&nbsp;&nbsp;Color Management</a></li>
         <li><a href='SymmetricAlpha.html'>&nbsp;&nbsp;Symmetric-Alpha</a></li>
         <li><a href='CMYK.html'>&nbsp;&nbsp;CMYK</a></li>
         <!--<li><a href='#Background'>Background</a></li>-->
         <li><a href='index.html#Usage'>&nbsp;&nbsp;Usage</a></li>
-        <li><a href='Reference.html'>&nbsp;&nbsp;Reference</a></li>
         <!--<li><a href='index.html#Data-types'>&nbsp;&nbsp;&nbsp;&nbsp;Data types</a></li>
         <li><a href='index.html#Color-models'>&nbsp;&nbsp;&nbsp;&nbsp;Color models</a></li>
         <li><a href='#Pixel-formats'>&nbsp;&nbsp;&nbsp;&nbsp;Pixel formats</a></li>-->
@@ -76,7 +77,7 @@
 
   <p>Handling of <a href='CMYK.html'>CMYK is in a separate document</a>.</p>
 
-  <a href='graphics/index.html'><img class='BablFish' alt='/babl-0.1.67' title='babl-0.1.67' src='graphics/babl-48x48.png'/></a>
+  <a href='graphics/index.html'><img class='BablFish' alt='/babl' title='babl' src='graphics/babl-48x48.png'/></a>
   </div>
   </div>
 
diff --git a/docs/Glossary-static.html b/docs/Glossary-static.html
new file mode 100644 (file)
index 0000000..b10108e
--- /dev/null
@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+  <head>
+    <title>babl - glossary</title>
+    <meta http-equiv="content-type" content="text/html;charset=utf-8" />
+    <link rel="icon" href="graphics/babl-16x16.png" type="image/png" />
+    <link rel="shortcut icon" href="graphics/babl-16x16.png" type="image/png" />
+    <style type='text/css'>
+       @import url(babl.css);
+    </style>
+  </head>
+  <body>
+
+    <div class='print'>
+      <div class='print_title'>
+        <h1>Babl-0.1.67</h1>
+      </div>
+    </div>
+<!--TOC-->
+
+    <div class='paper'>
+  <div class='content'>
+
+  <h2>Glossary</h2>
+
+  <p>This vocabulary is meant as a guide to the concepts involved in babl to
+help with understanding of the code and APIs, and help continued development to
+keep the vocabulary small.</p>
+
+  <dl>
+
+    <dt><a name='alpha' href='#alpha'>Alpha</a></dt>
+    <dd>Alpha is the name used for transparency in computer programming, two main forms exist <a href='#associated_alpha'>associated alpha</a> and <a href='#separate_alpha'>separate alpha</a>.</dd>
+
+    <dt><a name='associated_alpha' href='#associated_alpha'>Associated alpha</a></dt>
+    <dd>Alpha in an additive light representation where each component has its
+own associated alpha. This representation is useful for avoiding color from
+empty pixels bleeding into surroundings. It is also able to represent emittance
+in addition to opacity.
+Babl uses <a href='SymmetricAlpha'>Symmetric alpha transformations</a> between <a href='#separate_alpha'>separate alpha</a> and associated alpha.</dd>
+
+
+    <dt><a name='BablFish' href='#BablFish'>BablFish</a></dt>
+    <dd>The objects used for processing pixels, it converts between two
+BablFormats, the first time a pair of formats are passed to
+babl_fish(format_in, format_out) a benchmark is run, and the fastest
+combination of conversions available in babl to achieve the conversion within
+configured accuracy is returned and cached for subsequent requests.</dd>
+
+    <dt><a name='BablFormat' href='#BablFormat'>BablFormat</a></dt>
+    <dd>The data type used to describe a pixel format encoding, it consists of the specific order of components.</dd>
+
+    <dt><a name='BablSpace' href='#BablSpace'>BablSpace</a></dt>
+    <dd>a BablSpace describes the specifics of a BablModel - current types of BablSpaces in use in babl are RGB and CMYK based ones; the space encodes the specific parameters like custom TRCs and Primaries.</dd>
+
+    <dt><a name='BablModel' href='#BablModel'>BablModel</a></dt>
+    <dd>In babl a model describes a specific family of color encodings - with its list of color components. For the RGB and Grayscale spaces, the model also specifies any nonlinearities as TRCs.</dd>
+
+    <dt><a name='CIE' href='#CIE'>CIE</a></dt>
+    <dt><a name='ICC_profile' href='#ICC_profile'>ICC Profile</a></dt>
+    <dt><a name='encoding' href='#encoding'>Encoding</a></dt>
+
+    <dt><a name='luminance' href='#luminance'>Luminance</a></dt>
+    <dd>The photometric measure of luminious intensity of per unit area of light. The luminance in babl is proportional to luminance - though it doesn't use the SI unit of candela per square meter.</dd>
+
+    <dt><a name='non_associated_alpha' href='#non_associated_alpha'>Non-associated alpha</a></dt>
+    <dd>deprecated term, see separate alpha</dd>
+
+    <dt><a name='premultiplied_alpha' href='#premultiplied_alpha'>Premultiplied alpha</a></dt>
+    <dd>deprecated term, see associated alpha</dd>
+
+    <dt><a name='separate_alpha' href='#separate_alpha'>Separate alpha</a></dt>
+    <dd>This representation of pixels has alpha as a fully separate component,
+that can be adjusted without affecting the color.
+Babl uses <a href='SymmetricAlpha'>Symmetric alpha transformations</a> between separate and <a href='#associated_alpha'>associated alpha</a>.</dd>
+
+    <dt><a name='trc' href='#trc'>TRC</a></dt>
+
+  </dl>
+
+  <a href='graphics/index.html'><img class='BablFish' alt='/babl' title='babl' src='graphics/babl-48x48.png'/></a>
+  </div>
+  </div>
+
+    <div class='graphic'>
+      <div class='print'>
+        <img src='graphics/babl-a4poster.png' alt=' '/>
+      </div>
+    </div>
+
+  </body>
+</html>
index 26cb442336404ee17a6963021f623df9976ec494..0d9266e9ebcd65e10a8106fe065f13eeb996e9df 100644 (file)
@@ -15,6 +15,7 @@ DIST_SUBDIRS= graphics
 HTML_FILES = index-static.html         \
             index.html         \
             CMYK.html          \
+            Glossary.html      \
             ColorManagement.html \
             SymmetricAlpha.html \
             Reference.html
@@ -27,6 +28,7 @@ EXTRA_DIST=                   \
        ColorManagement-static.html     \
        Reference-static.html   \
        CMYK-static.html        \
+       Glossary-static.html    \
        SymmetricAlpha-static.html      \
        COPYING                 \
        toc                     \
@@ -52,6 +54,13 @@ CMYK.html: CMYK-static.html toc
        $(SHELL) $(top_srcdir)/docs/tools/xml_insert.sh $@ TOC $(top_srcdir)/docs/toc
        echo " [OK]"
 
+
+Glossary.html: Glossary-static.html toc
+       echo -n "HTML: $@"
+       cp $< $@ 
+       $(SHELL) $(top_srcdir)/docs/tools/xml_insert.sh $@ TOC $(top_srcdir)/docs/toc
+       echo " [OK]"
+
 ColorManagement.html: ColorManagement-static.html toc
        echo -n "HTML: $@"
        cp $< $@ 
index 34b7b8c52b292d677e4b61c4eba97c8910263f38..e1c8dd9e862674a9df4ff0e3d619bfc9dd81302c 100644 (file)
@@ -6,7 +6,7 @@
 -->
 <html>
   <head>
-    <title>babl-0.1.67</title>
+    <title>babl</title>
     <meta http-equiv="content-type" content="text/html;charset=utf-8" />
 
     <link rel="icon" href="graphics/babl-16x16.png" type="image/png" />
@@ -94,7 +94,7 @@
       </li>
     </ul>-->
 
-        <a href='graphics/index.html'><img class='BablFish' alt='/babl-0.1.67' title='babl-0.1.67' src='graphics/babl-48x48.png'/></a>
+        <a href='graphics/index.html'><img class='BablFish' alt='/babl' title='babl' src='graphics/babl-48x48.png'/></a>
       </div>
     </div>
     <div class='graphic'>
index 4aca2d3a760be0ae1e04d7c3e8aec75b88d9cec7..395c3e3f0f84a070e6efd44fb066b8d9f42107cf 100644 (file)
@@ -88,7 +88,7 @@ associated_to_separate_rgba (const float *associated_rgba,
 
 
 
-  <a href='graphics/index.html'><img class='BablFish' alt='/babl-0.1.67' title='babl-0.1.67' src='graphics/babl-48x48.png'/></a>
+  <a href='graphics/index.html'><img class='BablFish' alt='/babl' title='babl' src='graphics/babl-48x48.png'/></a>
   </div>
   </div>
 
index df667c83da8ddc2648e9707f90da66dd63c76e17..838b5cc86ea9d7a57a93458a362150483f1b43ec 100644 (file)
       <ul>
         <li><a href='index.html#Download'>&nbsp;&nbsp;Download</a></li>
         <li><a href='index.html#Features'>&nbsp;&nbsp;Features</a></li>
+        <li><a href='Reference.html'>&nbsp;&nbsp;Reference</a></li>
+        <li><a href='Glossary.html'>&nbsp;&nbsp;Glossary</a></li>
         <li><a href='ColorManagement.html'>&nbsp;&nbsp;Color Management</a></li>
         <li><a href='SymmetricAlpha.html'>&nbsp;&nbsp;Symmetric-Alpha</a></li>
         <li><a href='CMYK.html'>&nbsp;&nbsp;CMYK</a></li>
         <!--<li><a href='#Background'>Background</a></li>-->
         <li><a href='index.html#Usage'>&nbsp;&nbsp;Usage</a></li>
-        <li><a href='Reference.html'>&nbsp;&nbsp;Reference</a></li>
         <!--<li><a href='index.html#Data-types'>&nbsp;&nbsp;&nbsp;&nbsp;Data types</a></li>
         <li><a href='index.html#Color-models'>&nbsp;&nbsp;&nbsp;&nbsp;Color models</a></li>
         <li><a href='#Pixel-formats'>&nbsp;&nbsp;&nbsp;&nbsp;Pixel formats</a></li>-->
@@ -114,7 +115,7 @@ associated_to_separate_rgba (const float *associated_rgba,
 
 
 
-  <a href='graphics/index.html'><img class='BablFish' alt='/babl-0.1.67' title='babl-0.1.67' src='graphics/babl-48x48.png'/></a>
+  <a href='graphics/index.html'><img class='BablFish' alt='/babl' title='babl' src='graphics/babl-48x48.png'/></a>
   </div>
   </div>
 
index 7dba6771635ad05ef5fd8efc950685c448cdfe72..ac2b3c4e47527f82967b67b84057e62c7a977988 100644 (file)
@@ -85,6 +85,22 @@ CMYK_html = custom_target('CMYK.html',
   build_by_default: true,
 )
 
+
+Glossary_html = custom_target('Glossary.html',
+  input : [
+    'Glossary-static.html',
+    'toc',
+  ],
+  output: [ 'Glossary.html', ],
+  command: [
+    env_bin,
+    'cp', '@INPUT0@', '@OUTPUT@',
+    '&&', xml_insert, '@OUTPUT@', 'TOC', '@INPUT1@',
+  ],
+  build_by_default: true,
+)
+
+
 ColorManagement_html = custom_target('ColorManagement.html',
   input : [
     'ColorManagement-static.html',
index 1a5cb4f2c5db336f9315c9472d03c70ffa29379a..ec3685a1bce041c9774f9283f2a75750739523ac 100644 (file)
--- a/docs/toc
+++ b/docs/toc
@@ -5,12 +5,13 @@
       <ul>
         <li><a href='index.html#Download'>&nbsp;&nbsp;Download</a></li>
         <li><a href='index.html#Features'>&nbsp;&nbsp;Features</a></li>
+        <li><a href='Reference.html'>&nbsp;&nbsp;Reference</a></li>
+        <li><a href='Glossary.html'>&nbsp;&nbsp;Glossary</a></li>
         <li><a href='ColorManagement.html'>&nbsp;&nbsp;Color Management</a></li>
         <li><a href='SymmetricAlpha.html'>&nbsp;&nbsp;Symmetric-Alpha</a></li>
         <li><a href='CMYK.html'>&nbsp;&nbsp;CMYK</a></li>
         <!--<li><a href='#Background'>Background</a></li>-->
         <li><a href='index.html#Usage'>&nbsp;&nbsp;Usage</a></li>
-        <li><a href='Reference.html'>&nbsp;&nbsp;Reference</a></li>
         <!--<li><a href='index.html#Data-types'>&nbsp;&nbsp;&nbsp;&nbsp;Data types</a></li>
         <li><a href='index.html#Color-models'>&nbsp;&nbsp;&nbsp;&nbsp;Color models</a></li>
         <li><a href='#Pixel-formats'>&nbsp;&nbsp;&nbsp;&nbsp;Pixel formats</a></li>-->