[babl] docs: start adding a glossary
- From: Øyvind "pippin" Kolås <ok src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [babl] docs: start adding a glossary
- Date: Tue, 23 Jul 2019 09:13:37 +0000 (UTC)
commit 829da3636b6c82500bb4a338490adf6ac73ad45a
Author: Øyvind Kolås <pippin gimp org>
Date: Tue Jul 23 11:13:20 2019 +0200
docs: start adding a glossary
docs/CMYK-static.html | 2 +-
docs/CMYK.html | 5 ++-
docs/ColorManagement-static.html | 2 +-
docs/ColorManagement.html | 5 ++-
docs/Glossary-static.html | 94 ++++++++++++++++++++++++++++++++++++++++
docs/Makefile.am | 9 ++++
docs/Reference-static.html | 4 +-
docs/SymmetricAlpha-static.html | 2 +-
docs/SymmetricAlpha.html | 5 ++-
docs/meson.build | 16 +++++++
docs/toc | 3 +-
11 files changed, 135 insertions(+), 12 deletions(-)
---
diff --git a/docs/CMYK-static.html b/docs/CMYK-static.html
index 27cbe66..4730494 100644
--- a/docs/CMYK-static.html
+++ b/docs/CMYK-static.html
@@ -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>
diff --git a/docs/CMYK.html b/docs/CMYK.html
index 852c46a..25ea943 100644
--- a/docs/CMYK.html
+++ b/docs/CMYK.html
@@ -29,12 +29,13 @@
<ul>
<li><a href='index.html#Download'> Download</a></li>
<li><a href='index.html#Features'> Features</a></li>
+ <li><a href='Reference.html'> Reference</a></li>
+ <li><a href='Glossary.html'> Glossary</a></li>
<li><a href='ColorManagement.html'> Color Management</a></li>
<li><a href='SymmetricAlpha.html'> Symmetric-Alpha</a></li>
<li><a href='CMYK.html'> CMYK</a></li>
<!--<li><a href='#Background'>Background</a></li>-->
<li><a href='index.html#Usage'> Usage</a></li>
- <li><a href='Reference.html'> Reference</a></li>
<!--<li><a href='index.html#Data-types'> Data types</a></li>
<li><a href='index.html#Color-models'> Color models</a></li>
<li><a href='#Pixel-formats'> 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>
diff --git a/docs/ColorManagement-static.html b/docs/ColorManagement-static.html
index 57c5516..5a8f913 100644
--- a/docs/ColorManagement-static.html
+++ b/docs/ColorManagement-static.html
@@ -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>
diff --git a/docs/ColorManagement.html b/docs/ColorManagement.html
index aecef94..50c0460 100644
--- a/docs/ColorManagement.html
+++ b/docs/ColorManagement.html
@@ -25,12 +25,13 @@
<ul>
<li><a href='index.html#Download'> Download</a></li>
<li><a href='index.html#Features'> Features</a></li>
+ <li><a href='Reference.html'> Reference</a></li>
+ <li><a href='Glossary.html'> Glossary</a></li>
<li><a href='ColorManagement.html'> Color Management</a></li>
<li><a href='SymmetricAlpha.html'> Symmetric-Alpha</a></li>
<li><a href='CMYK.html'> CMYK</a></li>
<!--<li><a href='#Background'>Background</a></li>-->
<li><a href='index.html#Usage'> Usage</a></li>
- <li><a href='Reference.html'> Reference</a></li>
<!--<li><a href='index.html#Data-types'> Data types</a></li>
<li><a href='index.html#Color-models'> Color models</a></li>
<li><a href='#Pixel-formats'> 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
index 0000000..b10108e
--- /dev/null
+++ b/docs/Glossary-static.html
@@ -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>
diff --git a/docs/Makefile.am b/docs/Makefile.am
index 26cb442..0d9266e 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -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 $< $@
diff --git a/docs/Reference-static.html b/docs/Reference-static.html
index 34b7b8c..e1c8dd9 100644
--- a/docs/Reference-static.html
+++ b/docs/Reference-static.html
@@ -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'>
diff --git a/docs/SymmetricAlpha-static.html b/docs/SymmetricAlpha-static.html
index 4aca2d3..395c3e3 100644
--- a/docs/SymmetricAlpha-static.html
+++ b/docs/SymmetricAlpha-static.html
@@ -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>
diff --git a/docs/SymmetricAlpha.html b/docs/SymmetricAlpha.html
index df667c8..838b5cc 100644
--- a/docs/SymmetricAlpha.html
+++ b/docs/SymmetricAlpha.html
@@ -29,12 +29,13 @@
<ul>
<li><a href='index.html#Download'> Download</a></li>
<li><a href='index.html#Features'> Features</a></li>
+ <li><a href='Reference.html'> Reference</a></li>
+ <li><a href='Glossary.html'> Glossary</a></li>
<li><a href='ColorManagement.html'> Color Management</a></li>
<li><a href='SymmetricAlpha.html'> Symmetric-Alpha</a></li>
<li><a href='CMYK.html'> CMYK</a></li>
<!--<li><a href='#Background'>Background</a></li>-->
<li><a href='index.html#Usage'> Usage</a></li>
- <li><a href='Reference.html'> Reference</a></li>
<!--<li><a href='index.html#Data-types'> Data types</a></li>
<li><a href='index.html#Color-models'> Color models</a></li>
<li><a href='#Pixel-formats'> 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>
diff --git a/docs/meson.build b/docs/meson.build
index 7dba677..ac2b3c4 100644
--- a/docs/meson.build
+++ b/docs/meson.build
@@ -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',
diff --git a/docs/toc b/docs/toc
index 1a5cb4f..ec3685a 100644
--- a/docs/toc
+++ b/docs/toc
@@ -5,12 +5,13 @@
<ul>
<li><a href='index.html#Download'> Download</a></li>
<li><a href='index.html#Features'> Features</a></li>
+ <li><a href='Reference.html'> Reference</a></li>
+ <li><a href='Glossary.html'> Glossary</a></li>
<li><a href='ColorManagement.html'> Color Management</a></li>
<li><a href='SymmetricAlpha.html'> Symmetric-Alpha</a></li>
<li><a href='CMYK.html'> CMYK</a></li>
<!--<li><a href='#Background'>Background</a></li>-->
<li><a href='index.html#Usage'> Usage</a></li>
- <li><a href='Reference.html'> Reference</a></li>
<!--<li><a href='index.html#Data-types'> Data types</a></li>
<li><a href='index.html#Color-models'> Color models</a></li>
<li><a href='#Pixel-formats'> Pixel formats</a></li>-->
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]