Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

psimage(1) [debian man page]

PSIMAGE(l)																PSIMAGE(l)

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 colorimages 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 formats 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 arguments. -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]. -bo Selects binary output. Append s for single precision [Default is double]. -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 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(1gmt) 1 Jan 2004 PSIMAGE(l)

Check Out this Related Man Page

PSSCALE(l)																PSSCALE(l)

NAME
psscale - Create grayscale or colorscale for maps SYNOPSIS
psscale -Dxpos/ypos/length/width[h] [ -Btickinfo ] [ -Ccpt_file ] [ -E[length] ] [ -I[max_intens] ] [ -K ] [ -L ] [ -M ] [ -Ndpi ] [ -O ] [ -P ] [ -U[/dx/dy/][label] ] [ -V ] [ -Xx-shift ] [ -Yy-shift ] [ -Zzfile ] [ -ccopies ] DESCRIPTION
psscale plots grayscales or colorscales on maps. Both horizontal and vertical scales are supported. For cpt_files with gradational colors (i.e., the lower and upper boundary of an interval have different r/g/b values) psscale will interpolate to give a continuous scale. Varia- tions in intensity due to shading/illumination may be displayed by setting the option -I. Colors may be spaced according to a linear scale, all be equal size, or by providing a file with individual tile widths. -D Defines the position of the center/top (for horizontal scale) or center/left (for vertical scale) and the dimensions of the scale. Append h to get a horizontal scale [Default is vertical]. OPTIONS
No space between the option flag and the associated arguments. -B Set anotation, tick, and gridline interval for the colorbar. The xaxis label will plot beneath a horizontal bar (or vertically to the right of a vertical bar). As an option, use the yaxis label to plot the data unit to the right of a horizontal bar (and above a vertical bar). If no values are provided, the default is to anotate every color level (which may be overridden by ULB flags in the cpt file). Note that since vertical labels will be plotted as a column of individual characters, no octal escape characters imbed- ded in the label are allowed. -C cpt_file is the color palette file to be used. By default all color changes are anotated. To use a subset, add an extra column to the cpt-file with a L, U, or B to anotate Lower, Upper, or Both color segment boundaries (but see -B). If not given, psscale will read stdin. As for grdview, psscale can understand pattern specifications in the cpt file. -E Add sidebar triangles for back- and foreground colors. Optionally, append triangle height [Default is half the barwidth]. -I Add illumination effects. Optionally, set the range of intensities from + to - max_intens. If not specified, 1.0 is used. [Default is no illumination] -K More PostScript code will be appended later [Default terminates the plot system]. -L Gives equal-sized color rectangles. Default scales rectangles according to the z-range in the cpt-file (Also see -Z). If set, any equal interval annotation set with -B will be ignored. -M Force a monochrome graybar using the (television) YIQ transformation. -N Effective dots-per-inch for the rectangular image making up the color scale [300]. -bo Selects binary output. Append s for single precision [Default is double]. -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 absolute coordinates; the default (r) will reset plot origin. -Z File with colorbar-width per color entry. By default, width of entry is scaled to color range, i.e., z = 0-100 gives twice the width as z = 100-150 (Also see -L). -c Specifies the number of plot copies. [Default is 1] EXAMPLES
To append a vertical colorscale (7.5 cm long; 1.25 cm wide) to the right of a plot that is 6 inch wide and 4 inch high, using illumination, and show back- and foreground colors, and anotating every 5 units, try psscale -D6.5i/2i/7.5c/1.25c -O -Ccolors.cpt -I -E -B5:BATHYMETRY:/:m: >> map.ps NOTES
When the cpt file is discrete and no illumination is specified, the color bar will be painted using polygons. For all other cases we must paint with an image. Some color printers may give slightly different colors for the two methods given identical RGB values. SEE ALSO
gmt(1gmt), makecpt(1gmt), grd2cpt(1gmt) 1 Jan 2004 PSSCALE(l)
Man Page

Featured Tech Videos