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/ArgyllDoc.html | 4522 ++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 3461 insertions(+), 1061 deletions(-) (limited to 'doc/ArgyllDoc.html') diff --git a/doc/ArgyllDoc.html b/doc/ArgyllDoc.html index 498e974..98e730d 100644 --- a/doc/ArgyllDoc.html +++ b/doc/ArgyllDoc.html @@ -1,119 +1,140 @@ - - - - - - - - Argyll Documentation Top - - -

Argyll CMS documentation index (V1.5.1)
-

- Date:   8th March 2013
- Author: Graeme Gill -

Introduction

- ArgyllCMS is an ICC compatible color management system, available as - Open Source. It supports accurate ICC profile creation for scanners, - cameras and film recorders, and calibration and profiling of - displays and RGB & CMYK printers. Spectral sample data is - supported, allowing a selection of illuminants observer types, and - paper fluorescent whitener additive compensation. Profiles can also - incorporate source specific gamut mappings for perceptual and - saturation intents. Gamut mapping and profile linking uses the - CIECAM02 appearance model, a unique gamut mapping algorithm, and a - wide selection of rendering intents. Device Link can be created with - a wide variety of advanced options. It also includes code for the - fastest portable 8 bit raster color conversion engine available - anywhere, as well as support for fast, fully accurate 16 bit - conversion. Device color gamuts can also be viewed and compared - using a VRML viewer. Comprehensive documentation is provided for - each major tool, and a general guide to using the tools for typical - color management tasks is also available. A mailing list provides - support for more advanced usage.
-

This is Version 1.5.1, a bug fix and feature update to V1.5.0 - released on 1st March 2013. The first public release of icclib was - in November 1998, and of Argyll was in October 2000. Code - development commenced in 1995. See Changes - - - - - - - - - - - - - - - - - - - - - - - - - - - - Summary for an overview of changes since the last release. - Changes between revisions is detailed in the log.txt file - that accompanies the source code.

-

The latest source code is available from here.
-

-

An Introduction to Color - Management

- A concise discussion of what - color management is, and why we need it, together with a brief - overview of the ICC profile format.
-

Operating Environments

-

-

Argyll is known to compile and run in at least the following - environments:

- 1) MSWindows XP system using Microsoft VC++ 6.0 compiler
- 2) MSWindows XP system using Microsoft VC++ 8.0 Express compiler + - Platform SDK Feb. 2003
- 3) MSWindows XP system using Microsoft VC++ 9.0 Express compiler + - Platform SDK Feb. 2003
- 4) MSWindows XP system using the MingW port of the GCC compiler
- 5) Linux on Fedora Core 8, 32 bit using gcc
- 6) Linux on Fedora Core 8, 64 bit using gcc
- 7) Apple OS X 10.3 PPC using GCC
- 8) Apple OS X 10.4, 10.5, 10.6 Intel using GCC
- 9) Apple OS X10.7 Intel using  Clang
- 10) PCBSD 9.1 (FreeBSD) [You need to copy the libusb sub directory - from ArgyllCMS V1.4.0]
-
- Additionally it is also known to run on:
-
-  MSWindows 2000, Vista & Windows 7 32 bit.
-  MSWindows Vista 64bit, Windows 7 64bit & Windows 8 64 bit.
-  Linux Ubuntu 7.10
-  Linux Kubuntu 7.10
-  Linux Mandriva 2008.0
-  Linux OpenSuSE 10.3
-  Linux Whitebox 4.2/2
-

but may well compile and run correctly in many more than this, - including OS X 10.8.

- This is a command line terminal - only environment. Those unfamiliar with command line environments - should consult an appropriate tutorial for their environment if they - are interested in using this software. See the listing of tutorials below.
-
- The following color measuring instruments are directly supported:
-
- X-Rite:
+ + + + + + + + Argyll Documentation Top + + +

Argyll CMS documentation index (V1.6.3)
+

+ Date:   26th January 2014
+ Author: Graeme Gill +

Introduction

+ ArgyllCMS is an ICC compatible color management system, available as + Open Source. It supports accurate ICC profile creation for scanners, + cameras and film recorders, and calibration and profiling of + displays and RGB & CMYK printers. Device Link can be created + with a wide variety of advanced options, including specialized Video + calibration standards  and 3dLuts. Spectral sample data is + supported, allowing a selection of illuminants observer types, and + paper fluorescent whitener additive compensation. Profiles can also + incorporate source specific gamut mappings for perceptual and + saturation intents. Gamut mapping and profile linking uses the + CIECAM02 appearance model, a unique gamut mapping algorithm, and a + wide selection of rendering intents. It also includes code for the + fastest portable 8 bit raster color conversion engine available + anywhere, as well as support for fast, fully accurate 16 bit + conversion. Device color gamuts can also be viewed and compared + using a VRML viewer. Comprehensive documentation is provided for + each major tool, and a general guide to using the tools for typical + color management tasks is also available. A mailing list provides + support for more advanced usage.
+

This is Version 1.6.3, a bug fix update to V1.6.2 released on 8th + November 2013. The first public release of icclib was in November + 1998, and of Argyll was in October 2000. Code development + commenced in 1995. See Changes + Summary for an overview of changes since the last release. + Changes between revisions is detailed in the log.txt file + that accompanies the source code.

+

The latest source code is available from here.
+

+

An Introduction to Color + Management

+

A great introduction for non technical people is Steve Upton's The + Color of Toast.
+

+ I present here a more technical but concise + + + + + + + + + + + + + + + + discussion of what color management is, and why we need it, + together with a brief overview of the ICC profile format.
+
+

Operating Environments

+

+

Argyll is known to compile and run in at least the following + environments:

+ 1) MSWindows XP system using Microsoft VC++ 6.0 compiler
+ 2) MSWindows XP system using Microsoft VC++ 8.0 Express compiler + + Platform SDK Feb. 2003
+ 3) MSWindows XP system using Microsoft VC++ 9.0 Express compiler + + Platform SDK Feb. 2003
+ 4) MSWindows XP system using Microsoft VC++ 10.0 Express compiler + + Platform SDK Feb. 2003
+ 5) MSWindows XP system using Microsoft VC++ 11.0 Express compiler
+ 6) MSWindows XP system using the MingW port of the GCC compiler
+ 7) Linux on Fedora Core 8, 32 bit using gcc
+ 8) Linux on Fedora Core 8, 64 bit using gcc
+ 9) Apple OS X 10.3 PPC using GCC
+ 10) Apple OS X 10.4, 10.5, 10.6 Intel using GCC
+ 11) Apple OS X10.7 Intel using  Clang
+
+ Additionally it is also known to run on:
+
+  MSWindows 2000, Vista & Windows 7 32 bit.
+  MSWindows Vista 64bit, Windows 7, 8, 8.1 64 bit.
+  Linux Ubuntu 7.10
+  Linux Kubuntu 7.10
+  Linux Mandriva 2008.0
+  Linux OpenSuSE 10.3
+  Linux Whitebox 4.2/2
+

but may well compile and run correctly in many more than this, + including OS X 10.8.

+ This is a command line terminal + only environment. Those unfamiliar with command line environments + should consult an appropriate tutorial for their environment if they + are interested in using this software. See the listing of tutorials below.
+
+ The following color measuring instruments are directly supported:
+
+ JETI:
+
+     specbos 1211 + & 1201                    + + + + + + + + + + + + + + + + + + + + + - Tele-Spectro-Radiometer
+
+ X-Rite:
    DTP20 "Pulse"                              @@ -156,8 +177,29 @@ - - "swipe" type reflective spectrometer, that can be used untethered.
-     DTP22 Digital + + + + + + + + + + + + + + + + + + + + + + - "swipe" type reflective spectrometer, that can be used untethered.
+     DTP22 Digital Swatchbook            @@ -199,7 +241,28 @@ - - spot type reflective spectrometer.
+ + + + + + + + + + + + + + + + + + + + + + - spot type reflective spectrometer.
    DTP41                                         @@ -241,10 +304,6 @@ - - spot and strip reading reflective spectrometer.
-     DTP41T -                  -                      @@ -265,6 +324,11 @@ + + - spot and strip reading reflective spectrometer.
+     DTP41T +                  +                      @@ -285,8 +349,6 @@ - - spot and strip reading reflective/transmissive spectrometer.
-     DTP51                                         @@ -327,8 +389,9 @@ - - strip reading reflective colorimeter.
-     DTP92                                         + + - spot and strip reading reflective/transmissive spectrometer.
+     DTP51                                         @@ -369,69 +432,6 @@ - - CRT display colorimeter.
-     DTP94 "Optix XR" or "Optix XR2" or "Optix Pro"- display - colorimeter.
-     ColorMunki Design - or Photo           - - spot and "swipe" reflective/emissive spectrometer (UV cut only).
-     ColorMunki Create - or Smile   -          - display - colorimeter. (Similar to an Eye-One Display 2)
-     Lenovo W -                   -                   - - built in laptop Huey display colorimeter.
-     Eye-One Display - 3                 -         - Xrite i1 DisplayPro and ColorMunki - Display
-             -             -             -             -           [ The OEM - i1Display Pro, NEC SpectraSensor Pro and
-                   -                   -                   -        Quato Silver Haze 3 OEM i1d3 are also - reported to work.]
-     Eye-One Pro2 -                   -              - spot and - "swipe" reflective/emissive spectrometer.
-
- Gretag-Macbeth (now X-Rite):
-     Spectrolino   -                   -               - spot - reflective/emissive spectrometer.
-     SpectroScan   -                   -             - spot - reflective/emissive, XY table reflective spectrometer  .
-     SpectroScanT   -                   -           - spot - reflective/emissive/transmissive, XY table reflective spectrometer.
-     Eye-One Pro "EFI - ES-1000"           - spot and "swipe" - reflective/emissive spectrometer.
-     Eye-One Monitor -                   -         - spot and "swipe" emissive - spectrometer.
-     Eye-One Display 1 - or 2  or LT        - - display colorimeter.
-     HP DreamColor or - APS  -                 @@ -452,6 +452,9 @@ + + - strip reading reflective colorimeter.
+     DTP92                                         @@ -472,9 +475,6 @@ - - display colorimeter. (Treated as a Eye-One Display 2)
-     CalMAN X2 -                                  @@ -515,18 +515,70 @@ - - display colorimeter. (Treated as a Eye-One Display 2)
-     Huey   -                   -                 -        - display colorimeter.
-
- Sequel imaging (Now X-Rite):
-      MonacoOPTIX -                   -           - display - colorimeter (Treated as an Eye-One Display 1)
-                                                            + + - CRT display colorimeter.
+     DTP94 "Optix XR" or "Optix XR2" or "Optix Pro"- display + colorimeter.
+     ColorMunki Design + or Photo           - + spot and "swipe" reflective/emissive spectrometer (UV cut only).
+     ColorMunki Create + or Smile   +          - display + colorimeter. (Similar to an Eye-One Display 2)
+     Lenovo W +                   +                   - + built in laptop Huey display colorimeter.
+     Eye-One Display + 3                 +         - Xrite i1 DisplayPro and ColorMunki + Display
+             +             +             +             +           [ The OEM + i1Display Pro, NEC SpectraSensor Pro,
+                   +                   +                   +        Quato Silver Haze 3 OEM and HP + DreamColor  i1d3 are also reported to work.]
+     Eye-One Pro2 +                   +              - spot and + "swipe" reflective/emissive spectrometer.
+
+ Gretag-Macbeth (now X-Rite):
+     Spectrolino   +                   +               - spot + reflective/emissive spectrometer.
+     SpectroScan   +                   +             - spot + reflective/emissive, XY table reflective spectrometer  .
+     SpectroScanT   +                   +           - spot + reflective/emissive/transmissive, XY table reflective spectrometer.
+     Eye-One Pro "EFI + ES-1000"           - spot and "swipe" + reflective/emissive spectrometer.
+     Eye-One Monitor +                   +         - spot and "swipe" emissive + spectrometer.
+     Eye-One Display 1 + or 2  or LT        - + display colorimeter.
+     HP DreamColor or + APS  +                 @@ -567,10 +619,6 @@ - [The Sequel Chroma 4 may also work.]
-
- Lacie Blue - Eye:                                  @@ -591,6 +639,10 @@ + + - display colorimeter. (Treated as a Eye-One Display 2)
+     CalMAN X2 +                                  @@ -611,15 +663,6 @@ - - see Eye-One Display
-
- DataColor ColorVision:
-      Spyder 2 -                    -            -        - display colorimeter (Note - that the user must supply firmware)
-                                                           @@ -660,22 +703,19 @@ - [The Spyder 1 has also been reported as working, but this has not - been confirmed.]
-      Spyder 3 -                    -            -        - display colorimeter.
-      Spyder 4 -                    -            -        - display colorimeter (Note - that the user must supply calibration - data)
-
- Other:
-     Colorimètre HCFR                          + + - display colorimeter. (Treated as a Eye-One Display 2)
+     Huey   +                   +                 +        - display colorimeter.
+
+ Sequel imaging (Now X-Rite):
+      MonacoOPTIX +                   +           - display + colorimeter (Treated as an Eye-One Display 1)
+                                                            @@ -716,8 +756,6 @@ - - display colorimeter
-     ColorHug                                       @@ -738,110 +776,16 @@ + + [The Sequel Chroma 4 may also work.]
+
+ Lacie Blue + Eye:                                  - - display colorimeter. Experimental only, does not work on all - platforms.
-
- See Operation of particular - instruments for more instrument specific detail.
-
- Other instruments can be supported indirectly, since patch result - files created by other packages can be imported into Argyll.
-
- Please note the installation instructions for each - platform - they contain important information for getting your - instruments working.
-

If you've decided to buy a color instrument because Argyll - supports it, please let the dealer and manufacturer know that "You bought it because Argyll CMS - supports it" - thanks.
-

-

Please note that instruments are - being driven by ArgyllCMS drivers, and that any problems or - queries regarding instrument
- operation should be - directed to the Argyll's author(s) or the Argyll mailing list, - and not to any other - party.

-

There is a list - of contributed ccmx - (Colorimeter Correction Matrix) files for some display/colorimeter - combinations.

-

Copyright and Licensing:
-

-

Most of the source code and provided executable files are - copyrighted works, licensed under the Affero GNU Version 3 license, and therefore they - (or works derived from them) can't be copied, sold or made - available to users interacting with them remotely through a - computer network, without providing the source code. Nothing other - than your agreement and compliance with the Affero GNU License - grants you permission to use, modify or distribute Argyll source - code, executables or its derivative works. You could be sued for - copyright infringement if you use or distribute Argyll without a - valid license. The Affero GNU - license prohibits - extending these tools - (i.e. by combining them with other programs or scripts that make - use of, depend on, or work with the Argyll code) and distributing - them, unless the all the elements of the extensions are also made - available under a GPL compatible license. It is permissible to - provide Argyll tools with other non GPL components if the elements - of the package are not related, such that the packaging is mere - aggregation. For all the gory details, please read the - accompanying license.

- Note that unlike many commercial ICC profiling tools, the profiles - created using Argyll, are not subject to any claims or restrictions - of Argyll's author(s), but are assumed to be the copyright property - of the person who gathers the characterization data, and causes the - profiles to be created. -

The Argyll CMS is Copyright 1995 - 2013 Graeme W. Gill, and is - made available under the terms of the Affero GNU General Public - License Version 3, as detailed in the License.txt - file. Documentation is licensed under the terms of the GNU Free - Documentation License, Version 1.3. The author asserts his moral - rights over this material in relationship to the attribution and - integrity of these works. In particular, if these works are - modified in a way that materially changes their functionality, - then the modified works should be renamed in a way that clearly - distinguishes them from "Argyll" or "ArgyllCMS" so that the - effects of such changes do not reflect on the original works - integrity or the original authors reputation. A subset of files - (those that are related to the color instrument drivers, and are - collected together into the instlib.zip archive by the - spectro/instlib.ksh script + xicc/ccmx.h and xicc/ccmx.c) are - licensed under the General Public License Version 2 or later, as - detailed in the License2.txt file.
-

-

Portions of the ColorHug instrument library - (spectro/colorhug.[ch]) are Copyright 2011, Richard Hughes, and is - licensed under the General Public License Version 2 or later, as - detailed in the License2.txt file.

-

The tool spectro/spec2cie.c is Copyright 2005 Gerhard Fuernkranz, - and is made available under the terms of the GNU General Public - License Version 2 or later, and is licensed here under the Version - 3 license, as detailed in the License3.txt - file.
-

-

The Win32 USB library libusb-win32 kernel drivers are included in - this distribution in the usb/driver and usb/bin directories, and - are copyright Stephan Meyer and Travis Robinson, and are licensed - under the GNU Version 2 or later (the drivers, services, - installer). See  usb/driver/License.txt, - libusbw/COPYING_LGPL.txt and libusbw/COPYING_GPL.txt for details. - Additional terms noted on the website - are "This license combination explicitly allows the use of this - library in commercial, non-Open-Source applications."
-

-

The icc library in icc/, - the CGATS library in cgats/, @@ -882,7 +826,6 @@ - the jcnf library in jcnf/, @@ -898,6 +841,16 @@ + + - see Eye-One Display
+
+ DataColor ColorVision:
+      Spyder 2 +                    +            +        - display colorimeter (Note + that the user must supply firmware)
+                                                           @@ -922,78 +875,6 @@ - the files spectro/xdg_bds.*, - spectro/aglob.* and the - ucmm library in ucmm/ are - Copyright 1995 - 2011 Graeme W. Gill, and available according to - the "MIT" license granted in the icc/License.txt and - cgats/License.txt files, and the licenses at the top of - ucmm/ucmm.c and jcnf/jcnf.c.
-

-

The yajl library in jcnf/yajl - is Copyright 2007-2009, Lloyd Hilaiel and is licensed according to - the Berkeley-style License granted in the jcnf/yajl/COPYING files. - The yajl library has been repackaged and modified slightly for - convenience.
-

-

The TIFF library included in this distribution for convenience, - has its own copyright and license detailed in tiff/COPYRIGHT (an - "MIT"/"BSD" like license).
-

-

The Independent JPEG Group's JPEG library included in this - distribution for convenience, has its own copyright and license - detailed in jpg/README (an "MIT"/"BSD" like license). Executables - that include JPEG format support are based in part on the work of - the Independent JPEG Group.

-

xicc/iccjpeg.h and xicc/iccjpeg.c are from lcms and they are Copyright - (c) 1998-2010 Marti Maria Saguer and is licensed under an - "MIT"/"BSD" like license. See the top of the iccjpeg.c file for - the detailed copyright and licensing conditions.
-

-

The mongoose web server software is Copyright (c) 2004-2011 - Sergey Lyubka, and is licensed under an "MIT" license.

-

What sort of project is this ? (re: - contributions)
-

- This is essentially my private project, that I've made available - under GNU licensing conditions. Because I license my code under - other licenses as well, there is a limit to what I will accept in - the way of code contributions back into this project. For me to - accept contributions into the distribution, it either has to a - non-core (side) project, or has to be offered to me with copyright - conditions that are compatible with my other uses (i.e.. a "BSD" - like license, or assigning or licensing the copyright to me), or has - to be so trivial (say a one line bug fix), that it can't be the - subject of copyright.
-
- Of course there is nothing to stop someone setting up a real free - software, community project based on the GNU licensed code made - available here, that would be able to take GNU licensed - contributions from everyone and would essentially be a "fork" of - this code base.
-
-

Compiling

- How to build the software from the - source if you want to.
- Note that you don't need to - do this if you are using one of the binary installations.
-

Installing

- Important notes on installing the binary - software on various platforms.
-
-

Graphic - User Interfaces
-

- ArgyllCMS does not directly support a graphic user interface, but - several people have written GUI - based front ends for it. A popular front -end -that -supports -display -calibration @@ -1030,22 +911,27 @@ calibration + + [The Spyder 1 has also been reported as working, but this has not + been confirmed.]
+      Spyder 3 +                    +            +        - display colorimeter.
+      Spyder 4 +                    +            +        - display colorimeter (Note + that the user must supply calibration + data)
+
+ Other:
+     Colorimètre HCFR                          - and profiling is dispcalGUI - by Florian Höch. Others can be found with a suitable search.
-

Main - Tools and the command line
-

- These are all command line ("DOS" shell) tools, and each tool - require appropriate options to be set, followed by filename - arguments. Sometimes the filenames will have to include the usual - extensions, sometimes they are implicit. To get a brief listing of - the possible arguments and usage - of any of the tools, run it with just an "-?" argument, i.e. targen @@ -1084,23 +970,6 @@ href="http://www.google.com/search?hl=en&source=hp&q=argyllcms+GUI&a - -? (or some other unrecognized flag, if the "?" character is - treated specially in your shell, i.e. try "--" on OS X zsh).
-
- Note that in general the arguments consist of possible flags or - options followed by file name arguments. All arguments need to be - separated by whitespace.  (If you need to specify a string with - embedded white space, double quote the string). A flag consists of a - dash attached to a single letter, the letter identifying the flag, - and is usually case sensitive. An option is a flag that has an - associated parameter or parameters. The parameter can be separated - from the flag by white space, or may come directly after the flag. - So if a tool has a usage that looks like this:
-
-   tool -?
-   usage: tool [options] infile outfile
-    - -v                   @@ -1119,6 +988,9 @@ href="http://www.google.com/search?hl=en&source=hp&q=argyllcms+GUI&a + + - display colorimeter
+     ColorHug                                       @@ -1141,9 +1013,6 @@ href="http://www.google.com/search?hl=en&source=hp&q=argyllcms+GUI&a - Verbose mode
-    -d - n                @@ -1167,6 +1036,104 @@ href="http://www.google.com/search?hl=en&source=hp&q=argyllcms+GUI&a + + - display colorimeter
+
+ See Operation of particular + instruments for more instrument specific detail.
+
+ Other instruments can be supported indirectly, since patch result + files created by other packages can be imported into Argyll.
+
+ Please note the installation instructions for + each platform - they contain important information for getting your + instruments working.
+

If you've decided to buy a color instrument because Argyll + supports it, please let the dealer and manufacturer know that "You bought it because Argyll CMS + supports it" - thanks.
+

+

Please note that instruments are + being driven by ArgyllCMS drivers, and that any problems or + queries regarding instrument
+ operation should be + directed to the Argyll's author(s) or the Argyll mailing list, + and not to any other + party.

+

There is a list of contributed ccmx (Colorimeter Correction + Matrix) files for some display/colorimeter combinations.

+

Copyright and Licensing:
+

+

Most of the source code and provided executable files are + copyrighted works, licensed under the Affero GNU Version 3 license, and therefore they + (or works derived from them) can't be copied, sold or made + available to users interacting with them remotely through a + computer network, without providing the source code. Nothing other + than your agreement and compliance with the Affero GNU License + grants you permission to use, modify or distribute Argyll source + code, executables or its derivative works. You could be sued for + copyright infringement if you use or distribute Argyll without a + valid license. The Affero GNU + license prohibits + extending these tools + (i.e. by combining them with other programs or scripts that make + use of, depend on, or work with the Argyll code) and distributing + them, unless the all the elements of the extensions are also made + available under a GPL compatible license. It is permissible to + provide Argyll tools with other non GPL components if the elements + of the package are not related, such that the packaging is mere + aggregation. For all the gory details, please read the + accompanying license.

+ Note that unlike many commercial ICC profiling tools, the profiles + created using Argyll, are not subject to any claims or restrictions + of Argyll's author(s), but are assumed to be the copyright property + of the person who gathers the characterization data, and causes the + profiles to be created. +

The Argyll CMS is Copyright 1995 - 2013 Graeme W. Gill, and is + made available under the terms of the Affero GNU General Public + License Version 3, as detailed in the License.txt + file. Documentation is licensed under the terms of the GNU Free + Documentation License, Version 1.3. The author asserts his moral + rights over this material in relationship to the attribution and + integrity of these works. In particular, if these works are + modified in a way that materially changes their functionality, + then the modified works should be renamed in a way that clearly + distinguishes them from "Argyll" or "ArgyllCMS" so that the + effects of such changes do not reflect on the original works + integrity or the original authors reputation. A subset of files + (those that are related to the color instrument drivers, and are + collected together into the instlib.zip archive by the + spectro/instlib.ksh script + xicc/ccmx.h and xicc/ccmx.c) are + licensed under the General Public License Version 2 or later, as + detailed in the License2.txt file.
+

+

Portions of the ColorHug instrument library + (spectro/colorhug.[ch]) are Copyright 2011, Richard Hughes, and is + licensed under the General Public License Version 2 or later, as + detailed in the License2.txt file.

+

The tool spectro/spec2cie.c is Copyright 2005 Gerhard Fuernkranz, + and is made available under the terms of the GNU General Public + License Version 2 or later, and is licensed here under the Version + 3 license, as detailed in the License3.txt + file.
+

+

The Win32 USB library libusb-win32 kernel drivers are included in + this distribution in the usb/driver and usb/bin directories, and + are copyright Stephan Meyer and Travis Robinson, and are licensed + under the GNU Version 2 or later (the drivers, services, + installer). See  usb/driver/License.txt, + libusbw/COPYING_LGPL.txt and libusbw/COPYING_GPL.txt for details. + Additional terms noted on the website + are "This license combination explicitly allows the use of this + library in commercial, non-Open-Source applications."
+

+

The icc library in icc/, + the CGATS library in cgats/, @@ -1184,9 +1151,6 @@ href="http://www.google.com/search?hl=en&source=hp&q=argyllcms+GUI&a - Choose a depth 0-4
-    -r -                   @@ -1227,15 +1191,11 @@ href="http://www.google.com/search?hl=en&source=hp&q=argyllcms+GUI&a - Use a random depth
-    -f - [nn]            - Use full range. nn optional range 0 - 100.
-    -M -                  + + the jcnf library in jcnf/, @@ -1273,9 +1233,6 @@ href="http://www.google.com/search?hl=en&source=hp&q=argyllcms+GUI&a - Manual
-    infile -                @@ -1298,6 +1255,79 @@ href="http://www.google.com/search?hl=en&source=hp&q=argyllcms+GUI&a + + the files spectro/xdg_bds.*, + spectro/aglob.* and the + ucmm library in ucmm/ are + Copyright 1995 - 2011 Graeme W. Gill, and available according to + the "MIT" license granted in the icc/License.txt and + cgats/License.txt files, and the licenses at the top of + ucmm/ucmm.c and jcnf/jcnf.c.
+

+

The yajl library in jcnf/yajl + is Copyright 2007-2009, Lloyd Hilaiel and is licensed according to + the Berkeley-style License granted in the jcnf/yajl/COPYING files. + The yajl library has been repackaged and modified slightly for + convenience.
+

+

The TIFF library included in this distribution for convenience, + has its own copyright and license detailed in tiff/COPYRIGHT (an + "MIT"/"BSD" like license).
+

+

The Independent JPEG Group's JPEG library included in this + distribution for convenience, has its own copyright and license + detailed in jpg/README (an "MIT"/"BSD" like license). Executables + that include JPEG format support are based in part on the work of + the Independent JPEG Group.

+

xicc/iccjpeg.h and xicc/iccjpeg.c are from lcms and they are Copyright + (c) 1998-2010 Marti Maria Saguer and is licensed under an + "MIT"/"BSD" like license. See the top of the iccjpeg.c file for + the detailed copyright and licensing conditions.
+

+

The mongoose web server software is Copyright (c) 2004-2011 + Sergey Lyubka, and is licensed under an "MIT" license.

+

What sort of project is this ? (re: + contributions)
+

+ This is essentially my private project, that I've made available + under GNU licensing conditions. Because I license my code under + other licenses as well, there is a limit to what I will accept in + the way of code contributions back into this project. For me to + accept contributions into the distribution, it either has to a + non-core (side) project, or has to be offered to me with copyright + conditions that are compatible with my other uses (i.e.. a "BSD" + like license, or assigning or licensing the copyright to me), or has + to be so trivial (say a one line bug fix), that it can't be the + subject of copyright.
+
+ Of course there is nothing to stop someone setting up a real free + software, community project based on the GNU licensed code made + available here, that would be able to take GNU licensed + contributions from everyone and would essentially be a "fork" of + this code base.
+
+

Compiling

+ How to build the software from the + source if you want to.
+ Note that you don't need to + do this if you are using one of the binary installations.
+

Installing

+ Important notes on installing the binary + software on various platforms.
+
+

Graphic + User Interfaces
+

+ ArgyllCMS does not directly support a graphic user interface, but + several people have written GUI + based front ends for it. A popular front +end +that +supports +display +calibration @@ -1316,154 +1346,6 @@ href="http://www.google.com/search?hl=en&source=hp&q=argyllcms+GUI&a - Input file
-    outfile -             - Output file
-
- then there are  5 flags/options, and two filename arguments. - Notice that square braces [] denote optional items. The first - flag/option is a flag. The second is an option that has a numerical - argument in the range 0 to 4. The third is a flag. the fourth is an - option with an optional argument. The fourth is a flag.  The - flags and options can generally be in any order, but must be before - the file name arguments. (For a few special tools you actually - specify a sequence of flags and files where the flags apply just to - the following file.) So example invocations may look like:
-
-   tool -v testin testout
-   tool -d3 -M testin1 testout2
-   tool -f infile outfile
-   tool -f 45 infile outfile
-   tool -d 3 -f67 infile outfile
-

In order to make use of the tools, it is necessary to keep track - of where various files are, and what they are called. There are - many possible ways of doing this. One way is to put each source - profile and all its associated files (test charts, spectrometer - values etc.) in one set of directories for each source profile - type. Similarly the device profiles could be stored in a hierarchy - of directories ordered by device type, media, resolution, device - mode etc. Naturally you will want to set your $PATH so that you - can run the tools from whichever directory you are in, as well as - specify any necessary directory paths for file arguments so that - the tools are able to open them.
-

-

Note that there are two ways the Argyll tools deal with filename - extensions. In one you supply the extension (ie. you supply the - whole file name), so the extension is up to you. In the other - (used where one name is used for input and output files, or where - there are multiple output files), the program adds the extension. - In the documentation this should be indicated by calling it a - "base name".
-

-

For more information on using a command - line environments, consult an appropriate tutorial:

-

MS Windows :
-    <http://www.bleepingcomputer.com/tutorials/tutorial76.html>
-    <http://www.pcstats.com/articleview.cfm?articleid=1723&page=1>
-    <http://www.voidspace.org.uk/python/articles/command_line.shtml>
-
-     To find more: <http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial>
-
- OS X:
-     <http://www.osxfaq.com/Tutorials/LearningCenter/>
-     <http://www.atomiclearning.com/macosxterminalx.shtml>
-     <http://www.oreillynet.com/pub/a/mac/2001/12/14/terminal_one.html>
-
-     To find more: <http://www.google.com/search?hl=en&q=OS+X+shell+tutorial>
-
- Linux:
-     <http://www.linuxcommand.org/index.php>
-     <http://www.tuxfiles.org/linuxhelp/shell.html>
-     <http://www.ee.surrey.ac.uk/Teaching/Unix/>
-
-     To find more: <http://www.google.com/search?q=linux+command+line+shell+tutorial>

-


- Note that since OS X is - based on UNIX, there is much in common between the OS X and Linux - command line environments, and many of the UNIX tutorials may be - useful:
-

-

    <http://www.rain.org/~mkummel/unix.html>
-
-

-

Tutorial: Typical usage scenarios - and examples

- A guided tour of the major tools, - applied to typical CMS jobs, such as calibrating displays, creating - device profiles, calibrating printers, linking profiles, and - converting color spaces of raster files.
-
- Although it is is a couple of years old now, this tutorial - may also be of interest.
-  
-

Topical - Discussions

- Discussions about particular topics:
-
- About Fluorescent Whitening Agent compensation
-
- Operation of particular instruments
-
- About ICC profiles and Gamut Mapping
-
- About display monitor settings and - targets
-
- About display "Gamma"
-
- What's the difference between Calibration - and Characterization ?
-
- Why doesn't my Colorimeter work - well on my Wide Gamut display ?
-
- My blacks get crushed on my - display - why ? How do I fix it ?
-
- How can I have confidence in the i1pro - Driver ?
-
- Evaluating input targets
-
-

Flow - diagram of Major Tools:

-
-           Thumbnail of Flow Diagram
-
-

Main Tools by - category:

-

Calibrating devices
-

- dispcal -       Adjust, - calibrate and profile a display.
- printcal      Create a - printer calibration .cal file from a .ti3 data file.
-

Creating test targets for profiling or print calibration
-

- targen        @@ -1504,12 +1386,21 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Generate a profiling test target values .ti1 file.
- filmtarg      Create + + and profiling is dispcalGUI + by Florian Höch. Others can be found with a suitable search.
+

Main + Tools and the command line
+

+ These are all command line ("DOS" shell) tools, and each tool + require appropriate options to be set, followed by filename + arguments. Sometimes the filenames will have to include the usual + extensions, sometimes they are implicit. To get a brief listing of + the possible arguments and usage + of any of the tools, run it with just an "-?" argument, i.e. targen @@ -1548,10 +1439,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - film recorder TIFF files from Argyll .ti1 file.
- printtarg     Create @@ -1572,6 +1459,24 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + -? (or some other unrecognized flag, if the "?" character is + treated specially in your shell, i.e. try "--" on OS X zsh).
+
+ Note that in general the arguments consist of possible flags or + options followed by file name arguments. All arguments need to be + separated by whitespace.  (If you need to specify a string with + embedded white space, double quote the string). A flag consists of a + dash attached to a single letter, the letter identifying the flag, + and is usually case sensitive. An option is a flag that has an + associated parameter or parameters. The parameter can be separated + from the flag by white space, or may come directly after the flag. + So if a tool has a usage that looks like this:
+
+   tool -?
+   usage: tool [options] infile outfile
+    + -v                   @@ -1592,12 +1497,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a PS, EPS or TIFF file containing test patch values, ready for - printing. -

Obtaining test results for profiling or print calibration
-

- chartread     Read @@ -1638,11 +1537,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a test chart using an instrument to create a .ti3 data file.
- dispread      Test + + Verbose mode
+    -d + n                @@ -1683,10 +1581,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - and read colorimetric values from a display
- filmread      Read @@ -1707,6 +1601,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Choose a depth 0-4
+    -r +                   @@ -1727,10 +1625,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - film colorimetric values using a SpectroScanT (Deprecated ?)
- scanin        @@ -1771,15 +1665,13 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Convert a TIFF  image of a test chart into .ti3 - device values.
- illumread     Use an - instrument to measure an illuminant spectrum, and estimate its UV - content.
- fakeread      Fake + + Use a random depth
+    -f + [nn]            + Use full range. nn optional range 0 - 100.
+    -M +                  @@ -1820,14 +1712,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - the reading of a device using an ICC or MPP profile.
- synthread     Fake the - reading of a device using a synthetic device model.
- cb2ti3        @@ -1848,6 +1732,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Manual
+    infile +                @@ -1868,11 +1756,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Convert Colorblind format CMY/RGB test chart into - Argyll .ti3 CGATS format.
- kodak2ti3     Convert @@ -1913,10 +1796,158 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Kodak Colorflow format CMYK test chart into Argyll .ti3 CGATS - format.
- txt2ti3       + + Input file
+    outfile +             + Output file
+
+ then there are  5 flags/options, and two filename arguments. + Notice that square braces [] denote optional items. The first + flag/option is a flag. The second is an option that has a numerical + argument in the range 0 to 4. The third is a flag. the fourth is an + option with an optional argument. The fourth is a flag.  The + flags and options can generally be in any order, but must be before + the file name arguments. (For a few special tools you actually + specify a sequence of flags and files where the flags apply just to + the following file.) So example invocations may look like:
+
+   tool -v testin testout
+   tool -d3 -M testin1 testout2
+   tool -f infile outfile
+   tool -f 45 infile outfile
+   tool -d 3 -f67 infile outfile
+

In order to make use of the tools, it is necessary to keep track + of where various files are, and what they are called. There are + many possible ways of doing this. One way is to put each source + profile and all its associated files (test charts, spectrometer + values etc.) in one set of directories for each source profile + type. Similarly the device profiles could be stored in a hierarchy + of directories ordered by device type, media, resolution, device + mode etc. Naturally you will want to set your $PATH so that you + can run the tools from whichever directory you are in, as well as + specify any necessary directory paths for file arguments so that + the tools are able to open them.
+

+

Note that there are two ways the Argyll tools deal with filename + extensions. In one you supply the extension (ie. you supply the + whole file name), so the extension is up to you. In the other + (used where one name is used for input and output files, or where + there are multiple output files), the program adds the extension. + In the documentation this should be indicated by calling it a + "base name".
+

+

For more information on using a command + line environments, consult an appropriate tutorial:

+

MS Windows :
+    <http://www.bleepingcomputer.com/tutorials/tutorial76.html>
+    <http://www.pcstats.com/articleview.cfm?articleid=1723&page=1>
+    <http://www.voidspace.org.uk/python/articles/command_line.shtml>
+
+     To find more: <http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial>
+
+ OS X:
+     <http://www.osxfaq.com/Tutorials/LearningCenter/>
+     <http://www.atomiclearning.com/macosxterminalx.shtml>
+     <http://www.oreillynet.com/pub/a/mac/2001/12/14/terminal_one.html>
+
+     To find more: <http://www.google.com/search?hl=en&q=OS+X+shell+tutorial>
+
+ Linux:
+     <http://www.linuxcommand.org/index.php>
+     <http://www.tuxfiles.org/linuxhelp/shell.html>
+     <http://www.ee.surrey.ac.uk/Teaching/Unix/>
+
+     To find more: <http://www.google.com/search?q=linux+command+line+shell+tutorial>

+


+ Note that since OS X is + based on UNIX, there is much in common between the OS X and Linux + command line environments, and many of the UNIX tutorials may be + useful:
+

+

    <http://www.rain.org/~mkummel/unix.html>
+
+

+

Tutorial: Typical usage scenarios + and examples

+ A guided tour of the major tools, + applied to typical CMS jobs, such as calibrating displays, creating + device profiles, calibrating printers, linking profiles, and + converting color spaces of raster files.
+
+ Although it is is a couple of years old now, this tutorial + may also be of interest.
+  
+

Topical + Discussions

+ Discussions about particular topics:
+
+ About Fluorescent Whitening Agent compensation
+
+ Operation of particular instruments
+
+ About ICC profiles and Gamut Mapping
+
+ About display monitor settings and + targets
+
+ About display "Gamma"
+
+ What's the difference between Calibration + and Characterization ?
+
+ Why doesn't my Colorimeter work + well on my Wide Gamut display ?
+
+ My blacks get crushed on my + display - why ? How do I fix it ?
+
+ How can I have confidence in the i1pro + Driver ?
+
+ Does the i1pro High Resolution mode + improve accuracy ?
+
+ Evaluating input targets
+
+

Flow + diagram of Major Tools:

+
+           Thumbnail of Flow Diagram
+
+

Main Tools by + category:

+

Calibrating devices
+

+ dispcal +       Adjust, + calibrate and profile a display.
+ printcal      Create a + printer calibration .cal file from a .ti3 data file.
+

Creating test targets for profiling or print calibration
+

+ targen        @@ -1957,11 +1988,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Convert Gretag/Logo/X-Rite or other format RGB or CMYK - test chart results into Argyll .ti3 CGATS format.
- fakeCMY       @@ -1982,6 +2008,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Generate a profiling test target values .ti1 file.
+ filmtarg      Create @@ -2002,11 +2033,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Create a fake Argyll .ti3 CMY data file from a CMYK - profile, as a basis of creating a CMY to CMYK separation
- average       Average @@ -2046,11 +2072,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - / Merge two measurement data files
-

Creating Device Profiles

- colprof       + + film recorder TIFF files from Argyll .ti1 file.
+ printtarg     Create @@ -2090,9 +2117,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Create an ICC profile from the .ti3 test data.
- mppprof       @@ -2114,6 +2138,13 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + a PS, EPS or TIFF file containing test patch values, ready for + printing. +

Obtaining test results for profiling or print calibration
+

+ chartread     Read @@ -2133,10 +2164,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Create a Model Printer Profile (MPP) from the .ti3 - test data.
- revfix        @@ -2177,12 +2204,13 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Regenerate a device profiles B2A table data by - inverting the A2B table. -

Creating Device Link Profiles

- collink       + + a test chart using an instrument to create a .ti3 data file.
+ dispread      Test @@ -2222,12 +2250,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Link two device ICC profiles to create a device - link profile. -

Converting colors or applying print calibration
-

- cctiff        @@ -2249,6 +2271,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + and read colorimetric values from a display
+ filmread      Read @@ -2268,11 +2295,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Color convert a TIFF or JPEG file using a sequence - of ICC device, device link, abstract profiles and calibration files. -
- applycal      Apply @@ -2312,8 +2334,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - calibration curves to an ICC profile.
- icclu 
+ scanin        @@ -2355,10 +2381,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Lookup individual color values through any ICC - profile table.
- xicclu        @@ -2379,6 +2401,16 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Convert a TIFF  image of a test chart into .ti3 + device values.
+ illumread     Use an + instrument to measure an illuminant spectrum, and estimate its UV + content.
+ fakeread      Fake @@ -2399,10 +2431,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Lookup individual color values forward or inverted - though an ICC profile table.
- mpplu         @@ -2443,10 +2471,15 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Lookup individual color values though an MPP - profile. Also create MPP gamut files/views.
- greytiff      Convert + + the reading of a device using an ICC or MPP profile.
+ synthread     Fake the + reading of a device using a synthetic device model.
+ cb2ti3        @@ -2487,18 +2520,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a TIFF file to monochrome using an ICC device profile
-

Color Tweaking tools
-

- refine -        Creates an - abstract profile from two chart readings, useful for refining - proofing profiles.
- -

Creating gamut views

- iccgamut      Create @@ -2519,6 +2540,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Convert Colorblind format CMY/RGB test chart into + Argyll .ti3 CGATS format.
+ kodak2ti3     Convert @@ -2539,9 +2566,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a gamut file or VRML file of the color gamut of an ICC profile.
- tiffgamut     Create @@ -2582,9 +2606,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a gamut file or VRML file of the color gamut of a TIFF or JPEG - image.
- viewgam
+ txt2ti3       @@ -2626,12 +2651,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Convert one or more gamuts into a VRML 3D - visualization file. Compute an intersection.
-

Diagnostic and test tools
-

- iccdump       @@ -2652,6 +2671,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Convert Gretag/Logo/X-Rite or other format RGB or CMYK + test chart results into Argyll .ti3 CGATS format.
+ fakeCMY       @@ -2672,9 +2697,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Dump the contents of an ICC profile as text.
- profcheck     Check @@ -2715,8 +2737,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - an ICC profile against .ti3 test chart data.
- invprofcheck  + + Create a fake Argyll .ti3 CMY data file from a CMYK + profile, as a basis of creating a CMY to CMYK separation
+ average       Average @@ -2757,9 +2783,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Check ICC forward against inverse lookup.
- splitsti3     Split @@ -2779,6 +2802,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + / Merge two measurement data files
+

Creating Device Profiles

+ colprof       @@ -2799,13 +2827,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a CGATS file (ie. a .ti3) into two parts randomly to verify - profiling.
- timage -        Create TIFF test - images.
- mppcheck      Check @@ -2846,9 +2867,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - an MPP profile against .ti3 test chart data.
- spotread      Use + + Create an ICC profile from the .ti3 test data.
+ mppprof       @@ -2888,14 +2910,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - an instrument to read a single spot color value.
- verify -        Verify - matching of CIE in two CGATS/.ti3 files (also view differences as - VRML)
- synthcal      Create @@ -2917,6 +2931,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Create a Model Printer Profile (MPP) from the .ti3 + test data.
+ revfix        @@ -2935,11 +2954,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a synthetic input, display or output calibration (.cal)file. -

Other Tools

- ccxxmake      Use @@ -2979,15 +2993,15 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a Spectrometer to create a Colorimeter Correction Matrix - (CCMX)  or a Colorimeter Calibration Spectral Set (CCSS)  - for a particular display.
- extracticc    Extract + + Regenerate a device profiles B2A table data by + inverting the A2B table. +

Creating Device Link Profiles

+ collink       @@ -3025,15 +3039,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - an embedded ICC profile from a TIFF or JPEG file.
- extractttag   Extract a text tag (ie. CGATS - .ti3 data or CAL) from an ICC profile.
- dispwin       Install @@ -3057,6 +3062,14 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Link two device ICC profiles to create a device + link profile. +

Converting colors or applying print calibration
+

+ cctiff        + @@ -3074,16 +3087,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - or uninstall display profile, set display calibration from profile - or .cal file, test displace and dispwin access to a display.
- oeminst       - Install Instrument manufacturers files for the - Spyder 2, EDR or CCSS calibration files for i1d3 or Spyder 4,  - CCMX files for colorimeters.
- specplot       @@ -3124,12 +3127,14 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Plot a spectrum (.sp, .cmf, .ccss) and calculate CCT and VCT.
- spec2cie      Convert + + Color convert a TIFF or JPEG file using a sequence + of ICC device, device link, abstract profiles and calibration files. +
+ applycal      Apply @@ -3168,14 +3173,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - spectral .ti3 readings into CIE XYZ or L*a*b* readings. Apply FWA, - plot spectrums.
-   -

Main Tools - Alphabetic Listing:

- applycal      Apply @@ -3197,6 +3194,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + calibration curves to an ICC profile.
+ icclu         + + @@ -3215,9 +3218,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - calibration curves to an ICC profile.
- average       @@ -3258,8 +3258,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Average / Merge two measurement data files
- cb2ti3Lookup individual color values through any ICC + profile table.
+ xicclu        @@ -3301,10 +3303,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Convert Colorblind format CMY/RGB test chart into - Argyll .ti3 CGATS format.
- cctiff        @@ -3325,6 +3323,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Lookup individual color values forward or inverted + though an ICC profile or CAL table.
+ mpplu         @@ -3345,10 +3348,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Color convert a TIFF or JPEG file using a sequence - of ICC device, device link, abstract profiles and calibration files.
- ccxxmake      Use @@ -3388,12 +3387,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a Spectrometer to create a Colorimeter Correction Matrix - (CCMX)  or a Colorimeter Calibration Spectral Set (CCSS)  - for a particular display.
- chartread     Read + + Lookup individual color values though an MPP + profile. Also create MPP gamut files/views.
+ greytiff      Convert @@ -3433,9 +3432,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a test chart using an instrument to create a .ti3 data file.
- collink       @@ -3457,6 +3453,19 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + a TIFF file to monochrome using an ICC device profile
+

Color Tweaking tools
+

+ refine +        Creates an + abstract profile from two chart readings, useful for refining + proofing profiles.
+ +

Creating gamut views

+ iccgamut      Create @@ -3476,10 +3485,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Link two device ICC profiles to create a device - link profile.
- colprof       @@ -3520,12 +3525,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Create an ICC profile from the .ti3 test data.
- dispcal -       Adjust, calibrate and - profile a display.
- dispread      Test + + + a gamut file or VRML file of the color gamut of an ICC profile.
+ tiffgamut     Create @@ -3566,10 +3570,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - and read colorimetric values from a display
- dispwin       Install @@ -3590,6 +3590,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + a gamut file or VRML file of the color gamut of a TIFF or JPEG + image.
+ viewgam       @@ -3610,11 +3615,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - or uninstall display profile, set display calibration from profile - or .cal file, test displace and dispwin access to a display.
- extracticc    Extract @@ -3655,13 +3655,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - an embedded ICC profile from a TIFF or JPEG file.
- extractttag   Extract a text tag (ie. CGATS - .ti3 data or CAL) from an ICC profile.
- fakeCMYConvert one or more gamuts into a VRML 3D + visualization file. Compute an intersection.
+

Diagnostic and test tools
+

+ iccdump       @@ -3703,10 +3702,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Create a fake Argyll .ti3 CMY data file from a CMYK - profile, as a basis of creating a CMY to CMYK separation
- fakeread      Fake @@ -3727,6 +3722,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Dump the contents of an ICC profile as text.
+ profcheck     Check @@ -3747,9 +3746,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - the reading of a device using an ICC or MPP profile.
- filmread      Read @@ -3790,9 +3786,9 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - film colorimetric values using a SpectroScanT (Deprecated ?)
- filmtarg      Create + + an ICC profile against .ti3 test chart data.
+ invprofcheck  @@ -3833,9 +3829,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - film recorder TIFF files from Argyll .ti1 file.
- greytiff      Convert @@ -3856,6 +3849,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Check ICC forward against inverse lookup.
+ splitsti3     Split @@ -3876,10 +3873,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a TIFF file to monochrome using an ICC device profile
- iccdump       @@ -3919,10 +3912,15 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + a CGATS file (ie. a .ti3) into two parts randomly to verify + profiling.
+ timage +        Create TIFF test + images.
+ mppcheck      Check - Dump the contents of an ICC profile as text.
- iccgamut      Create @@ -3963,9 +3961,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a gamut file or VRML file of the color gamut of an ICC profile.
- icclu         @@ -3985,6 +3980,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + an MPP profile against .ti3 test chart data.
+ spotread      Use @@ -4006,10 +4005,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Lookup individual color values through any ICC - profile table.
- illumread     Use @@ -4048,16 +4043,18 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + an instrument to read a single spot color value.
+ colverify     Verify - an instrument to measure an illuminant spectrum, and estimate its UV - content.
- invprofcheck  Check ICC - forward against inverse lookup.
- kodak2ti3     Convert + + matching of CIE in two CGATS/.ti3 files (also view differences as + VRML)
+ synthcal      Create @@ -4096,10 +4093,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Kodak Colorflow format CMYK test chart into Argyll .ti3 CGATS - format.
- mppcheck      Check @@ -4121,6 +4114,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + a synthetic input, display or output calibration (.cal)file. +

Other Tools

+ ccxxmake      Use @@ -4140,9 +4139,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - an MPP profile against .ti3 test chart data.
- mpplu         @@ -4183,10 +4179,14 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Lookup individual color values though an MPP - profile. Also create MPP gamut files/views.
- mppprof       + + a Spectrometer to create a Colorimeter Correction Matrix + (CCMX)  or a Colorimeter Calibration Spectral Set (CCSS)  + for a particular display.
+ extracticc    Extract + @@ -4227,16 +4227,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Create a Model Printer Profile (MPP) from the .ti3 - test data.
- oeminst       - Install Instrument manufacturers files for the - Spyder 2, EDR or CCSS calibration files for i1d3 or Spyder 4,  - CCMX files for colorimeters.
- printcal      Create @@ -4256,6 +4246,16 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + an embedded ICC profile from a TIFF or JPEG file.
+ extractttag   Extract a text tag (ie. CGATS + .ti3 data or CAL) from an ICC profile.
+ dispwin       Install @@ -4276,9 +4276,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a printer calibration .cal file from a .ti3 data file.
- printtarg     Create @@ -4319,10 +4316,17 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a PS, EPS or TIFF file containing test patch values, ready for - printing.
- profcheck     Check + + or uninstall display profile, set display calibration from profile + or .cal file, test displace and dispwin access to a display.
+ oeminst       + Install Instrument manufacturers files for the + Spyder 2, EDR or CCSS calibration files for i1d3 or Spyder 4,  + CCMX files for colorimeters.
+ specplot       @@ -4363,14 +4367,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - an ICC profile against .ti3 test chart data.
- refine -        Creates an - abstract profile from two chart readings, useful for refining - proofing profiles.
- revfix        @@ -4391,6 +4387,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Plot a spectrum (.sp, .cmf, .ccss) and calculate CCT and VCT.
+ spec2cie      Convert @@ -4411,10 +4412,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Regenerate a device profiles B2A table data by - inverting the A2B table.
- scanin        @@ -4455,11 +4452,15 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Convert a TIFF  image of a test chart into - .ti3 device values.
- spec2cie      Convert + + spectral .ti3 readings into CIE XYZ or L*a*b* readings. Apply FWA, + plot spectrums.
+   +

Main Tools + Alphabetic Listing:

+ applycal      Apply @@ -4500,11 +4501,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - spectral .ti3 readings into CIE XYZ or L*a*b* readings. Apply FWA, - plot spectrums.
- specplot       @@ -4524,6 +4520,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + calibration curves to an ICC profile.
+ average       @@ -4545,9 +4545,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Plot a spectrum (.sp, .cmf, .ccss) and calculate CCT and VCT.
- splitsti3     Split @@ -4587,10 +4584,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a CGATS file (ie. a .ti3) into two parts randomly to verify - profiling.
- spotread      Use + + Average / Merge two measurement data files
+ cb2ti3        @@ -4630,10 +4627,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - an instrument to read a single spot color value.
- synthcal      Create @@ -4655,6 +4648,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Convert Colorblind format CMY/RGB test chart into + Argyll .ti3 CGATS format.
+ cctiff        @@ -4673,10 +4671,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a synthetic input, display or output calibration (.cal)file.
- synthread     Fake @@ -4717,11 +4711,13 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - the reading of a device using a synthetic device model.
- targen        + + Color convert a TIFF or JPEG file using a sequence + of ICC device, device link, abstract profiles and calibration files.
+ ccxxmake      Use @@ -4760,10 +4756,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Generate a profiling test target values .ti1 file. -
- tiffgamut     Create @@ -4785,6 +4777,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + a Spectrometer to create a Colorimeter Correction Matrix + (CCMX)  or a Colorimeter Calibration Spectral Set (CCSS)  + for a particular display.
+ chartread     Read @@ -4804,14 +4802,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - a gamut file or VRML file of the color gamut of a TIFF or JPEG - image.
- timage -        Create TIFF - test images.
- txt2ti3       @@ -4852,13 +4842,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Convert Gretag/Logo/X-Rite or other - format RGB or CMYK test chart results into Argyll .ti3 CGATS - format.
- verify        Verify + + a test chart using an instrument to create a .ti3 data file.
+ collink       @@ -4898,11 +4886,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - matching of CIE in two CGATS/.ti3 files (also view differences as - VRML)
- viewgam       Convert @@ -4924,6 +4907,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Link two device ICC profiles to create a device + link profile.
+ colprof       @@ -4942,10 +4930,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - one or more gamuts into a VRML 3D visualization file. Compute an - intersection.
- xicclu        @@ -4986,39 +4970,13 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Lookup individual color values forward or inverted - though an ICC profile table.
-
-

Environment Variables
-

- Performance/memory tuning hints, plus - tweaks for scipting.
-

Performance Tuning
-

- Performance hints.
-

Overview

- Overview of the software and its aims and functionality.
-

Limitations

- Limitations of the current functionality.
-

Organization

- How directories are organized, what they contain. -

Source

- Any detailed documentation on how the software works, or what - algorithms it is based on. (Very incomplete.) -

Minor Tools

- A very brief description of minor tools and test harnesses.
-
-
-

File - formats that Argyll uses

- Argyll uses a number of file formats for its operation, some that - are external standards, and some that are unique to Argyll.
-
- .ti1            + + Create an ICC profile from the .ti3 test data.
+ colverify     Verify @@ -5057,8 +5015,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Device test values
- .ti2            @@ -5081,6 +5037,14 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + matching of CIE in two CGATS/.ti3 files (also view differences as + VRML)
+ dispcal +       Adjust, calibrate and + profile a display.
+ dispread      Test @@ -5099,8 +5063,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Device test values & chart layout
- .ti3            @@ -5141,14 +5103,13 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Device test values & CIE tristimulus/spectral results  Format details.
- .cal -            Device - calibration information. Format details.
- .cht           + + and read colorimetric values from a display
+ dispwin       Install @@ -5187,9 +5148,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Test chart recognition template. Format - details.
- .gam         @@ -5212,6 +5170,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + or uninstall display profile, set display calibration from profile + or .cal file, test displace and dispwin access to a display.
+ extracticc    Extract @@ -5230,8 +5194,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - 3D gamut surface description
- .sp            @@ -5272,15 +5234,17 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Illuminant spectral description
- .ccmx -        Colorimeter Correction Matrix
- .ccss -         Colorimeter Calibration - Spectral Set
- CGATS      + + an embedded ICC profile from a TIFF or JPEG file.
+ extractttag   Extract a text tag (ie. CGATS + .ti3 data or CAL) from an ICC profile.
+ fakeCMY       @@ -5319,8 +5283,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Standard text based data exchange format
- ICC           @@ -5343,6 +5305,12 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + Create a fake Argyll .ti3 CMY data file from a CMYK + profile, as a basis of creating a CMY to CMYK separation
+ fakeread      Fake + @@ -5361,8 +5329,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - International Color Consortium profile format
- MPP          @@ -5403,9 +5369,11 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Model device profile format
- TIFF         + + the reading of a device using an ICC or MPP profile.
+ filmread      Read @@ -5445,8 +5413,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Tag Image File Format raster files.
- JPEG         @@ -5468,6 +5434,10 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> + + film colorimetric values using a SpectroScanT (Deprecated ?)
+ filmtarg      Create @@ -5487,9 +5457,6 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Joint Photographic Experts Group, JPEG File Interchange Format - raster files.
- VRML       @@ -5530,41 +5497,2474 @@ href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial"> - Virtual Reality Modelling Language 3D file format.
-
- ucmm       Unix micro - Color Management Module convention and configuration file format and - Profile - Locations.
-   -

Errors, Corrections and Omissions:

- If you notice any errors, corrections needed or omissions in - the current documentation, please contact the author.
-  
-   - - + + Virtual Reality Modelling Language 3D file format.
+
+ ucmm       Unix micro + Color Management Module convention and configuration file format and + Profile + Locations.
+   +

Errors, Corrections and Omissions:

+ If you notice any errors, corrections needed or omissions in + the current documentation, please contact the author.
+  
+   + + -- cgit v1.2.3