Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

shpadd(1) [debian man page]

SHAPELIB(1)							   User Commands						       SHAPELIB(1)

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)

shapelib							   OCTOBER 2004 						       SHAPELIB(1)

Check Out this Related Man Page

DTK_CREATE_STRING(3)						Draw Toolkit manual					      DTK_CREATE_STRING(3)

NAME

       dtk_create_string - Creates or modify a shape to display a string

SYNOPSIS

       #include <drawtk.h>

       dtk_hshape dtk_create_string(dtk_hshape shp, const char *text,
				    float size, float x, float y,
				    unsigned int alignment,
				    const float *color, dtk_hfont font);

DESCRIPTION

       dtk_create_string()  creates  a text specified by text at location (x,y) with a font size of size using a previously loaded font referenced
       by font argument (see dtk_load_font(3)).

       The position (x,y) is interpreted according to the combination of flags controlling the vertical and horizontal alignment  defined  in  the
       alignment argument:

	* DTK_BOTTOM,  DTK_VMID  and DTK_TOP make the value y to be interpreted as respectively the bottom, the middle and the top of the bounding
	  box of the shape.

	* DTK_LEFT, DTK_HMID and DTK_RIGHT make the value x to be interpreted as respectively the left, the middle and the right of  the  bounding
	  box of the shape.

       shp and color has the same usage and meaning than in other shape creation functions (see dtk_create_shape(3)):

	* shp  can be used to modify a previously created shape. If it is non-null, the handle will be used to modify the shape referenced by shp:
	  no new shape is created and the returned value is ensured to be shp in case of success, NULL otherwise. If shp  is  NULL,  the  function
	  will attempt to create a new shape.

	* color should point to a 4 float array containing a normalized RGBA value (i.e. each component is between 0.0 and 1.0).

RETURN VALUE

       In  case  of  success  the  function returns the handle to the newly created or modified shape. If the shp argument is non-null, the handle
       returned is the same value. In case of error, NULL is returned.

SEE ALSO

       dtk_load_font(3), dtk_create_shape(3)

EPFL
								       2010						      DTK_CREATE_STRING(3)
Man Page