From c07d0c2d2f6f7b0eb6e92cc6204bf05037957e82 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Mon, 1 Sep 2014 15:43:52 +0200 Subject: Imported Upstream version 1.6.3 --- doc/dispcal.html | 790 ++++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 754 insertions(+), 36 deletions(-) (limited to 'doc/dispcal.html') diff --git a/doc/dispcal.html b/doc/dispcal.html index 7327c8f..e23a8d0 100644 --- a/doc/dispcal.html +++ b/doc/dispcal.html @@ -36,6 +36,20 @@ + + + + + + + + + + + + + + @@ -75,6 +89,20 @@ for + + + + + + + + + + + + + + @@ -105,6 +133,20 @@ list + + + + + + + + + + + + + + @@ -132,7 +174,40 @@ list - Display via a web server at port (default 8080)

+  -dmadvr +              + + + + + + + + + + + + + + + + + [MSWin] Display via MadVR Video Renderer
 -E + href="#z">-z                   @@ -689,6 +1059,20 @@ output + + + + + + + + + + + + + + @@ -730,16 +1114,6 @@ center, - = right/bottom etc.
-                       -ss: -0.5 -= -half, -1.0 -= -normal, -2.0 @@ -754,24 +1128,99 @@ normal, + = right/bottom etc.
+                       +ss: +0.5 += +half, +1.0 += +normal, +2.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + = double etc.
+                       + + + + + + + + + + + + + + + + + + + + + ss,vs: = optional horizontal, vertical scale.
+  -F +                   + + + + + + + + + + + + - = double etc.
-                       - ss,vs: = optional horizontal, vertical scale.
-  -F -                   @@ -782,6 +1231,11 @@ normal, + Fill whole screen with black background
+  -E +                   @@ -791,8 +1245,11 @@ normal, - Fill whole screen with black background
Video + encode output as (16-235)/255 "TV" levels
  -  -Y A
+  -Y + + + R:rate            + + + Override measured refresh rate with rate Hz
+  -Y A                 Use non-adaptive integration time mode (if available).
+  -Y + p +             +     Don't wait for the instrument to be placed on + the display
 -C "command" The -v flag reports progress information, as well as other statistics about the progress of calibration. A - numerical argument greater than 1 gives greater verbosity.
+ numerical argument greater than 1 gives greater verbosity. 2 will + give per step adjustment and repeat information, while 3 will give + even greater technical detail.

When running on a UNIX based system that used the X11 Windowing System, dispcal will by default use the @@ -1142,6 +1741,20 @@ none, + + + + + + + + + + + + + + @@ -1183,6 +1796,16 @@ none, See the -o flag for an explanation of the implications of having no access to the VideoLUTs.

+ -dmadvr + [MSWin only] causes test patches to be displayed using the MadVR + video renderer. Note that you may have to start the video playback + software and load a video clip in pause for this to work. MadVR + rendering does not need or support VideoLUT access, but be aware + that the state of the Graphics Card VideoLUTs may affect the + results, and therefore may have to be set appropriately using + dispwin. Test patch colors will not be processed by the + MadVR 3dLut by default.
+
-c The instrument is assumed to communicate through a USB or serial communication port, and the port can be selected with the -c @@ -1198,9 +1821,11 @@ none, perform a quick measurement of current display behaviour, reports and then exits. If the -r flag is used the measurement are taken using the currently loaded - calibration (Video LUT) curves. If -R - is use, then the uncalibrated ("raw" or "native") behaviour is - measured. Reported are:
+ calibration (Video LUT) curves, and in the case of MadVR renderer + test patch display the Color Management 3dLut. If -R is use, then the uncalibrated + ("raw" or "native") behaviour is measured (ie. no VideoLut or CM). + Reported are:

    Black Brightness in cd/m^2
    White Brightness in cd/m^2
@@ -1339,10 +1964,9 @@ none, and how this works, see Operation of particular instruments. 3) Any installed CCSS files (if applicable), or CCMX files. These files are typically created - using ccxxmake, - and installed using oeminst. The - default and Base Calibration types will be indicated in the usage.
+ using ccxxmake, and installed using oeminst. The default and Base Calibration + types will be indicated in the usage.

-t Set the target white point @@ -1403,6 +2027,20 @@ Set + + + + + + + + + + + + + + @@ -1431,6 +2069,20 @@ the + + + + + + + + + + + + + + @@ -1510,6 +2162,20 @@ As + + + + + + + + + + + + + + @@ -1606,7 +2272,8 @@ As will then blend over to the native or compromise black point that is blacker, but not of the right hue. The rate of this blend can be controlled with the -A - parameter (see below).
+ parameter (see below). For applications where maximum contrast ratio + is important (such as Video), use -k0.

-A rate:  If @@ -1622,6 +2289,20 @@ If + + + + + + + + + + + + + + @@ -1668,7 +2349,7 @@ If ascertained. The verification uses a fixed number of semi-random test values to test the calibration.

- -E Run + -z Run verify pass on the display as it is currently setup (currently installed LUT curves). This will use the usual input parameters to establish the expected (target) characteristic. dispwin to load a .cal file into the display - before running dispcal -E. + before running dispcal -z. Note that if you set an Ambient light level interactively during the calibration, you need to enter the same number that was measured and set using the -a parameter @@ -1710,6 +2391,16 @@ If with black. This can aid black accuracy when measuring CRT displays or projectors.

+ The -E + flag causes the display test values to be scaled to the Video RGB + encoding range of (16-235)/255. This also modifies the resulting + calibration curve behavior downstream of dispcal. If a calibration + curve created using -E gets installed or converted to an ICC profile + 'vcgt' tag in the process of creating a profile in dispcal or + colprof, the incoming full range values will first have the + calibration curve applied and then be scaled to the Video encoding + range (16-235)/255.
+
-n When running on a UNIX based system that used the X11 Windowing System, dispcal normally selects the override redirect so that the test window will @@ -1782,6 +2473,20 @@ a + + + + + + + + + + + + + + @@ -1832,6 +2537,12 @@ a style="font-weight: bold;">-Iwb.

+ The -Y R:rate + options overrides calibration of the instrument refresh rate. This + may be useful if the instrument supports this function and the + refresh rate cannot be accurately calibrated from the display + itself.
+
The -Y A option uses a non-adaptive integration time emission measurement mode, if the instrument supports it, such as the Eye-One Pro or @@ -1841,6 +2552,13 @@ a This may give increased consistency and faster measurement times, but may also give less accurate low level readings.

+ The -Y p + option skips asking the user to place the instrument on the display. + Normally a grey patch is displayed, and then the user is asked to + confirm that the instrument is in place, so that readings can + commence. This flag disables that check. This may be useful in + automating certain operations.
+
The -C "command" option allows a method of relaying each test value to some other display than that -- cgit v1.2.3