Chapter Contents |
Previous |
Next |

POLYCONT Function |

Syntax | |

Associated Variables | |

Details |

## Syntax |

FUNCTION='POLYCONT'; |

Associated Variables |

- COLOR='
**color**' - specifies the polygon outline color.
**Color**can be any SAS/GRAPH color name. You can specify an outline color only with the first POLYCONT command in the sequence; all subsequent POLYCONT commands ignore the COLOR variable. If you do not specify a color, the POLYCONT function uses the interior color that was specified with the POLY function. - GROUP=
**group-value**

MIDPOINT=**midpoint-value**

SUBGROUP=**subgroup-value** - specify coordinates for HBAR and VBAR charts from the GCHART procedure. Use these variables only with the data coordinate systems 1, 2, 7, and 8.
- WHEN='B' | 'A'
- specifies when to draw the polygon in relation to other procedure output.
- X=
**horizontal-coordinate**

Y=**vertical-coordinate**

Z=**depth-coordinate**(PROC G3D only)

XC='**character-type-horizontal-coordinate**'

YC='**character-type-vertical-coordinate**' - specify a point on the outline of the polygon that is being created. Use the Z variable only with the G3D procedure.
- XSYS='
**coordinate-system**' - specifies the coordinate system for
the X and XC variable. Use the XC variable only with XSYS='2'. See XSYS Variable for an explanation
of
**coordinate-system**. - YSYS='
**coordinate-system**' - specifies the coordinate system for
the Y and YC variable. Use the YC variable only with YSYS='2'. See YSYS Variable for an explanation
of
**coordinate-system**. - ZSYS='
**coordinate-system**' - specifies the coordinate system for
the Z variable. See ZSYS Variable
for an explanation of
**coordinate-system**.

Details |

The polygon definition is terminated by a new POLY command or by any of these functions:

BAR | LABEL | PIEXY |

DRAW | MOVE | POINT |

DRAW2TXT | PIE | SYMBOL |

FRAME | PIECNTR |

Use POLY and POLYCONT together to draw a polygon. The (X, Y) observation from the POLY function and the last (X, Y) observation from POLYCONT are assumed to connect. Thus, you are not required to respecify the first point. For example, these statements draw a pentagon like the one in Pentagon Produced with the POLY and POLYCONT Functions:

data house; retain xsys ysys '3'; length function $ 8; /* start at the lower left corner */ function='poly'; x=35; y=25; output; /* move to the lower right corner */ function='polycont'; x=65; y=25; output; /* move to the upper right corner */ function='polycont'; x=65; y=65; output; /* move to the center top*/ function='polycont'; x=50; y=80; output; /* move to the upper left corner and complete the figure */ function='polycont'; x=35; y=65; output; run; proc ganno anno=house; run; quit;

*Pentagon Produced with the POLY and POLYCONT Functions*

Missing values for the X and Y variables that are specified with POLYCONT are interpreted differently from the way that they are interpreted with the other functions. Other functions use the missing values to request a default value. POLYCONT interprets a missing value as a discontinuity (that is, a hole) in the polygon. If you are not using the data coordinate system and you specify an X or Y value of -999 in a POLYCONT observation, the default of (XLAST, YLAST) is used. Missing values indicate holes and are handled identically in the Annotate facility and the GMAP procedure. See Displaying Map Areas and Response Data for more information on handling missing values.

Chapter Contents |
Previous |
Next |
Top of Page |

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.