extensions/CIE: add some documentation overrides
authorØyvind Kolås <pippin@gimp.org>
Mon, 22 Jul 2019 15:20:37 +0000 (17:20 +0200)
committerØyvind Kolås <pippin@gimp.org>
Mon, 22 Jul 2019 15:20:37 +0000 (17:20 +0200)
extensions/CIE.c
extensions/cairo.c

index 4b41894b18a352471286a83476982d05e4bcf90e..85f8bc5813977656cf352a040d9d09ee93b03f25 100644 (file)
@@ -164,6 +164,7 @@ models (void)
 
   babl_model_new (
     "name", "CIE xyY",
+    "doc", "the coordinate system often used for drawing chromaticity diagrams. Y is luminance.",
     babl_component ("CIE x"),
     babl_component ("CIE y"),
     babl_component ("CIE Y"),
@@ -172,6 +173,7 @@ models (void)
 
   babl_model_new (
     "name", "CIE xyY alpha",
+    "doc", "the coordinate system often used for drawing chromaticity diagrams. Y is luminance, with separate alpha",
     babl_component ("CIE x"),
     babl_component ("CIE y"),
     babl_component ("CIE Y"),
@@ -183,6 +185,7 @@ models (void)
 /* CIE 1976 UCS */
   babl_model_new (
     "name", "CIE Yuv",
+    "doc", "A newer more perceptually uniform space than xyY for chromaticity diagrams.",
     babl_component ("CIE Y"),
     babl_component ("CIE u"),
     babl_component ("CIE v"),
@@ -190,6 +193,7 @@ models (void)
 
   babl_model_new (
     "name", "CIE Yuv alpha",
+    "doc", "A newer more perceptually uniform space than xyY for chromaticity diagrams, with separate alpha.",
     babl_component ("CIE Y"),
     babl_component ("CIE u"),
     babl_component ("CIE v"),
index ada75aaf2fddd784269c5732fd93620079beea1e..53e8329a0a04c95930f2b1b520487130ac225440 100644 (file)
@@ -478,6 +478,7 @@ init (void)
     {
       const Babl *f32 = babl_format_new (
         "name", "cairo-ARGB32",
+        "doc", "endianness adaptive native cairo format with alpha",
         babl_model ("R'aG'aB'aA"),
         babl_type ("u8"),
         babl_component ("B'a"),
@@ -489,6 +490,7 @@ init (void)
 
       const Babl *f24 = babl_format_new (
         "name", "cairo-RGB24",
+        "doc", "endianness adaptive native cairo format without alpha",
         babl_model ("R'G'B'"),
         babl_type ("u8"),
         babl_component ("B'"),
@@ -544,6 +546,7 @@ init (void)
     {
       babl_format_new (
         "name", "cairo-ARGB32",
+        "doc", "endianness adaptive native cairo format with alpha",
         babl_model ("R'aG'aB'aA"),
         babl_type ("u8"),
         babl_component ("A"),
@@ -554,6 +557,7 @@ init (void)
       );
       babl_format_new (
         "name", "cairo-RGB24",
+        "doc", "endianness adaptive native cairo format without alpha",
         babl_model ("R'G'B'"),
         babl_type ("u8"),
         babl_component ("PAD"),
@@ -582,6 +586,7 @@ init (void)
   if (littleendian)
   {
     babl_format_new ("name", "cairo-ACMK32",
+                     "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with cairo.",
                      babl_model ("camayakaA"),
                      babl_type ("u8"),
                      babl_component ("ka"),
@@ -590,6 +595,7 @@ init (void)
                      babl_component ("A"),
                      NULL);
     babl_format_new ("name", "cairo-ACYK32",
+                     "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with cairo.",
                      babl_model ("camayakaA"),
                      babl_type ("u8"),
                      babl_component ("ka"),
@@ -601,6 +607,7 @@ init (void)
   else
   {
     babl_format_new ("name", "cairo-ACMK32",
+                     "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with cairo.",
                      babl_model ("camayakaA"),
                      babl_type ("u8"),
                      babl_component ("A"),
@@ -609,6 +616,7 @@ init (void)
                      babl_component ("ka"),
                      NULL);
     babl_format_new ("name", "cairo-ACYK32",
+                     "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with cairo.",
                      babl_model ("camayakaA"),
                      babl_type ("u8"),
                      babl_component ("A"),
@@ -621,6 +629,7 @@ init (void)
   /* companion subset formats for setting pango u16 RGB color values from cmykA
    * */
   babl_format_new ("name", "cykA u16",
+                   "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with pango.",
                    babl_model ("cmykA"),
                    babl_type ("u16"),
                    babl_component ("cyan"),
@@ -629,6 +638,7 @@ init (void)
                    babl_component ("A"),
                    NULL);
   babl_format_new ("name", "cmkA u16",
+                   "doc", "3 component CMYK subset format, to be used to two-pass CMYK processing/rendering with pango.",
                    babl_model ("cmykA"),
                    babl_type ("u16"),
                    babl_component ("cyan"),