NAME

       psimage - To plot SUN rasterfiles on maps

SYNOPSIS

       psimage    rasterfile    [   -W[-]xlength[/ylength]   |   -Edpi   ]   [
       -Cxpos/ypos[/justify] ] [ -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.   The 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 col-
       ors, and (3) made transparent where  one  of  back-  or  foreground  is
       painted  only. As an option, the user may choose to convert colorimages
       to grayscale using TV’s YIQ-transformation.  The user may  also  choose
       to  replicate the image which, when preceded 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 formats can be converted to Sun for-
              mat via a variety of public-domain software (e.g., convert, 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).  If xlength is negative we use the absolate
              value and interpolate image to the device resolution  using  the
              PostScript image operator.  Alternatively, use -E.

OPTIONS

       No space between the option flag and the associated arguments.

       -C     Sets  position  of  lower  left  corner of image, and optionally
              append justification [0/0/LB].

       -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 tem-
              plates.  Use - for transparency (and  set  -Gf  to  the  desired
              color).

       -Gf    Sets foreground color (replace black pixel) for 1-bit image tem-
              plates.  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 (televi-
              sion) 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 sys-
              tem].

       -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.).  The  GMT  parameters
              UNIX_TIME  and  UNIX_TIME_POS can affect the appearance; see the
              gmtdefaults man page for details.

       -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 abso-
              lute coordinates; the default (r) will reset plot origin.   Give
              c to center plot using current page size.

       -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, use

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

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

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

SEE ALSO

       gmt(l)



GMT4.0                            1 Oct 2004                        PSIMAGE(l)