From 3db384424bd7398ffbb7a355cab8f15f3add009f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Sun, 2 Oct 2016 19:24:58 +0200 Subject: New upstream version 1.9.1+repack --- doc/Environment.html | 258 ++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 237 insertions(+), 21 deletions(-) (limited to 'doc/Environment.html') diff --git a/doc/Environment.html b/doc/Environment.html index b4cd9ca..c4c1aed 100644 --- a/doc/Environment.html +++ b/doc/Environment.html @@ -10,9 +10,53 @@ Argyll Environment Variables +

Setting an environment variable

+  To set an environment variable an MSWindows DOS shell, either + use set, e.g.;

-

Environment variables
-

+     set ARGYLL_REV_CACHE_MULT=1.5
+
+ which will set the value for that session, or set it in
+
+ Control Panel->System->Advanced->Environment Variables..
+
+ in either user or system variables.
+
+ You can examine individual variables using
+
+     echo %VARIABLE_NAME%
+
+ or see all of them using
+
+    set
+
+
+ For OS X or Linux, the exact procedure will depend on the shell you + are running, but
+ is usually something like:
+
+     export ARGYLL_REV_CACHE_MULT=1.5
+ or
+     set ARGYLL_REV_CACHE_MULT=1.5
+ or
+     ARGYLL_REV_CACHE_MULT=1.5
+
+ and may need separately exporting, something like:
+
+     export ARGYLL_REV_CACHE_MULT
+
+ Generally it should be configured in the shell start-up + script,  if you want the setting to be used
+ for every session.
+
+ You can examine individual variables using
+
+     echo $VARIABLE_NAME
+
+ or see all of them using
+
+    set
+

Environment variables

The following environment variables affect behaviour:

ARGYLL_NOT_INTERACTIVE
@@ -45,6 +89,14 @@     Note that on MSWin systems, the character and return or line fee characters must be written to stdin in a single operation (i.e. testing ARGYLL_NOT_INTERACTIVE  + + + + + + + + mode manually will probably fail, because the character and return get split up.)
@@ -58,12 +110,28 @@ + + + + + + + + or X3DOM, which will result in .wrl, .x3d and .x3d.html files respectively. See 3d + + + + + + + + Viewing Format.

@@ -97,6 +165,14 @@ a + + + + + + + + delay of 200 msec is allowed between changing a patch color in software, and that change appearing in the displayed color itself. For some instuments (ie. i1d3, i1pro, ColorMunki, Klein K10-A) @@ -116,6 +192,14 @@ environment + + + + + + + + variable, ie. ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS=400 would set a 400 msec minimum delay.

@@ -158,19 +242,19 @@ environment as being recommended practice in modelling chromatic adaption.  The ICC profile format though, specifies the use of a non-cone space XYZ adaptation (so called "Wrong Von Kries" - chromatic adaptation) [ ICC Specification
- ICC.1:2001-04 (ICCV2.4) Annex A, pp 66, equations A.1, A.2 & - A.3 ], so ArgyllCMS profiles have a very slight incompatibility - with ICC profiles created strictly according to the ICC - specifications, depending on how close to white Output (i.e. - print) profiles media white is to the perfect diffuser. (Note that - CMM's that strictly follow the ICC specifications have much more - gross incompatibilities due to this, when dealing with the HP - & Microsoft sRGB and AdobeRGB profiles.) By setting this - environment variable, Output (i.e. print) profiles will be created - that better conform to the ICC specification, and  therefore - have better inter-interoperability with some other CMMs, at the - cost of poorer color behavior.
+ chromatic adaptation) [ ICC Specification ICC.1:2001-04 (ICCV2.4) + Annex A, pp 66, equations A.1, A.2 & A.3 ], so ArgyllCMS + profiles have a very slight incompatibility with ICC profiles + created strictly according to the ICC specifications, depending on + how close to white Output (i.e. print) profiles media white is to + the perfect diffuser. (Note that CMM's that strictly follow the + ICC specifications have much more gross incompatibilities due to + this, when dealing with the HP & Microsoft sRGB and AdobeRGB + profiles.) By setting this environment variable, Output (i.e. + print) profiles will be created that better conform to the ICC + specification, and  therefore have better + inter-interoperability with some other CMMs, at the cost of poorer + color behavior.
See also the ArgyllCMS 'arts' tag.
+
ARGYLL_CREATE_OUTPUT_PROFILE_WITH_CHAD
+
+
For Output type devices (i.e. Printers), the assumption + is that test patches are measured under D50 illuminant. It can be + very useful for proofing to calculate color corrections for other, + real world illuminants, and ArgyllCMS makes provision for this + with the coloprof -i parameter, or + the spec2cie -i parameter. To be + broadly useful, this change in illuminant needs to be available to + CMM's, which the ArgyllCMS's implementation makes possible by + incorporating the illuminant change into the absolute XYZ values + and hence the white point tag, so that Absolute Colorimetric + rendering intent returns XYZ values under that illuminant using + any CMM.
+
+ The ICC specification have provision for hiding this difference in + illuminant by chromatically transforming the absolute values to be + functionally equivalent to having been measured using a D50 + illuminant, and recording this transform in the ChromaticAdapation + ('chad') tag. This appears to motivated by the assumption that the + difference in illuminant is a quirk or limitation of the + instrument that is to be worked around, as well as the limitation + of the ICC Absolute to Relative chromatic transformation being + based on the inferior non-cone space XYZ adaptation (so called + "Wrong Von Kries" chromatic adaptation), while the + ChromaticAdapation tag allows for the use of a superior cone-space + based transformation. (see ARGYLL_CREATE_WRONG_VON_KRIES_OUTPUT_CLASS_REL_WP above + for more details.)
+
+
To + allow for strict conformance to the ICC specification when using + non-standard illuminants, setting the ARGYLL_CREATE_OUTPUT_PROFILE_WITH_CHAD + environment + variable causes a non-D50 illuminant white point change to be + hidden in the ChromaticAdapation Tag, and to still allow this to + be useful in a proofing situation, ArgyllCMS will incorporate the + effect of the ChromaticAdapation Tag when Absolute Colorimetric + Intent is chosen. Note that other CMM's may not do. For full + conformance with ICC specifications, the ARGYLL_CREATE_WRONG_VON_KRIES_OUTPUT_CLASS_REL_WP + variable would also be set, but neither of these options is + recommended, since ArgyllCMS's default behavior will give superior + results.
+
+ ARGYLL_CCAST_DEFAULT_RECEIVER
By default the ChromeCast test patch source uses a @@ -236,12 +429,27 @@ environment name="ARGYLL_DISABLE_I1PRO2_DRIVER">ARGYLL_DISABLE_I1PRO2_DRIVER

-
There is now support for most of the - the Eye-One Pro Rev E (aka Eye-One Pro 2) instrument features, but - a Rev E can be operated in legacy mode if the environment variable +
ArgyllCMS supports most of the the + Eye-One Pro Rev E (aka Eye-One Pro 2) instrument features, but a + Rev E can be operated in legacy mode if the environment variable ARGYLL_DISABLE_I1PRO2_DRIVER is set (ie. set it to "yes").
+
-
+ ARGYLL_XRGA
+
If the ARGYLL_XRGA  + environment variable is set to:
+
+     XRGA, then all Getag-MacBeth/X-Rite + reflective measurements will be converted to XRGA.
+     XRDI, then all Getag-MacBeth/X-Rite + reflective measurements will be converted to XRDI.
+     GMDI, then all Getag-MacBeth/X-Rite + reflective measurements will be converted to GMDI.
+
+ If not set (or set to some other string), then the native + calibration will be used. Note that the values must be upper case.
+
XDG_CACHE_HOME

@@ -257,6 +465,14 @@ Base + + + + + + + + Directory Specification, and uses the XDG_CACHE_HOME environment variable to place per instrument calibration information, and -- cgit v1.2.3