summaryrefslogtreecommitdiff
path: root/doc/dispwin.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/dispwin.html')
-rwxr-xr-x[-rw-r--r--]doc/dispwin.html197
1 files changed, 171 insertions, 26 deletions
diff --git a/doc/dispwin.html b/doc/dispwin.html
index 05db989..f3ae843 100644..100755
--- a/doc/dispwin.html
+++ b/doc/dispwin.html
@@ -51,6 +51,11 @@ Verbose
+
+
+
+
+
mode<br>
</span></font><font size="-1"><span style="font-family:
@@ -81,6 +86,11 @@ optionally
+
+
+
+
+
choose a different display m for Video LUT access.<br>
</span></font><font size="-1"><span style="font-family:
@@ -102,6 +112,11 @@ X11]
+
+
+
+
+
Choose the display from the following list (default 1)<br>
</span></font><span style="font-family: monospace;">&nbsp;<a
@@ -119,6 +134,11 @@ X11]
+
+
+
+
+
Display via a web server at port (default 8080)</span><br>
<span style="font-family: monospace;">&nbsp;<a
@@ -128,6 +148,11 @@ X11]
<tt>&nbsp;</tt><tt><a href="#dcc">-dcc[:n]</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
</tt><tt></tt><tt>Display via n'th ChromeCast (default 1, ? for
list)</tt><br style="font-family: monospace;">
@@ -153,6 +178,11 @@ ho,vi:
+
+
+
+
+
= left/top, 0.5 = center, 1.0 = right/bottom etc.</span><br
style="font-family: monospace;">
@@ -174,6 +204,11 @@ ss:
+
+
+
+
+
= half, 1.0 = normal, 2.0 = double etc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -188,6 +223,11 @@ ss:
+
+
+
+
+
ss,vs: = optional horizontal, vertical scale.<br>
&nbsp;</span></font><font size="-1"><span style="font-family:
@@ -210,6 +250,11 @@ whole
+
+
+
+
+
screen with black background</span></font><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;</span></font><font
@@ -221,6 +266,11 @@ whole
+
+
+
+
+
</span></font><small><span style="font-family: monospace;">Video
encode output as (16-235)/255 "TV" levels</span></small><br
@@ -258,6 +308,11 @@ just
+
+
+
+
+
video LUT loading &amp; Beeps<br>
</span></font><font size="-1"><span style="font-family:
@@ -280,6 +335,11 @@ native
+
+
+
+
+
display values (rather than through Video LUT&nbsp; and C.M.)<br>
&nbsp;<a href="#s">-s <span style="font-style: italic;">filename.cal</span></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -300,6 +360,11 @@ the
+
+
+
+
+
currently loaded Video LUT to 'filename'<br>
</span></font><font size="-1"><span style="font-family:
@@ -322,6 +387,11 @@ a
+
+
+
+
+
linear display calibration (clear calibration)</span></font><font
size="-1"><span style="font-family: monospace;"><br>
@@ -345,6 +415,11 @@ that
+
+
+
+
+
calfile/profile cal. is currently loaded in LUT<br>
</span></font><font size="-1"><span style="font-family:
@@ -365,9 +440,14 @@ that
+
+
+
+
+
</span></font><font size="-1"><span style="font-family:
- monospace;">Install profile for display and use it's calibration<br>
+ monospace;">Install profile for display and use its calibration<br>
</span></font><font size="-1"><span style="font-family:
monospace;">&nbsp;<a href="#U">-U</a>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -386,6 +466,11 @@ that
+
+
+
+
+
</span></font><font size="-1"><span style="font-family:
monospace;">Un-install profile for display<br>
@@ -407,6 +492,11 @@ the
+
+
+
+
+
install/uninstall scope for OS X [nlu] or Vista [lu]<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -427,6 +517,11 @@ is
+
+
+
+
+
one of: n = network, l = local system, u = user (default)<br>
</span></font><font size="-1"><span style="font-family:
@@ -448,6 +543,11 @@ is
+
+
+
+
+
</span></font><font size="-1"><span style="font-family:
monospace;">Load installed profiles cal. into Video LUT<br>
@@ -469,6 +569,11 @@ is
+
+
+
+
+
[<span style="font-weight: bold;">X11 only</span>] Run in daemon
loader mode for given X11 server <br>
@@ -492,6 +597,11 @@ debug
+
+
+
+
+
diagnostics to stderr</span></font><font size="-1"><span
style="font-family: monospace;"></span></font><font size="-1"><span
@@ -518,6 +628,11 @@ display
+
+
+
+
+
calibration (<a href="cal_format.html">.cal</a> or .icm) into
LUT, and exit.</span><span style="font-family: monospace;"></span><span
@@ -572,6 +687,22 @@ display
256 entries per color component, so the Visual generally needs to be
24 bits, 8 bits per color component.<br>
<br>
+ More modern X11 systems support the XRANDR extension, which handles
+ multiple displays much more gracefully, but note that there are
+ limitations in profiling and calibrating Mirrored or Cloned
+ Displays. Mirrored displays share the same frame buffer space
+ (Separate CRTC's with overlapping pixel locations) but can have
+ different calibration curves, while Cloned displays share both frame
+ buffer space and calibration curves (A single CRTC feeding multiple
+ Outputs). <b>dispwin</b> will show different display selections for
+ each output, but calibration or application of color management may
+ only be correct for the last set display (i.e. if frame buffer space
+ overlaps, or there is only a single CRTC to hold calibration curves,
+ and a single _ICC_PROFILE_xxx root atom holding the profile, if the
+ application is using the Xinerama convention for obtaining a
+ profile, rather than the Xrandr per Output property _ICC_PROFILE
+ convention.) <br>
+ <br>
<a name="dnm"></a><span style="font-weight: bold;">-d n[,m]</span>Because
of
the
@@ -590,6 +721,11 @@ the
+
+
+
+
+
difficulty cause by TwinView and MergedFB in X11 based systems, you
can optionally specify a separate display number after the display
@@ -645,6 +781,11 @@ the
but should be accurate within ± 1 bit. You may have to modify any
firewall to permit port 8081 to be accessed on your machine if it
falls back to the Default receiver (see <a href="Installing.html">installation
+
+
+
+
+
instructions</a> for your platform).<br>
<br>
@@ -745,22 +886,32 @@ the
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
+ 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
+ and registered with the operating system. <br>
+ <br>
+ For Linux X11 systems, the profile will be installed using&nbsp;<span style="white-space: pre;"> using </span>the
+
+
+
+
+ <a href="ucmm.html">ucmm</a> convention by default, and this
+ associates the display hardware identification (EDID) of the
+ selected display, with the profile. The X11 _ICC_PROFILE property
+ will be set 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 use of atoms 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). To make sure that the profile calbration
- 'vcgt' tag gets loaded into the Graphics Card at system start,
- please read the guide <a href="dispprofloc.html">here</a>.<br>
+ <a href="#L">-L</a> flag).<br>
+ <br>
+ If the <b>ARGYLL_USE_COLORD</b> environment variable is set (ie.
+ set it to "yes"), then on Gnome systems running <b>colord</b><span style="white-space: pre;">, dispwin will attempt to store and retrieve display ICC profiles using<br>colord.<br><br></span>
+ To make sure that the profile calbration 'vcgt' tag gets loaded into
+ the Graphics Card at system start, please read the guide <a href="dispprofloc.html">here</a>.<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
@@ -770,15 +921,12 @@ the
<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 user
- scope. On OS X, there is a choice of three scopes: <span
- style="font-weight: bold;">n</span>: for network scope, if people
+ 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
+ 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 Linux or 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
+ 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(sudo) to be
able to successfully use network or local system scope. This option
also applies to uninstalling a profile. Note that to install a user
@@ -799,8 +947,7 @@ the
in monitors that may require loading a matching ICC profile (ie.
such as re-configuring, plugging in a different monitor etc.)&nbsp;
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
+ 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>
@@ -811,17 +958,14 @@ the
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
+ 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.&nbsp; 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
+ 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>
@@ -842,5 +986,6 @@ the
<br>
<br>
<br>
- </body>
-</html>
+
+
+</body></html> \ No newline at end of file