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

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

@@ -0,0 +1,321 @@
+.\" 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-HILLSHADE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-hillshade \- Generate a shaded relief map
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster hillshade [OPTIONS] <INPUT> <OUTPUT>
+
+Generate a shaded relief 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)
+  \-z, \-\-zfactor <ZFACTOR>                              Vertical exaggeration used to pre\-multiply the elevations
+  \-\-xscale <XSCALE>                                    Ratio of vertical units to horizontal X axis units
+  \-\-yscale <YSCALE>                                    Ratio of vertical units to horizontal Y axis units
+  \-\-azimuth <AZIMUTH>                                  Azimuth of the light, in degrees (default: 315)
+  \-\-altitude <ALTITUDE>                                Altitude of the light, in degrees (default: 45)
+  \-\-gradient\-alg <GRADIENT\-ALG>                        Algorithm used to compute terrain gradient. GRADIENT\-ALG=Horn|ZevenbergenThorne (default: Horn)
+  \-\-variant <VARIANT>                                  Variant of the hillshading algorithm. VARIANT=regular|combined|multidirectional|Igor (default: regular)
+  \-\-no\-edges                                           Do not try to interpolate values at dataset edges or close to nodata values
+
+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 hillshade\fP generates a shaded relief map, from any
+GDAL\-supported elevation raster.
+.sp
+This subcommand is also available as a potential step of \fI\%gdal raster pipeline\fP
+.sp
+It generates an 8\-bit raster with a nice shaded relief effect. It is very useful
+for visualizing the terrain. You can optionally specify the azimuth and altitude
+of the light source, a vertical exaggeration factor and scaling factors to
+account for differences between vertical and horizontal units.
+.sp
+The value 0 is used as the output nodata value. A nodata value in the target dataset
+will be emitted if at least one pixel set to the nodata value is found in the
+3x3 window centered around each source pixel. By default, the algorithm will
+compute values at image edges or if a nodata value is found in the 3x3 window,
+by interpolating missing values, unless \fI\%\-\-no\-edges\fP is specified, in
+which case a 1\-pixel border around the image will be set with the nodata value.
+.sp
+In general, it assumes that x, y and z units are identical. However, if none of
+\fI\%\-\-xscale\fP and \fI\%\-\-yscale\fP are specified, and the CRS is a
+geographic or projected CRS, it will automatically determine the
+appropriate ratio from the units of the CRS, as well as the potential value of
+the units of the raster band (as returned by \fI\%GDALRasterBand::GetUnitType()\fP, if it
+is metre, foot international or US survey foot). Note that for geographic CRS,
+the result for source datasets at high latitudes may be incorrect, and prior
+reprojection to a polar projection might be needed using \fI\%gdal raster reproject\fP\&.
+.sp
+If x (east\-west) and y (north\-south) units are identical, but z (elevation) units
+are different, the \fI\%\-\-xscale\fP and \fI\%\-\-yscale\fP can be used to set
+the ratio of vertical units to horizontal.
+For geographic CRS near the equator, where units of latitude and units of
+longitude are similar, elevation (z) units can be converted to be compatible
+by using scale=370400 (if elevation is in feet) or scale=111120 (if elevation is in
+meters).  For locations not near the equator, the \fI\%\-\-xscale\fP value can be taken as
+the \fI\%\-\-yscale\fP value multiplied by the cosine of the mean latitude of the raster.
+.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 \-\-altitude <ALTITUDE>
+Altitude of the light, in degrees. 90 if the light comes from above the
+DEM, 0 if it is raking light. The default value is 45 degree.
+.sp
+This option is mutually exclusive with \fB\-\-variant=Igor\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-azimuth <AZIMUTH>
+Azimuth of the light, in degrees. 0 if it comes from the top of the raster,
+90 from the east, ... The default value, 315, should rarely be changed as it
+is the value generally used to generate shaded maps.
+.sp
+This option is mutually exclusive with \fB\-\-variant=multidirectional\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-b, \-\-band <BAND>
+Index (starting at 1) of the band to which the hillshade must be computed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-gradient\-alg Horn|ZevenbergenThorne
+Algorithm used to compute terrain gradient. The default is \fBHorn\fP\&.
+The literature suggests Zevenbergen & Thorne to be more suited to smooth
+landscapes, whereas Horn\(aqs formula to perform better on rougher terrain.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-edges
+Do not try to interpolate values at dataset edges or close to nodata values
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-variant regular|combined|multidirectional|Igor
+Variant of the hillshading algorithm:
+.INDENT 7.0
+.IP \(bu 2
+\fBregular\fP: the hillshade values combines the computed slope with the
+azimuth and altitude of the illumination according to:
+.INDENT 2.0
+.INDENT 3.5
+.sp
+.ce
+{Hillshade} = 1 + 254.0 * ((\esin(altitude) * cos(slope)) + (cos(altitude) * sin(slope) * cos(azimuth \- \efrac{\epi}{2} \- aspect)))
+
+
+.ce 0
+.UNINDENT
+.UNINDENT
+.IP \(bu 2
+\fBcombined\fP: combined shading, a combination of slope and oblique shading.
+.IP \(bu 2
+\fBmultidirectional\fP: multidirectional shading, a combination of hillshading
+illuminated from 225 deg, 270 deg, 315 deg, and 360 deg azimuth.
+Applies the formula of \X'tty: link http://pubs.usgs.gov/of/1992/of92-422/of92-422.pdf'\fI\%http://pubs.usgs.gov/of/1992/of92\-422/of92\-422.pdf\fP\X'tty: link'
+.IP \(bu 2
+\fBIgor\fP: shading which tries to minimize effects on other map features
+beneath. Igor\(aqs hillshading uses formula from Maperitive:
+\X'tty: link http://maperitive.net/docs/Commands/GenerateReliefImageIgor.html'\fI\%http://maperitive.net/docs/Commands/GenerateReliefImageIgor.html\fP\X'tty: link'
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-xscale <scale>
+Added in version 3.11.
+
+.sp
+Ratio of vertical units to horizontal X axis units. If the horizontal unit of the source DEM is degrees (e.g Lat/Long WGS84 projection), you can use scale=111120 if the vertical units are meters (or scale=370400 if they are in feet).
+.sp
+If none of \fI\%\-\-xscale\fP and \fI\%\-\-yscale\fP are specified, and the
+CRS is a geographic or projected CRS,
+\fBgdal raster hillshade\fP will automatically determine the appropriate ratio from
+the units of the CRS, as well as the potential value of the units of the
+raster band (as returned by \fI\%GDALRasterBand::GetUnitType()\fP, if it
+is metre, foot international or US survey foot). Note that for geographic CRS,
+the result for source datasets at high latitudes may be incorrect, and prior
+reprojection to a polar projection might be needed.
+.sp
+If \fI\%\-\-xscale\fP is specified, \fI\%\-\-yscale\fP must also be specified.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-yscale <scale>
+Added in version 3.11.
+
+.sp
+Ratio of vertical units to horizontal Y axis units. If the horizontal unit of the source DEM is degrees (e.g Lat/Long WGS84 projection), you can use scale=111120 if the vertical units are meters (or scale=370400 if they are in feet)
+.sp
+If none of \fI\%\-\-xscale\fP and \fI\%\-\-yscale\fP are specified, and the
+CRS is a geographic or projected CRS,
+\fBgdal raster hillshade\fP will automatically determine the appropriate ratio from
+the units of the CRS, as well as the potential value of the units of the
+raster band (as returned by \fI\%GDALRasterBand::GetUnitType()\fP, if it
+is metre, foot international or US survey foot). Note that for geographic CRS,
+the result for source datasets at high latitudes may be incorrect, and prior
+reprojection to a polar projection might be needed.
+.sp
+If \fI\%\-\-yscale\fP is specified, \fI\%\-\-xscale\fP must also be specified.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-z, \-\-zfactor <ZFACTOR>
+Vertical exaggeration used to pre\-multiply the elevations
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-append
+Append input raster as a new subdataset to an existing output file.
+Only works with drivers that support adding subdatasets such as
+\fI\%GTiff \-\- GeoTIFF File Format\fP and \fI\%GPKG \-\- GeoPackage raster\fP
+This also creates the output dataset if it does not exist yet.
+.UNINDENT
+.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
+.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 shaded relief map from a DTED0 file, using a vertical exaggeration factor of 30.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster hillshade \-\-zfactor=30 n43.dt0 out.tif \-\-overwrite
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Combine the output of shaded relief map and hypsometric rendering on a DEM to create a colorized shaded relief map.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal pipeline read n43.tif ! \e
+                color\-map \-\-color\-map color_file.txt ! \e
+                blend \-\-operator=hsv\-value \-\-overlay \e
+                    [ read n43.tif ! hillshade \-z 30 ] ! \e
+                write 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-index.1

@@ -0,0 +1,346 @@
+.\" 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-INDEX" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-index \- Create a vector index of raster datasets
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster index [OPTIONS] <INPUT>... <OUTPUT>
+
+Create a vector index of raster datasets.
+
+Positional arguments:
+  \-i, \-\-input <INPUT>                                  Input raster datasets [may be repeated] [required]
+  \-o, \-\-output <OUTPUT>                                Output vector 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]
+  \-\-lco, \-\-layer\-creation\-option <KEY>=<VALUE>         Layer creation option [may be repeated]
+  \-\-overwrite                                          Whether overwriting existing output dataset is allowed
+                                                       Mutually exclusive with \-\-update
+  \-\-update                                             Whether to open existing dataset in update mode
+                                                       Mutually exclusive with \-\-overwrite
+  \-\-overwrite\-layer                                    Whether overwriting existing output layer is allowed
+  \-\-append                                             Whether appending to existing layer is allowed
+  \-\-nln, \-\-output\-layer <OUTPUT\-LAYER>                 Output layer name
+  \-\-recursive                                          Whether input directories should be explored recursively.
+  \-\-filename\-filter <FILENAME\-FILTER>                  Pattern that the filenames in input directories should follow (\(aq*\(aq and \(aq?\(aq wildcard) [may be repeated]
+  \-\-min\-pixel\-size <MIN\-PIXEL\-SIZE>                    Minimum pixel size in term of geospatial extent per pixel (resolution) that a raster should have to be selected.
+  \-\-max\-pixel\-size <MAX\-PIXEL\-SIZE>                    Maximum pixel size in term of geospatial extent per pixel (resolution) that a raster should have to be selected.
+  \-\-location\-name <LOCATION\-NAME>                      Name of the field with the raster path (default: location)
+  \-\-absolute\-path                                      Whether the path to the input datasets should be stored as an absolute path
+  \-\-output\-crs <OUTPUT\-CRS>                            Output CRS
+  \-\-metadata <KEY>=<VALUE>                             Add dataset metadata item [may be repeated]
+  \-\-skip\-errors                                        Skip errors related to input datasets
+  \-\-profile <PROFILE>                                  Profile of output dataset. PROFILE=none|STAC\-GeoParquet (default: none)
+  \-\-base\-url <BASE\-URL>                                Base URL for STAC\-GeoParquet href
+  \-\-id\-method <ID\-METHOD>                              How to derive STAC\-GeoParquet \(aqid\(aq. ID\-METHOD=filename|md5|metadata\-item (default: filename)
+  \-\-id\-metadata\-item <ID\-METADATA\-ITEM>                Name of metadata item used to set STAC\-GeoParquet \(aqid\(aq (default: id)
+  \-\-source\-crs\-field\-name <SOURCE\-CRS\-FIELD\-NAME>      Name of the field to store the CRS of each dataset
+  \-\-source\-crs\-format <SOURCE\-CRS\-FORMAT>              Format in which the CRS of each dataset must be written. SOURCE\-CRS\-FORMAT=auto|WKT|EPSG|PROJ (default: auto)
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal raster index\fP creates a vector dataset with a record for each
+input raster file, an attribute containing the filename, and a polygon geometry
+outlining the raster.
+This output is suitable for use with \X'tty: link http://mapserver.org/'\fI\%MapServer\fP\X'tty: link' as a
+raster tileindex
+.sp
+See \fI\%gdal driver gti create\fP for an extension of this command
+that create files to be used as input for the \fI\%GTI\fP driver.
+.sp
+The following options are available:
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-absolute\-path
+The absolute path to the raster files is stored in the index file.
+By default the raster filenames will be put in the file exactly as they
+are specified on the command line.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-base\-url <BASE\-URL>
+Added in version 3.13.
+
+.sp
+Base URL for STAC\-GeoParquet the \fBhref\fP property of the \fIid\fP property in
+a STAC\-GeoParquet index.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-filename\-filter <FILENAME\-FILTER>
+Pattern that the filenames contained in input directories should follow.
+\(aq*\(aq is a wildcard character that matches any number of any characters
+including none. \(aq?\(aq is a wildcard character that matches a single character.
+Comparisons are done in a case insensitive way.
+Several filters may be specified.
+.sp
+For example: \fB\-\-filename\-filter \(dq*.tif,*.tiff\(dq\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-id\-metadata\-item <ID\-METADATA\-ITEM>
+Added in version 3.13.
+
+.sp
+Name of metadata item used to set STAC\-GeoParquet  \fIid\fP property. Defaults to \fBid\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-id\-method filename|md5|metadata\-item
+Added in version 3.13.
+
+.sp
+How to derive STAC\-GeoParquet \fIid\fP property
+.INDENT 7.0
+.IP \(bu 2
+\fBfilename\fP (the default): only the filename (without directory, but including extension) is used
+.IP \(bu 2
+\fBmd5\fP: the MD5Sum of the file is computed, and suffixed with the filename.
+.IP \(bu 2
+\fBmetadata\-item\fP: the value of the metadata item defined by \fI\%\-\-id\-metadata\-item\fP from each source dataset is used.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-location\-name <LOCATION\-NAME>
+The output field name to hold the file path/location to the indexed
+rasters. The default field name is \fBlocation\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-max\-pixel\-size <val>
+Maximum pixel size in term of geospatial extent per pixel (resolution) that
+a raster should have to be selected. The pixel size
+is evaluated after reprojection of its extent to the target CRS defined
+by \fI\%\-\-output\-crs\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-metadata <KEY>=<VALUE>
+Write an arbitrary layer metadata item, for formats that support layer
+metadata.
+This option may be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-min\-pixel\-size <val>
+Minimum pixel size in term of geospatial extent per pixel (resolution) that
+a raster should have to be selected. The pixel size
+is evaluated after reprojection of its extent to the target CRS defined
+by \fI\%\-\-output\-crs\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output\-crs <OUTPUT\-CRS>
+Geometries of input files will be transformed to the desired target
+coordinate reference system.
+Default creates simple rectangular polygons in the same coordinate reference
+system as the input rasters.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-profile none|STAC\-GeoParquet
+Added in version 3.13.
+
+.sp
+Defines the profile of the output dataset. If selecting \fBSTAC\-GeoParquet\fP,
+a Parquet file conforming to the \X'tty: link https://radiantearth.github.io/stac-geoparquet-spec/latest/'\fI\%STAC\-GeoParquet\fP\X'tty: link'
+specification is created (provided that the Parquet format is also selected).
+Such file can be read by the \fI\%GTI driver\fP\&.
+Setting \fBSTAC\-GeoParquet\fP also implicitly sets the target CRS to EPSG:4326.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-recursive
+Whether input directories should be explored recursively.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-errors
+Added in version 3.12.
+
+.sp
+Skip errors related to input datasets.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-source\-crs\-field\-name <SOURCE\-CRS\-FIELD\-NAME>
+The name of the field to store the CRS of each tile. This field name can be
+used as the value of the TILESRS keyword in MapServer
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-source\-crs\-format auto|WKT|EPSG|PROJ
+The format in which the CRS of each tile must be written. Types can be
+\fBauto\fP, \fBWKT\fP, \fBEPSG\fP, \fBPROJ\fP\&.
+This option should be used together with \fI\%\-\-source\-crs\-field\-name\fP\&.
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-append
+Whether appending features to existing layer(s) is allowed.
+This also creates the output dataset if it does not exist yet.
+.UNINDENT
+.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 \-\-lco, \-\-layer\-creation\-option <NAME>=<VALUE>
+Many formats have one or more optional layer creation options that can be
+used to control particulars about the layer created. For instance,
+the GeoPackage driver supports layer creation options to control the
+feature identifier or geometry column name, setting the identifier or
+description, etc.
+.sp
+May be repeated.
+.sp
+The layer creation options available vary by format driver, and some
+simple formats have no layer 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\%Vector drivers\fP format
+specific documentation for legal creation options for each format.
+.sp
+Note that layer creation options are different from dataset creation options.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
+Which output vector format to use. Allowed values may be given by
+\fBgdal \-\-formats | grep vector | grep rw | sort\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-nln, \-\-output\-layer <LAYER>
+Provides a name for the output vector layer.
+.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 \-\-overwrite\-layer
+Whether overwriting the existing output vector layer is allowed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-update
+Whether the output dataset must be opened in update mode. Implies that
+it 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
+.sp
+Produce a GeoPackage with a record for every
+image that the utility found in the \fBdoq\fP folder. Each record holds
+information that points to the location of the image and also a bounding rectangle
+shape showing the bounds of the image:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster index doq/*.tif doq_index.gpkg
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2
+.sp
+The \fI\%\-\-output\-crs\fP option can also be used to transform all input raster
+geometries into the same output projection:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster index \-\-output\-crs EPSG:4326 \-\-source\-crs\-field\-name=src_srs *.tif tile_index_mixed_crs.gpkg
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Creates a STAC\-GeoParquet compliant index.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster index \-\-profile STAC\-GeoParquet  *.tif index.parquet
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.