[ceph.git] / ceph / src / boost / libs / geometry / doc / reference / io / wkt_format.qbk

[/============================================================================
  Boost.Geometry (aka GGL, Generic Geometry Library)

  Copyright (c) 2009-2014 Barend Gehrels, Amsterdam, the Netherlands.
  Copyright (c) 2014 Adam Wulkiewicz, Lodz, Poland.

  Use, modification and distribution is subject to the Boost Software License,
  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
  http://www.boost.org/LICENSE_1_0.txt)
=============================================================================/]

WKT is a general markup format in ASCII.
It is described in detail on [@http://en.wikipedia.org/wiki/Well-known_text Wikipedia]

Boost Geometry supports the common formats (POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON).

Because Boost.Geometry also supports Box and Segment geometries, which are not standard OGC geometries, there are some extensions:

[heading Box]
* can be read from WKT by specifying either a polygon (with 4 points) or a specific BOX string (non OGC)
* streamed to WKT as a POLYGON

[heading Segment]
* can be read from WKT by specifying either a linestring (with 2 points) or a specific SEGMENT string (non OGC)
* streamed to WKT as a LINESTRING

[heading Ring]
* can be read from WKT by specifying a polygon (with no holes)
* streamed to WKT as POLYGON
Commit	Line	Data
7c673cae FG	1	[/============================================================================
	2	Boost.Geometry (aka GGL, Generic Geometry Library)
	3
	4	Copyright (c) 2009-2014 Barend Gehrels, Amsterdam, the Netherlands.
	5	Copyright (c) 2014 Adam Wulkiewicz, Lodz, Poland.
	6
	7	Use, modification and distribution is subject to the Boost Software License,
	8	Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
	9	http://www.boost.org/LICENSE_1_0.txt)
	10	=============================================================================/]
	11
	12	WKT is a general markup format in ASCII.
	13	It is described in detail on [@http://en.wikipedia.org/wiki/Well-known_text Wikipedia]
	14
	15	Boost Geometry supports the common formats (POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON).
	16
	17	Because Boost.Geometry also supports Box and Segment geometries, which are not standard OGC geometries, there are some extensions:
	18
	19	[heading Box]
	20	* can be read from WKT by specifying either a polygon (with 4 points) or a specific BOX string (non OGC)
	21	* streamed to WKT as a POLYGON
	22
	23	[heading Segment]
	24	* can be read from WKT by specifying either a linestring (with 2 points) or a specific SEGMENT string (non OGC)
	25	* streamed to WKT as a LINESTRING
	26
	27	[heading Ring]
	28	* can be read from WKT by specifying a polygon (with no holes)
	29	* streamed to WKT as POLYGON