IMGCOPY(1)IMGCOPY(1)NAMEimgcopy - copy and convert image file
SYNOPSISimgcopy [-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]
DESCRIPTIONimgcopy 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.
Page 1
IMGCOPY(1)IMGCOPY(1)-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).
Page 2
IMGCOPY(1)IMGCOPY(1)-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.
Page 3
IMGCOPY(1)IMGCOPY(1)
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 ALSOimgview(1), imginfo(1), imgworks(1), imgformats(1)
Page 4
