~ubuntu-branches/ubuntu/trusty/argyll/trusty-proposed

« back to all changes in this revision

Viewing changes to doc/Environment.html

  • Committer: Package Import Robot
  • Author(s): Artur Rona
  • Date: 2014-02-12 00:35:39 UTC
  • mfrom: (13.1.24 sid)
  • Revision ID: package-import@ubuntu.com-20140212003539-24tautzlitsiz61w
Tags: 1.5.1-5ubuntu1
* Merge from Debian unstable. (LP: #1275572) Remaining changes:
  - debian/control:
    + Build-depend on libtiff-dev rather than libtiff4-dev.
  - debian/control, debian/patches/06_fix_udev_rule.patch:
    + Fix udev rules to actually work; ENV{ACL_MANAGE} has
      stopped working ages ago, and with logind it's now the
      "uaccess" tag. Dropping also consolekit from Recommends.
  - debian/patches/drop-usb-db.patch:
    + Use hwdb builtin, instead of the obsolete usb-db
      in the udev rules.
* debian/patches/05_ftbfs-underlinkage.diff:
  - Dropped change, no needed anymore.
* Refresh the patches.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en">
 
1
<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
2
2
<html>
3
 
<head>
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">
8
 
  <meta name="GENERATOR"
9
 
 content="Mozilla/4.73 [en] (WinNT; I) [Netscape]">
10
 
  <title>Argyll Environment Variables</title>
11
 
</head>
12
 
<body>
13
 
<h2>
14
 
<u>Environment variables<br>
15
 
</u></h2>
16
 
The following environment variables affect behaviour:<br>
17
 
<br>
18
 
<span style="font-weight: bold;">ARGYLL_NOT_INTERACTIVE</span><br>
19
 
<br>
20
 
<div style="margin-left: 40px;">Normally Argylls tools expect that they
21
 
are directly
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>
28
 
<br>
29
 
If the <span style="font-weight: bold;">ARGYLL_NOT_INTERACTIVE</span>
30
 
environment variable is set, then:<br>
31
 
<br>
32
 
&nbsp;&nbsp;&nbsp; A Line Feed will be added to the end of each
33
 
progress line.<br>
34
 
<br>
35
 
&nbsp;&nbsp;&nbsp; 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
 
&nbsp;&nbsp;&nbsp; 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>
40
 
<br>
41
 
&nbsp;&nbsp;&nbsp; Note that while a reading is being made, a character
42
 
input can abort the reading, just as with normal interactive mode.<br>
43
 
<br>
44
 
</div>
45
 
<span style="font-weight: bold;">XDG_CACHE_HOME<br>
46
 
<span style="font-weight: bold;"><br>
47
 
</span></span>
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
50
 
Base
51
 
Directory
52
 
Specification</a>, and uses the <span style="font-weight: bold;">XDG_CACHE_HOME</span>
53
 
environment variable
54
 
to place per instrument calibration information (Eye-One Pro and
55
 
ColorMunki instruments).<br>
56
 
</div>
57
 
<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>
64
 
<br>
65
 
</div>
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>
68
 
<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>
76
 
<br>
77
 
</div>
78
 
<br>
79
 
<span style="font-weight: bold;">ARGYLL_IGNORE_XRANDR1_2<br>
80
 
<br>
81
 
</span>
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>
88
 
</div>
89
 
<br>
90
 
<br>
91
 
See <a href="Performance.html">Performance Tuning</a> for other
92
 
variables.<br>
93
 
<br>
94
 
<br>
95
 
</body>
 
3
  <head>
 
4
    <meta http-equiv="Content-Type" content="text/html;
 
5
      charset=ISO-8859-1">
 
6
    <meta http-equiv="content-type" content="text/html;
 
7
      charset=ISO-8859-1">
 
8
    <meta name="GENERATOR" content="Mozilla/4.73 [en] (WinNT; I)
 
9
      [Netscape]">
 
10
    <title>Argyll Environment Variables</title>
 
11
  </head>
 
12
  <body>
 
13
    <br>
 
14
    <h2> <u>Environment variables<br>
 
15
      </u></h2>
 
16
    The following environment variables affect behaviour:<br>
 
17
    <br>
 
18
    <span style="font-weight: bold;">ARGYLL_NOT_INTERACTIVE</span><br>
 
19
    <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>
 
27
      <br>
 
28
      If the <span style="font-weight: bold;">ARGYLL_NOT_INTERACTIVE</span>
 
29
      environment variable is set, then:<br>
 
30
      <br>
 
31
      &nbsp;&nbsp;&nbsp; A Line Feed will be added to the end of each
 
32
      progress line.<br>
 
33
      <br>
 
34
      &nbsp;&nbsp;&nbsp; Any time it would wait for a single keystroke
 
35
      input, it will instead wait for and read the next character from
 
36
      stdin.<br>
 
37
      &nbsp;&nbsp;&nbsp; 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>
 
40
      <br>
 
41
      &nbsp;&nbsp;&nbsp; Note that while a reading is being made, a
 
42
      character input can abort the reading, just as with normal
 
43
      interactive mode.<br>
 
44
    </div>
 
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>
 
48
    <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>
 
56
      <br>
 
57
    </div>
 
58
    <br>
 
59
    <span style="font-weight: bold;">ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS<br>
 
60
      <br>
 
61
    </span>
 
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
 
64
 
 
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
 
73
 
 
74
      environment variable, ie. ARGYLL_MIN_DISPLAY_UPDATE_DELAY_MS=400
 
75
      would set a 400 msec minimum delay.<br>
 
76
    </div>
 
77
    <span style="font-weight: bold;"><br>
 
78
      ARGYLL_IGNORE_XRANDR1_2<br>
 
79
      <br>
 
80
    </span>
 
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
 
86
      implementations.<br>
 
87
      <br>
 
88
    </div>
 
89
    <span style="font-weight: bold;">ARGYLL_DISABLE_I1PRO2_DRIVER<br>
 
90
      <br>
 
91
    </span>
 
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>
 
96
    </div>
 
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>
 
100
      </span></span>
 
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
 
103
 
 
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>
 
108
    </div>
 
109
    <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>
 
116
    </div>
 
117
    <br>
 
118
    &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp; <br>
 
119
    <br>
 
120
    See <a href="Performance.html">Performance Tuning</a> for other
 
121
    variables.<br>
 
122
    <br>
 
123
    <br>
 
124
  </body>
96
125
</html>