1
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en">
1
<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
4
<meta http-equiv="Content-Type"
5
content="text/html; charset=ISO-8859-1">
6
<meta http-equiv="content-type"
7
content="text/html; charset=ISO-8859-1">
9
content="Mozilla/4.73 [en] (WinNT; I) [Netscape]">
10
<title>Argyll Environment Variables</title>
14
<u>Environment variables<br>
16
The following environment variables affect behaviour:<br>
18
<span style="font-weight: bold;">ARGYLL_NOT_INTERACTIVE</span><br>
20
<div style="margin-left: 40px;">Normally Argylls tools expect that they
22
interacting with a user, and use a couple of techniques for
23
communicating with them through the command line. One is to output
24
progress information by re-writing the same display line by using a
25
Carriage Return rather than a Line Feed at the end of each line.
26
Another is to allow a single key stroke to trigger an action or
27
interrupt operations.<br>
29
If the <span style="font-weight: bold;">ARGYLL_NOT_INTERACTIVE</span>
30
environment variable is set, then:<br>
32
A Line Feed will be added to the end of each
35
Any time it would wait for a single keystroke input,
36
it will instead wait for and read the next character from stdin.<br>
37
To facilitate flushing stdin, any return or line
38
feed characters will be ignored, so a character other than return or
39
line feed must be used to trigger activity.<br>
41
Note that while a reading is being made, a character
42
input can abort the reading, just as with normal interactive mode.<br>
45
<span style="font-weight: bold;">XDG_CACHE_HOME<br>
46
<span style="font-weight: bold;"><br>
48
<div style="margin-left: 40px;">Argyll tries to follow the <a
49
href="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG
52
Specification</a>, and uses the <span style="font-weight: bold;">XDG_CACHE_HOME</span>
54
to place per instrument calibration information (Eye-One Pro and
55
ColorMunki instruments).<br>
58
<span style="font-weight: bold;">XDG_CONFIG_DIRS<br>
59
XDG_DATA_DIRS<span style="font-weight: bold;"><br>
60
<span style="font-weight: bold;"></span></span></span><br>
61
<div style="margin-left: 40px;">On Unix type operating systems,
62
configuration and profiles for displays are placed relative to these
63
environment variables.<br>
66
<span style="font-weight: bold;">ARGYLL_COLMTER_CAL_SPEC_SET</span><br>
67
<span style="font-weight: bold;">ARGYLL_COLMTER_COR_MATRIX</span><br>
69
<div style="margin-left: 40px;">Both of these can be used to set a
70
default <span style="font-weight: bold;">CCMX</span> or <span
71
style="font-weight: bold;">CCSS</span> colorimeter calibration file,
72
equivalent to supplying a <span style="font-weight: bold;">-X</span>
73
argument to spotread, dispcal, dispread and any other utility that
74
allows using a colorimteter. The ARGYLL_COLMTER_CAL_SPEC_SET will take
75
priority if both are set.<br>
79
<span style="font-weight: bold;">ARGYLL_IGNORE_XRANDR1_2<br>
82
<div style="margin-left: 40px;">On an X11 system, if
83
this is <span style="font-weight: bold;"></span>set (ie. set it to
84
"yes"), then the presence of the XRandR 1.2
85
extension will be ignored, and other extensions such as Xinerama and
86
XF86VidMode extension will be used. This may be a way to work around
87
buggy XRandR 1.2 implementations.<br>
91
See <a href="Performance.html">Performance Tuning</a> for other
4
<meta http-equiv="Content-Type" content="text/html;
6
<meta http-equiv="content-type" content="text/html;
8
<meta name="GENERATOR" content="Mozilla/4.73 [en] (WinNT; I)
10
<title>Argyll Environment Variables</title>
14
<h2> <u>Environment variables<br>
16
The following environment variables affect behaviour:<br>
18
<span style="font-weight: bold;">ARGYLL_NOT_INTERACTIVE</span><br>
20
<div style="margin-left: 40px;">Normally Argylls tools expect that
21
they are directly interacting with a user, and use a couple of
22
techniques for communicating with them through the command line.
23
One is to output progress information by re-writing the same
24
display line by using a Carriage Return rather than a Line Feed at
25
the end of each line. Another is to allow a single key stroke to
26
trigger an action or interrupt operations.<br>
28
If the <span style="font-weight: bold;">ARGYLL_NOT_INTERACTIVE</span>
29
environment variable is set, then:<br>
31
A Line Feed will be added to the end of each
34
Any time it would wait for a single keystroke
35
input, it will instead wait for and read the next character from
37
To facilitate flushing stdin, any return or
38
line feed characters will be ignored, so a character other than
39
return or line feed must be used to trigger activity.<br>
41
Note that while a reading is being made, a
42
character input can abort the reading, just as with normal
45
<span style="font-weight: bold;"></span><br>
46
<span style="font-weight: bold;">ARGYLL_COLMTER_CAL_SPEC_SET</span><br>
47
<span style="font-weight: bold;">ARGYLL_COLMTER_COR_MATRIX</span><br>
49
<div style="margin-left: 40px;">Both of these can be used to set a
50
default <span style="font-weight: bold;">CCMX</span> or <span
51
style="font-weight: bold;">CCSS</span> colorimeter calibration
52
file, equivalent to supplying a <span style="font-weight: bold;">-X</span>
53
argument to spotread, dispcal, dispread and any other utility that
54
allows using a colorimteter. The ARGYLL_COLMTER_CAL_SPEC_SET will
55
take priority if both are set.<br>
59
<span style="font-weight: bold;">ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS<br>
62
<div style="margin-left: 40px;"><span style="font-weight: bold;"><span
63
style="font-weight: bold;"><span style="font-weight: bold;"></span></span></span>Normally
65
a delay of 200 msec is allowed between changing a patch color on a
66
display, and reading the color with an instrument, although some
67
instruments (ie. i1d3) will automatically measure and set an
68
appropriate delay during instrument calibration. In rare
69
situations this delay may not be sufficient (ie. some TV's with
70
extensive image processing features turned on), and a larger delay
71
can be set using the <span style="font-weight: bold;"><span
72
style="font-weight: bold;"><span style="font-weight: bold;"></span></span></span>ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS
74
environment variable, ie. ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS=400
75
would set a 400 msec minimum delay.<br>
77
<span style="font-weight: bold;"><br>
78
ARGYLL_IGNORE_XRANDR1_2<br>
81
<div style="margin-left: 40px;">On an X11 system, if this is <span
82
style="font-weight: bold;"></span>set (ie. set it to "yes"),
83
then the presence of the XRandR 1.2 extension will be ignored, and
84
other extensions such as Xinerama and XF86VidMode extension will
85
be used. This may be a way to work around buggy XRandR 1.2
89
<span style="font-weight: bold;">ARGYLL_DISABLE_I1PRO2_DRIVER<br>
92
<div style="margin-left: 40px;">There is now partial support for the
93
Eye-One Pro Rev E (aka Eye-One Pro 2) instrument, but a Rev E can
94
be operated in legacy mode if the environment variable
95
ARGYLL_DISABLE_I1PRO2_DRIVER is set (ie. set it to "yes").<br>
97
<span style="font-weight: bold;"></span><br>
98
<span style="font-weight: bold;">XDG_CACHE_HOME<br>
99
<span style="font-weight: bold;"><br>
101
<div style="margin-left: 40px;">Argyll tries to follow the <a
102
href="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG
104
Base Directory Specification</a>, and uses the <span
105
style="font-weight: bold;">XDG_CACHE_HOME</span> environment
106
variable to place per instrument calibration information (Eye-One
107
Pro and ColorMunki instruments).<br>
110
<span style="font-weight: bold;">XDG_CONFIG_DIRS<br>
111
XDG_DATA_DIRS<span style="font-weight: bold;"><br>
112
<span style="font-weight: bold;"></span></span></span><br>
113
<div style="margin-left: 40px;">On Unix type operating systems,
114
configuration and profiles for displays are placed relative to
115
these environment variables.<br>
118
<br>
120
See <a href="Performance.html">Performance Tuning</a> for other