<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>dispwin</title>
<meta http-equiv="content-type"
content="text/html; charset=ISO-8859-1">
<meta name="author" content="Graeme Gill">
</head>
<body>
<h2><b>spectro/dispwin</b></h2>
<h3>Summary</h3>
This utility has several different but related functions. When given as
a file
argument an ICC profile containing vcgt "gamma" curves, or an Argyll
video calibration .cal file, it will load that calibration into the
chosen display. It can also install or uninstall a profile in the
system for the chosen display, or set the display calibration to that
in the currently installed system profile. By default it displays a
test window the same as that
used by dispcal and dispread, to test this functionality. It can also
be used to test the ability to load video card LUT curves to each
display, and to test how the console Bell will sound when used with
some instruments (ie. Eye-One Pro).<br>
<h3>Usage</h3>
<font size="-1"><span style="font-family: monospace;">dispwin [options]
[<span style="font-style: italic;">calfile</span>]</span><br
style="font-family: monospace;">
<span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#v">-v</a><span
style="font-family: monospace;">
Verbose mode<br>
</span></font><font size="-1"><span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#display">-display displayname</a><span
style="font-family: monospace;"> [<span style="font-weight: bold;">X11
only</span>] Choose X11 display name<br>
</span></font><font size="-1"><span style="font-family: monospace;"> <a
href="#dnm">-d n[,m]</a>
[<span
style="font-weight: bold;">X11
only</span>] Choose the display from the following list (default 1),<br>
and optionally choose a different display m for Video LUT access.<br>
</span></font><font size="-1"><span style="font-family: monospace;"> <a
href="#d">-d
n</a>
[Not X11] Choose the display from the following list (default 1)<br
style="font-family: monospace;">
</span></font><font size="-1"><span style="font-family: monospace;"></span><span
style="font-family: monospace;"> <a href="#p">-p ho,vo,ss</a>
Position test window and scale it</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
ho,vi: 0.0 = left/top, 0.5 = center, 1.0 = right/bottom etc.</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
ss: 0.5 = half, 1.0 = normal, 2.0 = double etc.<br>
</span></font><font size="-1"><span
style="font-family: monospace;"><a href="#F">-F</a>
Fill whole screen with black background</span></font><br
style="font-family: monospace;">
<font size="-1"><span style="font-family: monospace;"></span><span
style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#i">-i</a><span
style="font-family: monospace;">
Run forever with random values<br>
<a href="#G">-G</a> <span style="font-style: italic;">filename</span>
Display RGB colors from CGATS file<br>
</span></font><font size="-1"><a style="font-family: monospace;"
href="#m">-m</a><span style="font-family: monospace;">
Manually step through colors</span></font><br>
<font size="-1"><span style="font-family: monospace;"> <a href="#r">-r</a>
Test just video LUT loading<br>
</span></font><font size="-1"><span style="font-family: monospace;"> <a
href="#n">-n</a>
Test native display values (rather than through Video LUT)</span></font><br>
<font size="-1"><span style="font-family: monospace;"> <a
href="dispwin.html#c">-c</a>
Load a linear display calibration (clear calibration)</span></font><font
size="-1"><span style="font-family: monospace;"><br>
</span></font><font size="-1"><span style="font-family: monospace;"> <a
href="#V">-V</a>
Verify that calfile/profile cal. is currently loaded in LUT<br>
</span></font><font size="-1"><span style="font-family: monospace;"> <a
href="#I">-I</a>
</span></font><font size="-1"><span style="font-family: monospace;">Install
profile for display and use it's calibration<br>
</span></font><font size="-1"><span style="font-family: monospace;"> <a
href="#U">-U</a>
</span></font><font size="-1"><span style="font-family: monospace;">Un-install
profile for display<br>
<a href="#S">-S d</a>
Specify the install/uninstall scope for OS X [nlu] or Vista [lu]<br>
d is one of: n = network, l = local system, u = user (default)<br>
</span></font><font size="-1"><span style="font-family: monospace;"></span></font><font
size="-1"><span style="font-family: monospace;"> <a
href="dispwin.html#L">-L</a>
</span></font><font size="-1"><span style="font-family: monospace;">Load
installed profiles cal. into Video LUT<br>
</span></font><font size="-1"><span style="font-family: monospace;"> <a
href="#D">-D</a>
[<span style="font-weight: bold;">X11
only</span>] Run in daemon loader mode for given X11 server <br>
</span></font><font size="-1"><span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#E">-E [level]</a><span
style="font-family: monospace;">
Print debug diagnostics to stderr</span></font><font size="-1"><span
style="font-family: monospace;"></span></font><font size="-1"><span
style="font-family: monospace;"></span><span
style="font-family: monospace;"><br>
</span></font><a style="font-family: monospace;" href="#p1"><font
size="-1"><span style="font-family: monospace;"></span></font></a><font
size="-1"><a style="font-family: monospace;" href="#p1"><i>calfile</i></a><span
style="font-family: monospace;">
Load display calibration (<a href="cal_format.html">.cal</a> or .icm)
into LUT, and exit.</span><span style="font-family: monospace;"></span><span
style="font-family: monospace;"></span></font><br>
<br>
<h3>Comments<br>
</h3>
<a name="v"></a> The <b>-v</b> flag makes the program more verbose..<br>
<br>
<a name="display"></a><span style="font-weight: bold;">display</span>:
When running on a UNIX based system that used the
X11
Windowing
System, <b>dispwin</b> will by default use the $DISPLAY environment
variable to determine which display and screen to read from. This can
be overridden by supplying an X11 display name to the <span
style="font-weight: bold;">-display</span> option. Note that if
Xinerama is active, you can't select the screen using $DISPLAY or
-display, you have to select it using the <span
style="font-weight: bold;">-d</span> parameter.<br>
<br>
<a name="d"></a><span style="font-weight: bold;">-d</span>: By default
the location of
the test window will be the main display. If the system has more than
one display or screen, an alternate display/screen can be selected with
the <span style="font-weight: bold;">-d</span> parameter. If you
invoke <span style="font-weight: bold;">dispwin</span>
so as to display the usage
information (i.e. "dispcal -?" or "dispcal --"), then the discovered
displays/screens will be listed. Multiple displays may not be listed
if they appear as a single display to the operating system (ie. the
multi-display support is hidden in the video card driver). On UNIX
based system that used the X11
Windowing
System, the <span style="font-weight: bold;">-d</span> parameter will
override the screen specified by the $DISPLAY or <span
style="font-weight: bold;">-display</span> parameter.<br>
<br>
<span style="font-weight: bold;">Note</span> that if <span
style="font-weight: bold;"></span> the VideoLUTs for a display are not
accessible, <span style="font-weight: bold;">dispwin</span>
will fail when it attempts to access them. This could be because you
are trying to access
a remote display, and the remote display doesn't support the
XF86VidMode extension, or perhaps you are running multiple monitors
using NVidia TwinView, or MergedFB, and trying to access anything other
than the primary monitor. TwinView and MergedFB don't properly support
the XF86VidMode extension for multiple displays. Xinerama does properly
support calibration of multiple displays. See also below, on how to
select a different display for VideoLUT access. Also note that dispwin
will fail if the Visual depth doesn't match the
VideoLUT depth. Typically the VideoLUTs have 256 entries per color
component, so the Visual generally needs to be 24 bits, 8 bits per
color component.<br>
<br>
<a name="dnm"></a><span style="font-weight: bold;">-d n[,m]</span>Because
of the difficulty cause by TwinView and
MergedFB in X11 based systems, you can optionally specify a separate
display number after the display that is going to be used to present
test patches, for accessing the VideoLUT hardware. This must be
specified as a single string, e.g. <span style="font-weight: bold;">-d
1,2</span> . Some experimentation may be needed on such systems, to
discover what screen has access to the VideoLUT hardware, and which
screens the test patches appear on. You may be able to calibrate one
screen, and then share the calibration with another screen. Profiling
can be done independently to calibration.<br>
<br>
<a name="p"></a> The <span style="font-weight: bold;">-p</span>
parameter allows you to position and size the test patch window. By
default it is places in the center of the screen, and sized
appropriately for the type of instrument. The <span
style="font-weight: bold;">ho</span> and <span
style="font-weight: bold;">vo</span> values govern the horizontal and
vertical offset respectively. A value of 0.0 positions the window to
the far left or top of the screen, a value of 0.5 positions it in the
center of the screen (the default), and 1.0 positions it to the far
right or bottom of the screen. The <span style="font-weight: bold;">ss</span>
parameter is a scale factor for the test window size. A value of 0.5
for instance, would produce a half sized window. A value of 2.0 will
produce a double size window. Note that the ho,vo,ss numbers must be
specified as a single string (no space between the numbers and the
comma).<br>
For example, to create a double sized test window at the top right of
the screen, use <span style="font-weight: bold;">-p 1,0,2</span> .<br>
<br>
<a name="F"></a> The <span style="font-weight: bold;">-F</span>
flag causes the while screen behind the test window to be masked with
black. This can aid black accuracy when measuring CRT displays or
projectors.<br>
<br>
By default <span style="font-weight: bold;">dispwin</span> will put a
test window on the selected display, and display some test colors,
before darkening then brightening the screen by loading video LUT
values, test the bell sounds, then restore the original values and exit.<br>
<br>
If the <a name="i"></a><span style="font-weight: bold;">-i</span>
flag is set, then <span style="font-weight: bold;">dispwin</span> will
display the preset sequence, then random test colors forever.<br>
<br>
If the <a name="G"></a><span style="font-weight: bold;">-G</span>
parameter is set, then <span style="font-weight: bold;">dispwin</span>
will
display the sequence of RGB color in the supplied CGATS file, e.g. a
.ti1 file. Typically this might the used with the <span
style="font-weight: bold;">-m</span> option to manually measure a set
of test patches.<br>
<br>
If the <a name="m"></a><span style="font-weight: bold;">-m</span>
flag is set, then <span style="font-weight: bold;">dispwin</span> will
display the preset sequence then exits, but
advances manually after each return key.<br>
<br>
If the <a name="r"></a><span style="font-weight: bold;">-r</span>
flag is set, then <span style="font-weight: bold;">dispwin</span> will
test just the loading of video LUT values by first darkening, then
lightening the screen, before exiting.<br>
<br>
If the <a name="n"></a><span style="font-weight: bold;">-n</span>
flag is set, then <span style="font-weight: bold;">dispwin</span> will
display the colors directly on the display, rather than having the
color values translated through the currently loaded Video LUTs.<br>
<br>
<a name="c"></a> If a <span style="font-weight: bold;">-c</span> flag
is used, then rather than displaying a test window, <span
style="font-weight: bold;">dispwin</span> will load the selected
display with a linear set of Video LUT curves, effectively clearing
the calibration, and will then exit. Any <span
style="font-style: italic;">calfile</span>
will be ignored.<br>
<br>
<a name="V"></a> If a <span style="font-weight: bold;">-V</span> flag
is used, then rather than loading the calibration specified as the
final argument, the currently loaded calibration will be verified as
being the same as the given calibration file. If this is combined with
the <span style="font-weight: bold;"><span style="font-weight: bold;">-L</span></span>
flag, the currently loaded calibration will be verified as
being the same as the installed system profile for the display.<br>
<br>
<a name="I"></a><span style="font-weight: bold;">-I</span>: The ICC
profile specified as the
final argument will be installed as the default operating system
profile for the chosen display, and the display calibration will be set
to the calibration tag ('vcgt' tag, if any) in that profile.. On
MSWindows and OS X this means that the profile will be copied to the
appropriate color profile directory and registered with the operating
system. For Linux X11 systems, the profile will be installed using the <a
href="ucmm.html">ucmm</a> convention, and the X11 _ICC_PROFILE
property in the root window, and also the the XrandR 1.2 X11
_ICC_PROFILE output property on systems that are running XrandR 1.2 or
later. The latter is following this <a
href="http://www.burtonini.com/computing/x-icc-profiles-spec-0.2.html">convention</a>
for allowing applications to locate the display profile for a
particular X11 display, and expands it to accomodate XrandR 1.2. Note
that for X11 systems, the properties are not persistent, and will need
to be loaded each time the X11 server is started (see the <a href="#L">-L</a>
flag).<br>
<br>
<a name="U"></a><span style="font-weight: bold;">-U</span>: The ICC
profile specified as the
final argument will be un-installed as the default operating system
profile for the chosen display. The display calibration will remain
unchanged.<br>
<br>
<a name="S"></a><span style="font-weight: bold;">-S</span> d: Some
systems have more than one profile scope that an installed profile will
apply to, and this parameter allows overriding the default scope. On OS
X, there is a choice of three scopes: <span style="font-weight: bold;">n</span>:
for network scope, if people are sharing profiles over a network, <span
style="font-weight: bold;">l</span>: local system scope, which
installs the profile for all users of a system, and the default <span
style="font-weight: bold;">u</span>, which covers just the user
installing the profile. On Microsoft Vista, just the local system <span
style="font-weight: bold;">l</span> and user <span
style="font-weight: bold;">u</span> scope are available. Note that you
may need to run dispwin with elevated privileges to be able to
successfully use network or local system scope. This option also
applies to uninstalling a profile.<br>
<br>
<a name="L"></a> <span style="font-weight: bold;">-L</span>: This
option fetches the current installed system profile for the chosen
display, and sets the display to the calibration tag ('vcgt' tag, if
any) in the profile. This is a convenient way
of initializing the display on system startup from the installed
display profile, if the system doesn't not
do this automatically .<br>
<br>
<a name="D"></a> <span style="font-weight: bold;">-D</span>:
Experimental. When
running on a UNIX based system that used the
X11
Windowing
System, this
option runs dispwin in a "daemon" mode where it monitors the given X11
server, waiting for any changes in monitors that may require loading a
matching ICC profile (ie. such as re-configuring, plugging in a
different monitor etc.) This only works if XRandR 1.2 is
available on the server. By default dispwin runs silently, and will not
terminate. If the <span style="font-weight: bold;">-v</span> option is
given, it will emit messages to stdout to show what it is doing. When
it is first invoked, it will load the installed profiles of all the
screens of the given X11 server.<br>
<br>
<a name="E"></a>The <b>-E</b> flag causes diagnostics to be printed to
stdout. A level can
be set between 1 .. 9, that may give progressively more verbose
information. This can be useful in
tracking
down why an operation fails.<br>
<br>
<a name="p1"></a> The final optional parameter on the command line is
the name of an ICC profile that contains a Video LUT <span
style="font-weight: bold;">vcgt</span> tag, or an Argyll <a
href="cal_format.html">.cal</a>
format display calibration. If this parameter is provided, then the
selected display will be loaded with the given calibration. If the <span
style="font-weight: bold;">-V</span> flag was given, then it is
verified that this calibration is the currently loaded one. This
may be useful in initializing a system to the current calibration on
system
startup, although a better way may be to install the profile (<span
style="font-weight: bold;">-I</span> option), and then just use <span
style="font-weight: bold;">-L</span>. Note that the vcgt tag
interpretation within Argyll is
consistent with that of the originators of the tag. Other ICC profile
vcgt implementations may not be so consistent.<br>
<br>
<span style="font-weight: bold;">NOTE</span> that on an X11 system, if
the environment variable <span style="font-weight: bold;">ARGYLL_IGNORE_XRANDR1_2</span>
is set (ie. set it to "yes"), then the presence of the XRandR 1.2
extension will be ignored, and other extensions such as Xinerama and
XF86VidMode extension will be used. This may be a way to work around
buggy XRandR 1.2 implementations.<br>
<br>
<br>
<br>
<br>
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
56e231b080a119bc733fcd74872c9f3d
>
files
>
242
