1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>chartread</title>
<meta http-equiv="content-type" content="text/html;
charset=windows-1252">
<meta name="author" content="Graeme Gill">
</head>
<body>
<h2><b>spectro/chartread</b></h2>
<h3>Summary</h3>
Read a printer test chart using an instrument, to create a <a
href="File_Formats.html#.ti3">.ti3</a> data file. The type of
instrument is determined by the communication port selected.<br>
<br>
<span style="font-weight: bold;">chartread</span> can also be used
to read transmission values, and to read display values manually.<br>
<h3>Usage</h3>
<small><span style="font-family: monospace;">chartread [-options]
outfile</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</span><br style="font-family: monospace;">
<span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#c">-c listno</a><span
style="font-family: monospace;">
Set communication port from the following
list (default 1)</span><br style="font-family: monospace;">
<span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#t">-t</a><span
style="font-family: monospace;">
Use
transmission
measurement mode<br>
</span></small><small><span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#d">-d</a><span
style="font-family: monospace;">
Use
display
measurement
mode (white Y relative results)</span></small><small><span
style="font-family: monospace;"></span></small><small><span
style="font-family: monospace;"><br>
</span></small><font size="-1"><span style="font-family:
monospace;"><a href="#y">-y X</a>
Display type - instrument specific list to choose from.</span></font><br>
<small><span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#e">-e</a><span
style="font-family: monospace;">
Use
emissive
measurement
mode (absolute results)<br>
</span></small><small><span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#p">-p</a><span
style="font-family: monospace;">
Measure
patch
by
patch rather than strip</span></small><br>
<small><span style="font-family: monospace;"></span> <a
style="font-family: monospace;" href="#x">-x [lx]</a><span
style="font-family: monospace;">
Take
manually entered values, either L*a*b* (-xl) or XYZ (-xx).</span><br
style="font-family: monospace;">
<span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#n">-n</a><span
style="font-family: monospace;">
Don't
save spectral information (default saves spectral)<br>
</span></small><small><span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#l">-l</a><span
style="font-family: monospace;">
Save CIE as D50 L*a*b* rather than XYZ<br>
</span></small><small><span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#L">-L</a><span
style="font-family: monospace;">
Save CIE as D50 L*a*b* as well as XYZ</span></small><br>
<small><span style="font-family: monospace;"> <a href="#r">-r</a>
Resume
reading
partly
read chart<br>
<a href="#I">-I</a>
file.cal Override
calibration info from .ti2 in resulting .ti3<br>
</span></small><font size="-1"><span style="font-family:
monospace;"><a href="#F">-F filter</a>
Set filter configuration:<br>
n
None<br>
p
Polarising filter<br>
6
D65<br>
u
U.V. Cut</span></font><small><span style="font-family:
monospace;"></span><span style="font-family: monospace;"></span></small><br>
<font size="-1"><span style="font-family: monospace;"><a
href="#A">-A N|A|X|G</a>
XRGA conversion</span></font> (default N)<br>
<font size="-1"><span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#N">-N</a><span
style="font-family: monospace;">
Disable initial calibration of instrument unless
essential<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> </span><a style="font-family: monospace;"
href="#B">-B</a><span style="font-family: monospace;">
Disable auto bi-directional strip recognition</span></font><br>
<font size="-1"><span style="font-family: monospace;"><font
size="-1"><span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#b">-b</a><span
style="font-family: monospace;">
Force enable auto bi-directional strip
recognition</span></font><br>
</span></font> <font size="-1"><span style="font-family:
monospace;"> </span><a style="font-family: monospace;"
href="#H">-H</a><span style="font-family: monospace;">
Use high resolution spectrum mode (if available)<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> </span></font><font size="-1"><span
style="font-family: monospace;"><a href="#X1">-X file.ccmx</a>
Apply Colorimeter Correction Matrix</span></font><br>
<span style="font-family: monospace;"> <a href="#X2">-X
file.ccss</a>
Use
Colorimeter
Calibration
Spectral
Samples
for calibration</span><br>
<small><span style="font-family: monospace;"> </span><a style="
font-family: monospace;" href="#Q">-Q observ</a><span
style="font-family: monospace;">
Choose CIE Observer for
spectral data or CCSS instrument:</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">
</span></small><small><span
style="font-family: monospace;">1931_2 </span></small><small><span
style="font-family: monospace;"> (def.)</span></small><small><span
style="font-family: monospace;">, 1964_10, </span></small><small><span
style="font-family: monospace;"><tt><small>2012_2, 2012_10, </small></tt>S&B
1955_2, shaw, J&V 1978_2 or file.cmf</span></small><small><span
style="font-family: monospace;"></span></small><font size="-1"><span
style="font-family: monospace;"></span></font><br>
<font size="-1"><span style="font-family: monospace;"> <a
href="#T">-T ratio</a>
Modify
strip
patch
consistency tolerance by ratio (if available)<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> <a href="#S">-S</a>
Suppress
wrong
strip
& unexpected value warnings</span></font><br>
<font size="-1"><span style="font-family: monospace;"> <a
href="#W">-W n|h|x</a>
Override
serial port flow control: n = none, h = HW, x = Xon/Xoff</span></font><br
style="font-family: monospace;">
<small><span style="font-family: monospace;"></span><small
style="font-family: monospace;"> <a href="#D">-D [level]</a>
Print debug
diagnostics to stderr</small><br style="font-family: monospace;">
<span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#p1"><i>inoutfile</i></a><span
style="font-family: monospace;">
Base name for input[</span><a style="font-family:
monospace;" href="File_Formats.html#.ti2">.ti2</a><span
style="font-family: monospace;">]/output[</span><a
style="font-family: monospace;" href="File_Formats.html#.ti3">.ti3</a><span
style="font-family: monospace;">] file</span></small> <br>
<h3>Usage Details</h3>
<a name="v"></a>The <b>-v</b> flag causes extra information to be
printed out during chartread operation.<br>
<br>
<a name="c"></a>Normally instruments are connected via a serial
communication port, and the port used should be selected by
supplying the correct parameter to the <b>-c</b> flag. If you
invoke <span style="font-weight: bold;">chartread</span> so as to
display the usage information (i.e. "chartread -?" or "chartread
--"), then the discovered serial ports will be listed on Windows and
Mac OSX systems.<br>
<br>
<a name="t"></a>If using an Xrite DTP41T, and printing onto
transparent or back lit media, use the <b>-t</b> flag to operate
the instrument in transparency mode. If using a Spectrolino or
Eye-One Pro (handheld), this triggers a fake transparency mode, that
uses a separate backlight (such as a light box). The
instrument will be used to calibrate the level of backlight, and use
this to compute the transparency of the test chart samples. Note
that for good transparency values, the backlight level needs to be
neither too bright not too dark, should ideally be incandescent
rather than fluorescent (since fluorescent lights often have big
dips in their spectrum), and ideally should be of uniform brightness
over the measurement area. If using the SpectroScanT, the <span
style="font-weight: bold;">-t</span> flag operates the instrument
in transparency mode, each reading being manually triggered.<br>
<br>
<a name="d"></a>The <span style="font-weight: bold;">-d</span> flag
allows measuring in display mode using instruments that support this
mode, with the brightness normalized to the white patch value in the
test chart. While the brightness values are then relative to the
white, the readings are otherwise absolute. This corresponds to the
raw ICC absolute readings created by <a href="dispread.html">dispread</a>,
and is the mode that should be used for creating a normal display
ICC profile using manual, spot by spot readings. This can be useful
if the display cannot be driven directly by the computer, but can be
made manually to display the test charts.<br>
<br>
<a name="y"></a> The <span style="font-weight: bold;">-y</span>
flag allows setting the Display Type. The selection typically
determines two aspects of of the instrument operation: <span
style="font-weight: bold;">1)</span> It may set the measuring mode
to suite <a
href="http://en.wikipedia.org/wiki/Comparison_of_display_technology"><span
style="font-weight: bold;">refresh</span> or <span
style="font-weight: bold;">non-refresh</span> displays</a>.
Typically only LCD (Liquid Crystal) displays have a non-refresh
nature. <span style="font-weight: bold;">2)</span> It may select an
instrument calibration matrix suitable for a particular display
type. The selections available depends on the type and model of
instrument, and a list of the options for the discovered instruments
will be shown in the <a href="ArgyllDoc.html#CmdLine">usage</a>
information. For more details on what particular instruments support
and how this works, see <a href="instruments.html">Operation of
particular instruments</a>. <b>3)</b> Any installed CCSS files
(if applicable), or CCMX files. These files are typically created
using <a href="ccxxmake.html">ccxxmake</a>, and installed using <a
href="oeminst.html">oeminst</a>. The default and Base Calibration
types will be indicated in the usage.<br>
<br>
<a name="e"></a> If using an instrument that supports an emissive
measurement mode (such as the Spectrolino), then the <span
style="font-weight: bold;">-e</span> flag enables this measurement
mode, and the values recorded will be absolute XYZ values. This can
be used for media such as backlit film, measuring it on a lightbox,
so as to capture the actual illumination characteristics of that
particular media. An adaptive integration time will be used in
devices that support it. <br>
<br>
<a name="p"></a> The <span style="font-weight: bold;">-p</span>
flag causes chartread to use a spot read mode for an instrument,
even if it is capable of faster chart reading modes such as strip
reading. This can be useful if strip measurement patch recognition
is not reliable for certain media.<br>
<br>
<a name="x"></a> The <span style="font-weight: bold;">-x</span>
flag causes chartread to expect values to be manually entered for
each reading, rather than using an instrument to do the
measurements. This mode is ideal if your instrument is not
supported by Argyll. Either XYZ or L*a*b* values can be entered,
depending on what option follows <span style="font-weight: bold;"><span
style="font-weight: bold;">-l</span></span>, <span
style="font-weight: bold;">-lx</span> to specify XYZ values, or <span
style="font-weight: bold;">-ll</span> to specify L*a*b* values.
XYZ values are expected to be scaled to a maximum of 100. It is
possible to navigate about the test values being measured, so as to
do them in any order, as well as re-do values, in case of any
mistakes.<br>
<br>
<a name="n"></a> <span style="font-weight: bold;">-n</span> By
default spectral information as well as D50 standard observer XYZ
values will be recorded for each test patch, when such readings are
available from a device. The spectral readings allow for choosing a
non-standard viewing illuminant, a non-standard observer model, or
the use of the Fluorescent Paper Whitener Additive compensation when
creating the profile. If the spectral readings are not needed, then
prinread operation can be speeded up by specifying the <b>-n</b>
flag.<br>
<br>
<a name="l"></a> <span style="font-weight: bold;">-l</span> By
default D50 standard observer XYZ values will be recorded for each
test patch, but if the <span style="font-weight: bold;"><span
style="font-weight: bold;">-l</span></span> flag is used, D50
L*a*b* values will be recorded instead.<br>
<br>
<a name="L"></a> <span style="font-weight: bold;">-L</span> By
default D50 standard observer XYZ values will be recorded for each
test patch, but if the <span style="font-weight: bold;"><span
style="font-weight: bold;">-L</span></span> flag is used, XYZ <span
style="font-weight: bold;">and </span>D50 L*a*b* values will
be recorded.<br>
<br>
<a name="r"></a> <span style="font-weight: bold;">-r</span> By
default chartread reads the chart from scratch each time. When
reading a chart using a strip instrument or patch by patch you can
choose to finish chartread without reading all the patches, and
whatever patches have been read will be saved to the output .ti3
file. You can then <span style="text-decoration: underline;">resume</span>
reading the patches by using the <span style="font-weight: bold;">-r</span>
flag, in which case chartread will read the .ti3 file and set the
patches to those previously read values, allowing any unread patches
to then be read, or to re-read previously read patches.<br>
<br>
<a name="I"></a> <span style="font-weight: bold;">-I</span> <span
style="font-style: italic;">file.cal</span> Normally per
channel calibration curves are added to the .ti2 file using the <span
style="font-weight: bold;">printtarg -K</span> or <span
style="font-weight: bold;">-I</span> options, so that they will be
passed on to the .ti3 file by <span style="font-weight:
bold;">chartread</span>, so that <span style="font-weight: bold;">colprof</span>
is able to correctly compute total ink limits. Where the calibration
is being applied in a workflow with native calibration capability<small><span
style="font-family: monospace;"></span></small> though, it is
sometimes convenient to re-use a profile chart with different
calibration curves without going through the process of using <span
style="font-weight: bold;">printtarg</span> to re-create it. This
would mean though, that the calibration information and subsequent
ink limit calculations wouldn't be accurate. To overcome this and
allow such a scenario, the <span style="font-weight: bold;">chartread
-I</span> parameter allows overriding the .ti2 calibration curves
placed in the resulting .ti3 file with the actual calibration that
was used for that particular print.<br>
<br>
<a name="F"></a>The <b>-F</b> options allows configuring the
instrument to have a particular filter fitted to it. Some
instruments (i.e. the Gretag Spectrolino) allow the fitting of
various filters, such as a polarizing filter, D65 illuminant
simulation, or Ultra Violet Cut filter, and this option allows the
instrument to be configured appropriately.<br>
<br>
<a name="A"></a>The <b>-A</b> options allows overriding the default
or environment variable set <a href="XRGA.html">XRGA</a>
conversion:<br>
<br>
<b>-A N|A|X|G</b><br>
<br>
The <b>N</b> argument sets
the calibration to Native (default).<br>
The <b>A</b> argument sets
the calibration to XRGA.<br>
The <b>X</b> argument sets
the calibration to XRDI.<br>
The <b>G</b> argument sets
the calibration to GMDI.<br>
<br>
<a name="N"></a> <span style="font-weight: bold;">-N</span> Any
instrument that requires regular calibration will ask for
calibration on initial start-up. Sometimes this can be awkward if
the instrument is being mounted in some sort of measuring jig, or
annoying if several sets of readings are being taken in quick
succession. The -<span style="font-weight: bold;">N</span>
suppresses this initial calibration if a valid and not timed out
previous calibration is recorded in the instrument or on the host
computer. It is advisable to only use this option on the second and
subsequent measurements in a single session.<br>
<br>
<a name="B"></a> <span style="font-weight: bold;">-B</span> Some
strip instruments (i.e.. Eye-One Pro, Color Munki) when used with
Argyll will automatically recognize a strip when read in the reverse
direction by matching the patch readings against their expected
values. If the expected values are not known accurately enough, this
may cause erroneous reverse recognition, so the <span
style="font-weight: bold;">-<span style="font-weight: bold;">B</span></span>
flag allows this to be turned off, forcing strips to only be read in
the forward direction. (Note that the DTP20 always allows
bi-directional strip reading.) If the randomized patch layout has
not been used, then bi-directional strip recognition will
automatically turned off, and a warning issued if the -B flag is not
used.<br>
<br>
<a name="b"></a><b>-b</b> By default chartread will disable
bi-directional strip reading if a randomized layout hasn't been
used. The <b>-b</b> flag forces bi-directional strip reading on
even for charts that don't use a randomized layout. If the chart
strips have a distinct patch order, then this will be reliable, but
for other patch layouts, the direction may be guessed wrongly, so
this option should be used with care.<br>
<br>
<a name="H"></a> The -<span style="font-weight: bold;">H</span>
option turns on high resolution spectral mode, if the instrument
supports it. See <a href="instruments.html">Operation of particular
instruments</a> for more details.<br>
<br>
<a name="X1"></a> The -<span style="font-weight: bold;">X <span
style="font-style: italic;">file.ccmx</span></span> option reads
a <a href="File_Formats.html#.ccmx">Colorimeter Correction Matrix</a>
from the given file, and applies it to the colorimeter instruments
readings. This can improve a colorimeters accuracy for a particular
type of display. A list of contributed <span style="font-weight:
bold;">ccmx</span> files is <a href="ccmxs.html">here</a>.<br>
<br>
<a name="X2"></a> The -<span style="font-weight: bold;">X <span
style="font-style: italic;">file.ccss</span></span> option reads
a <a href="File_Formats.html#.ccss">Colorimeter Calibration
Spectral Sample</a> from the given file, and uses it to set the
colorimeter instruments calibration. This will only work with
colorimeters that rely on sensor spectral sensitivity calibration
information (ie. the X-Rite <span style="font-weight: bold;">i1d3</span>,
or the DataColor <span style="font-weight: bold;">Spyder4 &
Spyder 5</span>).This can improve a colorimeters accuracy for a
particular type of display. A list of contributed <span
style="font-weight: bold;">ccss</span> files is <a
href="ccsss.html">here</a>.<br>
<br>
<a name="T"></a> The -<span style="font-weight: bold;">T ratio</span>
argument modifies the patch consistency tolerance threshold for some
strip reading instruments (ie. the Eye-One Pro). In recognizing
patches in a strip, an instrument may take multiple readings as the
strip is read, and then divide the readings up into each patch. It
may then check the consistency of the multiple readings
corresponding to each patch, and reject the measurement if they are
too inconsistent. For some media (ie. a coarser screens, fabric
etc.) the default tolerance may be unreasonably tight, so the <span
style="font-weight: bold;">-T ratio</span> argument can be used to
modify this criteria. To loosen the tolerance, use a number greater
than 1.0 (ie. 1.5, 2.0).<br>
<br>
<a name="Q"></a> The <b>-Q</b> flag allows specifying a tristimulus
observer for a colorimeter when using CCSS instrument calibration
capability. The following choices are available:<br>
<b> 1931_2</b> selects the standard CIE 1931 2 degree
observer. The default.<br>
<b>1964_10</b> selects the standard CIE 1964 10 degree
observer.<br>
<b> 2012_2</b> selects the proposed CIE 2012 2 degree
observer.<br>
<b>2012_10</b> selects the proposed CIE 2012 10 degree
observer.<br>
<b>1955_2</b> selects the Stiles and Birch 1955 2 degree
observer<br>
<b>1978_2 </b>selects the Judd and Voss 1978 2 degree
observer<br>
<b>shaw</b> selects the Shaw and Fairchild 1997 2 degree
observer<br>
<i><b>file.cmf</b></i> selects an observer specified by the
given <a href="File_Formats.html#.cmf">.cmf</a> file.<br>
<br>
<a name="S"></a>The <b>-S</b> flag causes the normal "wrong strip"
and "unexpected value" warnings to be suppressed. There may be a lot
of these warnings if the expected patch value in the .ti2 file is in
fact far from the values actually being measured. It is probably
advisable to also use the <span style="font-weight: bold;">-B</span>
flag if warnings are turned off, since many warnings indicate that
the expected values are not to be relied on. With warnings
suppressed, greater care must be taken to read the correct strip. If
the randomized patch layout has not been used, then "wrong strip"
warnings will automatically be suppressed, and bi-directional strip
recognition turned off.<br>
<br>
<a name="W"></a>The <b>-W</b> <span style="font-weight: bold;">n|h|x</span>
parameter overrides the default serial communications flow control
setting. The value <span style="font-weight: bold;">n</span> turns
all flow control off, <span style="font-weight: bold;">h</span>
sets hardware handshaking, and <span style="font-weight: bold;">x</span>
sets Xon/Xoff handshaking. This commend may be useful in workaround
serial communications issues with some systems and cables. <br>
<br>
<a name="D"></a>The <b>-D</b> flag causes communications and other
instrument diagnostics to be printed to stdout. A level can be set
between 1 .. 9, that may give progressively more verbose
information, depending on the instrument. This can be useful in
tracking down why an instrument can't connect.<br>
<br>
<a name="p1"></a> The <i>inoutfile</i> parameters should be the
base name of the .ti2 file, and chartread will output an .ti3 that
has the same basename and the .ti3 extension. If the incoming .ti2
file contains per-channel calibration curves, these will be passed
through to the .ti3 so that accurate ink limits can be computed
during profiling.<br>
<br>
<hr style="width: 50%; height: 2px;">
<h3>Discussion</h3>
For information about the operation of different instruments, see <a
href="instruments.html">Operation of particular instruments</a>.<br>
<br>
<br>
</body>
</html>
|