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

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

@@ -0,0 +1,179 @@
+.\" 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_PROXIMITY" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal_proximity \- Produces a raster proximity map.
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_proximity [\-\-help] [\-\-help\-general]
+                  <srcfile> <dstfile> [\-srcband <n>] [\-dstband <n>]
+                  [\-of <format>] [\-co <name>=<value>]...
+                  [\-ot Byte/UInt16/UInt32/Float32/etc]
+                  [\-values <n>,<n>,<n>] [\-distunits {PIXEL|GEO}]
+                  [\-maxdist <n>] [\-nodata <n>] [\-use_input_nodata {YES|NO}]
+                  [\-fixed\-buf\-val <n>]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal_proximity\fP generates a raster proximity map indicating
+the distance from the center of each pixel to the center of the nearest
+pixel identified as a target pixel.  Target pixels are those in the source
+raster for which the raster pixel value is in the set of target pixel values.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+gdal_proximity is a Python utility, and is only available if GDAL Python bindings are available.
+.UNINDENT
+.UNINDENT
+.sp
+\fBTIP:\fP
+.INDENT 0.0
+.INDENT 3.5
+Equivalent in new \(dqgdal\(dq command line interface:
+.sp
+See \fI\%gdal raster proximity\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 <srcfile>
+The source raster file used to identify target pixels.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B <dstfile>
+The destination raster file to which the proximity map will be written.
+It may be a pre\-existing file of the same size as srcfile.
+If it does not exist it will be created.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-srcband <n>
+Identifies the band in the source file to use (default is 1).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-dstband <n>
+Identifies the band in the destination file to use (default is 1).
+.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 \-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 \-ot <type>
+Specify a data type supported by the driver, which may be one of the
+following: \fBByte\fP, \fBUInt16\fP, \fBInt16\fP, \fBUInt32\fP, \fBInt32\fP,
+\fBFloat32\fP (default), or \fBFloat64\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-values <n>,<n>,<n>
+A list of target pixel values in the source image to be considered target
+pixels. If not specified, all non\-zero pixels will be considered target pixels.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-distunits {PIXEL|GEO}
+Indicate whether distances generated should be in pixel or georeferenced
+coordinates (default PIXEL).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-maxdist <n>
+The maximum distance to be generated. The nodata value will be used for pixels
+beyond this distance. If a nodata value is not provided, the output band will be
+queried for its nodata value. If the output band does not have a nodata value,
+then the value 65535 will be used. Distance is interpreted in pixels unless
+\-distunits GEO is specified.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-nodata <n>
+Specify a nodata value to use for the destination proximity raster.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-use_input_nodata {YES|NO}
+Indicate whether nodata pixels in the input raster should be nodata in the output raster (default NO).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-fixed\-buf\-val <n>
+Specify a value to be applied to all pixels that are within the
+\-maxdist of target pixels (including the target pixels) instead of a distance value.
+.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 AUTHOR
+Frank Warmerdam <warmerdam@pobox.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.

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

@@ -0,0 +1,368 @@
+.\" 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_RASTERIZE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal_rasterize \- Burns vector geometries into a raster.
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal_rasterize [\-\-help] [\-\-long\-usage] [\-\-help\-general]
+                      [\-b <band>]... [\-i] [\-at]
+                      [[\-burn <value>]...|[\-a <attribute_name>]|[\-3d]]
+                      [\-add]
+                      [[\-l <layer_name>]...|[\-sql <sql_statement>]]
+                      [\-where <expression>] [\-dialect <sql_dialect>]
+                      [\-a_nodata <value>] [\-init <value>]... [\-a_srs <srs_def>]
+                      [\-to <NAME>=<VALUE>]... [\-te <xmin> <ymin> <xmax> <ymax>]
+                      [[\-tr <xres> <yres>]|[\-ts <width> <height>]]
+                      [\-tap] [\-optim AUTO|VECTOR|RASTER] [\-co <NAME>=<VALUE>]...
+                      [\-ot Byte|Int8|[U]Int{16|32|64}|CInt{16|32}|[C]Float{32|64}]
+                      [\-of <output_format>] [\-\-quiet] [\-oo <NAME>=<VALUE>]...
+                      <src_datasource> <dst_filename>
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+This program burns vector geometries (points, lines, and polygons) into the
+raster band(s) of a raster image.  Vectors are read from OGR supported vector
+formats. If the output raster already exists, the affected pixels are updated
+in\-place.
+.sp
+On the fly reprojection of vector data to the coordinate system of the
+raster data is supported.
+.sp
+\fBTIP:\fP
+.INDENT 0.0
+.INDENT 3.5
+Equivalent in new \(dqgdal\(dq command line interface:
+.sp
+See \fI\%gdal vector rasterize\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>
+The band(s) to burn values into.  Multiple \-b arguments may be used to burn
+into a list of bands.  The default is to burn into band 1.  Not used when
+creating a new raster.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-i
+Invert rasterization.  Burn the fixed burn value, or the burn value associated
+with the first feature into all parts of the image \fInot\fP inside the
+provided polygon.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+When the vector features contain a polygon nested within another polygon
+(like an island in a lake), GDAL must be built against GEOS to get
+correct results.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-at
+Enables the ALL_TOUCHED rasterization option so that all pixels touched
+by lines or polygons will be updated, not just those on the line render path,
+or whose center point is within the polygon (behavior is unspecified when the
+polygon is just touching the pixel center). Defaults to disabled for normal
+rendering rules.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+When this option is enabled, the order of the input features (lines or polygons)
+can affect the results. When two features touch each other, the last one (i.e. topmost)
+will determine the burned pixel value at the edge.
+You may wish to use the \fI\%\-sql\fP option to reorder the features (ORDER BY)
+to achieve a more predictable result.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-burn <value>
+A fixed value to burn into a band for all objects.  A list of \fI\%\-burn\fP options
+can be supplied, one per band being written to.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a <attribute_name>
+Identifies an attribute field on the features to be used for a burn\-in value.
+The value will be burned into all output bands.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-3d
+Indicates that a burn value should be extracted from the \(dqZ\(dq values of the
+feature. Works with points and lines (linear interpolation along each segment).
+For polygons, works properly only if they are flat (same Z value for all
+vertices).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-add
+Instead of burning a new value, this adds the new value to the existing raster.
+Suitable for heatmaps for instance.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-l <layername>
+Indicates the layer(s) from the datasource that will be used for input
+features.  May be specified multiple times, but at least one layer name or a
+\fI\%\-sql\fP option must be specified (not both).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-where <expression>
+An optional SQL WHERE style query expression to be applied to select features
+to burn in from the input layer(s).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-sql <select_statement>
+An SQL statement to be evaluated against the datasource to produce a
+virtual layer of features to be burned in.
+Starting with GDAL 3.7, the \fB@filename\fP syntax can be used to indicate
+that the content is in the pointed filename.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+This option will be ignored if the \fI\%\-l\fP option has been set as well.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-dialect <dialect>
+SQL dialect. In some cases can be used to use (unoptimized) OGR SQL instead of
+the native SQL of an RDBMS by passing OGRSQL. The
+\(dqSQLITE\(dq dialect can also be used with any datasource.
+.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 \-a_nodata <value>
+Assign a specified nodata value to output bands.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-init <value>
+Pre\-initialize the output image bands with these values.  However, it is not
+marked as the nodata value in the output file.  If only one value is given, the
+same value is used in all the bands.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_srs <srs_def>
+Override the projection for the output file. If not specified, the projection of
+the input vector file will be used if available. When using this option, no reprojection
+of features from the SRS of the input vector to the specified SRS of the output raster,
+so use only this option to correct an invalid source SRS.
+The <srs_def> may be any of the usual GDAL/OGR forms, complete WKT, PROJ.4,
+EPSG:n or a file containing the WKT.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-to <NAME>=<VALUE>
+set a transformer
+option suitable to pass to \fI\%GDALCreateGenImgProjTransformer2()\fP\&. This is
+used when converting geometries coordinates to target raster pixel space. For
+example this can be used to specify RPC related transformer options.
+.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 \-te <xmin> <ymin> <xmax> <ymax>
+Set georeferenced extents. The values must be expressed in georeferenced units.
+If not specified, the extent of the output file will be the extent of the vector
+layers.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-tr <xres> <yres>
+Set target resolution. The values must be expressed in georeferenced units.
+Both must be positive values.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-tap
+(target aligned pixels) Align
+the coordinates of the extent of the output file to the values of the \fI\%\-tr\fP,
+such that the aligned extent includes the minimum extent.
+Alignment means that xmin / resx, ymin / resy, xmax / resx and ymax / resy are integer values.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-ts <width> <height>
+Set output file size in pixels and lines. Note that \fI\%\-ts\fP cannot be used with
+\fI\%\-tr\fP
+If one of the two values is set to 0, it will be computed from the other value in order to
+preserve the aspect ratio.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-ot <type>
+Force the output bands to be of the indicated data type. Defaults to \fBFloat64\fP,
+unless the attribute field to burn is of type \fBInt64\fP, in which case \fBInt64\fP
+is used for the output raster data type if the output driver supports it.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-optim {AUTO|VECTOR|RASTER}
+Force the algorithm used (results are identical). Raster mode
+is used in most cases and  optimizes read/write  operations.  The
+vector mode is useful with a large amount of input features and
+optimizes CPU use, provided that the output image is tiled.
+Auto mode (the default) will choose the
+algorithm based on input and output properties.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-oo <NAME>=<VALUE>
+Added in version 3.7.
+
+.sp
+Source dataset open option (format specific)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B <src_datasource>
+Any OGR supported readable datasource.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B <dst_filename>
+The GDAL supported output file.  Must support update mode access.
+This file will be created if it does not already exist
+If the output raster already exists, the affected pixels are updated in\-place.
+.UNINDENT
+.sp
+The program creates a new target raster image when any of the \fI\%\-of\fP,
+\fI\%\-a_nodata\fP, \fI\%\-init\fP, \fI\%\-a_srs\fP, \fI\%\-co\fP, \fI\%\-te\fP,
+\fI\%\-tr\fP, \fI\%\-tap\fP, \fI\%\-ts\fP, or \fI\%\-ot\fP options are used.
+The resolution or size must be specified using the \fI\%\-tr\fP or \fI\%\-ts\fP option for all new
+rasters.  The target raster will be overwritten if it already exists and any of
+these creation\-related options are used.
+.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
+This utility is also callable from C with \fI\%GDALRasterize()\fP\&.
+.SH EXAMPLES
+.SS Example 1
+.sp
+The following would burn all polygons from \fBmask.shp\fP into the RGB TIFF
+file \fBwork.tif\fP with the color red (RGB = 255,0,0).
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_rasterize \-b 1 \-b 2 \-b 3 \-burn 255 \-burn 0 \-burn 0 \-l mask mask.shp work.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2
+.sp
+The following would burn all \(dqclass A\(dq buildings into the output elevation
+file, pulling the top elevation from the ROOF_H attribute.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_rasterize \-a ROOF_H \-where \(dqclass=\(aqA\(aq\(dq \-l footprints footprints.shp city_dem.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3
+.sp
+The following would burn all polygons from \fBfootprint.shp\fP into a new 1000x1000
+rgb TIFF as the color red.  Note that \fI\%\-b\fP is not used; the order of the \fI\%\-burn\fP
+options determines the bands of the output raster.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_rasterize \-burn 255 \-burn 0 \-burn 0 \-ot Byte \-ts 1000 1000 \-l footprints footprints.shp mask.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Frank Warmerdam <warmerdam@pobox.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.