@crossbind/port-gdal-wasi 2.0.0-beta.50

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal_contour.1

@@ -0,0 +1,352 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "GDAL_CONTOUR" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal_contour \- Builds vector contour lines from a raster elevation model.
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_contour [\-\-help] [\-\-help\-general]
+             [\-b <band>] [\-a <attribute_name>] [\-amin <attribute_name>] [\-amax <attribute_name>]
+             [\-3d] [\-inodata] [\-snodata <n>] [\-f <formatname>] [\-i <interval>]
+             [\-dsco <NAME>=<VALUE>]... [\-lco <NAME>=<VALUE>]...
+             [\-off <offset>] [\-fl <level> <level>...] [\-e <exp_base>]
+             [\-nln <outlayername>] [\-q] [\-p] [\-gt <n>|unlimited]
+             <src_filename> <dst_filename>
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+The \fBgdal_contour\fP generates a vector contour file from the input
+raster elevation model (DEM).
+.sp
+The contour line\-strings are oriented consistently and the high side will
+be on the right, i.e. a line string goes clockwise around a top.
+.sp
+\fBTIP:\fP
+.INDENT 0.0
+.INDENT 3.5
+Equivalent in new \(dqgdal\(dq command line interface:
+.sp
+See \fI\%gdal raster contour\fP\&.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-help
+Show this help message and exit
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-help\-general
+Gives a brief usage message for the generic GDAL commandline options and exit.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-q, \-\-quiet
+Suppress progress messages and other non\-error output.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-b <band>
+Picks a particular band to get the DEM from. Defaults to band 1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a <name>
+Provides a name for the attribute in which to put the elevation.
+If not provided no elevation attribute is attached.
+Ignored in polygonal contouring (\fI\%\-p\fP) mode.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-amin <name>
+Provides a name for the attribute in which to put the minimum elevation
+of contour polygon. If not provided no minimum elevation attribute
+is attached. Ignored in default line contouring mode.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-amax <name>
+Provides a name for the attribute in which to put the maximum elevation of
+contour polygon. If not provided no maximum elevation attribute is attached.
+Ignored in default line contouring mode.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-3d
+Force production of 3D vectors instead of 2D.
+Includes elevation at every vertex.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-inodata
+Ignore any nodata value implied in the dataset \- treat all values as valid.
+Cannot be used together with \fI\%\-snodata\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-snodata <value>
+Input pixel value to treat as \(dqnodata\(dq.
+Cannot be used together with \fI\%\-inodata\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-f <format>
+Create output in a particular format.
+.INDENT 7.0
+.INDENT 3.5
+If not specified, the format is guessed from the extension (previously was ESRI Shapefile).
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-dsco <NAME>=<VALUE>
+Dataset creation option (format specific)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-lco <NAME>=<VALUE>
+Layer creation option (format specific)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-i <interval>
+Elevation interval between contours.
+Must specify either \fI\%\-i\fP or \fI\%\-fl\fP or \fI\%\-e\fP\&.
+The first contour will be generated at the first multiple of \fBinterval\fP which is greater than the raster minimum value.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-off <offset>
+Offset from zero relative to which to interpret intervals.
+.sp
+For example, \fI\-i 100\fP requests contours at ...\-100, 0, 100...
+Further adding \fI\-off 25\fP makes that request instead ...\-75, 25, 125...
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-fl <level>
+Name one or more \(dqfixed levels\(dq to extract, in ascending order separated by spaces.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-e <base>
+Generate levels on an exponential scale: \fIbase ^ k\fP, for \fIk\fP an integer.
+Must specify either \-i or \-fl or \-e.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-nln <name>
+Provide a name for the output vector layer. Defaults to \(dqcontour\(dq.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-p
+Generate contour polygons rather than contour lines.
+.sp
+When this mode is selected the polygons are created for values between
+each level specified by \fI\%\-i\fP or \fI\%\-fl\fP or \fI\%\-e\fP,
+in case \fI\%\-fl\fP is used alone at least two fixed levels must be specified.
+.sp
+The minimum and maximum values from the raster are not automatically added to
+the fixed levels list but the special values \fBMIN\fP and \fBMAX\fP (case insensitive)
+can be used to include them.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-gt <n>
+Group n features per transaction (default 100 000). Increase the value for
+better performance when writing into DBMS drivers that have transaction
+support. \fBn\fP can be set to unlimited to load the data into a single
+transaction. If set to 0, no explicit transaction is done.
+.sp
+Added in version 3.10.
+
+.UNINDENT
+.SH RETURN STATUS CODE
+.sp
+The program returns status code 0 in case of success, and non\-zero in case of
+error (non\-blocking errors emitted as warnings are considered as a successful
+execution).
+.SH C API
+.sp
+Functionality of this utility can be done from C with \fI\%GDALContourGenerate()\fP\&.
+.SH EXAMPLES
+.SS Example 1
+.INDENT 0.0
+.TP
+.B title
+Creating contours from a DEM
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_contour \-a elev dem.tif contour.shp \-i 10.0
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+This would create 10\-meter contours from the DEM data in \fBdem.tif\fP and
+produce a shapefile in \fBcontour.shp|shx|dbf\fP with the contour elevations
+in the \fBelev\fP attribute.
+.SS Example 2
+.INDENT 0.0
+.TP
+.B title
+Creating polygonal contours from a DEM
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ cat test.asc
+ncols        2
+nrows        2
+xllcorner    0
+yllcorner    0
+cellsize     1
+4 15
+25 36
+
+$ gdal_contour test.asc \-f GeoJSON /vsistdout/ \-i 10 \-p \-amin min \-amax max
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+This would create 10\-meter polygonal contours from the DEM data in \fBtest.asc\fP
+and produce a GeoJSON output with the contour min and max elevations in the \fBmin\fP
+and \fBmax\fP attributes, including the minimum and maximum values from the raster.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+{
+    \(dqtype\(dq: \(dqFeatureCollection\(dq,
+    \(dqname\(dq: \(dqcontour\(dq,
+    \(dqfeatures\(dq: [
+    { \(dqtype\(dq: \(dqFeature\(dq, \(dqproperties\(dq: { \(dqID\(dq: 0, \(dqmin\(dq: 4.0, \(dqmax\(dq: 10.0 }, \(dqgeometry\(dq: { \(dqtype\(dq: \(dqMultiPolygon\(dq, \(dqcoordinates\(dq: [ [ [ [ 0.5, 1.214285714285714 ], [ 1.045454545454545, 1.5 ], [ 1.045454545454545, 2.0 ], [ 1.0, 2.0 ], [ 0.5, 2.0 ], [ 0.0, 2.0 ], [ 0.0, 1.5 ], [ 0.0, 1.214285714285714 ], [ 0.5, 1.214285714285714 ] ] ] ] } },
+    { \(dqtype\(dq: \(dqFeature\(dq, \(dqproperties\(dq: { \(dqID\(dq: 1, \(dqmin\(dq: 10.0, \(dqmax\(dq: 20.0 }, \(dqgeometry\(dq: { \(dqtype\(dq: \(dqMultiPolygon\(dq, \(dqcoordinates\(dq: [ [ [ [ 1.5, 1.261904761904762 ], [ 2.0, 1.261904761904762 ], [ 2.0, 1.5 ], [ 2.0, 2.0 ], [ 1.5, 2.0 ], [ 1.045454545454545, 2.0 ], [ 1.045454545454545, 1.5 ], [ 0.5, 1.214285714285714 ], [ 0.0, 1.214285714285714 ], [ 0.0, 1.0 ], [ 0.0, 0.738095238095238 ], [ 0.5, 0.738095238095238 ], [ 1.5, 1.261904761904762 ] ] ] ] } },
+    { \(dqtype\(dq: \(dqFeature\(dq, \(dqproperties\(dq: { \(dqID\(dq: 2, \(dqmin\(dq: 20.0, \(dqmax\(dq: 30.0 }, \(dqgeometry\(dq: { \(dqtype\(dq: \(dqMultiPolygon\(dq, \(dqcoordinates\(dq: [ [ [ [ 0.954545454545455, 0.0 ], [ 0.954545454545455, 0.5 ], [ 1.5, 0.785714285714286 ], [ 2.0, 0.785714285714286 ], [ 2.0, 1.0 ], [ 2.0, 1.261904761904762 ], [ 1.5, 1.261904761904762 ], [ 0.5, 0.738095238095238 ], [ 0.0, 0.738095238095238 ], [ 0.0, 0.5 ], [ 0.0, 0.0 ], [ 0.5, 0.0 ], [ 0.954545454545455, 0.0 ] ] ] ] } },
+    { \(dqtype\(dq: \(dqFeature\(dq, \(dqproperties\(dq: { \(dqID\(dq: 3, \(dqmin\(dq: 30.0, \(dqmax\(dq: 36.0 }, \(dqgeometry\(dq: { \(dqtype\(dq: \(dqMultiPolygon\(dq, \(dqcoordinates\(dq: [ [ [ [ 1.499999909090926, 0.0 ], [ 1.0, 0.0 ], [ 0.954545454545455, 0.0 ], [ 0.954545454545455, 0.5 ], [ 1.5, 0.785714285714286 ], [ 2.0, 0.785714285714286 ], [ 2.0, 0.500000047619043 ], [ 1.5, 0.500000047619043 ], [ 1.499999909090926, 0.5 ], [ 1.499999909090926, 0.0 ] ] ] ] } }
+    ]
+}
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3
+.INDENT 0.0
+.TP
+.B title
+Creating contours from a DEM with fixed levels
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ cat test.asc
+ncols        2
+nrows        2
+xllcorner    0
+yllcorner    0
+cellsize     1
+4 15
+25 36
+
+$ gdal_contour test.asc \-f GeoJSON /vsistdout/ \-fl 10 20 \-p \-amin min \-amax max
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+This would create a single polygonal contour between 10 and 20 meters from the DEM data in \fBtest.asc\fP
+and produce a GeoJSON output with the contour min and max elevations in the \fBmin\fP and \fBmax\fP attributes.
+.sp
+If the minimum and maximum values from the raster are desired, the special values \fBMIN\fP and \fBMAX\fP
+(case insensitive) can be used:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ cat test.asc
+ncols        2
+nrows        2
+xllcorner    0
+yllcorner    0
+cellsize     1
+4 15
+25 36
+
+$ gdal_contour test.asc \-f GeoJSON /vsistdout/ \-fl MIN 10 20 MAX \-p \-amin min \-amax max
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+This would create three polygonal contours from the DEM data in \fBtest.asc\fP and produce a GeoJSON output
+with the contour min and max elevations in the \fBmin\fP and \fBmax\fP attributes, the values of these fields will
+be: (4.0, 10.0), (10, 20.0) and (20.0, 36.0).
+.SS Example 4
+.INDENT 0.0
+.TP
+.B title
+Creating contours from a DEM specifying an interval and fixed levels at the same time
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ cat test.asc
+ncols        2
+nrows        2
+xllcorner    0
+yllcorner    0
+cellsize     1
+4 15
+25 36
+
+$ gdal_contour test.asc \-f GeoJSON /vsistdout/ \-i 10 \-fl 15 \-p \-amin min \-amax max
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+Creates contours at regular 10 meter intervals and adds extra contour for a fixed 15 m level.
+Finally turns areas between the contours into polygons  with the contour min and max elevations
+in the \fBmin\fP and \fBmax\fP attributes, the values of these fields will be:
+(4.0, 10.0), (10, 15.0), (15, 20.0), (20.0, 30.0)  and (30.0, 36.0).
+.SH AUTHOR
+Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer <silke@intevation.de>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal_create.1

@@ -0,0 +1,204 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "GDAL_CREATE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal_create \- Create a raster file (without source dataset)
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal_create [\-\-help] [\-\-long\-usage] [\-\-help\-general]
+                   [\-ot Byte|Int8|[U]Int{16|32|64}|CInt{16|32}|[C]Float{32|64}]
+                   [\-of <output_format>] [\-outsize <xsize> <ysize>]
+                   [\-bands <count>] [\-burn <value>]... [\-a_srs <srs_def>]
+                   [\-a_ullr <ulx> <uly> <lrx> <lry>] [\-a_nodata <value>]
+                   [\-mo <NAME>=<VALUE>]... [\-co <NAME>=<VALUE>]... [\-\-quiet]
+                   [\-if <input_dataset>]
+                   <out_dataset>
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+The \fBgdal_create\fP utility can be used to initialize a new raster file,
+from its dimensions, band count and set various parameters, such as CRS,
+geotransform, nodata value, metadata. It can be used also in special cases,
+like creating a PDF file from a XML composition file.
+.sp
+\fBTIP:\fP
+.INDENT 0.0
+.INDENT 3.5
+Equivalent in new \(dqgdal\(dq command line interface:
+.sp
+See \fI\%gdal raster create\fP\&.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-help
+Show this help message and exit
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-help\-general
+Gives a brief usage message for the generic GDAL commandline options and exit.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-q, \-\-quiet
+Suppress progress messages and other non\-error output.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-ot <type>
+Force the output image bands to have a specific data type supported by the
+driver, which may be one of the following: \fBByte\fP, \fBInt8\fP, \fBUInt16\fP,
+\fBInt16\fP, \fBUInt32\fP, \fBInt32\fP, \fBUInt64\fP, \fBInt64\fP, \fBFloat32\fP, \fBFloat64\fP, \fBCInt16\fP,
+\fBCInt32\fP, \fBCFloat32\fP or \fBCFloat64\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-of <format>
+Select the output format. If not specified, the format is guessed from the
+extension. Use the short format name.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-outsize <xsize> <ysize>
+Set the size of the output file in pixels. First value is width. Second one
+is height.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-bands <count>
+Number of bands. Defaults to 1 if \-outsize is specified, or 0 otherwise.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-burn <value>
+A fixed value to burn into a band. A list of \fI\%\-burn\fP options
+can be supplied, one per band (the first value will apply to the first band,
+the second one to the second band, etc.). If a single value is specified,
+it will apply to all bands.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_srs <srs_def>
+Override the projection for the output file.  The<srs_def> may be any of
+the usual GDAL/OGR forms, complete WKT, PROJ.4, EPSG:n or a file containing
+the WKT. No reprojection is done.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_ullr <ulx> <uly> <lrx> <lry>
+Assign the georeferenced bounds of the output file.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_nodata <value>
+Assign a specified nodata value to output bands.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-mo <META\-TAG>=<VALUE>
+Passes a metadata key and value to set on the output dataset if possible.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-co <NAME>=<VALUE>
+Many formats have one or more optional creation options that can be
+used to control particulars about the file created. For instance,
+the GeoTIFF driver supports creation options to control compression,
+and whether the file should be tiled.
+.sp
+The creation options available vary by format driver, and some
+simple formats have no creation options at all. A list of options
+supported for a format can be listed with the
+\fI\%\-\-format\fP
+command line option but the documentation for the format is the
+definitive source of information on driver creation options.
+See \fI\%Raster drivers\fP format
+specific documentation for legal creation options for each format.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-if <input_dataset>
+Added in version 3.3.
+
+.sp
+Name of GDAL input dataset that serves as a template for default values of
+options \-outsize, \-bands, \-ot, \-a_srs, \-a_ullr and \-a_nodata.
+Note that the pixel values will \fInot\fP be copied.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B <out_dataset>
+The destination file name.
+.UNINDENT
+.SH RETURN STATUS CODE
+.sp
+The program returns status code 0 in case of success, and non\-zero in case of
+error (non\-blocking errors emitted as warnings are considered as a successful
+execution).
+.SH EXAMPLES
+.SS Example 1: Initialize a new GeoTIFF file with a uniform value of 10
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_create \-outsize 20 20 \-a_srs EPSG:4326 \-a_ullr 2 50 3 49 \-burn 10 out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Create a PDF file from a XML composition file
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_create \-co COMPOSITION_FILE=composition.xml out.pdf
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Initialize a blank GeoTIFF file from an input one
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_create \-if prototype.tif output.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.