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)