~noskcaj/ubuntu/trusty/argyll/merge

« back to all changes in this revision

Viewing changes to doc/dispcal.html

  • Committer: Bazaar Package Importer
  • Author(s): Roland Mas
  • Date: 2010-01-05 14:49:38 UTC
  • mfrom: (1.1.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20100105144938-8b123qj3xabjehzs
Tags: 1.1.0~rc3-1
* New upstream pre-release.
* Moved udev rules file to /lib/udev/rules.d.

Show diffs side-by-side

added added

removed removed

Lines of Context:
131
131
the target response curve actual technical gamma<br>
132
132
&nbsp;<a href="#f">-f [degree]</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
133
133
Amount of black level accounted for with output offset (default all
134
 
input offset)<br>
 
134
output offset)<br>
135
135
&nbsp;<a href="#a">-a ambient</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
136
136
Use viewing condition adjustment for ambient in Lux<br>
137
137
</span></font><font size="-1"><span style="font-family: monospace;">&nbsp;<a
192
192
&nbsp;&nbsp;&nbsp;&nbsp; Use high resolution spectrum mode (if
193
193
available)<br>
194
194
</span></font><font size="-1"><span style="font-family: monospace;">&nbsp;</span><a
 
195
 style="font-family: monospace;" href="#V">-V</a><span
 
196
 style="font-family: monospace;">
 
197
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
198
&nbsp;&nbsp;&nbsp;&nbsp; Use adaptive measurement mode (if available)</span></font><br>
 
199
<font size="-1"><span style="font-family: monospace;">&nbsp;</span><a
195
200
 style="font-family: monospace;" href="#M">-M "command"</a><span
196
201
 style="font-family: monospace;">
197
202
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Invoke shell "command" each
474
479
Set the
475
480
target response curve gamma. This is
476
481
normally an exponential curve (output = input ^gamma), and defaults to
477
 
2.4 on MSWindows&nbsp; and Linux/Unix (which is typical for a CRT type
478
 
display), and 1.8 on a Macintosh (OS X). Four pre-defined curves can be
479
 
used as well:&nbsp; the sRGB colorspace response curve, which is an
 
482
2.4 on MSWindows and Macintosh OS X 10.6 or latter and Linux/Unix
 
483
(which is typical of a CRT type
 
484
displays real response), and 1.8 on a Macintosh (prior to OS X 10.6).
 
485
Four pre-defined curves can be
 
486
used as well: the sRGB colorspace response curve, which is an
480
487
exponent curve with a
481
488
straight segment at the dark end and an overall response of
482
489
approximately gamma 2.2 (<span style="font-weight: bold;">-gs</span>),
486
493
and the SMPTE 240M video standard response curve (<span
487
494
 style="font-weight: bold;">-g240</span>) <br>
488
495
<br>
489
 
&nbsp;Note that a
 
496
<span style="font-weight: bold;">Note</span> that a
490
497
real display can't reproduce any of these ideal curves, since it will
491
498
have a non-zero black point, whereas all the ideal curves assume zero
492
499
light at zero input. In the case of a gamma curve target, dispcal uses
494
501
output at 50% input
495
502
as the ideal gamma power curve. To allow for the non-zero black level
496
503
of a real display, by default <span style="font-weight: bold;">dispcal</span>
497
 
will offset and scale the target curve so that zero input gives the
498
 
actual black level of the display (input offset). This ensures the most
 
504
will offset the target curve values so that zero input gives the
 
505
actual black level of the display (output offset). This ensures that
 
506
the target curve better corresponds to the typical natural behavior of
 
507
displays, but it may not be the most
499
508
visually even progression from display minimum, but this behavior can
500
509
be changed using the <span style="font-weight: bold;">-f</span> option
501
510
(see below).<br>
502
511
<br>
503
 
<span style="font-weight: bold;">Note</span> that many color spaces are
504
 
encoded with, and labelled as having a gamma of approximately 2.2 (ie.
505
 
sRGB, REC 709, SMPTE 240M), but are actually intended to be displayed
 
512
<span style="font-weight: bold;">Also note</span> that many color
 
513
spaces are
 
514
encoded with, and labelled as having a gamma of approximately<span
 
515
 style="font-weight: bold;"> 2.2</span> (ie.
 
516
sRGB, REC 709, SMPTE 240M, Macintosh OS X 10.6), but are actually
 
517
intended to be displayed
506
518
on a display with a typical CRT gamma of <span
507
 
 style="font-weight: bold;">2.4</span>. This is because this 2.2 gamma
 
519
 style="font-weight: bold;">2.4</span> viewed in a darkened
 
520
environment. This is because this <span style="font-weight: bold;">2.2</span>
 
521
gamma
508
522
is a source gamma encoding in bright viewing conditions such as a
509
523
television studio, while typical display viewing conditions are quite
510
524
dark by comparison, and a contrast expansion of (approx.) gamma 1.1 is
516
530
you want!</span>
517
531
What you probably want to do, is to set the gamma curve to about gamma
518
532
2.4, so that the contrast range is expanded appropriately, or
519
 
alternatively use sRGB or REC 709 but also use the <span
520
 
 style="font-weight: bold;">-a</span> parameter to specify the ambient
 
533
<span style="text-decoration: underline; font-weight: bold;">alternatively</span>
 
534
use sRGB or REC 709 or a gamm of 2.2 but <span
 
535
 style="font-weight: bold;">also</span> use the <span
 
536
 style="font-weight: bold;">-a</span> parameter to specify the actual
 
537
ambient
521
538
viewing conditions, so that <span style="font-weight: bold;">dispcal</span>
522
539
can make an appropriate contrast enhancement. If your instrument is
523
540
capable of measuring ambient light levels, then you can do so during
525
542
&lt;http://www.color.org/sRGB.xalter&gt; for details of how sRGB is
526
543
intended to be used.<br>
527
544
<br>
528
 
It is hard to know whether Apple Macintosh computers should
 
545
It is hard to know whether Apple Macintosh computers prior to OS X 10.6
 
546
should
529
547
also have such an adjustment, since it is not really possible to know
530
548
whether colors labelled as being in such a colorspace are actually
531
549
encoded in that gamma with the expectation that they will be displayed
554
572
 style="font-weight: bold;">-G</span> options, real displays do not
555
573
have a zero black response, while all the target response curves do, so
556
574
this has to be allowed for in some way. The default way of handling
557
 
this (equivalent to -f 0)&nbsp; is to offset and scale the input values
 
575
this (equivalent to -f 1.0)&nbsp; is to allow for this at the output of
 
576
the ideal
 
577
response curve, by offsetting and scaling the output values.<span
 
578
 style="font-weight: bold;"></span> This defined a curve that will
 
579
match the
 
580
responses that many other systems provide and may be a better match to
 
581
the natural response of the display, but will give a
 
582
less visually even response from black<span style="font-weight: bold;"></span>.
 
583
The other alternative is to offset and scale the input values
558
584
into the ideal response
559
585
curve so that zero input gives the actual non-zero display response.
560
 
This ensures the most visually even progression from display minimum.
561
 
The other alternative is to allow for this at the output of the ideal
562
 
response curve, by offsetting and scaling the output values.<span
563
 
 style="font-weight: bold;"></span> This can be done by using the <span
564
 
 style="font-weight: bold;">-f</span> option. This will probably give a
565
 
less progressive response from black, but may better match the
566
 
responses that other systems provide. A further subtlety is to provide
 
586
This ensures the most visually even progression from display minimum,
 
587
but might be hard to achieve since it is different to the naturally
 
588
response of a display.
 
589
A subtlety is to provide
567
590
a split between how much of the offset is accounted for as input to the
568
591
ideal response curve, and how much is accounted for at the output, and
569
592
this can be done by providing a parameter <span
570
593
 style="font-weight: bold;">-f degree</span>, where the degree is 0.0
571
594
accounts for it all as input offset, and 1.0 accounts for all of it as
572
 
output offset.<br>
 
595
output offset. If <span style="font-weight: bold;">-f</span> is used
 
596
without a specified degree, a degree of 0.0 is assumed, the opposite of
 
597
the default.<br>
573
598
<br>
574
599
<a name="a"></a><span style="font-weight: bold;">-a ambient</span>: As
575
600
explained for the <span style="font-weight: bold;">-g</span>
597
622
Normally
598
623
dispcal will attempt to make all colors
599
624
down the neutral axis (R=G=B) have the same hue as the chosen white
600
 
point (equivalent to <span style="font-weight: bold;">-k 1.0</span>).
 
625
point (ie. default is <span style="font-weight: bold;">-k 1.0</span>).
601
626
Near the black point, red, green or blue can only be added, not
602
627
subtracted from zero, so the process of making the near black colors
603
628
have the desired hue, will <span style="font-weight: bold;">lighten</span>
604
629
them to some extent. For a device
605
630
with a good contrast ratio or a black point that has nearly the same
606
631
hue as the white, this is not a problem. If the device contrast ratio
607
 
is not so good, and the black hue is noticeably different to that of
 
632
is not so good, and the native black hue is noticeably different to
 
633
that of
608
634
the chosen white point (which is often the case for <span
609
635
 style="font-weight: bold;">LCD</span> type displays, or <span
610
636
 style="font-weight: bold;">CRT</span> type displays with one channel
620
646
used for <span style="font-weight: bold;">LCD</span>
621
647
type displays, but the <span style="font-weight: bold;">-k</span>
622
648
option allows overriding these with a custom value between 0.0 (no
623
 
correction) to 1.0 (full correction). If less than full correction is
 
649
correction of black) to 1.0 (full correction of black). If less than
 
650
full correction is
624
651
chosen, then the resulting calibration curves will have the target
625
652
white point down most of the curve, but will then blend over to the
626
653
native or compromise black point that is blacker, but not of the right
627
654
hue. The rate of this blend can be controlled with the <span
628
 
 style="font-weight: bold;">-A</span> parameter.<br>
 
655
 style="font-weight: bold;">-A</span> parameter (see below).<br>
629
656
<br>
630
657
<a name="A"></a><span style="font-weight: bold;">-A rate</span>:&nbsp;
631
658
If the black point is not being set completely to the same hue as the
758
785
for more details. This may give better accuracy for display
759
786
measurements.<br>
760
787
<br>
 
788
<a name="V"></a> The -<span style="font-weight: bold;">V</span> option
 
789
uses adaptive emission measurement mode, if the instrument supports it,
 
790
such as the Eye-One Pro. This may give better accuracy for low level
 
791
measurements, but may be more inconsistent overall due to the varying
 
792
integration times. Overall measurement time will probably be longer.<br>
 
793
<br>
761
794
<a name="M"></a> The -<span style="font-weight: bold;">M</span> <span
762
795
 style="font-weight: bold;">"command" </span>option
763
796
allows a method of gathering each test value from some external source,