Name
psc — PostScript plotting
Syntax
psc lwf | slwf | on | off | open | close | scp | fontsize | vie | align | status | prot | col | font | fill | rec | stroke | expand | talign | txt | axes | curtxt | pos | line | chf | utmgrid | moveto | lineto | win | devcm2user | arc | ssc | bmp | jpeg | cross | newline | clip | linestyle | linewidth | outline | dash | overprint | ticml | pattern
Description
PostScript plotting, settings and commands.
The plotting system in Geocap called dplot is applying these commands to plot maps with a high carthographic standard.
PostScript is a state system which means that a specific setting is valid until a new setting is applied.
Note that it is possible to use psc com to write native PostScript commands. Check the PostScript Reference Manual (third edition).
Arguments
lwf line_width_factor
Set the line_width_factor of a postscript pen.
slwf line_width_factor
Set line_width_factor for shift lines in contouring.
open file_name
Open the file_name for writing postscript output.
close
Close the current output file for writing postscript output.
scp scale_in_meters_x scale_in_meters_y rel_portion_of_horizontal_margin_left rel_portion_of_vertical_margin_bottom
Scale plot, using the scale parameters for plot in x and y direction and the relative portion of the margins.
fontsize fontsize [cm]
Set the fontsize in user coordinates or in cm.
vie x_lower_left y_lower_left x_upper_right y_upper_right [cm]
Set viewport area, either in relative coordinates or in cm.
align [top | bottom | left | right | center]
Set graphics alignment.
status
Will write out the status of postscript in the message window.
prot [reset] | x_position y_position rotation_angle [cm]
Set rotation of plot in user or cm coordinates.
col red blu gre
Display the postscript line in rgb values red blu gre. Observe that the standard col command will also affect postscript when active.
font font_number
Will set the font with the given font_number.
fill
Will issue the postscript fill command in the output file.
stroke
Will issue the postscript stroke command in the output file.
rec x_lower_left y_lower_left x_upper_right y_upper_right
Will draw a rectangle according to the parameter input.
expand hor | ver | inside | outside | cover
Will expand the plot inside the viewport according to the argument.
Scale to match width of window/viewport
hor: scale_y = scale_x.
ver: scale_x = scale_y.
inside: shortest of scale_x or scale_y.
outside: longest of scale_x or scale_y.
cover: scale to viewport exactly.
txt text
Display text in the plot using the active font and font size.
curtxt curve_text [size size] [rot rot_angle] [use] [bsp] [palign align_x align_y]
Display curve_text by following the curve in active data using the active font and font size.
use: use the curve as it is. bsp: b-spline the curve. palign: position aligning the text according to align_x align_y.
If these parameters are set to 0 the text will be placed on the line.
axes n | e | w | s [incrx | incry | factorx | factory | offsetx | offsety]
Display axes for side: north | east | west | south. Specify increment, factor and offset.
talign x_position y_position
Set graphics alignment of text.
ticml tic_mark_length
Specify tic mark length for axes of size tic_mark_length.
pos x_position y_position cm
Set current position. Possibly translate from user to cm.
line x_start y_start x_stop y_stop
Will draw a line from start to stop.
chf crosshair_factor
Factor of the small cross lines in geographical grid.
utmgrid delta_x delta_y cross_size
Plotting of utmgrid or current projection.
moveto x_start y_start
Will move the pen to the start position.
lineto x_stop y_stop
Will draw the pen to the stop position.
win x_lower_left y_lower_left x_upper_right y_upper_right [aoi]
Set plot window area in world coordinates. aoi means set this as area of interest.
devcm2user
Will return to a Tcl variable the factor between cm and user coordinates.
user2devcm
Will return to a Tcl variable the factor between user and cm coordinates.
arc x_center y_center radius start_angle stop_angle
Will draw an arc according to the parameters specified.
ssc
Will set the area of interest to match the bounding box of active data.
bmp | jpeg | jpg file_name | use
Display a bit map of specified format from a file_name or use the current graphics on the screen.
cross x_center y_center size
Will draw a cross at x_center y_center with the total size in x and y directions.
newline
Issue a new text line equivalent to 1.2 times the fontsize.
clip x_lower_left y_lower_left x_upper_right y_upper_right
Clip out an area of the plot in user coordinates.
linestype line_style
Will set the line style, use 0,1 or 2. Ref. PostScript Reference Manual (third edition) p.673-674, setlinecap.
linewidth line_width
Will set the line with size. To be used in pattern specifications.
outline on | off
Will set outline of text on | off.
overprint on | off
Will set overprint of graphics on | off.
dash dash1 space1 dash2 space2 etc...
Will set line plotting in dash mode according to the dash pattern. Ref. PostScript Reference Manual (third edition) p.666.
pattern open x_size y_size
Open a pattern of size x_size y_size.
The postscript commands making up the pattern should be coded hereafter.
pattern close name [rotation]
Close the active pattern and name it name. Optionally use a rotation.
pattern name
Use pattern with name of pattern name.
Examples
Ex.1: Producing a postscript plot
psc format a4 ;# specify format
win demo ;# demo window: 450000 460000 6450000 6460000 1000 4000
psc open c:/users/olav/psfile.ps ;# open output file
psc on ;# set postscript on
psc vie 0.1 0.1 0.9 0.9 ;# specify viewport in viewport coordinates
mak ran 11 ;# make 11 random points
grp 99 99 ;# grid surface 99 x 99 elements
sma i 250 can ;# spline map and annotate contours
psc off ;# turn off postscript
sma i 250 sav ;# spline map and sav contours
psc on ;# turn on postscript
mak glc ;# get largest cell
col red ;# set red color
pol ;# draw the line
psc fontsize 1.5 cm ;# set font size
psc col .3 .2 .6 ;# set color
psc curtxt "Largest contour" palign 0 0 ;# plot text to follow curve with no alignment
psc pos 450200 6461000 ;# specify position
psc fontsize 2.8 cm ;# set font size
psc col .5 .9 .9 ;# set color
psc txt "This is a text" ;# plot text
psc outline on ;# activate outline
psc lwf 2 ;# set line width factor
psc col 0 0 0 ;# color black
psc txt "This is a text" ;# plot outline around text
psc outline off ;# outline feature off
psc lwf 1 ;# reset line width factor
col gre ;# set green color
dra dwa ;# dra data window area
psc fontsize 0.5 cm ;# set font size
psc ticml 0.15 ;# set tic mark length (in cm)
psc axes ns incrx 2000 incry 2000 ;# draw axes in north and south
psc axes ew incrx 2000 incry 2000 ;# draw axes in east and west
psc close ;# close postscript
The above example produces this image.
Simple postscript plot to demonstrate principles.