PSCLIP

Section: Misc. Reference Manual Pages (l)
Updated: DATE
Index Return to Main Contents
 

NAME

psclip - To set up polygonal clip paths  

SYNOPSIS

psclip xyfiles -Jparameters -Rwest/east/south/north[r] [ -Btickinfo ] [ -Eaz/el ] [ -Fred/green/blue ] [ -K ] [ -N ] [ -M[flag] ] [ -O ] [ -P ] [ -S ] [ -U[/dx/dy/][label] ] [ -V ] [ -Xx-shift ] [ -Yy-shift ] [ -Zzlevel ] [ -ccopies ] [ -: ]  

DESCRIPTION

psclip reads (x,y) file(s) [or standard input] and draws polygons that are activated as clipping paths. Several files may be read to create complex paths consisting of several non-connecting segments. As an option (-N), the user may choose to reverse the sense of what is the inside and outside of the paths. After subsequent plotting, which will be clipped against these paths, the clipping may be deactivated by running psclip with the -S option only.
xyfiles
File(s) with (x,y) values for clip polygons. If no files are given, the standard input is read. #include "explain_-j.txt" #include "explain_-R.txt"
 

OPTIONS

No space between the option flag and the associated arguments

#include "explain_-b.txt"

-E
Sets the viewpoint's azimuth and elevation [180/90]
-F
Sets the color used for Frame and annotation. [Default is black] #include "explain_-H.txt" #include "explain_-K.txt"
-M
Multiple segment file. Segments are separated by a record whose first character is <flag>. [Default is '>'].
-N
Invert the sense of what is inside and outside, i.e., use the outside of the polygons for clipping. #include "explain_-O.txt" #include "explain_-P.txt"
-S
Mark end of existing clip path. No input file is needed. Implicitly sets -O. #include "explain_-U.txt" #include "explain_-V.txt" #include "explain_-XY.txt"
-Z
For 3-D projections: Sets the z-level of the polygons [0]. #include "explain_-t.txt" #include "explain_-c.txt"
 

EXAMPLES

To make an overlay PostScript file that will set up a complex clip area to which subsequent plotting will be confined to, try:

psclip my_region.xy -R0/40/0/40 -Jm0.3 -O -K > clip_mask_on.ps

To deactivate the clipping, run:

psclip -S -O > clip_mask_off.ps  

SEE ALSO

gmt, psbasemap, psmask #include "refs.i"


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 07:12:30 GMT, January 07, 2025