NAME
shpadd - append a shape to an ESRI shapefile
SYNOPSIS
shpadd file [[x y] [+]]*
DESCRIPTION
Appends a shape to the shapefile determined from file. The geometric
data of the new shape consists of lists of X/Y points on the command
line grouped into parts, with points in different parts separated by a
plus (+) sign. If no points or parts are given then a shape of type
NullShape is appended to the shapefile, and otherwise the type of the
new shape is determined by the shapefile’s header. See shpdump(1) for
a description of shape types and how geometric data for parts are
interpreted for a specific type. No geometric restrictions set by the
shapefile specification are enforced by shpadd(1).
Shapefiles actually consist of two files with the same basename and
extensions .shp and .shx (or .SHP and .SHX) containing the shape data
and shape index respectively. The files to open are determined by
first stripping any filename extension from file and attempting to open
the files file.shp or file.SHP, and file.shx or file.SHX for the
respective data and index files.
EXIT STATUS
0 Successful program execution.
1 Missing file argument, the shapefile can’t be opened, or the
program ran out of memory.
DIAGNOSTICS
The following diagnostics may be issued on stdout:
Unable to open:file
Out of memory
AUTHORS
Frank Warmerdam (warmerdam@pobox.com) is the maintainer of the shapelib
shapefile library. Joonas Pihlaja (jpihlaja@cc.helsinki.fi) wrote this
man page.
BUGS
Coordinate values that can’t be be parsed by sscanf(3) get undefined
values. There’s no way to give measure or Z data to vertices in a
shape, but those are always set to zero if the shapefile’s shape type
requires those values. MultiPatch shape types aren’t supported.
SEE ALSO
dbfadd(1), dbfcreate(1), dbfdump(1), dbf_dump(1), shpcreate(1),
shpdump(1), shprewind(1)