CMSTAGGIF(1)                         CMS                          CMSTAGGIF(1)



NAME
     cmstaggif - associate an ICC device profile with a GIF image

SYNOPSIS
     cmstaggif [ -f | -n]  [ -s source_profile ]
               [ -o  output_file ] [ -h ] image_file

DESCRIPTION
     cmstaggif associates an International Color Consortium (ICC) profile with
     a GIF image file; this is called "tagging" the image file.  There are two
     possible ways to associate the profile with the image.  By default, or if
     the -f flag is set, the full ICC profile will be embedded as a tag in the
     image file.  If the -n flag is set, then only the name of the file will
     be embedded.  This approach is only useful if the image file and profile
     are guaranteed to always reside on the same machine.

     If the image file is already tagged, the old profile will be replaced by
     the new one in the output image file.

Command Line Options
     cmstaggif supports the following command line options:

     -s source_profile
               Specifies the (source) profile to associate with the image. If
               a path name is provided, that is where the profile will be
               looked for. Otherwise, the profile will be looked for in the
               default profile directory:  /usr/share/cms/profiles.  If this
               option is not set, the user's CMS_SETTING_RGB profile will be
               used. If that is not set, an error will result.

     -f        Requires that the full ICC profile be embedded in the GIF image
               file.  This option is mutually exclusive with the -n option.

     -n        Requires that only the name of the ICC profile be embedded in
               the GIF image.  This option is mutually exclusive with the -f
               option.

     -o  output_file
               Specifies a file to which the output image file will be
               written. If this is not specified, output is written to
               standard out.

     -h        Display a usage message.

     imagefile
               A GIF file to be "tagged" with the ICC profile.

ERRORS
     The following are error conditions:






                                                                        Page 1

CMSTAGGIF(1)                         CMS                          CMSTAGGIF(1)



     ⊕    the specified image file can not be opened for reading;

     ⊕    the specified image file is not a GIF file;

     ⊕    the specified source profile can not be found, or is not an ICC
          profile.

FILES
     /usr/share/cms/profiles    directory in which system device profiles are
                                stored

NOTE
     There is currently no standard for associating ICC profiles with GIF
     images.  Therefore, the approach used here is non-standard.  When a
     standard is approved, this application will be changed to conform.

SEE ALSO
     cocogif(1).





































                                                                        Page 2