self-hosted/postgis
self-hosted/postgis
1
0
Fork 0
mirror of https://git.osgeo.org/gitea/postgis/postgis synced 2024-10-23 08:32:42 +00:00
Code Issues Packages Projects Releases Wiki Activity

provide better example and images to complement. Also note that ST_AsRaster doesn't yet work with newer geometries

Browse source 
git-svn-id: http://svn.osgeo.org/postgis/trunk@7784 b70326c6-7e19-0410-871a-916f4a2858ee
This commit is contained in:
Regina Obe 2011-08-25 11:33:45 +00:00
parent ef467a5c27
commit 6fa2dc33a0
3 changed files with 26 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

BIN
doc/html/images/st_asraster01.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 638 B

BIN
doc/html/images/st_asraster02.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.3 KiB

32
doc/reference_raster.xml
View file

@ -4529,25 +4529,45 @@ FROM dummy_rast WHERE rid=2;
<para>To create the postgis raster, the X and Y scale or the width and height of the new raster or a reference raster must be provided.</para>
<para>The output raster will be in the same coordinate system as the source geometry. The only exception is for ST_AsRaster variations with a raster input parameter. </para>
<para>Availability: 2.0.0 - requires GDAL &gt;= 1.6.0. </para>
<note><para>Not yet capable of rendering complex geometry types such as curves, TINS, and PolyhedralSurfaces, but should be
able too once GDAL can.</para></note>
</refsection>
<refsection>
<title>Examples: Output geometries as PNG files</title>
<para><informalfigure>
<mediaobject>
<imageobject>
<imagedata fileref="images/st_asraster01.png" />
</imageobject>
<caption><para>black circle</para></caption>
</mediaobject>
</informalfigure></para>
<programlisting>
-- this will output a black circle taking up 150 x 150 pixels --
SELECT ST_AsPNG(ST_AsRaster(ST_Buffer(ST_Point(1,5),10),150, 150, '2BUI'));</programlisting>
<programlisting>-- this will output a red circle taking up 150 x 150 pixels --
SELECT ST_AsPNG(ST_AsRaster(ST_Buffer(ST_Point(1,5),10),150, 150,
ARRAY['8BUI', '8BUI', '8BUI'],
ARRAY[200,0,0], ARRAY[0,0,0]));</programlisting>
<para><informalfigure>
<mediaobject>
<imageobject>
<imagedata fileref="images/st_asraster02.png" />
</imageobject>
<caption><para>example from buffer rendered with just PostGIS</para></caption>
</mediaobject>
</informalfigure></para>
<programlisting>-- the bands map to RGB bands - the value (118,154,118) - teal --
SELECT ST_AsPNG(
ST_AsRaster(
ST_Buffer(
ST_GeomFromText('LINESTRING(50 50,150 150,150 50)'), 10,'join=bevel'),
200,200,ARRAY['8BUI', '8BUI', '8BUI'], ARRAY[118,154,118], ARRAY[0,0,0]));</programlisting>
</refsection>
<!-- Optionally add a "See Also" section -->
<refsection>
<title>See Also</title>
<para><xref linkend="RT_ST_BandPixelType" />, <xref linkend="RT_ST_GDALDrivers" />, <xref linkend="RT_ST_AsGDALRaster" />,<xref linkend="RT_ST_AsPNG" /> , <xref linkend="RT_ST_AsJPEG" />, <xref linkend="RT_ST_SRID" /></para>
<para><xref linkend="RT_ST_BandPixelType" />, <xref linkend="ST_Buffer" />, <xref linkend="RT_ST_GDALDrivers" />, <xref linkend="RT_ST_AsGDALRaster" />,<xref linkend="RT_ST_AsPNG" /> , <xref linkend="RT_ST_AsJPEG" />, <xref linkend="RT_ST_SRID" /></para>
</refsection>
</refentry>