From 094535c010320967639e8e86f974d878e80baa72 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Fri, 1 May 2015 16:13:57 +0200 Subject: Imported Upstream version 1.7.0 --- doc/Environment.html | 209 ++++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 175 insertions(+), 34 deletions(-) (limited to 'doc/Environment.html') diff --git a/doc/Environment.html b/doc/Environment.html index 66dbbe2..d02bf6c 100644 --- a/doc/Environment.html +++ b/doc/Environment.html @@ -2,9 +2,9 @@ + charset=windows-1252"> + charset=windows-1252"> Argyll Environment Variables @@ -15,7 +15,7 @@ The following environment variables affect behaviour:

- ARGYLL_NOT_INTERACTIVE
+ ARGYLL_NOT_INTERACTIVE

Normally Argylls tools expect that they are directly interacting with a user, and use a couple of @@ -43,8 +43,25 @@ interactive mode.

- ARGYLL_COLMTER_CAL_SPEC_SET
- ARGYLL_COLMTER_COR_MATRIX
+ ARGYLL_3D_DISP_FORMAT
+ +
This overrides the default 3D visualisation file format + for tools such as iccgamut or viewgam. Set to VRML or X3D + + + + or X3DOM, which will result in .wrl, .x3d + and .x3d.html files respectively. See 3d + + + + Viewing Format.
+
+
+ ARGYLL_COLMTER_CAL_SPEC_SET
+ ARGYLL_COLMTER_COR_MATRIX

Both of these can be used to set a default CCMX or

- ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS
+ ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS
Normally - a delay of 200 msec is allowed between changing a patch color on a - display, and reading the color with an instrument, although some - instruments (ie. i1d3, i1pro, ColorMunki) will automatically - measure and set an appropriate delay during instrument - calibration. In rare situations this delay may not be sufficient - (ie. some TV's with extensive image processing features turned - on), and a larger delay can be set using the ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS - environment variable, ie. ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS=400 - would set a 400 msec minimum delay.
-
-
- ARGYLL_IGNORE_XRANDR1_2
-
- + +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) + ArgyllCMS will automatically measure and set an appropriate update + delay during instrument calibration. In rare situations this delay + may not be sufficient (ie. some TV's with extensive image + processing features turned on), and a larger delay can be set + using the ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS + + + + + +environment + + + + variable, ie. ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS=400 would set a + 400 msec minimum delay.
+
+ + ARGYLL_DISPLAY_SETTLE_TIME_MULT
+
Normally the display technology type determines how + long is allowed between when a patch color change appears on the + display, and when that change has settled down, and as actually + complete within measurement tolerance. A CRT or Plasma display for + instance, can have quite a long settling delay due to the decay + characteristics of the phosphor used, while an LCD can also have a + noticeable settling delay due to the liquid crystal response time + and any response time enhancement circuitry. [ Instruments without + a display technology type selection such as spectrometers assume a + worst case.].
+ The ARGYLL_DISPLAY_SETTLE_TIME_MULT environment variable allows + the rise and fall times of the model to be scaled to extend or + reduce the settling time. For instance, + ARGYLL_DISPLAY_SETTLE_TIME_MULT=2.0 would double the settling + time, while ARGYLL_DISPLAY_SETTLE_TIME_MULT=0.5 would halve it.
+
+ ARGYLL_CREATE_WRONG_VON_KRIES_OUTPUT_CLASS_REL_WP
+ +
By default ArgyllCMS uses the Bradford sharpened cone + Chromatic adaption matrix in adapting the measured, absolute + colorimetric test data to the PCS (Profile Connection + Space) relative colorimetric D50 white point for all profile + types. This makes the profile handling consistent with the widely + deployed (HP & Microsoft) sRGB and AdobeRGB profiles, as well + 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.
+ See also the ArgyllCMS 'arts' + tag.
+
+ ARGYLL_CREATE_DISPLAY_PROFILE_WITH_CHAD
+ +
The ICC V2 format originally provided no clear mechanism + for Display profiles to use a modern chromatic adaptation + transform in dealing with the D65 white point of typical displays. + Profile makers ended up taking two different approaches :- one was + to use a Bradford chromatic transform for the media (display) + white to PCS D50 (this approach being used by the widely deployed + HP & Microsoft sRGB and AdobeRGB profiles, as well as + ArgyllCMS profiles by default), and the other was to apply the + Bradford transform to the measurement data and then disable + Absolute Intent for display profiles by setting the + mediaWhitePoint tag to D50. The latter approach was supplemented + later on with the introduction of the ChromaticAdapation ('chad') + tag, but this did not restore the Absolute Colorimetric capability + to Display profiles. The latter approach has also been adopted + more formally in the ICC V4 specifications. To improve restore the + Absolute Intent for such profiles, ArgyllCMS will make use of the + 'chad' tag in such profiles when Absolute Colorimetric intent is + requested, but by default does not create such profiles. Setting + this environment variable causes it to create Display profiles in + the fashion dictated by the ICC V4 spec. :- setting the + mediaWhitePoint tag to D50 and storing the display media white to + D50 matrix in the 'chad' tag. (This approach has slightly poorer + accuracy for Absolute Intent than ArgyllCMS's default.)
+
+ ARGYLL_CCAST_DEFAULT_RECEIVER
+ +
By default the ChromeCast test patch source uses a + special receiver application that gets the test patch data + directly. By setting this environment variable to true, the + default Google ChromeCast receiver will be used, making use of a + local web server to provide the images. This is slower than the + special reciever, but can be used as a fallback.
+
+ ARGYLL_IGNORE_XRANDR1_2
+
+
On an X11 system, if this is set (ie. set it to "yes"), then the presence of the XRandR 1.2 extension will be ignored, and @@ -89,37 +222,45 @@ implementations.

- ARGYLL_DISABLE_I1PRO2_DRIVER
+ ARGYLL_DISABLE_I1PRO2_DRIVER

 -
There is now partial support for the - Eye-One Pro Rev E (aka Eye-One Pro 2) instrument, but a Rev E can - be operated in legacy mode if the environment variable +
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 ARGYLL_DISABLE_I1PRO2_DRIVER is set (ie. set it to "yes").

- XDG_CACHE_HOME
+ XDG_CACHE_HOME
Argyll tries to follow the XDG - Base Directory Specification, and uses the , and uses the XDG_CACHE_HOME environment - variable to place per instrument calibration information (Eye-One - Pro and ColorMunki instruments).
+ variable to place per instrument calibration information, and + .ccmx and .ccss files.

- XDG_CONFIG_DIRS
- XDG_DATA_DIRS
+ XDG_CONFIG_DIRS
+ XDG_DATA_DIRS

On Unix type operating systems, configuration and profiles for displays are placed relative to these environment variables.
-
-          
+       

See Performance Tuning for other variables.
-- cgit v1.2.3