From fd3f4af8cc1afc20c3a131ab3004e84fda0e2828 Mon Sep 17 00:00:00 2001
From: Regina Obe <lr@pcorp.us>
Date: Tue, 22 Dec 2015 19:32:35 +0000
Subject: [PATCH] Add figures for ST_Boundary references #3406
git-svn-id: http://svn.osgeo.org/postgis/trunk@14517 b70326c6-7e19-0410-871a-916f4a2858ee
---
doc/html/image_src/Makefile.in | 2 ++
doc/html/image_src/st_boundary01.wkt | 2 ++
doc/html/image_src/st_boundary02.wkt | 2 ++
doc/reference_accessor.xml | 46 +++++++++++++++++++++++++++-
4 files changed, 51 insertions(+), 1 deletion(-)
create mode 100644 doc/html/image_src/st_boundary01.wkt
create mode 100644 doc/html/image_src/st_boundary02.wkt
diff --git a/doc/html/image_src/Makefile.in b/doc/html/image_src/Makefile.in
index 2e9bde714..521331196 100644
--- a/doc/html/image_src/Makefile.in
+++ b/doc/html/image_src/Makefile.in
@@ -23,6 +23,8 @@ IMAGES= \
../images/de9im02.png \
../images/st_azimuth01.png \
../images/st_azimuth02.png \
+ ../images/st_boundary01.png \
+ ../images/st_boundary02.png \
../images/st_buffer01.png \
../images/st_buffer02.png \
../images/st_buffer03.png \
diff --git a/doc/html/image_src/st_boundary01.wkt b/doc/html/image_src/st_boundary01.wkt
new file mode 100644
index 000000000..119ce17c7
--- /dev/null
+++ b/doc/html/image_src/st_boundary01.wkt
@@ -0,0 +1,2 @@
+Style1;LINESTRING(100 150,50 60, 70 80, 160 170)
+Style2;MULTIPOINT(100 150,160 170)
diff --git a/doc/html/image_src/st_boundary02.wkt b/doc/html/image_src/st_boundary02.wkt
new file mode 100644
index 000000000..728dd79ff
--- /dev/null
+++ b/doc/html/image_src/st_boundary02.wkt
@@ -0,0 +1,2 @@
+Style1;POLYGON (( 10 130, 50 190, 110 190, 140 150, 150 80, 100 10, 20 40, 10 130 ), ( 70 40, 100 50, 120 80, 80 110, 50 90, 70 40 ))
+Style2;MULTILINESTRING((10 130,50 190,110 190,140 150,150 80,100 10,20 40,10 130),(70 40,100 50,120 80,80 110,50 90,70 40))
diff --git a/doc/reference_accessor.xml b/doc/reference_accessor.xml
index 82cab68e7..a820d2c87 100644
--- a/doc/reference_accessor.xml
+++ b/doc/reference_accessor.xml
@@ -128,6 +128,50 @@
<refsection>
<title>Examples</title>
+ <informaltable>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry><para><informalfigure>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/st_boundary01.png" />
+ </imageobject>
+ <caption><para>Linestring with boundary points overlaid</para></caption>
+ </mediaobject>
+ </informalfigure>
+ <programlisting>SELECT ST_Boundary(geom)
+FROM (SELECT 'LINESTRING(100 150,50 60, 70 80, 160 170)'::geometry As geom) As f;
+ </programlisting>
+<screen>-- ST_AsText output
+MULTIPOINT(100 150,160 170)
+</screen>
+ </para></entry>
+
+ <entry><para><informalfigure>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/st_boundary02.png" />
+ </imageobject>
+ <caption><para>polygon holes with boundary multilinestring</para></caption>
+ </mediaobject>
+ </informalfigure>
+ <programlisting>SELECT ST_Boundary(geom)
+FROM (SELECT
+'POLYGON (( 10 130, 50 190, 110 190, 140 150, 150 80, 100 10, 20 40, 10 130 ),
+ ( 70 40, 100 50, 120 80, 80 110, 50 90, 70 40 ))'::geometry As geom) As f;
+ </programlisting>
+<screen>-- ST_AsText output
+MULTILINESTRING((10 130,50 190,110 190,140 150,150 80,100 10,20 40,10 130),
+ (70 40,100 50,120 80,80 110,50 90,70 40))
+</screen>
+ </para></entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </informaltable>
+
<programlisting>SELECT ST_AsText(ST_Boundary(ST_GeomFromText('LINESTRING(1 1,0 0, -1 1)')));
st_astext
-----------
@@ -156,7 +200,7 @@ MULTIPOINT(-1 1 1,1 1 0.75)
<refsection>
<title>See Also</title>
- <para><xref linkend="ST_ExteriorRing" />, <xref linkend="ST_MakePolygon" /></para>
+ <para><xref linkend="ST_AsText" />, <xref linkend="ST_ExteriorRing" />, <xref linkend="ST_MakePolygon" /></para>
</refsection>
</refentry>
--
2.40.0