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

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-raster-color-map.1

@@ -0,0 +1,243 @@
+.\" 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-RASTER-COLOR-MAP" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-color-map \- Generate a RGB or RGBA dataset from a single band, using a color map
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster color\-map [OPTIONS] <INPUT> <OUTPUT>
+
+Generate a RGB or RGBA dataset from a single band, using a color map
+
+Positional arguments:
+  \-i, \-\-input <INPUT>                                  Input raster datasets [required] [not available in pipelines]
+  \-o, \-\-output <OUTPUT>                                Output raster dataset [required] [not available in pipelines]
+
+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 (\(dqGDALG\(dq allowed) [not available in pipelines]
+  \-\-co, \-\-creation\-option <KEY>=<VALUE>                Creation option [may be repeated] [not available in pipelines]
+  \-\-overwrite                                          Whether overwriting existing output dataset is allowed [not available in pipelines]
+                                                       Mutually exclusive with \-\-append
+  \-\-append                                             Append as a subdataset to existing output [not available in pipelines]
+                                                       Mutually exclusive with \-\-overwrite
+  \-b, \-\-band <BAND>                                    Input band (1\-based index) (default: 1)
+  \-\-color\-map <COLOR\-MAP>                              Color map filename
+  \-\-add\-alpha                                          Adds an alpha mask band to the destination.
+  \-\-color\-selection <COLOR\-SELECTION>                  How to compute output colors from input values. COLOR\-SELECTION=interpolate|exact|nearest (default: interpolate)
+
+Advanced Options:
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>                  Input formats [may be repeated] [not available in pipelines]
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>                    Open options [may be repeated] [not available in pipelines]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal raster color\-map\fP generates a RGB or RGBA dataset from a
+single band, using a color map, either attached directly to a raster band,
+or from an external text file. It is typically used to create \fI\%hypsometric\fP maps
+from a DEM.
+.sp
+This subcommand is also available as a potential step of \fI\%gdal raster pipeline\fP
+.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.
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-add\-alpha
+Adds an alpha mask band to the output.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-b, \-\-band <BAND>
+Index (starting at 1) of the band to process.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-color\-map <COLOR\-MAP>
+Color map filename containing the association between various raster
+values and the corresponding wished color.
+.sp
+This option must be specified if the input raster band has no attached color table.
+.sp
+The text\-based color configuration file generally contains 4 columns
+per line: the raster value and the corresponding Red, Green, Blue
+component (between 0 and 255). The raster value can be any floating
+point value, or the \fBnv\fP keyword for the nodata value.
+The raster can also be expressed as a percentage: 0% being the minimum
+value found in the raster, 100% the maximum value.
+.sp
+An extra column can be optionally added for the alpha component.
+If it is not specified, full opacity (255) is assumed.
+.sp
+Various field separators are accepted: comma, tabulation, spaces, \(aq:\(aq.
+.sp
+Common colors used by GRASS can also be specified by using their name,
+instead of the RGB triplet. The supported list is: white, black, red,
+green, blue, yellow, magenta, cyan, aqua, grey/gray, orange, brown,
+purple/violet and indigo.
+.INDENT 7.0
+.INDENT 3.5
+GMT \fB\&.cpt\fP palette files are also supported (COLOR_MODEL = RGB only).
+.UNINDENT
+.UNINDENT
+.sp
+Note: the syntax of the color configuration file is derived from the one
+supported by GRASS r.colors utility. ESRI HDR color table files (.clr)
+also match that syntax. The alpha component and the support of tab and
+comma as separators are GDAL specific extensions.
+.sp
+For example:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.EX
+3500   white
+2500   235:220:175
+50%   190 185 135
+700    240 250 150
+0      50  180  50
+nv     0   0   0   0
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+To implement a \(dqround to the floor value\(dq mode, the raster value can be
+duplicate with a new value being slightly above the threshold.
+For example to have red in [0,10], green in ]10,20] and blue in ]20,30]:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.EX
+0       red
+10      red
+10.001  green
+20      green
+20.001  blue
+30      blue
+.EE
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-color\-selection interpolate|exact|nearest
+How to compute output colors from input values:
+.INDENT 7.0
+.IP \(bu 2
+\fBinterpolate\fP (default): apply linear interpolation when a raster value
+falls between two entries of the color map.
+.IP \(bu 2
+\fBexact\fP: only input raster values matching exacting an entry of the
+color map will be colorized. If none matching color entry is found,
+the \(dq0,0,0,0\(dq RGBA quadruplet will be used.
+.IP \(bu 2
+\fBnearest\fP: input raster values will be assigned the entry of the color
+map that is the closest.
+.UNINDENT
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+This option is only taken into account when \fI\%\-\-color\-map\fP
+is specified.
+.UNINDENT
+.UNINDENT
+.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 \-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
+.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: Generates a RGB dataset from a DTED0 file using an external color map
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster color\-map \-\-color\-map=color\-map.txt n43.dt0 out.tif \-\-overwrite
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-raster-compare.1

@@ -0,0 +1,215 @@
+.\" 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-RASTER-COMPARE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-compare \- Compare two raster dataset
+.sp
+Added in version 3.12.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster compare [OPTIONS] <REFERENCE> <INPUT>
+
+Compare two raster datasets.
+
+Positional arguments:
+  \-\-reference <REFERENCE>              Reference dataset [required]
+  \-i, \-\-input <INPUT>                  Input raster dataset [required] [not available in pipelines]
+
+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:
+  \-\-skip\-all\-optional                  Skip all optional comparisons
+  \-\-skip\-binary                        Skip binary file comparison
+  \-\-skip\-crs                           Skip CRS comparison
+  \-\-skip\-geotransform                  Skip geotransform comparison
+  \-\-skip\-overview                      Skip overview comparison
+  \-\-skip\-metadata                      Skip metadata comparison
+  \-\-skip\-rpc                           Skip RPC metadata comparison
+  \-\-skip\-geolocation                   Skip Geolocation metadata comparison
+  \-\-skip\-subdataset                    Skip subdataset comparison
+
+Advanced Options:
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>  Input formats [may be repeated] [not available in pipelines]
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>    Open options [may be repeated] [not available in pipelines]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal raster compare\fP compares two GDAL supported datasets and
+reports the differences. In addition to reporting differences to the
+standard output, the program will also return the difference count in its
+exit value.
+.sp
+As a convention, the first dataset specified as a positional argument, or through
+\fI\%\-\-reference\fP, is assumed to be the reference/exact/golden dataset. The second
+dataset specified as a positional argument, or through \fI\%\-\-input\fP, is the
+dataset compared to the reference dataset.
+.sp
+Image pixels, and various metadata are checked. There is also a byte by
+byte comparison done which will count as one difference. So, if it is
+only important that the GDAL visible data is identical, a difference
+count of 1 (the binary difference) should be considered acceptable, or you
+may specify \fI\%\-\-skip\-binary\fP to omit byte to byte comparison.
+.sp
+This program can also be used as the last step of a \fI\%raster pipeline\fP\&.
+.sp
+The following options are available:
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-input <input\-dataset>
+The dataset being compared to the reference dataset, referred to as the input
+dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-reference <reference\-dataset>
+The dataset that is considered correct, referred to as the reference dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-all\-optional
+Whether to skip all optional tests. This is an alias to defining all other
+\fB\-\-skip\-XXXX\fP options.
+.sp
+The remaining non\-optional tests are:
+.INDENT 7.0
+.IP \(bu 2
+checking dataset width, height and band count
+.IP \(bu 2
+checking band description, data type, color interpretation and nodata value
+.IP \(bu 2
+checking pixel content
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-binary
+Whether to skip exact comparison of binary content.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-crs
+Whether to skip comparison of coordinate reference systems (CRS).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-geolocation
+Whether to skip comparison of GEOLOCATION metadata domain.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-geotransform
+Whether to skip comparison of geotransform matrix.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-metadata
+Whether to skip comparison of metadata
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-overview
+Whether to skip comparison of overviews.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-rpc
+Whether to skip comparison of Rational Polynomial Coefficients (RPC) metadata domain.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-subdataset
+Whether to ignore comparison of all subdatasets that are part of the dataset.
+.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 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: Comparing two datasets that differ by their data types
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster compare autotest/gcore/data/byte.tif autotest/gcore/data/uint16.tif
+Reference file has size 736 bytes, whereas input file has size 1136 bytes.
+Reference band 1 has data type Byte, but input band has data type UInt16
+
+$ echo $?
+2
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Comparing two datasets while values have different units
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster pipeline read test_in_foot.tif ! calc \-\-calc \(dqX * 0.3048\(dq ! compare \-\-reference=reference_in_meter.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.