PATRN                                                              Menu: POLYG
==============================================================================
Fills a polygon with a predesigned pattern.

         1.  (CHAR) name of fill pattern (1-8 char.) (<ENTER> for pull-down lib.)
         2.  (NUM) color of pattern (<ENTER> -original color)
         3.  (NUM) scale factor (greater than 0)
         4.  (POINT) origin
         5.  (POINT) point for direction
         6.* (IND) polygon to fill (press <ENTER> for NEW origin)
         7.* (Y/N) confirm choice

Description

This command fills polygons with patterns. A pattern is any system file saved
either in your current directory or in the \ARCALIB directory.

Identify the fill pattern either by its name or using the pull-down library
(press ENTER for the pull-down library).

Specify a color for the pattern or press ENTER to use the original pattern
color. If the original pattern consists of two colors, both will be changed
to the specified color.

Enter the scaling factor (greater than 0), then indicate the origin point and
a direction point for the fill. Indicate and confirm the polygon to fill (the
procedure may take some time) or press ENTER for a new origin point.

To halt the drawing of the pattern, press Alt+Shift simultaneously.

A pattern is a set of polygons, so it may be selected using option `a' (hatch)
in the \apsel command. The patterns can be created on any plane.

The system repeats the prompt requesting a polygon to fill until you enter a
new command. You may press ENTER to define a new origin point and direction
point if you indicated them incorrectly.

If your scaling factor is larger than 1 (the original pattern definition)
and the polygon to fill is smaller than 1, only part of the pattern will be
included in your polygon. Therefore, it is important to relate to the
dimension of the pattern.

The polygon to fill may contain inner or outer loops created using \pjump.

To define the pattern, create a motif using the system. You may use any
system entity, i.e., lines, polygons, etc., except arcs. If you want to set
spaces between each repetition of the basic pattern, you can create a
`control line' (line type 4) parallel to the X and/or Y axes, at the
requested distance from the pattern to the start point of the next
repetition of that pattern.

You may now add your pattern to the system pattern library (named L$FILPAT)
by saving the file under any name (\save command) and then using the \olib
command (option `a' or `e'). For the file description, it is recommended to
type the pattern dimensions in order to reference a factor. The pattern files
may be located either in your current directory or in the \ARCALIB directory.

The next time you display the pull-down library it will contain the newly
added fill patterns.
