ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



     NNNNAAAAMMMMEEEE
	  convert - converts an	input file using one image format to
	  an output file with a	differing image	format.

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
	  ccccoooonnnnvvvveeeerrrrtttt [ _o_p_t_i_o_n_s ...	] _i_n_p_u_t__f_i_l_e _o_u_t_p_u_t__f_i_l_e

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
	  ccccoooonnnnvvvveeeerrrrtttt converts an input file using one image format	to an
	  output file with a differing image format.

	  ccccoooonnnnvvvveeeerrrrtttt recognizes the following image formats:


	  TTTTaaaagggg	DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn

	  -------------------------------------------------------------------------------

	  AAAAVVVVSSSS	AVS X image file.

	  BBBBMMMMPPPP	Microsoft Windows bitmap image file.

	  CCCCMMMMYYYYKKKK	Raw cyan, magenta, yellow, and black bytes.

	  EEEEPPPPSSSS	Adobe Encapsulated PostScript file.

	  EEEEPPPPSSSSFFFF	Adobe Encapsulated PostScript file.

	  EEEEPPPPSSSSIIII	Adobe Encapsulated PostScript Interchange format.

	  FFFFAAAAXXXX	Group 3.

	  FFFFIIIITTTTSSSS	Flexible Image Transport System.

	  GGGGIIIIFFFF	Compuserve Graphics image file.

	  GGGGIIIIFFFF88887777	Compuserve Graphics image file (version	87a).

	  GGGGRRRRAAAAYYYY	Raw gray bytes.

	  HHHHIIIISSSSTTTTOOOOGGGGRRRRAAAAMMMM

	  IIIIRRRRIIIISSSS	SGI RGB	image file.

	  JJJJPPPPEEEEGGGG

	  MMMMAAAAPPPP	Red, green, and	blue colormap bytes followed by	the
		image colormap indexes.

	  MMMMAAAATTTTTTTTEEEE	Raw matte bytes.

	  MMMMIIIIFFFFFFFF	Magick image file format.



     Page 1					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



	  MMMMTTTTVVVV

	  NNNNUUUULLLLLLLL	NULL image.

	  PPPPCCCCDDDD	Photo CD.

	  PPPPCCCCXXXX	ZSoft IBM PC Paintbrush	file.

	  PPPPIIIICCCCTTTT	Apple Macintosh	QuickDraw/PICT file.

	  PPPPNNNNMMMM	Portable bitmap.

	  PPPPSSSS	Adobe PostScript file.

	  PPPPSSSS2222	Adobe Level II PostScript file.

	  RRRRAAAADDDD	Radiance image format.

	  RRRRGGGGBBBB	Raw red, green,	and blue bytes.

	  RRRRLLLLEEEE	Utah Run length	encoded	image file; read only.

	  SSSSUUUUNNNN	SUN Rasterfile.

	  TTTTEEEEXXXXTTTT	raw text file; read only.

	  TTTTGGGGAAAA	Truevision Targa image file.

	  TTTTIIIIFFFFFFFF	Tagged Image File Format.

	  VVVVIIIICCCCAAAARRRR	read only.

	  VVVVIIIIDDDD	Visual Image Directory.

	  VVVVIIIIFFFFFFFF	Khoros Visualization image file.

	  XXXX	select image from X server screen.

	  XXXXCCCC	constant image of X server color.  Specify the desired
		color as the filename.

	  XXXXBBBBMMMM	X11 bitmap file.

	  XXXXPPPPMMMM	X11 pixmap file.

	  XXXXWWWWDDDD	X Window System	window dump image file.

	  YYYYUUUUVVVV	CCIR 601 4:1:1 file.

	  YYYYUUUUVVVV3333	CCIR-601 4:1:1 files.

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS



     Page 2					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



	  To convert a _M_I_F_F image of a cockatoo	to a SUN raster	image,
	  use:

	       ccccoooonnnnvvvveeeerrrrtttt ccccoooocccckkkkaaaattttoooooooo....mmmmiiiiffffffff ssssuuuunnnn::::ccccoooocccckkkkaaaattttoooooooo....rrrraaaassss

	  To convert a multi-page _P_o_s_t_s_c_r_i_p_t document to individual
	  FAX pages, use:

	       ccccoooonnnnvvvveeeerrrrtttt ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee ddddooooccccuuuummmmeeeennnntttt....ppppssss ffffaaaaxxxx::::ppppaaaaggggeeee

	  To convert a TIFF image to a _P_o_s_t_s_c_r_i_p_t A4 page with the
	  image	in the lower left-hand corner, use:

	       ccccoooonnnnvvvveeeerrrrtttt ----ppppaaaaggggeeee AAAA4444++++0000++++0000 iiiimmmmaaaaggggeeee....ttttiiiiffffffff ddddooooccccuuuummmmeeeennnntttt....ppppssss

	  To convert a raw GGGGRRRRAAAAYYYY	image to a portable graymap, use:

	       ccccoooonnnnvvvveeeerrrrtttt ----ssssiiiizzzzeeee 777766668888xxxx555511112222 ggggrrrraaaayyyy::::rrrraaaawwww iiiimmmmaaaaggggeeee....ppppggggmmmm

	  To convert a Photo CD	image to a TIFF	image, use:

	       ccccoooonnnnvvvveeeerrrrtttt ----ssssiiiizzzzeeee 1111555533336666xxxx1111000022224444 iiiimmmmgggg0000000000009999....ppppccccdddd iiiimmmmaaaaggggeeee....ttttiiiiffffffff
	       convert img0009.pcd[4] image.tiff

	  To create a visual image directory of	all your JPEG images,
	  use:

	       ccccoooonnnnvvvveeeerrrrtttt ''''vvvviiiidddd::::****....jjjjppppgggg'''' ddddiiiirrrreeeeccccttttoooorrrryyyy....mmmmiiiiffffffff

	  To identify the dimensions and the type of an	image file,
	  use:

	       ccccoooonnnnvvvveeeerrrrtttt ----vvvveeeerrrrbbbboooosssseeee	iiiimmmmaaaaggggeeee nnnnuuuullllllll::::

     OOOOPPPPTTTTIIIIOOOONNNNSSSS
	  ----bbbblllluuuurrrr	_f_a_c_t_o_r
	       blurs an	image.	Specify	_f_a_c_t_o_r as the percent
	       enhancement (0.0	- 99.9%).

	  ----bbbboooorrrrddddeeeerrrr <_w_i_d_t_h>_x<_h_e_i_g_h_t>_f_P
	       surround	the image with a border	or color.  See XXXX((((1111))))
	       for details about the geometry specification.

	       The color of the	border is obtained from	the X server
	       and is defined as bbbboooorrrrddddeeeerrrrccccoooolllloooorrrr (class bbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr).  See
	       XXXX((((1111)))) for	details.

	  ----ccccoooolllloooorrrrssss _v_a_l_u_e
	       preferred number	of colors in the image.

	       The actual number of colors in the image	may be less
	       than your request, but never more.  Note, this is a



     Page 3					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



	       color reduction option.	Images with less unique	colors
	       than specified with this	option will remain unchanged.
	       Refer to	qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for	more details.

	       Note, options ----ddddiiiitttthhhheeeerrrr, ----ccccoooolllloooorrrrssssppppaaaacccceeee, and ----ttttrrrreeeeeeeeddddeeeepppptttthhhh
	       affect the color	reduction algorithm.

	  ----ccccoooolllloooorrrrssssppppaaaacccceeee _v_a_l_u_e
	       the type	of colorspace: GGGGRRRRAAAAYYYY, OOOOHHHHTTTTAAAA, RRRRGGGGBBBB,	XXXXYYYYZZZZ, YYYYCCCCbbbbCCCCrrrr,
	       YYYYIIIIQQQQ, YYYYPPPPbbbbPPPPrrrr, or YYYYUUUUVVVV.

	       Color reduction,	by default, takes place	in the RGB
	       color space.  Empirical evidence	suggests that
	       distances in color spaces such as YUV or	YIQ correspond
	       to perceptual color differences more closely than do
	       distances in RGB	space.	These color spaces may give
	       better results when color reducing an image.  Refer to
	       qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for more details.

	       The ----ccccoooolllloooorrrrssss or ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee option is required for this
	       option to take effect.

	  ----ccccoooommmmmmmmeeeennnntttt _s_t_r_i_n_g
	       annotate	an image with a	comment.

	       By default, each	image is commented with	its file name.
	       Use this	option to assign a specific comment to the
	       image.  Optionally you can include the image filename,
	       type, width, height, or scene number by embedding
	       special format characters.  Embed %%%%ffff for	filename, %%%%mmmm
	       for magick, %%%%wwww for width, %%%%hhhh for	height,	%%%%ssss for scene
	       number, or \\\\nnnn for newline.  For example,

		    -comment "%m:%f %wx%h"

	       produces	an image comment of MMMMIIIIFFFFFFFF::::bbbbiiiirrrrdddd....mmmmiiiiffffffff 555511112222xxxx444488880000 for
	       an image	titled bbbbiiiirrrrdddd....mmmmiiiiffffffff and whose width is 512	and
	       height is 480.

	       If the first character of _s_t_r_i_n_g	is @@@@, the image
	       comment is read from a file titled by the remaining
	       characters in the string.

	  ----ccccoooommmmpppprrrreeeessssssss _t_y_p_e
	       the type	of image compression: _Q_E_n_c_o_d_e_d or
	       _R_u_n_l_e_n_g_t_h_E_n_c_o_d_e_d.

	       Specify ++++ccccoooommmmpppprrrreeeessssssss to store the binary image in an
	       uncompressed format.  The default is the	compression
	       type of the specified image file.

	  ----ccccoooonnnnttttrrrraaaasssstttt



     Page 4					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



	       enhance or reduce the image contrast.

	       This option enhances the	intensity differences between
	       the lighter and darker elements of the image.  Use
	       ----ccccoooonnnnttttrrrraaaasssstttt to enhance the	image or ++++ccccoooonnnnttttrrrraaaasssstttt to reduce
	       the image contrast.

	  ----ccccrrrroooopppp	<_w_i_d_t_h>{%}_x<_h_e_i_g_h_t>{%}{+-}<_x _o_f_f_s_e_t>{+-}<_y _o_f_f_s_e_t>
	       preferred size and location of the cropped image.  See
	       XXXX((((1111)))) for	details	about the geometry specification.

	       To specify a percentage width or	height instead,	append
	       %%%%.  For example to crop the image by ten	percent	on all
	       sides of	the image, use ----ccccrrrroooopppp 11110000%%%%.

	       Use cropping to crop a particular area of an image.
	       Use ----ccccrrrroooopppp 0000xxxx0000 to	remove edges that are the background
	       color.

	  ----ddddeeeennnnssssiiiittttyyyy <_w_i_d_t_h>_x<_h_e_i_g_h_t>
	       vertical	and horizontal resolution in pixels of the
	       image.

	       This option specifies an	image density for a Postscript
	       page.  The default is 72	pixels per inch	in the
	       horizontal and vertical direction.  The density is
	       given to	Ghostscript as the ----rrrr option when decoding a
	       Postscript image.  See _g_s(_1) for	details.

	  ----ddddeeeessssppppeeeecccckkkklllleeee
	       reduce the speckles within an image.

	  ----ddddiiiissssppppllllaaaayyyy _h_o_s_t:_d_i_s_p_l_a_y[._s_c_r_e_e_n]
	       specifies the X server to contact; see XXXX((((1111)))).

	  ----ddddiiiitttthhhheeeerrrr
	       apply Floyd/Steinberg error diffusion to	the image.

	       The basic strategy of dithering is to trade intensity
	       resolution for spatial resolution by averaging the
	       intensities of several neighboring pixels.  Images
	       which suffer from severe	contouring when	reducing
	       colors can be improved with this	option.

	       The ----ccccoooolllloooorrrrssss option is required for dithering to take
	       effect.

	  ----eeeeddddggggeeee
	       detect edges with an image.

	  ----eeeennnnhhhhaaaannnncccceeee
	       apply a digital filter to enhance a noisy image.



     Page 5					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



	  ----eeeeqqqquuuuaaaalllliiiizzzzeeee
	       perform histogram equalization to the image.

	  ----fffflllliiiipppp
	       create a	"mirror	image" by reflecting the image
	       scanlines in the	vertical direction.

	  ----fffflllloooopppp
	       create a	"mirror	image" by reflecting the image
	       scanlines in the	horizontal direction.

	  ----ffffoooonnnntttt	_n_a_m_e
	       This option specifies the font to be used for
	       displaying normal text.	The default is ffffiiiixxxxeeeedddd.

	  ----ggggaaaammmmmmmmaaaa _v_a_l_u_e
	       level of	gamma correction.

	       The same	color image displayed on two different
	       workstations may	look different due to differences in
	       the display monitor.  Use gamma correction to adjust
	       for this	color difference.  Reasonable values extend
	       from 0.8	to 2.3.

	       You can apply separate gamma values to the red, green,
	       and blue	channels of the	image with a gamma value list
	       delineated with commas (i.e. 1.7,2.3,1.2).

	  ----ggggeeeeoooommmmeeeettttrrrryyyy <_w_i_d_t_h>{%}_x<_h_e_i_g_h_t>{%}{!}
	       perferred size or location of the image.

	       By default, the width and height	are maximum values.
	       That is,	the image is expanded or contracted to fit the
	       width and height	value while maintaining	the aspect
	       ratio of	the image.  Append an exclamation point	to the
	       geometry	to force the image size	to exactly the size
	       you specify.  For example, if you specify 666644440000xxxx444488880000!!!! the
	       image width is set to 640 pixels	and height to 480.  If
	       only one	factor is specified, both the width and	height
	       assume the value.

	       To specify a percentage width or	height instead,	append
	       %%%%.  The image size is multiplied	by the width and
	       height percentages to obtain the	final image
	       dimensions.  To increase	the size of an image, use a
	       value greater than 100 (e.g. 125%).  To decrease	an
	       image's size, use a percentage less than	100.

	  ----iiiinnnntttteeeerrrrllllaaaacccceeee _t_y_p_e
	       the type	of interlacing scheme: NNNNOOOONNNNEEEE, LLLLIIIINNNNEEEE, or PPPPLLLLAAAANNNNEEEE.

	       This option is used to specify the type of interlacing



     Page 6					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



	       scheme for raw image formats such as RRRRGGGGBBBB	or YYYYUUUUVVVV.	 NNNNOOOONNNNEEEE
	       means do	not interlace (RGBRGBRGBRGBRGBRGB...), LLLLIIIINNNNEEEE
	       uses scanline interlacing
	       (RRR...GGG...BBB...RRR...GGG...BBB...), and PPPPLLLLAAAANNNNEEEE uses
	       plane interlacing (RRRRRR...GGGGGG...BBBBBB...).

	       Use LLLLIIIINNNNEEEE, or PPPPLLLLAAAANNNNEEEE to create an interlaced GIF image.
	       ----llllaaaabbbbeeeellll _n_a_m_e assign a label to an	image.

	       Use this	option to assign a specific label to the
	       image.  Optionally you can include the image filename,
	       type, width, height, or scene number in the label by
	       embedding special format	characters.   Embed %%%%ffff for
	       filename, %%%%mmmm for	magick,	%%%%wwww for width, %%%%hhhh for height,
	       or %%%%ssss for scene number.	For example,
		    -label "%m:%f %wx%h"
	       produces	an image label of MMMMIIIIFFFFFFFF::::bbbbiiiirrrrdddd....mmmmiiiiffffffff 555511112222xxxx444488880000 for
	       an image	titled bbbbiiiirrrrdddd....mmmmiiiiffffffff and whose width is 512	and
	       height is 480.

	       If the first character of _s_t_r_i_n_g	is @@@@, the image	label
	       is read from a file titled by the remaining characters
	       in the string.

	       When converting to Postscript, use this option to
	       specify a header	string to print	above the image.

	  ----mmmmaaaapppp _f_i_l_e_n_a_m_e
	       choose a	particular set of colors from this image.

	       By default, color reduction chooses an optimal set of
	       colors that best	represent the original image.
	       Alternatively, you can choose a particular set of
	       colors with this	option.

	  ----mmmmaaaatttttttteeee
	       store matte channel if the image	has one.

	  ----mmmmoooodddduuuullllaaaatttteeee _v_a_l_u_e
	       vary the	brightness, saturation,	and hue	of an image.

	       Specify the percent change in brightness, the color
	       saturation, and the color hue separated by commas.  For
	       example,	to increase the	color brightness by 20%	and
	       decrease	the color saturation by	10% and	leave the hue
	       unchanged, use: ----mmmmoooodddduuuullllaaaatttteeee 22220000,,,,----11110000.

	  ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee
	       transform the image to black and	white.

	  ----nnnneeeeggggaaaatttteeee
	       apply color inversion to	image.



     Page 7					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



	       The red,	green, and blue	intensities of an image	are
	       negated.

	  ----nnnnooooiiiisssseeee
	       reduce the noise	in an image with a noise peak
	       elimination filter.

	       The principal function of noise peak elimination	filter
	       is to smooth the	objects	within an image	without	losing
	       edge information	and without creating undesired
	       structures.  The	central	idea of	the algorithm is to
	       replace a pixel with its	next neighbor in value within
	       a 3 x 3 window, if this pixel has been found to be
	       noise.  A pixel is defined as noise if and only if this
	       pixel is	a maximum or minimum within the	3 x 3 window.

	  ----nnnnoooorrrrmmmmaaaalllliiiizzzzeeee
	       transform image to span the full	range of color values.

	       This is a contrast enhancement technique.

	  ----ppppaaaaggggeeee	<_w_i_d_t_h>_x<_h_e_i_g_h_t>{+-}<_x _o_f_f_s_e_t>{+-}<_y _o_f_f_s_e_t>
	       preferred size and location of the Postscript page.

	       Use this	option to specify the dimensions of the
	       Postscript page in pixels per inch or a TEXT page in
	       pixels.	The default for	a Postscript page is to	center
	       the image on a letter page 612 by 792 pixels. The
	       margins are 1/2"	(i.e.  612x792+36+36).	Other common
	       sizes are:

		   Letter      612x 792
		   Tabloid     792x1224
		   Ledger     1224x 792
		   Legal       612x1008
		   Statement   396x 612
		   Executive   540x 720
		   A3	       842x1190
		   A4	       595x 842
		   A5	       420x 595
		   B4	       729x1032
		   B5	       516x 729
		   Folio       612x 936
		   Quarto      610x 780
		   10x14       720x1008

	       For convenience you can specify the page	size by	media
	       (e.g.  A4, Ledger, etc.).

	       The page	geometry is relative to	the vertical and
	       horizontal density of the Postscript page.  See
	       ----ddddeeeennnnssssiiiittttyyyy	for details.



     Page 8					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



	       The default page	dimensions for a TEXT image is
	       612x792.

	  ----qqqquuuuaaaalllliiiittttyyyy _v_a_l_u_e
	       JPEG quality setting.

	       Quality is 0 (worst) to 100 (best). The default is 85.

	  ----rrrroooollllllll	{+-}<_x _o_f_f_s_e_t>{+-}<_y _o_f_f_s_e_t>
	       roll an image vertically	or horizontally.  See XXXX((((1111)))) for
	       details about the geometry specification.

	       A negative _x _o_f_f_s_e_t rolls the image left-to-right.  A
	       negative	_y _o_f_f_s_e_t rolls the image top-to-bottom.

	  ----rrrroooottttaaaatttteeee _d_e_g_r_e_e_s
	       apply Paeth image rotation to the image.

	       Empty triangles left over from rotating the image are
	       filled with the color defined as	bbbboooorrrrddddeeeerrrrccccoooolllloooorrrr (class
	       bbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr).  See XXXX((((1111)))) for details.

	  ----ssssaaaammmmpppplllleeee _g_e_o_m_e_t_r_y
	       scale image with	pixel sampling.

	  ----sssscccceeeennnneeee _v_a_l_u_e
	       image scene number.

	  ----sssshhhhaaaarrrrppppeeeennnn _w_e_i_g_h_t
	       sharpen an image.  Specify _f_a_c_t_o_r as the	percent
	       enhancement (0.0	- 99.9%).

	  ----sssshhhheeeeaaaarrrr <_x _d_e_g_r_e_e_s>_x<_y	_d_e_g_r_e_e_s>
	       shear the image along the X or Y	axis by	a positive or
	       negative	shear angle.

	       Shearing	slides one edge	of an image along the X	or Y
	       axis, creating a	parallelogram.	An X direction shear
	       slides an edge along the	X axis,	while a	Y direction
	       shear slides an edge along the Y	axis.  The amount of
	       the shear is controlled by a shear angle.  For X
	       direction shears, _x _d_e_g_r_e_e_s is measured relative	to the
	       Y axis, and similarly, for Y direction shears _y _d_e_g_r_e_e_s
	       is measured relative to the X axis.

	       Empty triangles left over from shearing the image are
	       filled with the color defined as	bbbboooorrrrddddeeeerrrrccccoooolllloooorrrr (class
	       bbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr).  See XXXX((((1111)))) for details.

	  ----ssssiiiizzzzeeee	<_w_i_d_t_h>{%}_x<_h_e_i_g_h_t>
	       width and height	of the image.




     Page 9					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



	       Use this	option to specify the width and	height of raw
	       images whose dimensions are unknown such	as GGGGRRRRAAAAYYYY, RRRRGGGGBBBB,
	       or CCCCMMMMYYYYKKKK.	 In addition to	width and height, use ----ssssiiiizzzzeeee to
	       tell the	number of colors in a MMMMAAAAPPPP image	file, (e.g.
	       -size 640x512+256).

	       For Photo CD images, choose from	these sizes:

		  192x128
		  384x256
		  768x512
		 1536x1024
		 3072x2048

	  ----ttttrrrreeeeeeeeddddeeeepppptttthhhh _v_a_l_u_e
	       Normally, this integer value is zero or one.  A zero or
	       one tells ccccoooonnnnvvvveeeerrrrtttt to choose a optimal tree depth	for
	       the color reduction algorithm.

	       An optimal depth	generally allows the best
	       representation of the source image with the fastest
	       computational speed and the least amount	of memory.
	       However,	the default depth is inappropriate for some
	       images.	To assure the best representation, try values
	       between 2 and 8 for this	parameter.  Refer to
	       qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for more details.

	       The ----ccccoooolllloooorrrrssss option is required for this option to take
	       effect.

	  ----uuuunnnnddddeeeerrrrccccoooolllloooorrrr <_u_n_d_e_r_c_o_l_o_r _f_a_c_t_o_r>_x<_b_l_a_c_k-_g_e_n_e_r_a_t_i_o_n _f_a_c_t_o_r>
	       control undercolor removal and black generation on CMYK
	       images.

	       This option enables you to perform undercolor removal
	       and black generation on CMYK images-- images to be
	       printed on a four-color printing	system.	You can
	       control how much	cyan, magenta, and yellow to remove
	       from your image and how much black to add to it.	 The
	       standard	undercolor removal is 1111....0000xxxx1111....0000.	You'll
	       frequently get better results, though, if the
	       percentage of black you add to your image is slightly
	       higher than the percentage of C,	M, and Y you remove
	       from it.	 For example you might try 0000....5555xxxx0000....7777.

	  ----vvvveeeerrrrbbbboooosssseeee
	       print detailed information about	the image.

	       This information	is printed: image scene	number;	 image
	       name;  converted	image name;  image size;  the image
	       class (_D_i_r_e_c_t_C_l_a_s_s or _P_s_e_u_d_o_C_l_a_s_s);  the	total number
	       of unique colors;  and the number of seconds to read



     Page 10					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



	       and convert the image.

	  Options are processed	in command line	order.	Any option you
	  specify on the command line remains in effect	until it is
	  explicitly changed by	specifying the option again with a
	  different effect.

	  Change '-' to	'+' in any option above	to reverse its effect.
	  For example, specify +matte to store the image without its
	  matte	channel.

	  By default, the image	format is determined by	its magic
	  number. To specify a particular image	format,	precede	the
	  filename with	an image format	name and a colon (i.e.
	  ps:image) or specify the image type as the filename suffix
	  (i.e.	image.ps).  See	DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN for	a list of valid
	  formats.

	  When you specify XXXX as	your image type, the filename has
	  special meaning.  It specifies an X window by	id, name, or
	  rrrrooooooootttt.	 If no filename	is specified, the window is selected
	  by clicking the mouse	in the desired window.

	  Specify _i_n_p_u_t__f_i_l_e as	- for standard input, _o_u_t_p_u_t__f_i_l_e as -
	  for standard output.	If _i_n_p_u_t__f_i_l_e has the extension	....ZZZZ or
	  ....ggggzzzz, the file	is uncompressed	with uuuunnnnccccoooommmmpppprrrreeeessssssss	or gggguuuunnnnzzzziiiipppp
	  respectively.	 If _o_u_t_p_u_t__f_i_l_e	has the	extension ....ZZZZ or	....ggggzzzz,
	  the file size	is compressed using with ccccoooommmmpppprrrreeeessssssss or ggggzzzziiiipppp
	  respectively.	 Finally, precede the image file name with |
	  to pipe to or	from a system command.

	  Use an optional index	enclosed in brackets after a file name
	  to specify a desired subimage	of a multi-resolution image
	  format like Photo CD (e.g. img0001.pcd[4]).

	  Single images	are written with the filename you specify.
	  However, multi-part images (i.e. a multi-page	Postscript
	  document) are	written	with the filename followed by a	period
	  (....) and the scene number.  You can change this behavior by
	  embedding a pppprrrriiiinnnnttttffff format specification in the file name.
	  For example,
	      image%02d.miff
	  converts files image00.miff, image01.miff, etc.

     EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
	  ddddiiiissssppppllllaaaayyyy
	       To get the default host,	display	number,	and screen.

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
	  ddddiiiissssppppllllaaaayyyy((((1111)))),,,, aaaannnniiiimmmmaaaatttteeee((((1111)))),,,, iiiimmmmppppoooorrrrtttt((((1111)))),,,, mmmmoooonnnnttttaaaaggggeeee((((1111)))),,,, mmmmooooggggrrrriiiiffffyyyy((((1111)))),,,,
	  segment(1), combine(1), xtp(1)




     Page 11					     (printed 11/7/96)






     ccccoooonnnnvvvveeeerrrrtttt((((1111))))		 IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111	MMMMaaaayyyy 1111999999994444))))	    ccccoooonnnnvvvveeeerrrrtttt((((1111))))



     CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
	  Copyright 1995 E. I. du Pont de Nemours and Company

	  Permission to	use, copy, modify, distribute, and sell	this
	  software and its documentation for any purpose is hereby
	  granted without fee, provided	that the above copyright
	  notice appear	in all copies and that both that copyright
	  notice and this permission notice appear in supporting
	  documentation, and that the name of E. I. du Pont de Nemours
	  and Company not be used in advertising or publicity
	  pertaining to	distribution of	the software without specific,
	  written prior	permission.  E.	I. du Pont de Nemours and
	  Company makes	no representations about the suitability of
	  this software	for any	purpose.  It is	provided "as is"
	  without express or implied warranty.

	  E. I.	du Pont	de Nemours and Company disclaims all
	  warranties with regard to this software, including all
	  implied warranties of	merchantability	and fitness, in	no
	  event	shall E. I. du Pont de Nemours and Company be liable
	  for any special, indirect or consequential damages or	any
	  damages whatsoever resulting from loss of use, data or
	  profits, whether in an action	of contract, negligence	or
	  other	tortuous action, arising out of	or in connection with
	  the use or performance of this software.

     AAAAUUUUTTTTHHHHOOOORRRRSSSS
	  John Cristy, E.I. du Pont De Nemours and Company
	  Incorporated


























     Page 12					     (printed 11/7/96)