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 .shpand.shx (or .SHPand.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 ([email protected]) is the maintainer of the shapelib shapefile library. Joonas Pihlaja ([email protected]) 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.

RELATED TO shpadd…