


IMCOPY(1IM)                IMAGE TOOLS                IMCOPY(1IM)



NAME
     imcopy  -  Copy a portion of an image to a new file

SYNOPSIS
     imcopy [_o_p_t_i_o_n_s] _i_n_f_i_l_e_n_a_m_e _o_u_t_f_i_l_e_n_a_m_e

DESCRIPTION
     imcopy copies a portion of an input image to a new file.  If
     the  input  file contains multiple images, a portion of each
     input image is copied and written to the output  file.   The
     input and output image file formats may be different.

OPTIONS
     imcopy has a  variety  of  options  in  the  following  five
     categories:

          File Selection     What input and output files to use
          Format Selection   What image file format to use
          Format Control     What variant of a file format to generate
          Standard           Standard generic options on all SDSC tools
          Manipulation       How the image can be manipulated

     _F_i_l_e _S_e_l_e_c_t_i_o_n, _F_o_r_m_a_t _S_e_l_e_c_t_i_o_n, _F_o_r_m_a_t _C_o_n_t_r_o_l, and  _S_t_a_n_-
     _d_a_r_d options are common to all SDSC image tools and are dis-
     cussed in depth in the man page for imconv(1IM).

     All options can be abbreviated to the first few unique char-
     acters.

  Manipulation Options
     The region of the input image to be copied to a new file  is
     defined by four arguments:

          -xposition _x   Left edge of region
          -yposition _y   Top edge of region
          -xsize _w       Width of region
          -ysize _h       Height of region

     -xposition and -yposition specify the copy  region  position
     and  are  constrained  to  be within the bounds of the input
     image.  (0,0) is the upper left corner  of  the  image.   If
     these  options  are  not  given,  the  copy  region position
     defaults to a position that centers  the region  within  the
     input image.

     -xsize and -ysize give the size of the copy region  and  are
     constrained to fit within the bounds of the input image.  If
     these options are not given, the copy region defaults  to  a
     rectangle  whose  upper  left  corner  is  at the given copy
     region position, and which extends to the right  and  bottom
     edges of the input image.




SDSC              Last change: August 26, 1992                  1






IMCOPY(1IM)                IMAGE TOOLS                IMCOPY(1IM)



NOTES
     For notes regarding  file  format  conversion  and  standard
     image tool options, see the man page on imconv(1IM).

     Error messages are reported to stderr.

EXAMPLES
     To copy from an Alias PIX file a 100x100 pixel region  whose
     upper  left corner is at (10,20) and store it to a Wavefront
     RLA file, use the following:

          imcopy picture.pix -xpos 10 -ypos 20 -xsize 100  -ysize
          100 clipart.rla

     To copy a 500x500 pixel region from the  center  of  an  HDF
     file and write it to a TIFF file, use the following:

          imcopy picture.hdf -xsize 500 -ysize 500 newpic.tiff

     To copy the top 20 scanlines from an XWD file and  store  it
     to a new XWD file, use the following:

          imcopy window.xwd -ypos 0 -ysize 20 border.xwd

     To copy an entire input GIF image to a  PCX  file,  use  the
     following:

          imcopy incoming.gif outgoing.pcx

     With no copy region specified, the actions of imcopy default
     to  the  same  as  the  SDSC  image  format  conversion tool
     imconv(1IM), but they take a little longer.

SEE ALSO
     imflip (1IM), imroll (1IM), imrotate (1IM),  imshear  (1IM),
     imscale (1IM), ImVfbCopy (3IM)

     For information on SDSC's image library, see imintro(3IM).

     For information on the individual image  file  formats,  see
     their  respective man pages: imbmp (3IM), imcur (3IM), imeps
     (3IM), imgif (3IM), imhdf (3IM), imico (3IM), imicon  (3IM),
     imiff  (3IM),  immpnt (3IM), impbm (3IM), impcx (3IM), impgm
     (3IM), impic (3IM), impict (3IM), impix (3IM), impnm  (3IM),
     imppm  (3IM),  imps  (3IM),  imras (3IM), imrgb (3IM), imrla
     (3IM), imrle  (3IM),  imrpbm  (3IM),  imrpgm  (3IM),  imrpnm
     (3IM),  imrppm  (3IM),  imsynu  (3IM),  imtga  (3IM), imtiff
     (3IM), imviff (3IM), imx (3IM), imxbm (3IM), imxwd (3IM)

AUTHOR
     Dave Nadeau
     San Diego Supercomputer Center



2                 Last change: August 26, 1992               SDSC






IMCOPY(1IM)                IMAGE TOOLS                IMCOPY(1IM)



     See the individual file format man pages for the authors  of
     the  underlying  format  read  and write code.  The names of
     these man pages begin with the letters "im" followed by  the
     format  name.  For example, the name of the TIFF man page is
     imtiff.  To display it, enter man imtiff.

CONTACT
     SDSC consultants, (619)534-5100, consult@y1.sdsc.edu















































SDSC              Last change: August 26, 1992                  3



