IMGCOPY(1) IMGCOPY(1) NAME imgcopy - copy and convert image file SYNOPSIS imgcopy [-fformat] [-tdata_type] [-Oorder] [-pw,h,z,c] [-ow,h,z,c] [-sw,h,z,c] [-corientation] [-Ccolor_model] [-Pcompression_type] [-qcompression_quality] [-mminimum_value] [-Mmaximum_value] [-h] [-D] [-n#colors] [-a] infile[:index][#format][%format_args] outfile[#format][%format_args] DESCRIPTION imgcopy allows image files with formats supported by the ImageVision Library to be copied and converted to other supported formats. The following command line options are allowed: -fformat Specifies the file format to convert to. By default the output image file format is based on the file name extension. If the extension is not of a known type, then the default file format will be used (usually TIFF). The supported file formats depend on what ImageVision file formats have been installed; if an unknown format is given the valid options will be listed. -tdata_type Specifies the data type to convert to. By default the output image file will use the input image's data type, if possible. The data type may be one of: bit, char, uchar, short, ushort, long, ulong, float and double. -Oorder Specifies the ordering of dimensions of the created image. May be one of: interleaved (bands, samples, lines), sequential (samples, bands, lines) or separate (samples, lines, bands). By default the output image file will have the same ordering as the input if the selected image file format supports it. -pw,h,z,c Specifies the page size of the created image. A default page size will be computed if none is given. -ow,h,z,c Specifies the origin of a subregion to be copied from the input image. By default the entire image will be copied. This subregion is specified in a coordinate system with its origin at the upper left corner of the image progressing along the x axis towards the lower right corner of the image. -sw,h,z,c Specifies the size of a subregion to be copied from the input image. By default the entire image will be copied. -corientation Specifies the orientation to convert to. By default the output image file will use the input image's orientation, if possible. The orientation may be one of: tl, bl, tr, br, lt, lb, rt and rb. Where l is left, r is right, t is top and b is bottom. -Ccolor_model Specifies the color model to convert to. By default the output image file will use the input image's color model, if possible. The color model may be one of: rgb, abgr, grey, negative, palette, hsv, cmy and cmyk. -Pcompresssion_type Specifies the type of compression to use in the output image file. The compression may be one of: none, fax3, fax4, lzw, macrle, sgirle, jpeg or zip -qcompresssion_quality Specifies the quality of compression to use in the output image file. The value ranges from 0 (worst) to 100 (best). The default is 75. Currently this is only meaninful when saving to a JFIF (.jpg) file. -mminimum_value Specifies the minimum value to tag the output image with. No scaling is implied; this option is mainly used to override input images with invalid minimum values. By default the output image file will use the input image's minimum value. This option overrides the -h option. -Mmaximum_value Specifies the maximum value to tag the output image with. No scaling is implied; this option is mainly used to override input images with invalid maximum values. By default the output image file will use the input image's maximum value. This option overrides the -h option. -h Specifies that the input image is to be histogrammed in order to determine the minimum and maximum values to tag the output image with. No scaling is implied; this option is mainly used to override input images with invalid minimum and maximum values. By default the output image file will use the input image's minimum and maximum values. This option overrides the -m and -M options. -D Specifies that ordererd dithering should be used instead of Floyd- Steinberg dithering when converting to images with a palette type color model. -n#colors When doing Floyd-Steinberg dithering, the target number of entries in the color map to be computes (using Heckbert's median-cut algorithm). -a Specifies that the input image is to be appended as a sub-image to the output image. Only certain formats (like TIFF and GIF) support the appending of sub-images. The w, h, z and c values used with the -p, -s and -o options refer to the width, height, depth and component dimensions of the image. The optional index after the input file name is useful on multi- resolution images like Photo CD, to select the desired sub-image. You can use imginfo to get a complete list of all sub-images for a given file. The optional format following a file name can be used to specify an output file format or to indicate that an image is in raw format. The format_args are format specific. EXAMPLES To convert an image to the classic SGI format use a command like: imgcopy someimage.someformat outimage.rgb To pick out a 100x100 region starting at (40,50) and write it out as a TIFF image file use the command: imgcopy -s 100,100 -o 40,50 inimage.rgb outimage.tif To convert an RGB image to greyscale color model use the command: imgcopy -Cgrey inimage.rgb outimage.bw To convert an image to SGI format with no extension on the output file name use either command: imgcopy -fsgi inimage outimage imgcopy inimage outimage#sgi To convert the higest resolution sub-image in a Photo CD image to TIFF format use the command: imgcopy inimage.pcd:5 outimage.tif To convert a raw file (with no header information) containing a luminance, unsigned char, 512 by 512 image to TIFF format: imgcopy infile#raw%size=512,512%colormodel=luminance outimage.tif NOTES The supported image file formats depend on which file formats are currently installed. The installed formats can be listed with the imgformats(1) command. The SGI file format ignores most data formatting options; it determines what it can support and creates a compatible file as best it can. SEE ALSO imgview(1), imginfo(1), imgworks(1), imgformats(1) Page 4