<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <meta name="author" content="Graeme Gill"> <meta name="description" content="Root of Argyll CMS documentation"> <meta name="GENERATOR" content="Mozilla/4.73 [en] (WinNT; I) [Netscape]"> <title>Argyll Documentation Top</title> </head> <body> <h1> Argyll CMS documentation index (V1.4.0)<br> </h1> Date: 20th April 2012<br> Author: Graeme Gill <h2><u><a name="Intro"></a>Introduction</u></h2> 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.<br> <p>This is Version 1.4.0, a bug fix and feature update to V1.3.7 released on 26th March 2012. The first public release of icclib was in November 1998, and of Argyll was in October 2000. Code development commenced in 1995. See <a href="ChangesSummary.html">Changes Summary</a> for an overview of changes since the last release. Changes between revisions is detailed in the <b>log.txt</b> file that accompanies the source code. </p> <p>The latest source code is available from <a href="http://www.argyllcms.com/">here</a>. </p> <p>Argyll is known to compile and run in at least nine environments: </p> 1) MSWindows 2K system using Microsoft VC++ 6.0 compiler<br> 2) MSWindows 2K system using Microsoft VC++ 8.0 Express compiler + Platform SDK Feb. 2003<br> 3) MSWindows 2K system using Microsoft VC++ 9.0 Express compiler + Platform SDK Feb. 2003<br> 4) MSWindows 2K system using the MingW port of the GCC compiler<br> 5) Linux on Fedora Core 8, 32 bit using gcc <br> 6) Linux on Fedora Core 8, 64 bit using gcc<br> 7) Apple OSX 10.3 PPC using gcc<br> 8) Apple OSX 10.4 Intel using gcc<br> 9) Apple OSX 10.5 Intel using gcc<br> <br> It is also known to run on:<br> <br> MSWindows 2000, XP, Vista & Windows 7 32 bit.<br> MSWindows Vista 64bit & Windows 7 64bit<br> Linux Ubuntu 7.10<br> Linux Kubuntu 7.10<br> Linux Mandriva 2008.0<br> Linux OpenSuSE 10.3<br> Linux Whitebox 4.2/2<br> Apple OSX 10.6 Intel<br> Apple OSX 10.7 Intel<br> <p>but may well compile and run correctly in many more than this. </p> This is a <span style="font-weight: bold;">command line terminal</span> 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 <a href="#cltutes">tutorials</a> below.<span style="font-weight: bold;"></span><br> <br> The following color measuring instruments are directly supported:<br> <br> X-Rite:<br> <a href="instruments.html#DTP20">DTP20 "Pulse"</a> - "swipe" type reflective spectrometer, that can be used untethered.<br> <a href="instruments.html#DTP22">DTP22 Digital Swatchbook</a> - spot type reflective spectrometer.<br> <a href="instruments.html#DTP41">DTP41</a> - spot and strip reading reflective spectrometer.<br> <a href="instruments.html#DTP41">DTP41T</a> - spot and strip reading reflective/transmissive spectrometer.<br> <a href="instruments.html#dtp51">DTP51</a> - strip reading reflective colorimeter.<br> <a href="instruments.html#DTP92">DTP92</a> - CRT display colorimeter.<br> <a href="instruments.html#DTP94">DTP94</a> <font size="-1">"Optix XR"</font> or "Optix XR2" or "Optix Pro"- display colorimeter.<br> <a href="instruments.html#ColorMunki"><span style="text-decoration: underline;">ColorMunki</span></a> Design or Photo - spot and "swipe" reflective/emissive spectrometer (UV cut only).<br> <a href="instruments.html#i1d"><span style="text-decoration: underline;">ColorMunki</span></a> Create - display colorimeter. (Treated as a Eye-One Display 2)<br> <a href="instruments.html#Huey">Lenovo W</a> - built in laptop Huey display colorimeter.<br> <a href="instruments.html#i1d3">Eye-One Display 3</a> - Xrite i1 DisplayPro and ColorMunki Display <br> [ The OEM i1Display Pro and<br> NEC SpectraSensor Pro are also reported to work.]<br> <br> Gretag-Macbeth (now X-Rite):<br> <a href="instruments.html#sl">Spectrolino</a> - spot reflective/emissive spectrometer.<br> <a href="instruments.html#ss">SpectroScan</a> - spot reflective/emissive, XY table reflective spectrometer .<br> <a href="instruments.html#ss">SpectroScanT</a> - spot reflective/emissive/transmissive, XY table reflective spectrometer.<br> <a href="instruments.html#i1p">Eye-One Pro</a> "EFI ES-1000" - spot and "swipe" reflective/emissive spectrometer.<br> <a href="instruments.html#i1m">Eye-One Monitor</a> - spot and "swipe" emissive spectrometer.<br> <a href="instruments.html#i1d">Eye-One Display 1 or 2 or LT</a> - display colorimeter.<br> <a href="instruments.html#i1d">HP DreamColor or APS</a> - display colorimeter. (Treated as a Eye-One Display 2)<br> <a href="instruments.html#i1d">CalMAN X2</a> - display colorimeter. (Treated as a Eye-One Display 2)<br> <a href="instruments.html#Huey">Huey</a> - display colorimeter.<br> <br> Sequel imaging (Now X-Rite):<br> <a href="instruments.html#mox">MonacoOPTIX</a> - display colorimeter (Treated as an Eye-One Display 1)<br> [The Sequel Chroma 4 may also work.]<br> <br> Lacie Blue Eye: - see <a href="instruments.html#i1d">Eye-One Display</a><br> <br> DataColor ColorVision:<br> <a href="instruments.html#spyd2">Spyder 2</a> - display colorimeter (Note that the user must <a href="spyd2en.html">supply</a> firmware)<br> [The Spyder 1 has also been reported as working, but this has not been confirmed.]<br> <a href="instruments.html#spyd3">Spyder 3</a> - display colorimeter.<br> <a href="instruments.html#spyd4">Spyder 4</a> - display colorimeter (Note that the user must <a href="spyd4en.html">supply</a> calibration data)<br> <br> Other:<br> <span class="titre"><a href="instruments.html#HCFR">Colorimètre HCFR</a> - display colorimeter (Not on MSWindows 64 bit)</span><br> <span style="font-weight: bold;"></span><span class="titre"><br> See </span><a href="instruments.html">Operation of particular instruments</a> for more instrument specific detail.<br> <br> <span style="font-weight: bold;">Please note that instruments are being driven by ArgyllCMS drivers, and that any problems or queries regarding instrument<br> operation </span><span style="font-weight: bold;">should be directed to the Argyll's author(s) or the Argyll mailing list, and not to any</span> <span style="font-weight: bold;">other party.</span><br> <br> <br> There is a <a href="ccmxs.html">list of contributed</a> <span style="font-weight: bold;">ccmx</span> (Colorimeter Correction Matrix) files for some display/colorimeter combinations.<br> <br> Other instruments can be supported indirectly, since patch result files created by other packages can be imported into Argyll.<br> <br> Please <span style="font-weight: bold;">note</span> the <a href="Installing.html">installation instructions</a> for each platform - they contain important information for getting your instruments working.<br> <p>If you've decided to buy a color instrument because Argyll supports it, please let the dealer and manufacturer know that "<span style="font-weight: bold;">You bought it because Argyll CMS supports it</span>" - thanks.<br> </p> <p><span style="font-weight: bold;">Please direct</span> any queries or problems regarding operation of color instruments in combination with Argyll, to the Author(s) of Argyll, and not to any other party. </p> <h2><span style="text-decoration: underline; color: rgb(51, 0, 51);"><a name="Copyright"></a>Copyright and Licensing:</span><br> </h2> <p>Most of the source code and provided executable files are copyrighted works, licensed under the <span style="font-weight: bold;">Affero GNU Version 3 license</span>, 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 <span style="font-weight: bold;">Affero GNU</span> license <span style="font-weight: bold;">prohibits</span> extending these tools<span style="font-weight: bold;"></span> (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 <a href="License.txt">license</a>. </p> 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. <p>The Argyll CMS is Copyright 1995 - 2012 Graeme W. Gill, and is made available under the terms of the Affero GNU General Public License Version 3, as detailed in the <a href="License.txt">License.txt</a> 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 istrument 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 <a href="License2.txt">License2.txt</a> file.<br> </p> <p>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 <a href="License2.txt">License2.txt</a> file.</p> <p>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 <a href="License3.txt">License3.txt</a> file.<br> </p> <p>The UNIX USB library libusb included in this distribution, is copyright Johannes Erdfelt, Thomas Sailer and Brad Hards, and is licensed under the GNU LGPL Version 2 or later. See libusb/LICENSE and libusb/COPYING for details. <br> </p> <p>The Win32 USB library libusb-win32, included in this distribution, is copyright Stephan Meyer, Johannes Erdfelt and Thomas Sailer, and is licensed under the GNU LGPL Version 2 or latter (the DLL) and GNU GPL Version 2 or later (the drivers, services, installer). See libusbw/License.txt, libusbw/COPYING_LGPL.txt and libusbw/COPYING_GPL.txt for details.<br> </p> <p>The USB library libusb V1.0 included in this distribution, is copyright by the authors listed in the <span style="font-weight: bold;">libusb1/AUTHORS</span> file, and is licensed under the GNU LGPL Version 2 or later. See <span style="font-weight: bold;">libusb1/COPYING</span> for details of this license. The MSWindows kernel driver is Copyright Stephan Meyer, and is licesed under the GNU GPL Version 2 or later - See <span style="font-weight: bold;">libusb1/KDRIVER_LICENSE</span> and <span style="font-weight: bold;">libusb1/COPYING_GPL</span>. The WinUSB CoInstaller redistributable files from the Microsoft Windows Driver Kit are licensed by Microsoft according to the terms indicated in the <span style="font-weight: bold;">libusb1/license.rtf</span> file, section 2. These operating system files are provided ("aggregated") here under the terms of the Microsoft license purely for convenience, and do not form part of the libusb V1.0 package, and are therefore not subject to the terms of the libusb V1.0 license(s). The .inf files that make use of the CoInstallers are provided under a free use, "MIT" type license. </p> <p>The icc library in<span style="font-weight: bold;"> icc</span>/, the CGATS library in <span style="font-weight: bold;">cgats</span>/, the jcnf library in <span style="font-weight: bold;">jcnf</span>/, the files <span style="font-weight: bold;">spectro/xdg_bds.*</span>, <span style="font-weight: bold;">spectro/aglob.*</span> and the ucmm library in <span style="font-weight: bold;">ucmm</span>/ 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.<br> </p> <p>The yajl library in <span style="font-weight: bold;">jcnf/yajl</span> 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.<br> </p> <p> The TIFF library included in this distribution for convenience, has its own copyright and license detailed in tiff/COPYRIGHT (an "MIT"/"BSD" like license).<br> </p> <p>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. </p> <p>xicc/iccjpeg.h and xicc/iccjpeg.c are 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.<br> </p> <p>The mongoose web server software is Copyright (c) 2004-2011 Sergey Lyubka, and is licensed under an "MIT" license. </p> <h2><span style="text-decoration: underline; color: rgb(51, 0, 51);"><a name="ProjType"></a>What sort of project is this ? (re: contributions)<br> </span></h2> 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. <br> <br> 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.<br> <br> <h1><u><a href="Compiling.html">Compiling</a></u></h1> How to <a href="Compiling.html">build the software</a> from the source if you want to.<br> <span style="font-weight: bold;">Note</span> that you don't need to do this if you are using one of the binary installations.<br> <h1 style="color: rgb(51, 204, 0);"><u><a href="Installing.html">Installing</a></u></h1> Important notes on <a href="Installing.html">installing the binary software</a> on various platforms.<br> <br> <h2 style="color: rgb(51, 0, 51);"><u><u><a name="GUIs"></a>Graphic User Interfaces<br> </u></u></h2> ArgyllCMS does not directly support a graphic user interface, but several people have written <span style="font-weight: bold;">GUI</span> based front ends for it. A popular <span style="font-weight: bold;"></span>front end that supports display calibration and profiling is <a href="http://hoech.net/dispcalGUI/">dispcalGUI</a> by Florian Höch. Others can be found with a suitable <a href="http://www.google.com/search?hl=en&source=hp&q=argyllcms+GUI&aq=f&aqi=g1&aql=&oq=">search</a>.<br> <h2 style="color: rgb(51, 0, 51);"><u><a name="CmdLine"></a>Main Tools and the command line<br> </u></h2> 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 <span style="font-weight: bold;">usage</span> of any of the tools, run it with just an "-?" argument, i.e. <b>targen -? </b>(or some other unrecognized flag, if the "?" character is treated specially in your shell, i.e. try "--" on OS X zsh).<br> <br> 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:<br> <br> tool -?<br> usage: tool [options] infile outfile<br> -v Verbose mode<br> -d n Choose a depth 0-4<br> -r Use a random depth<br> -f [nn] Use full range. nn optional range 0 - 100.<br> -M Manual<br> infile Input file<br> outfile Output file<br> <br> 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:<br> <br> tool -v testin testout<br> tool -d3 -M testin1 testout2<br> tool -f infile outfile<br> tool -f 45 infile outfile<br> tool -d 3 -f67 infile outfile<br> <p>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.<br> </p> <p>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".<br> </p> <p><a name="cltutes"></a>For more information on using a command line environments, consult an appropriate tutorial:</p> <p>MS Windows :<br> <<a href="http://www.bleepingcomputer.com/tutorials/tutorial76.html">http://www.bleepingcomputer.com/tutorials/tutorial76.html</a>><br> <<a href="http://www.pcstats.com/articleview.cfm?articleid=1723&page=1">http://www.pcstats.com/articleview.cfm?articleid=1723&page=1</a>><br> <<a href="http://www.voidspace.org.uk/python/articles/command_line.shtml">http://www.voidspace.org.uk/python/articles/command_line.shtml</a>><br> <br> To find more: <<a href="http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial">http://www.google.com/search?hl=en&q=windows+command+prompt+tutorial></a><br> <br> OS X:<br> <<a href="http://www.osxfaq.com/Tutorials/LearningCenter/">http://www.osxfaq.com/Tutorials/LearningCenter/</a>><br> <<a href="http://www.atomiclearning.com/macosxterminalx.shtml">http://www.atomiclearning.com/macosxterminalx.shtml</a>><br> <<a href="http://www.oreillynet.com/pub/a/mac/2001/12/14/terminal_one.html">http://www.oreillynet.com/pub/a/mac/2001/12/14/terminal_one.html</a>><br> <br> To find more: <<a href="http://www.google.com/search?hl=en&q=OS+X+shell+tutorial">http://www.google.com/search?hl=en&q=OS+X+shell+tutorial</a>><br> <br> Linux:<br> <<a href="http://www.linuxcommand.org/index.php">http://www.linuxcommand.org/index.php</a>><br> <<a href="http://www.tuxfiles.org/linuxhelp/shell.html">http://www.tuxfiles.org/linuxhelp/shell.html</a>><br> <<a href="http://www.ee.surrey.ac.uk/Teaching/Unix/">http://www.ee.surrey.ac.uk/Teaching/Unix/</a>><br> <br> To find more: <<a href="http://www.google.com/search?q=linux+command+line+shell+tutorial">http://www.google.com/search?q=linux+command+line+shell+tutorial</a>></p> <p><br> <span style="font-weight: bold;">Note</span> 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:<br> </p> <p> <<a href="http://www.rain.org/%7Emkummel/unix.html">http://www.rain.org/~mkummel/unix.html</a>><br> </p> <h2><u><a href="Scenarios.html">Tutorial: Typical usage scenarios and examples</a></u></h2> A <a href="Scenarios.html">guided tour</a> 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. <br> <br> <h3 style="color: rgb(0, 0, 0);"><u><a name="Topics"></a>Topical Discussions</u></h3> Discussions about particular topics:<br> <br> <a href="FWA.html">About Fluorescent Whitening Agent compensation</a><br> <br> <a href="instruments.html">Operation of particular instruments</a><br> <br> <a href="iccgamutmapping.html">About ICC profiles and Gamut Mapping</a><br> <br> <a href="monitorcontrols.html">About display monitor settings and targets</a><br> <br> <a href="gamma.html">About display "Gamma"</a><br> <br> <a href="calvschar.html">What's the difference between Calibration and Characterization ?</a><br> <br> <a href="WideGamutColmters.html">Why doesn't my Colorimeter work well on my Wide Gamut display ?</a><br> <span style="font-family: monospace;"></span><br> <a href="CrushedDisplyBlacks.html">My blacks get crushed on my display - why ? How do I fix it ?</a><br> <br> <a href="i1proDriver.html">How can I have confidence in the i1pro Driver ?</a><br> <br> <a href="evalInputTargets.html">Evaluating input targets</a><br> <br> <h2><b><u><font><b><u><font size="+2"><a name="Flow"></a>Flow diagram of Major Tools:</font></u></b></font></u></b></h2> <br> <a href="ArgyllFlow.jpg"><img alt="Thumbnail of Flow Diagram" src="ArgyllFlowThumb.jpg" style="border: 2px solid ; width: 150px; height: 202px;"></a><br> <br> <h2><b><u><font size="+2"><a name="CatList"></a>Main Tools by category:</font></u></b></h2> <h3>Calibrating devices<br> </h3> <small><a style="font-family: monospace;" href="dispcal.html">dispcal</a><span style="font-family: monospace;"> </span></small>Adjust, calibrate and profile a display<small><big>.<br> </big></small><small><a style="font-family: monospace;" href="printcal.html">printcal</a><span style="font-family: monospace;"> </span></small>Create a printer calibration .cal file from a .ti3 data file<small><big>.</big></small><br> <h3>Creating test targets for profiling or print calibration<br> </h3> <small><a style="font-family: monospace;" href="targen.html">targen</a><span style="font-family: monospace;"> </span><big>Generate a profiling test target values .ti1 file. </big><br style="font-family: monospace;"> <a style="font-family: monospace;" href="filmtarg.html">filmtarg</a><span style="font-family: monospace;"> </span><big>Create film recorder TIFF files from Argyll .ti1 file. </big><br style="font-family: monospace;"> <a style="font-family: monospace;" href="printtarg.html">printtarg</a><span style="font-family: monospace;"> </span><big>Create a PS, EPS or TIFF file containing test patch values, ready for printing.</big></small> <h3>Obtaining test results for profiling or print calibration<br> </h3> <small><a style="font-family: monospace;" href="chartread.html">chartread</a><span style="font-family: monospace;"> </span><big>Read a test chart using an instrument to create a .ti3 data file.</big><span style="font-family: monospace;"> </span><br style="font-family: monospace;"> <a style="font-family: monospace;" href="dispread.html">dispread</a><span style="font-family: monospace;"> </span><big>Test and read colorimetric values from a display </big><br style="font-family: monospace;"> <a style="font-family: monospace;" href="filmread.html">filmread</a><span style="font-family: monospace;"> </span><big>Read film colorimetric values using a SpectroScanT (Deprecated ?)</big><br style="font-family: monospace;"> <a style="font-family: monospace;" href="scanin.html">scanin</a><span style="font-family: monospace;"> </span><big>Convert a TIFF image of a test chart into .ti3 device values. <br> </big></small><small><a style="font-family: monospace;" href="illumread.html">illumread</a><span style="font-family: monospace;"> </span></small>Use an instrument to measure an illuminant spectrum, and estimate its UV content.<br style="font-family: monospace;"> <small><a style="font-family: monospace;" href="fakeread.html">fakeread</a><span style="font-family: monospace;"> </span><big>Fake the reading of a device using an ICC or MPP profile. <br> </big></small><small><a style="font-family: monospace;" href="synthread.html">synthread</a><span style="font-family: monospace;"> </span><big>Fake the reading of a device using a synthetic device model. </big></small><br style="font-family: monospace;"> <small><a style="font-family: monospace;" href="cb2ti3.html">cb2ti3</a><span style="font-family: monospace;"> </span><big>Convert Colorblind format CMY/RGB test chart into Argyll .ti3 CGATS format. </big><br style="font-family: monospace;"> <a style="font-family: monospace;" href="kodak2ti3.html">kodak2ti3</a><span style="font-family: monospace;"> </span><big>Convert Kodak Colorflow format CMYK test chart into Argyll .ti3 CGATS format. </big><br style="font-family: monospace;"> <a style="font-family: monospace;" href="txt2ti3.html">txt2ti3</a><span style="font-family: monospace;"> </span><big>Convert Gretag/Logo/X-Rite or other format RGB or CMYK test chart results into Argyll .ti3 CGATS format. </big><br style="font-family: monospace;"> <a style="font-family: monospace;" href="fakeCMY.html">fakeCMY</a><span style="font-family: monospace;"> </span><big>Create a fake Argyll .ti3 CMY data file from a CMYK profile, as a basis of creating a CMY to CMYK separation<br> </big></small><small><a style="font-family: monospace;" href="average.html">average</a><span style="font-family: monospace;"> </span><big>Average / Merge two measurement data files</big></small><br> <h3>Creating Device Profiles</h3> <small><a style="font-family: monospace;" href="colprof.html">colprof</a><span style="font-family: monospace;"> </span></small>Create an ICC profile from the .ti3 test data. <br> <small><a style="font-family: monospace;" href="mppprof.html">mppprof</a><span style="font-family: monospace;"> </span></small>Create a Model Printer Profile (MPP) from the .ti3 test data. <br> <small><a style="font-family: monospace;" href="sepgen.html">sepgen</a><span style="font-family: monospace;"> </span></small><b>IN DEVELOPMENT</b> Create a CMY[K] to device colorant separation. <br> <small><a style="font-family: monospace;" href="revfix.html">revfix</a><span style="font-family: monospace;"> </span></small>Regenerate a device profiles B2A table data by inverting the A2B table. <h3>Creating Device Link Profiles</h3> <small><a style="font-family: monospace;" href="collink.html">collink</a><span style="font-family: monospace;"> </span></small>Link two device ICC profiles to create a device link profile. <h3>Converting colors or applying print calibration<br> </h3> <small><a style="font-family: monospace;" href="cctiff.html">cctiff</a><span style="font-family: monospace;"> </span></small>Color convert a TIFF or JPEG file using a sequence of ICC device, device link, abstract profiles and calibration files. <br> <small><a style="font-family: monospace;" href="applycal.html">applycal</a><span style="font-family: monospace;"> </span></small>Apply calibration curves to an ICC profile.<br> <small><a style="font-family: monospace;" href="icclu.html">icclu </a><span style="font-family: monospace;"> </span></small>Lookup individual color values through any ICC profile table. <br> <small><a style="font-family: monospace;" href="xicclu.html">xicclu</a><span style="font-family: monospace;"> </span></small>Lookup individual color values forward or inverted though an ICC profile table. <br> <small><a style="font-family: monospace;" href="mpplu.html">mpplu</a><span style="font-family: monospace;"> </span></small>Lookup individual color values though an MPP profile. Also create MPP gamut files/views.<br> <small><a style="font-family: monospace;" href="greytiff.html">greytiff</a><span style="font-family: monospace;"> </span></small>Convert a TIFF file to monochrome using an ICC device profile <br> <h3>Color Tweaking tools<br> </h3> <small><a style="font-family: monospace;" href="refine.html">refine</a><span style="font-family: monospace;"> </span></small>Creates an abstract profile from two chart readings, useful for refining proofing profiles. <a href="mppprof.html"><br> </a> <h3>Creating gamut views</h3> <small><a style="font-family: monospace;" href="iccgamut.html">iccgamut</a><span style="font-family: monospace;"> </span></small>Create a gamut file or VRML file of the color gamut of an ICC profile. <br> <small><a style="font-family: monospace;" href="tiffgamut.html">tiffgamut</a><span style="font-family: monospace;"> </span></small>Create a gamut file or VRML file of the color gamut of a TIFF or JPEG image. <br> <small><a style="font-family: monospace;" href="viewgam.html">viewgam</a><span style="font-family: monospace;"> </span></small>Convert one or more gamuts into a VRML 3D visualization file. Compute an intersection.<br> <h3>Diagnostic and test tools<br> </h3> <small><a style="font-family: monospace;" href="iccdump.html">iccdump</a><span style="font-family: monospace;"> </span></small>Dump the contents of an ICC profile as text. <br> <small><a style="font-family: monospace;" href="profcheck.html">profcheck</a><span style="font-family: monospace;"> </span></small>Check an ICC profile against .ti3 test chart data. <br> <small style="font-family: monospace;"><a href="invprofcheck.html">invprofcheck</a> </small>Check ICC forward against inverse lookup. <br> <small><a style="font-family: monospace;" href="splitti3.html">splitsti3</a><span style="font-family: monospace;"> </span></small>Split a CGATS file (ie. a .ti3) into two parts randomly to verify profiling. <br> <small style="font-family: monospace;"><a href="timage.html">timage</a> </small>Create TIFF test images. <br> <small><a style="font-family: monospace;" href="mppcheck.html">mppcheck</a><span style="font-family: monospace;"> </span></small>Check an MPP profile against .ti3 test chart data. <br> <small><a style="font-family: monospace;" href="spotread.html">spotread</a><span style="font-family: monospace;"> </span></small>Use an instrument to read a single spot color value. <br> <small><a style="font-family: monospace;" href="verify.html">verify</a><span style="font-family: monospace;"> </span></small>Verify matching of CIE in two CGATS/.ti3 files (also view differences as VRML)<br> <small><a style="font-family: monospace;" href="synthcal.html">synthcal</a><span style="font-family: monospace;"> </span></small>Create a synthetic input, display or output calibration (<a href="File_Formats.html#.cal">.cal</a>)file. <h3>Other Tools</h3> <small><a style="font-family: monospace;" href="ccxxmake.html">ccxxmake</a><span style="font-family: monospace;"> </span></small>Use a Spectrometer to create a Colorimeter Correction Matrix (CCMX) or a Colorimeter Calibration Spectral Set (CCSS) for a particular display.<br> <small><a style="font-family: monospace;" href="extracticc.html">extracticc</a><span style="font-family: monospace;"></span></small><small><span style="font-family: monospace;"> </span>Extract an embedded ICC profile from a TIFF or JPEG file.<br> </small><small><a style="font-family: monospace;" href="extractttag.html">extractttag</a><span style="font-family: monospace;"></span></small><small><span style="font-family: monospace;"> </span>Extract a text tag (ie. CGATS .ti3 data or CAL) from an ICC profile.</small><br> <small><a style="font-family: monospace;" href="dispwin.html">dispwin</a><span style="font-family: monospace;"></span></small><small><span style="font-family: monospace;"> </span></small>Install or uninstall display profile, set display calibration from profile or .cal file, test displace and dispwin access to a display.<br> <small><a style="font-family: monospace;" href="i1d3ccss.html">i1d3ccss</a><span style="font-family: monospace;"> </span></small>A special purpose tool that can either install CCSS files, or locat and translate X-Rite .EDR files to CCSS files and install them.<br> <small><a style="font-family: monospace;" href="specplot.html">specplot</a><span style="font-family: monospace;"> </span><span style="text-decoration: underline; font-family: monospace;"></span></small> Plot a spectrum (.sp) and calculate CCT and VCT.<br> <small><a style="font-family: monospace;" href="spec2cie.html">spec2cie</a><span style="font-family: monospace;"> </span><span style="text-decoration: underline; font-family: monospace;"></span></small>Convert spectral .ti3 readings into CIE XYZ or L*a*b* readings. Apply FWA, plot spectrums.<br> <small><a style="font-family: monospace;" href="spyd2en.html">spyd2en</a><span style="font-family: monospace;"> </span><span style="text-decoration: underline; font-family: monospace;"></span></small>A special purpose tool that enables the Spyder 2 colorimeter.<br> <small><a style=" font-family: monospace;" href="spyd4en.html">spyd4en</a><span style="font-family: monospace;"> </span><span style="text-decoration: underline; font-family: monospace;"></span></small>A special purpose tool that enables the full range of Spyder 4 colorimeter calibration choices.<br> <h2><b><u><font size="+2"><a name="AlphList"></a>Main Tools Alphabetic Listing:</font></u></b></h2> <small><a style="font-family: monospace;" href="applycal.html">applycal</a><span style="font-family: monospace;"> </span></small>Apply calibration curves to an ICC profile.<br> <small><a style="font-family: monospace;" href="average.html">average</a><span style="font-family: monospace;"> </span><big>Average / Merge two measurement data files</big></small><br> <small><a style="font-family: monospace;" href="cb2ti3.html">cb2ti3</a><span style="font-family: monospace;"> </span></small>Convert Colorblind format CMY/RGB test chart into Argyll .ti3 CGATS format. <br> <small><a style="font-family: monospace;" href="cctiff.html">cctiff</a><span style="font-family: monospace;"> </span></small>Color convert a TIFF or JPEG file using a sequence of ICC device, device link, abstract profiles and calibration files.<br> <small><a style="font-family: monospace;" href="ccxxmake.html">ccxxmake</a><span style="font-family: monospace;"> </span></small>Use a Spectrometer to create a Colorimeter Correction Matrix (CCMX) or a Colorimeter Calibration Spectral Set (CCSS) for a particular display.<br> <small><a style="font-family: monospace;" href="chartread.html">chartread</a><span style="font-family: monospace;"> </span></small>Read a test chart using an instrument to create a .ti3 data file. <br> <small><a style="font-family: monospace;" href="collink.html">collink</a><span style="font-family: monospace;"> </span></small>Link two device ICC profiles to create a device link profile. <br> <small><a style="font-family: monospace;" href="colprof.html">colprof</a><span style="font-family: monospace;"> </span></small>Create an ICC profile from the .ti3 test data. <br> <small style="font-family: monospace;"><a href="dispcal.html">dispcal</a> </small>Adjust, calibrate and profile a display<small><big>.</big></small><br> <small><a style="font-family: monospace;" href="dispread.html">dispread</a><span style="font-family: monospace;"> </span></small>Test and read colorimetric values from a display <br> <small><a style="font-family: monospace;" href="dispwin.html">dispwin</a><span style="font-family: monospace;"></span></small><small><span style="font-family: monospace;"> </span></small>Install or uninstall display profile, set display calibration from profile or .cal file, test displace and dispwin access to a display.<br> <small><a style="font-family: monospace;" href="extracticc.html">extracticc</a><span style="font-family: monospace;"></span></small><small><span style="font-family: monospace;"> </span>Extract an embedded ICC profile from a TIFF or JPEG file.<br> </small><small><a style="font-family: monospace;" href="extractttag.html">extractttag</a><span style="font-family: monospace;"></span></small><small><span style="font-family: monospace;"> </span>Extract a text tag (ie. CGATS .ti3 data or CAL) from an ICC profile.</small><br> <small><a style="font-family: monospace;" href="fakeCMY.html">fakeCMY</a><span style="font-family: monospace;"> </span></small>Create a fake Argyll .ti3 CMY data file from a CMYK profile, as a basis of creating a CMY to CMYK separation <br> <small><a style="font-family: monospace;" href="fakeread.html">fakeread</a><span style="font-family: monospace;"> </span></small>Fake the reading of a device using an ICC or MPP profile. <br> <small><a style="font-family: monospace;" href="filmread.html">filmread</a><span style="font-family: monospace;"> </span></small>Read film colorimetric values using a SpectroScanT (Deprecated ?)<br> <small><a style="font-family: monospace;" href="filmtarg.html">filmtarg</a><span style="font-family: monospace;"> </span></small>Create film recorder TIFF files from Argyll .ti1 file. <br> <small><a style="font-family: monospace;" href="greytiff.html">greytiff</a><span style="font-family: monospace;"> </span></small>Convert a TIFF file to monochrome using an ICC device profile <br> <small><a style="font-family: monospace;" href="i1d3ccss.html">i1d3ccss</a><span style="font-family: monospace;"> </span></small>A special purpose tool that can either install CCSS files, or locat and translate X-Rite .EDR files to CCSS files and install them.<br> <small><a style="font-family: monospace;" href="iccdump.html">iccdump</a><span style="font-family: monospace;"> </span></small>Dump the contents of an ICC profile as text. <br> <small><a style="font-family: monospace;" href="iccgamut.html">iccgamut</a><span style="font-family: monospace;"> </span></small>Create a gamut file or VRML file of the color gamut of an ICC profile. <br> <small><a style="font-family: monospace;" href="icclu.html">icclu </a><span style="font-family: monospace;"> </span></small>Lookup individual color values through any ICC profile table. <br> <small><a style="font-family: monospace;" href="illumread.html">illumread</a><span style="font-family: monospace;"> </span></small>Use an instrument to measure an illuminant spectrum, and estimate its UV content.<br> <small><a style="font-family: monospace;" href="invprofcheck.html">invprofcheck</a><span style="font-family: monospace;"> </span></small>Check ICC forward against inverse lookup. <br> <small><a style="font-family: monospace;" href="kodak2ti3.html">kodak2ti3</a><span style="font-family: monospace;"> </span></small>Convert Kodak Colorflow format CMYK test chart into Argyll .ti3 CGATS format. <br> <small><a style="font-family: monospace;" href="mppcheck.html">mppcheck</a><span style="font-family: monospace;"> </span></small>Check an MPP profile against .ti3 test chart data. <br> <small><a style="font-family: monospace;" href="mpplu.html">mpplu</a><span style="font-family: monospace;"> </span></small>Lookup individual color values though an MPP profile. Also create MPP gamut files/views. <br> <small><a style="font-family: monospace;" href="mppprof.html">mppprof</a><span style="font-family: monospace;"> </span></small>Create a Model Printer Profile (MPP) from the .ti3 test data. <br> <small><a style="font-family: monospace;" href="printcal.html">printcal</a><span style="font-family: monospace;"> </span></small>Create a printer calibration .cal file from a .ti3 data file<small><big>.</big></small><br> <small><a style="font-family: monospace;" href="printtarg.html">printtarg</a><span style="font-family: monospace;"> </span></small><small><big>Create a PS, EPS or TIFF file containing test patch values, ready for printing.</big></small><br> <small><a style="font-family: monospace;" href="profcheck.html">profcheck</a><span style="font-family: monospace;"> </span></small>Check an ICC profile against .ti3 test chart data. <br> <small><a style="font-family: monospace;" href="refine.html">refine</a><span style="font-family: monospace;"> </span></small>Creates an abstract profile from two chart readings, useful for refining proofing profiles. <br> <small><a style="font-family: monospace;" href="revfix.html">revfix</a><span style="font-family: monospace;"> </span></small>Regenerate a device profiles B2A table data by inverting the A2B table. <br> <small><a style="font-family: monospace;" href="scanin.html">scanin</a><span style="font-family: monospace;"> </span></small>Convert a TIFF image of a test chart into .ti3 device values. <br> <small><a style="font-family: monospace;" href="sepgen.html">sepgen</a><span style="font-family: monospace;"> </span></small><b>IN DEVELOPMENT</b> Create a CMY[K] to device colorant separation. <br> <small><a style="font-family: monospace;" href="spec2cie.html">spec2cie</a><span style="font-family: monospace;"> </span><span style="text-decoration: underline; font-family: monospace;"></span></small>Convert spectral .ti3 readings into CIE XYZ or L*a*b* readings. Apply FWA, plot spectrums.<br> <small><a style="font-family: monospace;" href="specplot.html">specplot</a><span style="font-family: monospace;"> </span><span style="text-decoration: underline; font-family: monospace;"></span></small> Plot a spectrum (.sp) and calculate CCT and VCT.<br> <small><a style="font-family: monospace;" href="splitti3.html">splitsti3</a><span style="font-family: monospace;"> </span></small>Split a CGATS file (ie. a .ti3) into two parts randomly to verify profiling. <br> <small><a style="font-family: monospace;" href="spotread.html">spotread</a><span style="font-family: monospace;"> </span></small>Use an instrument to read a single spot color value. <br> <small><a style="font-family: monospace;" href="spyd2en.html">spyd2en</a><span style="font-family: monospace;"> </span><span style="text-decoration: underline; font-family: monospace;"></span></small>A special purpose tool that enables the Spyder 2 colorimeter.<br> <small><a style=" font-family: monospace;" href="spyd4en.html">spyd4en</a><span style="font-family: monospace;"> </span><span style="text-decoration: underline; font-family: monospace;"></span></small>A special purpose tool that enables the full range of Spyder 4 colorimeter calibration choices.<br> <small><a style="font-family: monospace;" href="synthcal.html">synthcal</a><span style="font-family: monospace;"> </span></small>Create a synthetic input, display or output calibration (<a href="File_Formats.html#.cal">.cal</a>)file.<br> <small><a style="font-family: monospace;" href="synthread.html">synthread</a><span style="font-family: monospace;"> </span><big>Fake the reading of a device using a synthetic device model. </big></small><br> <small><a style="font-family: monospace;" href="targen.html">targen</a><span style="font-family: monospace;"> </span></small>Generate a profiling test target values .ti1 file. <br> <small><a style="font-family: monospace;" href="tiffgamut.html">tiffgamut</a><span style="font-family: monospace;"> </span></small>Create a gamut file or VRML file of the color gamut of a TIFF or JPEG image. <br> <small><a style="font-family: monospace;" href="timage.html">timage</a><span style="font-family: monospace;"> </span></small>Create TIFF test images. <br> <small><a style="font-family: monospace;" href="txt2ti3.html">txt2ti3</a><span style="font-family: monospace;"> </span></small><small><big>Convert Gretag/Logo/X-Rite or other format RGB or CMYK test chart results into Argyll .ti3 CGATS format.</big></small> <br> <font size="-1"><a style="font-family: monospace;" href="verify.html">verify</a><span style="font-family: monospace;"> </span></font>Verify matching of CIE in two CGATS/.ti3 files (also view differences as VRML)<br> <font size="-1"><a style="font-family: monospace;" href="viewgam.html">viewgam</a><span style="font-family: monospace;"> </span></font>Convert one or more gamuts into a VRML 3D visualization file. Compute an intersection.<br> <small><a style="font-family: monospace;" href="xicclu.html">xicclu</a><span style="font-family: monospace;"> </span></small>Lookup individual color values forward or inverted though an ICC profile table. <br> <br> <h2><u><a href="Environment.html">Environment Variables<br> </a></u></h2> <span style="text-decoration: underline;"><span style="font-weight: bold;"></span></span> Performance/memory tuning hints, plus tweaks for scipting.<br> <h2><u><a href="Performance.html">Performance Tuning<br> </a></u></h2> <span style="text-decoration: underline;"><span style="font-weight: bold;"></span></span> Performance hints. <br> <h2><u><a href="Overview.html">Overview</a></u></h2> Overview of the software and its aims and functionality.<br> <h2><u><a href="Limitations.html">Limitations</a></u></h2> Limitations of the current functionality.<br> <h2><u><a href="Organisation.html">Organization</a></u></h2> How directories are organized, what they contain. <h2><u><a href="Source.html">Source</a></u></h2> Any detailed documentation on how the software works, or what algorithms it is based on. (Very incomplete.) <h2><u><a href="MinorTools.html">Minor Tools</a></u></h2> A very brief description of minor tools and test harnesses. <br> <br> <br> <h2><u><a name="FFormats"></a><a href="File_Formats.html">File formats that Argyll uses</a></u></h2> Argyll uses a number of file formats for its operation, some that are external standards, and some that are unique to Argyll. <br> <br> <a href="File_Formats.html#.ti1">.ti1</a> Device test values <br> <a href="File_Formats.html#.ti2">.ti2</a> Device test values & chart layout <br> <a href="File_Formats.html#.ti3">.ti3</a> Device test values & CIE tristimulus/spectral results <a href="ti3_format.html">Format details.</a><br> <a href="File_Formats.html#.cal">.cal</a> Device calibration information. <a href="cal_format.html">Format details.</a><br> <a href="File_Formats.html#.cht">.cht</a> Test chart recognition template. <a href="cht_format.html">Format details.</a> <br> <a href="File_Formats.html#.gam">.gam</a> 3D gamut surface description <br> <a href="File_Formats.html#.sp">.sp</a> Illuminant spectral description <br> <a href="File_Formats.html#.ccmx">.ccmx</a> Colorimeter Correction Matrix <br> <a href="File_Formats.html#.ccmx">.ccss</a> Colorimeter Calibration Spectral Set <br> <a href="File_Formats.html#CGATS">CGATS</a> Standard text based data exchange format <br> <a href="File_Formats.html#ICC">ICC</a> International Color Consortium profile format <br> <a href="File_Formats.html#MPP">MPP</a> Model device profile format <br> <a href="File_Formats.html#TIFF">TIFF</a> Tag Image File Format raster files. <br> <a href="File_Formats.html#JPEG">JPEG</a> Joint Photographic Experts Group, JPEG File Interchange Format raster files. <br> <a href="File_Formats.html#VRML">VRML</a> Virtual Reality Modelling Language 3D file format. <br> <br> <a href="ucmm.html">ucmm</a> Unix micro Color Management Module convention and configuration file format and <span style="color: rgb(204, 0, 0); font-weight: bold;">Profile Locations</span>.<br> <h2><u>Errors, Corrections and Omissions:</u></h2> <script language="JavaScript"> <!-- // Comment var v1 = ".com" var v2 = "argyllcms" var v3 = "Graeme" var v4 = "@" var v5 = "mailto:" var v6 = v5 + v3 + v4 + v2 + v1 document.write("<a href=" + v6 + ">" + "Let me know" + "</a>") //--> </script> If you notice any errors, corrections needed or omissions in the current documentation, please contact the author.<br> <br> </body> </html>