CMSTAGGIF(1)			     CMS			  CMSTAGGIF(1)

NAME    [Toc]    [Back]

     cmstaggif - associate an ICC device profile with a	GIF image

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     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.

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

ERRORS    [Toc]    [Back]

     The following are error conditions:






									Page 1






CMSTAGGIF(1)			     CMS			  CMSTAGGIF(1)



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

     o	  the specified	image file is not a GIF	file;

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

FILES    [Toc]    [Back]

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

NOTE    [Toc]    [Back]

     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    [Toc]    [Back]

     cocogif(1).


									PPPPaaaaggggeeee 2222