summaryrefslogtreecommitdiff
path: root/xicc/cam97s3.h
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2014-09-01 13:56:46 +0200
committerJörg Frings-Fürst <debian@jff-webhosting.net>2014-09-01 13:56:46 +0200
commit22f703cab05b7cd368f4de9e03991b7664dc5022 (patch)
tree6f4d50beaa42328e24b1c6b56b6ec059e4ef21a5 /xicc/cam97s3.h
Initial import of argyll version 1.5.1-8debian/1.5.1-8
Diffstat (limited to 'xicc/cam97s3.h')
-rw-r--r--xicc/cam97s3.h169
1 files changed, 169 insertions, 0 deletions
diff --git a/xicc/cam97s3.h b/xicc/cam97s3.h
new file mode 100644
index 0000000..9893ea4
--- /dev/null
+++ b/xicc/cam97s3.h
@@ -0,0 +1,169 @@
+
+/*
+ * cam97s3
+ *
+ * Color Appearance Model, based on
+ * CIECAM97, "Revision for Practical Applications"
+ * by Mark D. Fairchild, with the addition of the Viewing Flare
+ * model described on page 487 of "Digital Color Management",
+ * by Edward Giorgianni and Thomas Madden, and the
+ * Helmholtz-Kohlraush effect, using the equation
+ * the Bradford-Hunt 96C model as detailed in Mark Fairchilds
+ * book "Color Appearance Models".
+ *
+ * Author: Graeme W. Gill
+ * Date: 5/10/00
+ * Version: 1.20
+ *
+ * Copyright 2000 Graeme W. Gill
+ * Please refer to COPYRIGHT file for details.
+ * This material is licenced under the GNU AFFERO GENERAL PUBLIC LICENSE Version 3 :-
+ * see the License.txt file for licencing details.
+ */
+
+/* Algorithm tweaks */
+#define CIECAM97S3_SPLINE_E /* Use spline interpolation for eccentricity factor */
+
+/* Definitions assumed here:
+
+ Stimulus field is the 2 degrees field of view of the sample
+ being characterised.
+
+ Viewing/Scene/Image field is the area of the whole image or
+ display surface that the stimulus is part of.
+
+ Background field is 10-12 degree field surrounding the stimulus field.
+ This may be within, overlap or encompass the Viewing/Scene/Image field.
+
+ Surround/Adapting field is the visual field minus the background field.
+
+ Visual field is the 130 degree angular field that is seen by the eyes.
+
+ Illuminating field is the field that illuminates the reflective
+ Scene/Image. It may be the same as the Ambient field.
+
+ Ambient field is the whole surrounding environmental light field.
+
+ NOTE: In "Digital Color Management", Giorgianni and Madden use the term
+ "Surround" to mean the same thing as "Background" in the CIECAM97 terminology.
+ The ICC standard doesn't define what it means by "Surround illumination".
+
+*/
+
+/* Rules of Thumb: */
+/* Ambient Luminance (Lat, cd/m^2) is Ambient Illuminance (Lux) divided by PI. */
+/* i.e. Lat = Iat/PI */ /* (1 foot candle = 0.0929 lux) */
+
+/* The Adapting/Surround Luminance is often taken to be */
+/* the 20% of the Ambient Luminance. (gray world) */
+/* i.e. La = Lat/5 = Iat/15.7 */
+
+/* For a reflective print, the Viewing/Scene/Image luminance (Lv, cd/m^2), */
+/* will be the Illuminating Luminance (Li, cd/m^2) reflected by the */
+/* media white point (Yw) */
+
+/* If there is no special illumination for a reflective print, */
+/* then the Illuminating Luminance (Li) will be the Ambient Luminance (Lat) */
+
+/* An emisive display will have an independently determined Lv. */
+
+/* The classification of the type of surround is */
+/* determined by comparing the Adapting/Surround luminance (La, cd/m^2) */
+/* with the average luminance of the Viewing/Scene/Image field (Lv, cd/m^2) */
+
+/* La/Lv == 0%, dark */
+/* La/Lv 0 - 20%, dim */
+/* La/Lv > 20%, average */
+/* special, cut sheet */
+
+/* The Background relative luminance Yb is typically assumed to */
+/* be 0.18 .. 0.2, and is assumed to be grey. */
+
+/* The source of flare light depends on the type of display system. */
+/* For a CRT, it will be the Ambient light reflecting off the glass surface. */
+/* (This implies Yf = Lat * reflectance/Lv) */
+/* For a reflection print, it will be the Illuminant reflecting from the media */
+/* surface. (Yf = Li * reflectance) */
+/* For a projected image, it will be stray projector light, scattered by the */
+/* surround, screen and air particles. (Yf = Li * reflectance_and_scattering) */
+
+/*
+
+ Typical Ambient Illuminance brightness
+ (Lux) La Condition
+ 11 1 Twilight
+ 32 2 Subdued indoor lighting
+ 64 4 Less than typical office light; sometimes recommended for
+ display-only workplaces (sRGB)
+ 350 22 Typical Office (sRGB annex D)
+ 500 32 Practical print evaluationa (ISO-3664 P2)
+ 1000 64 Good Print evaluation (CIE 116-1995)
+ 1000 64 Overcast Outdoors
+ 2000 127 Critical print evaluation (ISO-3664 P1)
+ 10000 637 Typical outdoors, full daylight
+ 50000 3185 Bright summers day
+
+*/
+
+/* ---------------------------------- */
+struct _cam97s3 {
+/* Public: */
+ void (*del)(struct _cam97s3 *s); /* We're done with it */
+
+ int (*set_view)(
+ struct _cam97s3 *s,
+ ViewingCondition Ev, /* Enumerated Viewing Condition */
+ double Wxyz[3], /* Reference/Adapted White XYZ (Y scale 1.0) */
+ double La, /* Adapting/Surround Luminance cd/m^2 */
+ double Yb, /* Luminance of Background relative to reference white (range 0.0 .. 1.0) */
+ double Lv, /* Luminance of white in the Viewing/Scene/Image field (cd/m^2) */
+ /* Ignored if Ev is set */
+ double Yf, /* Flare as a fraction of the reference white (range 0.0 .. 1.0) */
+ double Fxyz[3], /* The Flare white coordinates (typically the Ambient color) */
+ int hk /* Flag, NZ to use Helmholtz-Kohlraush effect */
+ );
+
+ /* Conversions */
+ int (*XYZ_to_cam)(struct _cam97s3 *s, double *out, double *in);
+ int (*cam_to_XYZ)(struct _cam97s3 *s, double *out, double *in);
+
+/* Private: */
+ /* Scene parameters */
+ ViewingCondition Ev; /* Enumerated Viewing Condition */
+ double Wxyz[3]; /* Reference/Adapted White XYZ (Y range 0.0 .. 1.0) */
+ double Yb; /* Relative Luminance of Background to reference white (Y range 0.0 .. 1.0) */
+ double La; /* Adapting/Surround Luminance cd/m^2 */
+ double Yf; /* Flare as a fraction of the reference white (Y range 0.0 .. 1.0) */
+ double Fxyz[3]; /* The Flare white coordinates (typically the Ambient color) */
+
+ /* Internal parameters */
+ double C; /* Surround Impact */
+ double Nc; /* Chromatic Induction */
+ double F; /* Adaptation Degree */
+
+ /* Pre-computed values */
+ double Fsc; /* Flare scale */
+ double Fisc; /* Inverse flare scale */
+ double Fsxyz[3]; /* Scaled Flare color coordinates */
+ double rgbW[3]; /* Sharpened cone response white values */
+ double D; /* Degree of chromatic adaption */
+ double rgbcW[3]; /* Chromatically transformed white value */
+ double rgbpW[3]; /* Hunt-Pointer-Estevez cone response space white */
+ double n; /* Background induction factor */
+ double nn; /* Precomuted function of n */
+ double Fl; /* Lightness contrast factor ?? */
+ double Nbb; /* Background brightness induction factors */
+ double Ncb; /* Chromatic brightness induction factors */
+ double z; /* Base exponential nonlinearity */
+ double rgbaW[3]; /* Post-adapted cone response of white */
+ double Aw; /* Achromatic response of white */
+
+ /* Flags */
+ int hk; /* If NZ, use Helmholtz-Kohlraush effect */
+ int trace; /* Trace values through computation */
+}; typedef struct _cam97s3 cam97s3;
+
+
+/* Create a cam97s3 conversion class, with default viewing conditions */
+cam97s3 *new_cam97s3(void);
+