NAME

     psimage - To plot SUN rasterfiles on maps


SYNOPSIS

     psimage  rasterfile  [  -Wxlength[/ylength]  |  -Edpi  ]   [
     -Cxpos/ypos  ] [ -Fpen ] [ -G[f|b]r/g/b ] [ -I ] [ -K ] [ -M
     ] [ -Nnxrep/nyrep] [ -O ] [ -P ] [ -U[dx/dy/][label] ] [  -V
     ] [ -Xx-shift ] [ -Yy-shift ] [ -ccopies ]


DESCRIPTION

     psimage reads a 1, 8, 24, or 32-bit Sun rasterfile and plots
     it  on  a  map.   Image can be scaled arbitrarily, and 1-bit
     images can be (1) inverted, i.e., black pixels (on)  becomes
     white  (off)  and vice versa, or (2) colorized, by assigning
     different foreground and background  colors,  and  (3)  made
     transparent  where  one  of  back-  or foreground is painted
     only. As an option, the user may choose to convert  colorim-
     ages  to  grayscale using TV's YIQ-transformation.  The user
     may also choose to replicate the image which, when preceeded
     by  appropriate clip paths, may allow larger custom-designed
     fill patterns to be implemented (the -Gp  mechanism  offered
     in  most GMT programs is limited to rasters smaller than 146
     by 146).

     rasterfile
          This must be a Sun rasterfile.  Depth can be 1, 8,  24,
          or 32-bit. Old-style, Standard, Run-length-encoded, and
          RGB Sun rasterfiles are supported.  Other  raster  for-
          mats  can  be  converted to Sun format via a variety of
          public-domain software (e.g., imconv, xv).

     -E   Sets the dpi of the image in dots pr inch, or use -W.

     -W   Sets the size of the image.  If not  given  ylength  is
          set to xlength * (ny/nx).  Alternatively, use -E.



OPTIONS

     No space between the option flag and  the  associated  argu-
     ments.

     -C   Sets position of lower left corner of image [0/0].

     -F   Draws a rectangular frame around  the  image  with  the
          given pen [no frame].

     -Gb  Sets background color (replace white pixel)  for  1-bit
          image  templates.   Use - for transparency (and set -Gf
          to the desired color).

     -Gf  Sets foreground color (replace black pixel)  for  1-bit
          image  templates.   Use - for transparency (and set -Gb
          to the desired color).

     -I   Invert image before plotting (1-bit images only).  This
          is what is done when you use -GP in other GMT programs.

     -K   More PostScript code will be  appended  later  [Default
          terminates the plot system].

     -M   Convert color image to monochrome grayshades using  the
          (television) YIQ-transformation.

     -N   Replicate the image nxrep in x and nyrep in y  [Default
          is 1/1].

     -O   Selects Overlay plot mode [Default  initializes  a  new
          plot system].

     -P   Selects  Portrait  plotting  mode   [GMT   Default   is
          Landscape, see gmtdefaults to change this].

     -U   Draw Unix System time stamp on plot.  User may  specify
          where the lower left corner of the stamp should fall on
          the  page  relative  to  lower  left  corner  of  plot.
          Optionally,  append  a label, or c (which will plot the
          command string.)

     -V   Selects verbose mode, which will send progress  reports
          to stderr [Default runs "silently"].

     -X -Y
          Shift origin of plot by (x-shift,y-shift).   Prepend  a
          for  absolute  coordinates;  the default (r) will reset
          plot origin.

     -c   Specifies the number of plot copies. [Default is 1]


EXAMPLES

     To  plot  the  image  contained  in  the  8-bit   rasterfile
     scanned_face.ras, scaling it to 8 by 10 cm, try

     psimage scanned_face.ras -W8c/10c > image.ps

     To replicate the image template 1_bit.ras over a 5 by 5 inch
     area,  colorize  it, and setting each piece to be 1 by 1 cm,
     try

     psimage 1_bit.ras -Gb200/150/100 -Gf100/50/30 -N5i/5i -W1c >
     image.ps


SEE ALSO

     gmt(l)