CMSTAG(1)			     CMS			     CMSTAG(1)

NAME    [Toc]    [Back]

     cmstag - associate	an ICC device profile with one or more image files

SYNOPSIS    [Toc]    [Back]

     cmstag [ -f | -n]	[ -s source_profile ]
	    [ -o out_file ] image_files

DESCRIPTION    [Toc]    [Back]

     cmstag associates an International	Color Consortium (ICC) profile with
     one or more image files.  The image files need not	all be in the same
     format.  There are	two possible ways to associate the profile with	the
     image(s).	By default, or if the -f flag is set, the full ICC profile
     will be embedded as a tag in the image file(s).  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.	All files specified will be tagged with	the same
     profile.

Command	Line Options
     cmstag supports the following command line	options:

     -s	source_profile
	       Specifies the (source) profile to associate with	the image(s).
	       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 image
	       file(s).	 This option is	mutually exclusive with	the -n option.

     -n	       Requires	that only the name of the ICC profile be embedded in
	       the image file(s).  This	option is mutually exclusive with the
	       -s option.

     -o	out_file
	       If only one file	is being tagged, an output file	may be
	       specied.	The tagged image will be stored	in out_file.  If more
	       than one	image is being tagged, an error	results.

     image_files
	       One or more files to be "tagged"	with the ICC profile. All
	       image files will	be tagged with the same	profile	in the same
	       way.

ERRORS    [Toc]    [Back]

     cmstag tags each image file separately.  An error in processing one file
     ususally does not prevent the processing of other files.






									Page 1






CMSTAG(1)			     CMS			     CMSTAG(1)



     The following are error conditions:

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

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

     o	  the specified	image file is not in a supported image file format.
	  Supported formats are: SGI image file, TIFF, JPEG/JFIF, and GIF.

     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


									PPPPaaaaggggeeee 2222