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