cocostiff(1)

NAME
     cocostiff - color correct a TIFF stream

SYNOPSIS
     cocostiff [ -a source_profile | -s source_profile ] -d destination_profile
               [ -h ] [ -o output_file ] [ input_file ]

DESCRIPTION
     cocostiff uses the International Color Consortium (ICC) profiles to
     determine how to perform the appropriate color management operation
     ("color correction", hence "coco") upon a TIFF stream. The operation will
     be a color space conversion from the input device color space to the
     output device color space.

     A TIFF stream is a TIFF image file in the Streamable TIFF (STIFF) format.
     STIFF files are directly created by Impressario products, such as gscan.
     Regular TIFF image files can by turned into STIFF files by running
     /usr/lib/print/il2stiff.

     The device color space associated with the input stream is determined in
     one of four ways. The following approaches are tried in order:

     o    First, if the -s flag is set, the specified src-profile will be
          used.  Specifying -s will override any profile embedded in the
          source image.

     o    Second, if there is an ICC profile embedded in the source image,
          that will be used.

     o    Third, if the -a flag is set, the specified src_profile will be
          used.  Embedded profiles take precedence over profiles specified
          with -a.

     o    Finally, the color management system's default monitor or CMYK
          profile will be used.  Which profile, monitor or CMYK, is selected
          will be determined by the number of color channels in the input
          image.  If there are three channels, the monitor profile,
          monitor.pf, is selected; if there are four, the CMYK profile,
          gencmyk.pf.

     If no default is set, the system searches through CMS_PROFILE_PATH for
     the default monitor profile, monitor.pf.  If that profile is not found,
     cocostiff has no way to determine a source device profile and so passes
     the input image stream through unchanged.

     The output device color space is determined quite simply from the value
     of the -d flag.

     If a full path is not provided for a device profile, the system looks
     through the directories specified in CMS_PROFILE_PATH.

     If, for any reason cocostiff is unable to perform the requested
     conversion, the source stream is copied to the destination stream.  Some
     of the reasons that a conversion might not be performed are:

     o    no destination profile was specified;

     o    the number of channels in the input or output stream does not match
          its profile;

     o    one of the specified profiles could not be found;

     o    one of the specified profiles could not be read;

     o    the source image is one bit deep;

     o    the CMS did not know how to handle one of the profiles;

     o    the CMS needed to read the system RGB or system CMYK profile and
          could not.

Command Line Options
     cocostiff supports the following command line options:

     -a source_profile
               Specifies a profile to be used with images that do not have an
               embedded ICC profile.

     -d destination_profile
               Specifies a profile for the destination device. The destination
               image file format, including the depth and number of channels,
               will be determined by this profile.  -h Display a usage
               message.

     -o output_file
               The output TIFF file. If this is not supplied, cocostiff will
               write to standard out.

     -s source_profile
               The profile for the source device.  This will override any
               profile embedded in the image.  If this profile does not match
               up with the source stream/source file image file format,
               cocostiff will pass the source through unchanged.

     input_file
               The input TIFF file.  If this is not supplied, cocostiff will
               read from standard in.


ERRORS
     Because cocostiff is a filter, it tries to produce valid output if at all
     possible.  However, there are conditions under which cocostiff will exit
     with an error condition. These are:
     o    a source file was specified, but could not be opened;

     o    a destination file was specified, but could not be opened;

     o    an unrecoverable system error.

SEE ALSO
     vstiff(1), libstiff(3).