.TH "gdal_translate" 1 "Tue Sep 18 2012" "GDAL" \" -*- nroff -*- .ad l .nh .SH NAME gdal_translate \- gdal_translate converts raster data between different formats .SH "SYNOPSIS" .PP .PP .nf gdal_translate [--help-general] [-ot {Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/ CInt16/CInt32/CFloat32/CFloat64}] [-strict] [-of format] [-b band] [-mask band] [-expand {gray|rgb|rgba}] [-outsize xsize[%] ysize[%]] [-unscale] [-scale [src_min src_max [dst_min dst_max]]] [-srcwin xoff yoff xsize ysize] [-projwin ulx uly lrx lry] [-a_srs srs_def] [-a_ullr ulx uly lrx lry] [-a_nodata value] [-gcp pixel line easting northing [elevation]]* [-mo "META-TAG=VALUE"]* [-q] [-sds] [-co "NAME=VALUE"]* [-stats] src_dataset dst_dataset .fi .PP .SH "DESCRIPTION" .PP The gdal_translate utility can be used to convert raster data between different formats, potentially performing some operations like subsettings, resampling, and rescaling pixels in the process\&. .PP .IP "\fB\fB-ot\fP: \fItype\fP\fP" 1c For the output bands to be of the indicated data type\&. .IP "\fB\fB-strict\fP:\fP" 1c Do'nt be forgiving of mismatches and lost data when translating to the output format\&. .IP "\fB\fB-of\fP \fIformat\fP:\fP" 1c Select the output format\&. The default is GeoTIFF (GTiff)\&. Use the short format name\&. .IP "\fB\fB-b\fP \fIband\fP:\fP" 1c Select an input band \fIband\fP for output\&. Bands are numbered from 1\&. Multiple \fB-b\fP switches may be used to select a set of input bands to write to the output file, or to reorder bands\&. Starting with GDAL 1\&.8\&.0, \fIband\fP can also be set to 'mask,1' (or just 'mask') to mean the mask band of the 1st band of the input dataset\&. .IP "\fB\fB-mask\fP \fIband\fP:\fP" 1c (GDAL >= 1\&.8\&.0) Select an input band \fIband\fP to create output dataset mask band\&. Bands are numbered from 1\&. \fIband\fP can be set to 'none' to avoid copying the global mask of the input dataset if it exists\&. Otherwise it is copied by default ('auto'), unless the mask is an alpha channel, or if it is explicitely used to ben a regular band of the output dataset ('-b mask')\&. \fIband\fP can also be set to 'mask,1' (or just 'mask') to mean the mask band of the 1st band of the input dataset\&. .IP "\fB\fB-expand\fP \fIgray|rgb|rgba\fP:\fP" 1c (From GDAL 1\&.6\&.0) To expose a dataset with 1 band with a color table as a dataset with 3 (RGB) or 4 (RGBA) bands\&. Usefull for output drivers such as JPEG, JPEG2000, MrSID, ECW that don't support color indexed datasets\&. The 'gray' value (from GDAL 1\&.7\&.0) enables to expand a dataset with a color table that only contains gray levels to a gray indexed dataset\&. .IP "\fB\fB-outsize\fP \fIxsize[%] ysize[%]\fP:\fP" 1c Set the size of the output file\&. Outsize is in pixels and lines unless '' is attached in which case it is as a fraction of the input image size\&. .IP "\fB\fB-scale\fP \fI[src_min src_max [dst_min dst_max]]\fP:\fP" 1c Rescale the input pixels values from the range \fIsrc_min\fP to \fIsrc_max\fP to the range \fIdst_min\fP to \fIdst_max\fP\&. If omitted the output range is 0 to 255\&. If omitted the input range is automatically computed from the source data\&. .IP "\fB\fB-unscale\fP:\fP" 1c Apply the scale/offset metadata for the bands to convert scaled values to unscaled values\&. It is also often necessary to reset the output datatype with the \fB-ot\fP switch\&. .IP "\fB\fB-srcwin\fP \fIxoff yoff xsize ysize\fP:\fP" 1c Selects a subwindow from the source image for copying based on pixel/line location\&. .IP "\fB\fB-projwin\fP \fIulx uly lrx lry\fP:\fP" 1c Selects a subwindow from the source image for copying (like \fB-srcwin\fP) but with the corners given in georeferenced coordinates\&. .IP "\fB\fB-a_srs\fP \fIsrs_def\fP:\fP" 1c Override the projection for the output file\&. The \fIsrs_def\fP may be any of the usual GDAL/OGR forms, complete WKT, PROJ\&.4, EPSG:n or a file containing the WKT\&. .IP "\fB\fB-a_ullr\fP \fIulx uly lrx lry\fP:\fP" 1c 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\&. .IP "\fB\fB-a_nodata\fP \fIvalue\fP:\fP" 1c Assign a specified nodata value to output bands\&. Starting with GDAL 1\&.8\&.0, can be set to \fInone\fP to avoid setting a nodata value to the output file if one exists for the source file .IP "\fB\fB-mo\fP \fI'META-TAG=VALUE'\fP:\fP" 1c Passes a metadata key and value to set on the output dataset if possible\&. .IP "\fB\fB-co\fP \fI'NAME=VALUE'\fP:\fP" 1c Passes a creation option to the output format driver\&. Multiple \fB-co\fP options may be listed\&. See format specific documentation for legal creation options for each format\&. .IP "\fB\fB-gcp\fP \fIpixel line easting northing elevation\fP:\fP" 1c Add the indicated ground control point to the output dataset\&. This option may be provided multiple times to provide a set of GCPs\&. .IP "\fB\fB-q\fP:\fP" 1c Suppress progress monitor and other non-error output\&. .IP "\fB\fB-sds\fP:\fP" 1c Copy all subdatasets of this file to individual output files\&. Use with formats like HDF or OGDI that have subdatasets\&. .IP "\fB\fB-stats\fP:\fP" 1c (GDAL >= 1\&.8\&.0) Force (re)computation of statistics\&. .IP "\fB\fIsrc_dataset\fP:\fP" 1c The source dataset name\&. It can be either file name, URL of data source or subdataset name for multi-dataset files\&. .IP "\fB\fIdst_dataset\fP:\fP" 1c The destination file name\&. .PP .SH "EXAMPLE" .PP .PP .nf gdal_translate -of GTiff -co "TILED=YES" utm.tif utm_tiled.tif .fi .PP .PP Starting with GDAL 1\&.8\&.0, to create a JPEG-compressed TIFF with internal mask from a RGBA dataset : .PP .nf gdal_translate rgba.tif withmask.tif -b 1 -b 2 -b 3 -mask 4 -co COMPRESS=JPEG -co PHOTOMETRIC=YCBCR --config GDAL_TIFF_INTERNAL_MASK YES .fi .PP .PP Starting with GDAL 1\&.8\&.0, to create a RGBA dataset from a RGB dataset with a mask : .PP .nf gdal_translate withmask.tif rgba.tif -b 1 -b 2 -b 3 -b mask .fi .PP .SH "AUTHORS" .PP Frank Warmerdam warmerdam@pobox.com, Silke Reimer silke@intevation.de