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

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-vector-rasterize.1

@@ -0,0 +1,406 @@
+.\" 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-VECTOR-RASTERIZE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-vector-rasterize \- Burn vector geometries into a raster
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal vector rasterize [OPTIONS] <INPUT> <OUTPUT>
+
+Burns vector geometries into a raster.
+
+Positional arguments:
+  \-i, \-\-input <INPUT>                                      Input vector datasets [required]
+  \-o, \-\-output <OUTPUT>                                    Output raster dataset [required]
+
+Common Options:
+  \-h, \-\-help                                               Display help message and exit
+  \-\-json\-usage                                             Display usage as JSON document and exit
+  \-\-config <KEY>=<VALUE>                                   Configuration option [may be repeated]
+  \-q, \-\-quiet                                              Quiet mode (no progress bar or warning message) [not available in pipelines]
+
+Options:
+  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>      Output format
+  \-\-co, \-\-creation\-option <KEY>=<VALUE>                    Creation option [may be repeated]
+  \-\-overwrite                                              Whether overwriting existing output dataset is allowed
+  \-b, \-\-band <BAND>                                        The band(s) to burn values into (1\-based index) [may be repeated]
+  \-\-invert                                                 Invert the rasterization
+  \-\-all\-touched                                            Enables the ALL_TOUCHED rasterization option
+  \-\-burn <BURN>                                            Burn value [may be repeated]
+  \-a, \-\-attribute\-name <ATTRIBUTE\-NAME>                    Attribute name
+  \-\-3d                                                     Indicates that a burn value should be extracted from the Z values of the feature
+  \-l, \-\-input\-layer <INPUT\-LAYER>                          Input layer name
+                                                           Mutually exclusive with \-\-sql
+  \-\-where <WHERE>                                          SQL where clause
+  \-\-sql <SQL>                                              SQL select statement
+                                                           Mutually exclusive with \-\-input\-layer
+  \-\-dialect <DIALECT>                                      SQL dialect
+  \-\-nodata <NODATA>                                        Assign a specified nodata value to output bands
+  \-\-init <INIT>                                            Pre\-initialize output bands with specified value [may be repeated]
+  \-\-crs <CRS>                                              Override the projection for the output file
+  \-\-transformer\-option <NAME>=<VALUE>                      Set a transformer option suitable to pass to GDALCreateGenImgProjTransformer2 [may be repeated]
+  \-\-extent <xmin>,<ymin>,<xmax>,<ymax>                     Set the target georeferenced extent [4 values]
+  \-\-resolution <xres>,<yres>                               Set the target resolution [2 values]
+                                                           Mutually exclusive with \-\-size
+  \-\-tap, \-\-target\-aligned\-pixels                           (target aligned pixels) Align the coordinates of the extent of the output file to the values of the resolution
+                                                           Depends on \-\-resolution
+  \-\-size <xsize>,<ysize>                                   Set the target size in pixels and lines [2 values]
+                                                           Mutually exclusive with \-\-resolution
+  \-\-ot, \-\-datatype, \-\-output\-data\-type <OUTPUT\-DATA\-TYPE>  Output data type. OUTPUT\-DATA\-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64
+  \-\-optimization <OPTIMIZATION>                            Force the algorithm used (results are identical). OPTIMIZATION=AUTO|RASTER|VECTOR (default: AUTO)
+  \-\-add                                                    Add to existing raster
+  \-\-update                                                 Whether to open existing dataset in update mode
+
+Advanced Options:
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>                        Open options [may be repeated]
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>                      Input formats [may be repeated]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal vector rasterize\fP burns vector geometries into a raster.
+.sp
+By default (unless \fI\%\-\-update\fP or \fI\%\-\-add\fP) is specified, a new
+raster is created with a specified resolution (\fI\%\-\-resolution\fP) or size
+(\fI\%\-\-size\fP). Pixel values will either be set to a constant (the value 1,
+or some other value specified with \fI\%\-\-burn\fP), the Z value of feature
+geometries (with \fI\%\-\-3d\fP), or the value of a field specified with
+\fI\%\-\-attribute\-name\fP\&.
+.sp
+The left figure illustrates the default rasterization behavior, where only pixels on the line render
+path are included.
+.sp
+The right figure shows the effect of \fI\%\-\-all\-touched\fP, where every pixel that touches the input polygons is
+included.
+.sp
+Since GDAL 3.12, this algorithm can be part of a \fI\%gdal pipeline\fP\&.
+.sp
+The following options are available:
+.sp
+Added in version 3.12.
+
+.SH GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET)
+.sp
+This program supports serializing the command line as a JSON file using the \fBGDALG\fP output format.
+The resulting file can then be opened as a raster dataset using the
+\fI\%GDALG: GDAL Streamed Algorithm\fP driver, and apply the specified pipeline in a on\-the\-fly /
+streamed way.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+However this algorithm is not natively streaming compatible. Consequently a
+temporary dataset will be generated, which may cause significant processing
+time at opening.
+.UNINDENT
+.UNINDENT
+.SH PROGRAM-SPECIFIC OPTIONS
+.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, implies \fB\-\-update\fP\&. Suitable for heatmaps for instance.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-all\-touched
+Enables the ALL_TOUCHED rasterization option.
+.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 \-a, \-\-attribute\-name <ATTRIBUTE\-NAME>
+Name of the attribute / field from which a burn value should be retrieved for each feature. GDAL will attempt to parse the field value as a number. If this is not successful, a value of zero will be written.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-band, \-b <BAND>
+The band(s) to burn values into. May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-burn <BURN>
+Burn value. May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-crs <CRS>
+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 CRS of the input vector to the specified CRS of the output raster, so use only this option to correct an invalid source CRS. The \fB<CRS>\fP 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 \-\-extent <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 \-\-init <INIT>
+Pre\-initialize output bands with specified value. May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-l, \-\-input\-layer <INPUT\-LAYER>
+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 \-sql option must be specified (not both).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-invert
+Invert rasterization. Burn the fixed burn value, or the burn value associated with the first feature into all parts of the image not 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 \-\-nodata <NODATA>
+Assign a specified nodata value to output bands.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-optimization <OPTIMIZATION>
+Force the algorithm used (results are identical). The raster mode is used in most cases and optimise read/write operations. The vector mode is useful with a decent amount of input features and optimise the CPU use. That mode have to be used with tiled images to be efficient. The auto mode (the default) will chose the algorithm based on input and output properties.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-ot, \-\-datatype, \-\-output\-data\-type <OUTPUT\-DATA\-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 \-\-resolution <xres>,<yres>
+Set target resolution. The values must be expressed in georeferenced units. Both must be positive values. Note that \fI\-\-resolution\fP cannot be used with \fI\-\-size\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-size <xsize>,<ysize>
+Set output file size in pixels and lines. Note that \fI\-\-size\fP cannot be used with \fI\-\-resolution\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 of the extent.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-sql <SQL>|@<filename>
+An SQL statement to be evaluated against the datasource to produce a virtual layer of features to be burned in.
+The @filename syntax can be used to indicate that the content is in the pointed filename.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-dialect <DIALECT>
+SQL dialect.
+.sp
+By default the native SQL of an RDBMS is used when using
+\fBgdal vector sql\fP\&. If using \fBsql\fP as a step of \fBgdal vector pipeline\fP,
+this is only true if the step preceding \fBsql\fP is \fBread\fP, otherwise the
+\fI\%OGRSQL\fP dialect is used.
+.sp
+If a datasource does not support SQL natively, the default is to use the
+\fBOGRSQL\fP dialect, which can also be specified with any data source.
+.sp
+The \fI\%SQL SQLite dialect\fP dialect can be chosen with the \fBSQLITE\fP
+and \fBINDIRECT_SQLITE\fP dialect values, and this can be used with any data source.
+Overriding the default dialect may be beneficial because the capabilities of
+the SQL dialects vary.
+.sp
+Supported dialects can be checked with \fBgdal \-\-format\fP\&. For example:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal \-\-format \(dqPostgreSQL\(dq
+[...]
+Supported SQL dialects: NATIVE OGRSQL SQLITE
+[...]
+
+$ gdal \-\-format \(dqESRI Shapefile\(dq
+[...]
+Supported SQL dialects: OGRSQL SQLITE
+[...]
+.EE
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-tap, \-\-target\-aligned\-pixels
+(target aligned pixels) Align the coordinates of the extent of the output file to the values of \fI\-\-resolution\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.
+\fI\%\-\-tap\fP requires \fI\%\-\-resolution\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-transformer\-option <NAME>=<VALUE>
+set a transformer option suitable to pass to GDALCreateGenImgProjTransformer2(). 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 \-\-where <WHERE>
+An optional SQL WHERE style query expression to be applied to select features to burn in from the input layer(s).
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-co, \-\-creation\-option <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
+May be repeated.
+.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\%\-\-formats\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\-format <format>
+Format/driver name to be attempted to open the input file(s). It is generally
+not necessary to specify it, but it can be used to skip automatic driver
+detection, when it fails to select the appropriate driver.
+This option can be repeated several times to specify several candidate drivers.
+Note that it does not force those drivers to open the dataset. In particular,
+some drivers have requirements on file extensions.
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
+Dataset open option (format specific).
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
+Which output raster format to use. Allowed values may be given by
+\fBgdal \-\-formats | grep raster | grep rw | sort\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-overwrite
+Allow program to overwrite existing target file or dataset.
+Otherwise, by default, \fBgdal\fP errors out if the target file or
+dataset already exists.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-update
+Whether to open an existing output dataset in update mode.
+.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: Burn a shapefile into a raster
+.INDENT 0.0
+.INDENT 3.5
+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 vector rasterize \-b 1,2,3 \-\-burn 255,0,0 \-l mask mask.shp work.tif
+.EE
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SS Example 2: The following would burn all \(dqclass A\(dq buildings into the output elevation file, pulling the top elevation from the ROOF_H attribute.
+.sp
+Burn a shapefile into a raster using a specific where condition to select features
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector rasterize \-a ROOF_H \-\-where \(dqclass=\(aqA\(aq\(dq \-l footprints footprints.shp city_dem.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: The following would burn all polygons from footprint.shp into a new 1000x1000 rgb TIFF as the color red.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+\fI\-b\fP is not used; the order of the \fI\-\-burn\fP options determines the bands of the output raster.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector rasterize \-\-burn 255,0,0 \-\-ot Byte \-\-size 1000,1000 \-l footprints footprints.shp mask.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 4: Burn a shapefile into a raster using a specific where condition to select features, and restrict the extent to the one of selected features
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal pipeline read /vsizip/vsicurl/https://www2.census.gov/geo/tiger/TIGER2025/STATE/tl_2025_us_state.zip ! \e
+                filter \-\-where  \(dqstusps = \(aqCA\(aq\(dq \-\-update\-extent ! \e
+                rasterize  \-\-burn 1 \-\-size 1500,1500 \-\-datatype Byte ! \e
+                write out.png \-\-overwrite
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Alessandro Pasotti <elpaso@itopen.it>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-vector-read.1

@@ -0,0 +1,97 @@
+.\" 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-VECTOR-READ" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-vector-read \- Read a vector dataset (pipeline only)
+.sp
+Added in version 3.11.
+
+.SH DESCRIPTION
+.sp
+The \fBread\fP operation is for use in a \fI\%gdal pipeline\fP only, and reads a single input
+vector dataset. This is the first step of a pipeline.
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+* read [OPTIONS] <INPUT>
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
+
+Read a vector dataset.
+
+Positional arguments:
+  \-i, \-\-input <INPUT>                       Input vector datasets [required]
+
+Options:
+  \-l, \-\-layer, \-\-input\-layer <INPUT\-LAYER>  Input layer name(s) [may be repeated]
+
+Advanced Options:
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>       Input formats [may be repeated]
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>         Open options [may be repeated]
+.EE
+.UNINDENT
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-if, \-\-input\-format <format>
+Format/driver name to be attempted to open the input file(s). It is generally
+not necessary to specify it, but it can be used to skip automatic driver
+detection, when it fails to select the appropriate driver.
+This option can be repeated several times to specify several candidate drivers.
+Note that it does not force those drivers to open the dataset. In particular,
+some drivers have requirements on file extensions.
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
+Dataset open option (format specific).
+.sp
+May be repeated.
+.UNINDENT
+.SH EXAMPLES
+.SS Example 1: Read a GeoPackage file
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal vector pipeline read input.gpkg ! ... [other commands here] ...
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.