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

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

@@ -0,0 +1,367 @@
+.\" 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-CALC" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-calc \- Perform pixel-wise calculations on a raster
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster calc [OPTIONS] <INPUTS>... <OUTPUT>
+
+Perform raster algebra
+
+Positional arguments:
+  \-i, \-\-input <INPUTS>                                     Input raster datasets [1.. values] [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
+  \-\-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
+  \-\-no\-check\-crs                                           Do not check consistency of input coordinate reference systems
+  \-\-no\-check\-extent                                        Do not check consistency of input extents
+  \-\-propagate\-nodata                                       Whether to set pixels to the output NoData value if any of the input pixels is NoData
+  \-\-calc <CALC>                                            Expression(s) to evaluate [1.. values] [required]
+  \-\-dialect <DIALECT>                                      Expression dialect. DIALECT=muparser|builtin (default: muparser)
+  \-\-flatten                                                Generate a single band output raster per expression, even if input datasets are multiband
+  \-\-nodata <NODATA>                                        Assign a specified nodata value to output bands (\(aqnone\(aq, numeric value, \(aqnan\(aq, \(aqinf\(aq, \(aq\-inf\(aq)
+
+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 calc\fP performs pixel\-wise calculations on one or more input GDAL datasets. Calculations
+can be performed eagerly, writing results to a conventional raster format,
+or lazily, written as a set of derived bands in a \fI\%VRT (Virtual Dataset)\fP\&.
+.sp
+The list of input GDAL datasets can be specified at the end
+of the command line or put in a text file (one input per line) for very long lists.
+If more than one input dataset is used, it should be prefixed with a name by which it
+will be referenced in the calculation, e.g. \fBA=my_data.tif\fP\&. (If a single dataset is
+used, it will be referred to with the variable \fBX\fP in formulas.)
+.sp
+Starting with GDAL 3.12, it is also possible to use a \fI\%VRT C++ pixel function\fP
+(such a \fBsum\fP, \fBmean\fP, \fBmin\fP, \fBmax\fP) by specifying \fI\%\-\-dialect\fP to
+\fBbuiltin\fP\&.
+.sp
+The inputs should have the same spatial reference system and should cover the same spatial extent but are not required to have the same
+spatial resolution. The spatial extent check can be disabled with \fI\%\-\-no\-check\-extent\fP,
+in which case the inputs must have the same dimensions. The spatial reference system check can be
+disabled with \fI\%\-\-no\-check\-crs\fP\&.
+.sp
+Since GDAL 3.12, this algorithm can be part of a \fI\%gdal pipeline\fP or \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 \-\-calc
+An expression to be evaluated using the \X'tty: link https://beltoforion.de/en/muparser'\fI\%muparser\fP\X'tty: link' math parser library.
+The expression may refer to individual bands of each input (e.g., \fBX[1] + 3\fP) or it may be applied to all bands
+of an input (\fBX + 3\fP).
+.sp
+There are two methods by which an expression may be applied to multiple bands. In the default method, the expression is
+applied to each band individually, resulting in one output band for each input band. For example, with a three\-band
+input \fBX\fP, the expression \fB\-\-calc \(dqX+3\(dq\fP would be expanded into \fB\-\-calc \(dqX[1]+3\(dq \-\-calc \(dqX[2]+3\(dq \-\-calc \(dqX[3]+3\(dq\fP\&.
+If the expression contains a reference to all bands of multiple inputs, those inputs must either have the same
+number of bands, or a single band. For example, if inputs \fBA\fP and \fBB\fP each have three bands, and input \fBC\fP has
+a single band, then the argument \fB\-\-calc \(dqA + B + C\(dq\fP is equivalent to
+\fB\-\-calc \(dqA[1] + B[1] + C[1]\(dq \-\-calc \(dqA[2] + B[2] + C[1]\(dq \-\-calc \(dqA[3] + B[3] + C[1]\(dq\fP\&.
+Similarly, \fB\-\-calc \(dqsum(A,B,C)\(dq\fP would be expanded to
+\fB\-\-calc \(dqsum(A[1], B[1], C[1]\(dq \-\-calc \(dqsum(A[2], B[2], C[1])\(dq \-\-calc \(dqsum(A[3], B[3], C[1])\(dq\fP\&.
+.sp
+In the second method, which is enabled with \fI\%\-\-flatten\fP, aggregate functions (\fBsum\fP, \fBavg\fP, \fBmin\fP, and \fBmax\fP)
+invoked on multiple bands will be applied to all bands in aggregate. In this case, \fBsum(A)\fP is expanded into \fBsum(A[1], A[2], A[3])\fP,
+and \fBsum(A,C)\fP is expanded into \fBsum(A[1], A[2], A[3], C[1])\fP\&. If the expression consists _only_ of aggregate functions,
+this will produce a single output band no matter how many input bands are present. However, if the expression contains
+a non\-aggregate reference to all bands of an input, then one output band will still be produced for each input band. A simple
+example is the expression \fBA / sum(A)\fP, which would produce an N\-band raster where each output band contains the input band\(aqs
+fraction of the total.
+.sp
+Multiple calculations may be specified; output band(s) will be produced for each expression in the order they
+are provided.
+.sp
+Input rasters will be converted to 64\-bit floating point numbers before performing calculations.
+.sp
+Starting with GDAL 3.12, it is also possible to use a \fI\%VRT C++ pixel function\fP
+(such a \fBsum\fP, \fBmean\fP, \fBmin\fP, \fBmax\fP) by specifying \fI\%\-\-dialect\fP to
+\fBbuiltin\fP\&.
+Arguments to functions are passed within parentheses, like \fBsum(k=1)\fP,
+\fBmin(propagateNoData=true)\fP or \fBinterpolate_linear(t0=1,dt=1,t=10)\fP\&.
+.SS Built\-in variables
+.sp
+The following built\-in variables are available in expressions:
+.INDENT 7.0
+.IP \(bu 2
+\fB_CENTER_X_\fP: X coordinate of the pixel center, expressed in the dataset CRS
+.IP \(bu 2
+\fB_CENTER_Y_\fP: Y coordinate of the pixel center, expressed in the dataset CRS
+.IP \(bu 2
+\fBNODATA\fP: The output \fINoData\fP value, if any.
+.UNINDENT
+.sp
+These variables are useful for calculations that depend on spatial position,
+such as latitude\-based corrections, solar angle approximations, or zonal masks.
+.sp
+See \fI\%Example 7\fP for a usage example.
+.sp
+Note: To work with longitude/latitude values, the input dataset must be in a
+geographic coordinate reference system (for example, EPSG:4326).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-dialect muparser|builtin
+Added in version 3.12.
+
+.sp
+Specify the expression engine used to interpret the value of \fI\%\-\-calc\fP\&.
+The default is \fBmuparser\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-flatten
+Added in version 3.12.
+
+.sp
+Generate a single band output raster per expression, even if input datasets are multiband.
+.sp
+For the default muparser dialect, using the name of an input raster (let\(aqs say A)
+is equivalent to \fBA[1],A[2],...,A[n]\fP\&. Such syntax works with the
+\fBmin\fP, \fBmax\fP, \fBsum\fP and \fBavg\fP muparser functions.
+.sp
+For example, let\(aqs consider 2 rasters A and B with 3bands each, then
+\fB\-\-flatten \-\-calc \(dqavg(A)\-avg(B)\(dq\fP is equivalent to \fB\-\-calc \(dqavg(A[1],A[2],A[3])\-avg(B[1],B[2],B[3])\(dq\fP
+.sp
+And \fB\-\-flatten \-\-dialect=builtin \-\-calc mean\fP will compute a single band
+with the average of all 4 input bands.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-i [<name>=]<input>
+Select an input dataset to be processed. If more than one input dataset is provided,
+each dataset must be prefixed with a name to which it will will be referenced in \fI\%\-\-calc\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-check\-extent
+Do not verify that the input rasters have the same spatial extent. The input rasters will instead be required to
+have the same dimensions. The geotransform of the first input will be assigned to the output.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-check\-crs
+Do not check the spatial reference systems of the inputs for consistency. All inputs will be assumed to have the
+spatial reference system of the first input, and this spatial reference system will be used for the output.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-nodata
+Added in version 3.12.
+
+.sp
+Set the NoData value for the output dataset. May be set to \(dqnone\(dq to leave the NoData value undefined. If
+\fI\%\-\-nodata\fP is not specified, \fBgdal raster calc\fP will use a NoData value from the first
+source dataset to have one.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-propagate\-nodata
+Added in version 3.12.
+
+.sp
+If set, a NoData value in any input dataset used an in expression will cause the output value to be NoData.
+.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 \-\-ot, \-\-datatype, \-\-output\-data\-type <OUTPUT\-DATA\-TYPE>
+Output data type among \fBByte\fP, \fBInt8\fP, \fBUInt16\fP, \fBInt16\fP, \fBUInt32\fP,
+\fBInt32\fP, \fBUInt64\fP, \fBInt64\fP, \fBCInt16\fP, \fBCInt32\fP, \fBFloat32\fP,
+\fBFloat64\fP, \fBCFloat32\fP, \fBCFloat64\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: Per\-band sum of three files
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster calc \-i \(dqA=file1.tif\(dq \-i \(dqB=file2.tif\(dq \-i \(dqC=file3.tif\(dq \-\-calc \(dqA+B+C\(dq \-o out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Per\-dataset average of all bands of each dataset
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster calc \-i \(dqA=file1.tif\(dq \-i \(dqB=file2.tif\(dq \-i \(dqC=file3.tif\(dq \-\-flatten \-\-calc \(dqavg(A)\(dq \-\-calc \(dqavg(B)\(dq \-\-calc \(dqavg(C)\(dq \-o out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Per\-band maximum of three files
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster calc \-i \(dqA=file1.tif\(dq \-i \(dqB=file2.tif\(dq \-i \(dqC=file3.tif\(dq \-\-calc \(dqmax(A,B,C)\(dq \-o out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 4: Setting values of zero and below to NaN
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster calc \-i \(dqA=input.tif\(dq \-o result.tif \-\-calc=\(dqA > 0 ? A : NaN\(dq
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 5: Compute the average (as a single band) of all bands of two input datasets
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster calc \-i A=input1.tif \-i B=input2.tif \-o result.tif \-\-flatten \-\-calc=mean \-\-dialect=builtin
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 6: Generate a masked aspect layer where the slope angle is greater than 2 degrees, using nested pipelines (since GDAL 3.12.1)
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster calc \-i \(dqSLOPE=[ read dem.tif ! slope ]\(dq \-i \(dqASPECT=[ read dem.tif ! aspect ]\(dq \-o result.tif \-\-calc \(dq(SLOPE >= 2) ? ASPECT : \-9999\(dq \-\-nodata \-9999
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 7: Latitude\-based calculation using _CENTER_Y_
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster calc \-i A=input.tif \e
+    \-\-calc=\(dqsin(_CENTER_Y_ * 0.0174533)\(dq \e
+    \-o output.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Dan Baston <dbaston@gmail.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.

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

@@ -0,0 +1,209 @@
+.\" 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-CLEAN-COLLAR" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-clean-collar \- Clean the collar of a raster dataset, removing noise
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster clean\-collar [OPTIONS] <INPUT> [<OUTPUT>]
+
+Clean the collar of a raster dataset, removing noise.
+
+Positional arguments:
+  \-i, \-\-input <INPUT>                                  Input raster dataset [required]
+  \-o, \-\-output <OUTPUT>                                Output raster dataset
+
+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
+  \-\-update                                             Whether to open existing dataset in update mode
+  \-\-color <COLOR>                                      Transparent color(s): tuple of integer (like \(aqr,g,b\(aq), \(aqblack\(aq, \(aqwhite\(aq (default: black) [may be repeated]
+  \-\-color\-threshold <COLOR\-THRESHOLD>                  Select how far from specified transparent colors the pixel values are considered transparent. (default: 15)
+  \-\-pixel\-distance <PIXEL\-DISTANCE>                    Number of consecutive transparent pixels that can be encountered before the giving up search inwards. (default: 2)
+  \-\-add\-alpha                                          Adds an alpha band to the output dataset.
+                                                       Mutually exclusive with \-\-add\-mask
+  \-\-add\-mask                                           Adds a mask band to the output dataset.
+                                                       Mutually exclusive with \-\-add\-alpha
+  \-\-algorithm <ALGORITHM>                              Algorithm to apply. ALGORITHM=floodfill|twopasses (default: floodfill)
+
+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 raster clean\-collar\fP scans a (8\-bit) image and sets all pixels that
+are nearly or exactly black (the default), white or one or more custom colors around the collar
+to black or white.
+This is often used to \(dqfix up\(dq lossy compressed air photos so that color pixels can be
+treated as transparent when mosaicing. The output format must use lossless compression
+if either alpha band or mask band is not set.
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-add\-alpha
+Adds an alpha band to the output file.
+The alpha band is set to 0 in the image collar and to 255 elsewhere.
+This option is mutually exclusive with \fI\%\-\-add\-mask\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-add\-mask
+Adds a mask band to the output file,
+The mask band is set to 0 in the image collar and to 255 elsewhere.
+This option is mutually exclusive with \fI\%\-\-add\-alpha\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-algorithm floodfill|twopasses
+Selects the algorithm to apply.
+.sp
+\fBtwopasses\fP uses a top\-to\-bottom pass followed by a bottom\-to\-top pass.
+It may miss with concave areas.
+The algorithm processes the image one scanline at a time.  A scan \(dqin\(dq is done
+from either end setting pixels to black or white until at least
+\(dqnon_black_pixels\(dq pixels that are more than \(dqdist\(dq gray levels away from
+black, white or custom colors have been encountered at which point the scan stops.  The nearly
+black, white or custom color pixels are set to black or white. The algorithm also scans from
+top to bottom and from bottom to top to identify indentations in the top or bottom.
+.sp
+\fBfloodfill\fP (default) uses the \X'tty: link https://en.wikipedia.org/wiki/Flood_fill#Span_filling'\fI\%Flood Fill\fP\X'tty: link'
+algorithm and will work with concave areas. It requires creating a temporary
+dataset and is slower than \fBtwopasses\fP\&. When a non\-zero value for \fI\%\-\-pixel\-distance\fP
+is used, \fBtwopasses\fP is actually called as an initial step of \fBfloodfill\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-color <c1>,<c2>,<c3>...<cn>|black|white
+Search for pixels near the specified color. May be specified multiple times.
+When this option is specified, the pixels that are considered as the collar are set to 0,
+unless only white is specified, in which case there are set to 255.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-color\-threshold <val>
+Select how far from black, white or custom colors the pixel values can be
+and still considered near black, white or custom color. Defaults to 15.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-pixel\-distance <val>
+Number of consecutive transparent pixels that can be encountered before the
+giving up search inwards. Said otherwise, the collar will be extended by
+this number of pixels.
+Defaults to 2.
+.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 + | 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
+If only an input dataset is specified, ask for it to be opened in update mode
+If an output dataset is specified, ask for it to be opened in update mode
+(this implies that it already exists).
+Note that updating an existing dataset may lead to file size increase if
+the dataset is compressed, and/or quality loss if lossy compression is used.
+.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: Edit in place a dataset using the default black color as the color of the collar
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster clean\-collar \-\-update my.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Create a new dataset, using black or white as the color of the collar, considering values in the [0,5] range as being considered black, and values in the [250,255] range to be white. It also adds an alpha band to the output dataset.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster clean\-collar \-\-add\-alpha \-\-color=black \-\-color=white \-\-color\-threshold=5 in.tif out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.