From f6b8e0eae4374f339487a33e3e4fe5462d5816e1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Sat, 25 Nov 2017 10:16:00 +0100 Subject: New upstream version 2.0.0 --- doc/dispwin.html | 197 +++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 171 insertions(+), 26 deletions(-) mode change 100644 => 100755 doc/dispwin.html (limited to 'doc/dispwin.html') diff --git a/doc/dispwin.html b/doc/dispwin.html old mode 100644 new mode 100755 index 05db989..f3ae843 --- a/doc/dispwin.html +++ b/doc/dispwin.html @@ -51,6 +51,11 @@ Verbose + + + + + mode
 
  -dcc[:n]             + + + + + Display via n'th ChromeCast (default 1, ? for list)
@@ -153,6 +178,11 @@ ho,vi: + + + + + = left/top, 0.5 = center, 1.0 = right/bottom etc.
@@ -174,6 +204,11 @@ ss: + + + + + = half, 1.0 = normal, 2.0 = double etc.
                      @@ -188,6 +223,11 @@ ss: + + + + + ss,vs: = optional horizontal, vertical scale.
  Video encode output as (16-235)/255 "TV" levels
-s filename.cal      @@ -300,6 +360,11 @@ the + + + + + currently loaded Video LUT to 'filename'

@@ -345,6 +415,11 @@ that + + + + + calfile/profile cal. is currently loaded in LUT
Install profile for display and use it's calibration
+ monospace;">Install profile for display and use its calibration
 -U                   @@ -386,6 +466,11 @@ that + + + + + Un-install profile for display
@@ -407,6 +492,11 @@ the + + + + + install/uninstall scope for OS X [nlu] or Vista [lu]
                      @@ -427,6 +517,11 @@ is + + + + + one of: n = network, l = local system, u = user (default)
Load installed profiles cal. into Video LUT
@@ -469,6 +569,11 @@ is + + + + + [X11 only] Run in daemon loader mode for given X11 server
@@ -492,6 +597,11 @@ debug + + + + + diagnostics to stderr.cal or .icm) into LUT, and exit.
+ 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). dispwin 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.)
+
-d n[,m]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 installation + + + + + instructions for your platform).

@@ -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 ucmm - 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 +
+ For Linux X11 systems, the profile will be installed using  using the + + + + + ucmm 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 convention 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 - -L flag). To make sure that the profile calbration - 'vcgt' tag gets loaded into the Graphics Card at system start, - please read the guide here.
+ -L flag).
+
+ If the ARGYLL_USE_COLORD environment variable is set (ie. + set it to "yes"), then on Gnome systems running colord, dispwin will attempt to store and retrieve display ICC profiles using
colord.

 + To make sure that the profile calbration 'vcgt' tag gets loaded into + the Graphics Card at system start, please read the guide here.

-U: The ICC profile specified as the final argument will be un-installed as the @@ -770,15 +921,12 @@ the -S 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: n: for network scope, if people + scope. On OS X, there is a choice of three scopes: n: for network scope, if people are sharing profiles over a network, l: local system scope, which installs the profile - for all users of a system, and the default u, which covers just the user + for all users of a system, and the default u, which covers just the user installing the profile. On Linux or Microsoft Vista, just the local - system l and user u scope are available. Note that + system l and user u 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.)  This only works if XRandR 1.2 is available on the server. By default - dispwin runs silently, and will not terminate. If the -v option is given, it will emit + dispwin runs silently, and will not terminate. If the -v 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.
@@ -811,17 +958,14 @@ the tracking down why an operation fails.

The final optional parameter on the command line - is the name of an ICC profile that contains a Video LUT vcgt tag, or an Argyll .cal format display calibration. If + is the name of an ICC profile that contains a Video LUT vcgt tag, or an Argyll .cal format display calibration. If this parameter is provided, then the selected display will be loaded with the given calibration. If the -V 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 (-I option), and then just use -L. Note that the vcgt tag + bold;">-I option), and then just use -L. 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.
@@ -842,5 +986,6 @@ the


- - + + + \ No newline at end of file -- cgit v1.2.3