.TH r.in.poly
.SH NAME
\fIr.in.poly\fR \- Create raster maps from ascii polygon/line data files
in the current directory.
.br
.I "(GRASS Raster Program)"
.SH SYNOPSIS
\fBr.in.poly\fR
.br
\fBr.in.poly help\fR
.br
\fBr.in.poly\fR \fBinput=\fIname\fR \fBoutput=\fIname\fR \fB[title=\fI"phrase"]\fR \fB[rows=\fIvalue]\fR
.SH DESCRIPTION
.I r.in.poly allows the creation of GRASS binary raster maps from
ASCII files in the current directory
containing polygon and linear features.
.SH "COMMAND LINE OPTIONS"
.LP
Parameters
.IP \fBinput\*=\fIname\fR 20
Unix input file, in ascii format, containing the polygon and linear features.
The format of this file is described in the section
.B "INPUT FORMAT"
below.
.IP \fBoutput\*=\fIname\fR
Raster output file
.IP \fItitle\*="phrase"
Title for resultant raster map (optional)
.IP \fIrows\fR
Number of rows to hold in memory (default: 512).
This parameter allows users with less memory (or more) on their system
to control how much memory 
.I r.in.poly 
uses.
.SH "INPUT FORMAT"
The input format for the
.B input
file consists of sections describing either polygonal areas or linear features.
The basic format is:
.KS
.TS
tab(;);
lll.
A;;<for polygonal areas>
;easting northing
;.
;.
;.
\&=;cat# label
L;;<for linear features>
;easting northing
;.
;.
;.
\&=;cat# label
.TE
.KE
The
.I A
signals the beginning of a polygon. It must appear in the first
column. 
The
.I L
signal the beginning of a linear feature. It also must appear in the first
column. The coordinates of the vertices of the polygon, or the coordinates
defining the linear feature follow and must have a space in the first
column and at least one space between the 
.I easting
and the
.I northing.
To give meaning to the features, the
.I =
indicates that the feature currently being processed has
category value
.I cat#
(which must be an integer) and a
.I label
(which may be more than one word, or which may be omitted).
.SH "SEE ALSO"
.TS
tab(;);
ll.
r.digit;interactive on-screen polygon/line digitizing for raster maps
r.colors;creates color tables for raster maps
.TE
.SH AUTHOR
Michael Shapiro, U.S. Army Construction Engineering Research Laboratory