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

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

@@ -0,0 +1,673 @@
+.\" 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_TRANSLATE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal_translate \- Converts raster data between different formats.
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal_translate [\-\-help] [\-\-long\-usage] [\-\-help\-general]
+                      [\-ot Byte|Int8|[U]Int{16|32|64}|CInt{16|32}|[C]Float{32|64}]
+                      [\-if <format>]... [\-of <output_format>] [\-\-quiet]
+                      [\-b <band>]... [\-mask <mask>] [\-expand gray|rgb|rgba]
+                      [[\-strict]|[\-not_strict]]
+                      [\-outsize <xsize[%]|0> <ysize[%]|0>] [\-tr <xres> <yres>]
+                      [\-ovr <level>|AUTO|AUTO\-<n>|NONE] [\-sds]
+                      [\-r nearest,bilinear,cubic,cubicspline,lanczos,average,mode]
+                      [[\-scale [<src_min> <src_max> [<dst_min> <dst_max>]]]...|
+                      [\-scale_X [<src_min> <src_max> [<dst_min> <dst_max>]]]...|
+                      [\-unscale]]
+                      [[\-exponent <value>]|[\-exponent_X <value>]...]
+                      [\-srcwin <xoff> <yoff> <xsize> <ysize>]
+                      [\-projwin <ulx> <uly> <lrx> <lry>]
+                      [\-projwin_srs <srs_def>] [\-epo] [\-eco] [\-a_srs <srs_def>]
+                      [\-a_coord_epoch <epoch>] [\-a_ullr <ulx> <uly> <lrx> <lry>]
+                      [\-a_nodata <value>|none]
+                      [\-a_gt <gt(0)> <gt(1)> <gt(2)> <gt(3)> <gt(4)> <gt(5)>]
+                      [\-a_scale <value>] [\-a_offset <value>] [\-nogcp]
+                      [\-gcp <pixel> <line> <easting> <northing> [<elevation>]]...
+                      [\-colorinterp {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...},...]
+                      [\-colorinterp_X {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...}]...
+                      [[\-stats]|[\-approx_stats]]
+                      [\-norat] [\-noxmp] [\-co <NAME>=<VALUE>]...
+                      [\-mo <NAME>=<VALUE>]... [\-dmo <DOMAIN>:<KEY>=<VALUE>]...
+                      [\-oo <NAME>=<VALUE>]...
+                      <input_file> <output_file>
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+The \fBgdal_translate\fP utility can be used to convert raster data between
+different formats, potentially performing some operations like subsetting,
+resampling, and rescaling pixels in the process.
+.sp
+\fBTIP:\fP
+.INDENT 0.0
+.INDENT 3.5
+Equivalent in new \(dqgdal\(dq command line interface:
+.INDENT 0.0
+.IP \(bu 2
+\fI\%gdal raster convert\fP for format translation.
+.IP \(bu 2
+\fI\%gdal raster clip\fP for spatial subsetting.
+.IP \(bu 2
+\fI\%gdal raster nodata\-to\-alpha\fP to add an alpha channel from nodata values.
+.IP \(bu 2
+\fI\%gdal raster resize\fP for image resizing.
+.IP \(bu 2
+\fI\%gdal raster scale\fP to scale pixel values.
+.IP \(bu 2
+\fI\%gdal raster set\-type\fP to change the band data type.
+.UNINDENT
+.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 \-ot <type>
+Force the output image bands to have a specific data type supported by the
+driver, which may be one of the following: \fBByte\fP, \fBInt8\fP, \fBUInt16\fP,
+\fBInt16\fP, \fBUInt32\fP, \fBInt32\fP, \fBUInt64\fP, \fBInt64\fP, \fBFloat32\fP, \fBFloat64\fP, \fBCInt16\fP,
+\fBCInt32\fP, \fBCFloat32\fP or \fBCFloat64\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-strict
+Enable strict mode. In this mode, GDAL will fail instead of silently
+performing operations that may lead to loss of information, such as
+data type conversions that cannot be exactly preserved.
+.sp
+The exact behavior of this option is driver\-dependent. Most raster
+drivers use it to enforce strict preservation of the input data type
+and will report an error if the requested operation cannot be performed
+without data loss. See \fI\%Example 5\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-if <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
+Added in version 3.2.
+
+.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 \-b <band>
+Select an input band \fBband\fP for output. Bands are numbered from 1.
+Multiple \fI\%\-b\fP switches may be used to select a set of input bands
+to write to the output file, or to reorder bands. \fBband\fP can also be set
+to \(dqmask,1\(dq (or just \(dqmask\(dq) to mean the mask band of the first band of the
+input dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-mask <band>
+Select an input band \fBband\fP to create output dataset mask band. Bands are
+numbered from 1. \fBband\fP can be set to \(dqnone\(dq to avoid copying the global
+mask of the input dataset if it exists. Otherwise it is copied by default
+(\(dqauto\(dq), unless the mask is an alpha channel, or if it is explicitly used
+to be a regular band of the output dataset (\(dq\-b mask\(dq). \fBband\fP can also
+be set to \(dqmask,1\(dq (or just \(dqmask\(dq) to mean the mask band of the 1st band
+of the input dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-expand gray|rgb|rgba
+To expose a dataset with 1 band with a color table as a dataset with
+3 (RGB) or 4 (RGBA) bands. Useful for output drivers such as JPEG,
+JPEG2000, MrSID, ECW that don\(aqt support color indexed datasets. The \(aqgray\(aq
+value enables to expand a dataset with a color table that only contains
+gray levels to a gray indexed dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-outsize <xsize>[%]|0 <ysize>[%]|0
+Set the size of the output file.  Outsize is in pixels and lines unless \(aq%\(aq
+is attached in which case it is as a fraction of the input image size.
+If one of the 2 values is set to 0, its value will be determined from the
+other one, while maintaining the aspect ratio of the source dataset.
+.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. This is mutually exclusive with
+\fI\%\-outsize\fP, \fI\%\-a_ullr\fP, and \fI\%\-a_gt\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-ovr {<level>|AUTO|AUTO\-<n>|NONE}
+Added in version 3.6.
+
+.sp
+To specify which overview level of source file must be used. The default choice,
+AUTO, will select the overview level whose resolution is the closest to the
+target resolution. Specify an integer value (0\-based, i.e. 0=1st overview level)
+to select a particular level. Specify AUTO\-n where n is an integer greater or
+equal to 1, to select an overview level below the AUTO one. Or specify NONE to
+force the base resolution to be used (can be useful if overviews have been
+generated with a low quality resampling method, and a higher quality resampling method
+is specified with \fI\%\-r\fP\&.)
+.sp
+When \fI\%\-ovr\fP is specified as an integer value,
+and neither \fI\%\-outsize\fP nor \fI\%\-tr\fP is specified, the size of
+the overview will be used as the output size.
+.sp
+When \fI\%\-ovr\fP is specified, values of \fI\%\-srcwin\fP
+should be expressed as pixel offset and size of the full resolution source dataset.
+Similarly when using \fI\%\-outsize\fP with percentage values, they refer to the size
+of the full resolution source dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-r {nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode}
+Select a resampling algorithm.
+.sp
+\fBnearest\fP (default) applies a nearest neighbour (simple sampling) resampler
+.sp
+\fBaverage\fP computes the average of all non\-NODATA contributing pixels. Starting with GDAL 3.1, this is a weighted average taking into account properly the weight of source pixels not contributing fully to the target pixel.
+.sp
+\fBrms\fP computes the root mean squared / quadratic mean of all non\-NODATA contributing pixels (GDAL >= 3.3)
+.sp
+\fBbilinear\fP applies a bilinear convolution kernel.
+.sp
+\fBcubic\fP applies a cubic convolution kernel.
+.sp
+\fBcubicspline\fP applies a B\-Spline convolution kernel.
+.sp
+\fBlanczos\fP applies a Lanczos windowed sinc convolution kernel.
+.sp
+\fBmode\fP selects the value which appears most often of all the sampled points.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-scale [<src_min> <src_max> [<dst_min> <dst_max>]]
+Rescale the input pixels values from the range \fBsrc_min\fP to \fBsrc_max\fP
+to the range \fBdst_min\fP to \fBdst_max\fP\&.
+If omitted the output range is from the minimum value to the maximum value allowed
+for integer data types (for example from 0 to 255 for Byte output) or from 0 to 1
+for floating\-point data types.
+If omitted the input range is automatically computed from the
+source dataset, in its whole (not just the window of interest potentially
+specified with \fI\%\-srcwin\fP or \fI\%\-projwin\fP). This may be a
+slow operation on a large source dataset, and if using it multiple times
+for several gdal_translate invocation, it might be beneficial to call
+\fBgdalinfo \-stats {source_dataset}\fP priorly to precompute statistics, for
+formats that support serializing statistics computations (GeoTIFF, VRT...)
+Note that the values specified after \fI\%\-scale\fP are only used to compute a scale and
+offset to apply to the input raster values. In particular, \fBsrc_min\fP and
+\fBsrc_max\fP are not used to clip input values unless \fI\%\-exponent\fP
+is also specified.
+Instead of being clipped, source values that are outside the range of \fBsrc_min\fP and \fBsrc_max\fP will be scaled to values outside the range of \fBdst_min\fP and \fBdst_max\fP\&.
+If clipping without exponential scaling is desired,
+\fB\-exponent 1\fP can be used.
+\fI\%\-scale\fP can be repeated several times (if specified only once,
+it also applies to all bands of the output dataset), so as to specify per
+band parameters. It is also possible to use the \fB\-scale_bn\fP syntax where bn
+is a band number (e.g. \fB\-scale_2\fP for the 2nd band of the output dataset)
+to specify the parameters of one or several specific bands.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-exponent <exp_val>
+Apply non\-linear scaling with a power function. \fBexp_val\fP is the exponent
+of the power function (must be positive). This option must be used with the
+\fI\%\-scale\fP option. If specified only once, \fI\%\-exponent\fP applies
+to all bands of
+the output image. It can be repeated several times so as to specify per
+band parameters. It is also possible to use the \fB\-exponent_bn\fP syntax where
+bn is a band number (e.g. \fB\-exponent_2\fP for the 2nd band of the output
+dataset) to specify the parameters of one or several specific bands.
+.sp
+The scaled value \fBDst\fP is calculated from the source value \fBSrc\fP with the following
+formula:
+.sp
+.ce
+{Dst} = \eleft( {Dst}_{max} \- {Dst}_{min} \eright) \etimes \eoperatorname{max} \eleft( 0, \eoperatorname{min} \eleft( 1, \eleft( \efrac{{Src} \- {Src}_{min}}{{Src}_{max}\-{Src}_{min}} \eright)^{exp\e_val} \eright) \eright) + {Dst}_{min}
+
+
+.ce 0
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-unscale
+Apply the scale/offset metadata for the bands to convert linearly\-scaled values to
+unscaled values.  It is also often necessary to reset the output datatype
+with the \fI\%\-ot\fP switch.
+The unscaled value is computed from the scaled raw value with the following
+formula:
+.sp
+.ce
+{unscaled\e_value} = {scaled\e_value} * {scale} + {offset}
+
+
+.ce 0
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-srcwin <xoff> <yoff> <xsize> <ysize>
+Selects a subwindow from the source image for copying based on pixel/line
+location. Pixel/line offsets (\fBxoff\fP and \fByoff\fP) are measured from the
+left and top of the image.
+If the subwindow extends beyond the bounds of the source dataset,
+output pixels will be written with a value of zero, unless a NoData value is
+defined either in the source dataset or by \fI\%\-a_nodata\fP\&.
+Alternatively, \fBgdal_translate\fP can issue an error in this case
+if so directed by options \fI\%\-epo\fP or \fI\%\-eco\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-projwin <ulx> <uly> <lrx> <lry>
+Selects a subwindow from the source image for copying
+(like \fI\%\-srcwin\fP) but with the corners given in georeferenced
+coordinates (by default expressed in the SRS of the dataset. Can be
+changed with \fI\%\-projwin_srs\fP). If the subwindow extends beyond
+the bounds of the source dataset, output pixels will be written with a value
+of zero, unless a NoData value is defined either in the source dataset or
+by \fI\%\-a_nodata\fP\&. Alternatively, \fBgdal_translate\fP can issue
+an error in this case if so directed by options \fI\%\-epo\fP or \fI\%\-eco\fP\&.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+Beginning with GDAL 3.11, the extent described by \fI\%\-projwin\fP will
+be transformed into the dataset SRS and used to select a subwindow.
+Before GDAL 3.11, only the two corner points were transformed into the
+dataset SRS, and these two transformed points were used to define an extent
+in the dataset SRS. Depending on the SRS involved, the subwindow selected in
+GDAL 3.11 may be substantially larger than in previous versions.
+.UNINDENT
+.UNINDENT
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+When using nearest\-neighbor resampling, the window specified by
+\fI\%\-projwin\fP is expanded (rounded, for GDAL < 3.11) if necessary
+to match input pixel boundaries. For other resampling algorithms, the window
+is not modified.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-projwin_srs <srs_def>
+Specifies the SRS in which to interpret the coordinates given with
+\fI\%\-projwin\fP\&. The <srs_def> may be any of the usual GDAL/OGR forms,
+complete WKT, PROJ.4, EPSG:n or a file containing the WKT.
+.sp
+\fBWARNING:\fP
+.INDENT 7.0
+.INDENT 3.5
+This does not cause reprojection of the dataset to the specified SRS.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-epo
+(Error when Partially Outside) If this option is set, \fI\%\-srcwin\fP or
+\fI\%\-projwin\fP values that falls partially outside the source raster
+extent will be considered as an error. The default behavior is to accept
+such requests.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-eco
+(Error when Completely Outside) Same as \fI\%\-epo\fP, except that the
+criterion for erroring out is when the request falls completely outside
+the source raster extent.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_srs <srs_def>
+Override the projection for the output file. Can be used with
+\fI\%\-a_ullr\fP or \fI\%\-a_gt\fP to specify the extent in this projection.
+.sp
+The coordinate reference systems that can be passed are anything supported by the
+\fI\%OGRSpatialReference::SetFromUserInput()\fP call, which includes EPSG Projected,
+Geographic or Compound CRS (i.e. EPSG:4296), a well known text (WKT) CRS definition,
+PROJ.4 declarations, or the name of a .prj file containing a WKT CRS definition.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+No reprojection is done.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_coord_epoch <epoch>
+Added in version 3.4.
+
+.sp
+Assign a coordinate epoch, linked with the output SRS. Useful when the
+output SRS is a dynamic CRS.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_scale <value>
+Set band scaling value. No modification of pixel values is done.
+Note that the \fI\%\-unscale\fP does not take into account \fI\%\-a_scale\fP\&.
+You may for example specify \fB\-scale 0 1 <offset> <offset+scale>\fP to
+apply a (offset, scale) tuple, for the equivalent of the 2 steps:
+\fBgdal_translate input.tif tmp.vrt \-a_scale scale \-a_offset offset\fP followed by
+\fBgdal_translate tmp.vrt output.tif \-unscale\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_offset <value>
+Set band offset value. No modification of pixel values is done.
+Note that the \fI\%\-unscale\fP does not take into account \fI\%\-a_offset\fP\&.
+You may for example specify \fB\-scale 0 1 <offset> <offset+scale>\fP to
+apply a (offset, scale) tuple, for the equivalent of the 2 steps:
+\fBgdal_translate input.tif tmp.vrt \-a_scale scale \-a_offset offset\fP followed by
+\fBgdal_translate tmp.vrt output.tif \-unscale\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_ullr <ulx> <uly> <lrx> <lry>
+Assign/override the georeferenced bounds of the output file.  This assigns
+georeferenced bounds to the output file, ignoring what would have been
+derived from the source file. So this does not cause reprojection to the
+specified SRS.
+This is mutually exclusive with \fI\%\-a_gt\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_gt <gt(0)> <gt(1)> <gt(2)> <gt(3)> <gt(4)> <gt(5)>
+Assign/override the geotransform of the output file.
+This assigns the geotransform to the output file, ignoring what would have been
+derived from the source file. So this does not cause reprojection to the
+specified SRS. See \fI\%Geotransform Tutorial\fP\&.
+This is mutually exclusive with \fI\%\-a_ullr\fP
+.sp
+Added in version 3.8.
+
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a_nodata <value>
+Assign a specified nodata value to output bands. It can
+be set to \fBnone\fP to avoid setting a nodata value to the output file if
+one exists for the source file. Note that, if the input dataset has a
+nodata value, this does not cause pixel values that are equal to that nodata
+value to be changed to the value specified with this option.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-colorinterp_X <red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...>
+Override the color interpretation of band X (where X is a valid band number,
+starting at 1)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-colorinterp {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...},...
+Override the color interpretation of all specified bands. For
+example \-colorinterp red,green,blue,alpha for a 4 band output dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-mo <META\-TAG>=<VALUE>
+Passes a metadata key and value to set on the output dataset if possible.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-dmo DOMAIN:META\-TAG=VALUE
+Passes a metadata key and value in specified domain to set on the output dataset if possible.
+.sp
+Added in version 3.9.
+
+.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.
+.sp
+In addition to the driver\-specific creation options, gdal_translate
+(and \fI\%GDALTranslate()\fP and \fI\%GDALCreateCopy()\fP) recognize
+the following options:
+.INDENT 7.0
+.IP \(bu 2
+\fBAPPEND_SUBDATASET=[YES​/​NO]: \fP Defaults to \fBNO\fP\&. 
+.sp
+Can be specified to YES to avoid prior destruction of existing dataset,
+for drivers that support adding several subdatasets (e.g. GTIFF, NITF)
+.IP \(bu 2
+\fBCOPY_SRC_MDD=[AUTO​/​YES​/​NO]: \fP (GDAL >= 3.8)  Defaults to \fBAUTO\fP\&. 
+.sp
+Defines if metadata domains of the source dataset should be copied to the
+destination dataset.
+In the default AUTO mode, only \(dqsafe\(dq domains will be copied, which
+include the default metadata domain (some drivers may include other
+domains such as IMD, RPC, GEOLOCATION).
+When setting YES, all domains will be copied (but a few reserved ones like
+IMAGE_STRUCTURE or DERIVED_SUBDATASETS).
+Currently only recognized by the GTiff, COG, VRT, PNG and JPEG drivers.
+.sp
+When setting NO, no source metadata will be copied.
+.IP \(bu 2
+\fBSRC_MDD=<domain_name>: \fP (GDAL >= 3.8) 
+.sp
+Defines which source metadata domain should be copied.
+This option restricts the list of source metadata domains to be copied
+(it implies COPY_SRC_MDD=YES if it is not set). This option may be specified
+as many times as they are source domains. The default metadata domain is the
+empty string \(dq\(dq (\(dq_DEFAULT_\(dq) may also be used when empty string is not practical).
+Currently only recognized by the GTiff, COG, VRT, PNG and JPEG drivers.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-nogcp
+Do not copy the GCPs in the source dataset to the output dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-gcp <pixel> <line> <easting> <northing> [<elevation>]
+Add the indicated ground control point to the output dataset.  This option
+may be provided multiple times to provide a set of GCPs.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-q
+Suppress progress monitor and other non\-error output.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-sds
+Copy all subdatasets of this file to individual output files.  Use with
+formats like HDF that have subdatasets.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-stats
+Force (re)computation of statistics.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-norat
+Do not copy source RAT into destination dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-noxmp
+Do not copy the XMP metadata in the source dataset to the output dataset when driver is able to copy it.
+.sp
+Added in version 3.2.
+
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-oo <NAME>=<VALUE>
+Dataset open option (format specific)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B <src_dataset>
+The source dataset name. It can be either file name, URL of data source or
+subdataset name for multi\-dataset files.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B <dst_dataset>
+The destination file name.
+.UNINDENT
+.SH NODATA / SOURCE VALIDITY MASK HANDLING DURING RESAMPLING
+.sp
+Masked values, either identified through a nodata value metadata set on the
+source band, a mask band, an alpha band will not be used during resampling
+(when using \fI\%\-outsize\fP or \fI\%\-tr\fP).
+.sp
+The details of how it is taken into account depends on the resampling kernel:
+.INDENT 0.0
+.IP \(bu 2
+for nearest resampling, for each target pixel, one of the potential contributing
+source pixels is selected (in an implementation specific way). Its value is used
+as it, be it valid or invalid.
+.IP \(bu 2
+for bilinear, cubic, cubicspline and lanczos, for each target pixel, the weights
+of contributing source pixels is set to zero to ignore them when they are masked.
+There is an extra specificity for cubic and lanczos: given that some of the weights in the
+kernel are negative, such strategy could lead to strong overshoot/undershoot
+when there is an alternance of valid and invalid pixels. Consequently, if any
+of the horizontal or vertical direction, if the maximum number of valid source
+pixels in each dimension is less than the radius of the resampling kernel,
+the target pixel is considered as nodata.
+.IP \(bu 2
+for the other resampling methods, source pixels contributing to the target pixel
+are ignored if masked. Only the valid ones are taken into account. If there are
+none, the target pixel is considered as nodata.
+.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 C API
+.sp
+This utility is also callable from C with \fI\%GDALTranslate()\fP\&.
+.SH EXAMPLES
+.SS Example 1: Creating a tiled GeoTIFF
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_translate \-of GTiff \-co \(dqTILED=YES\(dq utm.tif utm_tiled.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Creating a JPEG\-compressed TIFF with internal mask from a RGBA dataset
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_translate rgba.tif withmask.tif \-b 1 \-b 2 \-b 3 \-mask 4 \-co COMPRESS=JPEG \e
+  \-co PHOTOMETRIC=YCBCR \-\-config GDAL_TIFF_INTERNAL_MASK YES
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Creating a RGBA dataset from a RGB dataset with a mask
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_translate withmask.tif rgba.tif \-b 1 \-b 2 \-b 3 \-b mask
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 4: Subsetting using \-projwin and \-outsize
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal_translate \-projwin \-20037500 10037500 0 0 \-outsize 100 100 frmt_wms_googlemaps_tms.xml junk.png
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 5: Use of strict mode with unsupported data type
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal_create test.tif \-bands 3 \-ot Int16 \-outsize 1 1
+$ gdal_translate \-strict test.tif test.webp
+ERROR 6: WEBP driver doesn\(aqt support data type Int16.
+Only UInt8 bands supported.
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer <silke@intevation.de>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.