.\" 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-SET-TYPE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-raster-set-type \- تغییر نوع داده باندهای یک مجموعه داده رستر
.sp
افزوده شده در نسخه 3.11.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal raster set\-type [OPTIONS] <INPUT> <OUTPUT>

Modify the data type of bands of a raster dataset.

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
  \-\-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 [required]

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 set\-type\fP
می‌تواند برای اجبار باندهای تصویر خروجی به داشتن یک نوع داده مشخص استفاده شود. اگر نوع داده خروجی \(dqکوچک‌تر\(dq از نوع داده ورودی باشد، مقادیر ممکن است کوتاه (truncate) یا گرد شوند.
.sp
این زیردستور همچنین به عنوان یک مرحله بالقوه از
\fI\%gdal raster pipeline\fP
در دسترس است.
.SH "خروجی GDALG (مجموعه داده در لحظه / جریانی)"
.sp
این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از فرمت خروجی
\fBGDALG\fP
پشتیبانی می‌کند.
فایل حاصل را می‌توان سپس به عنوان یک مجموعه داده رستر با استفاده از درایور
\fI\%GDALG: GDAL Streamed Algorithm\fP
باز کرد و خط لوله مشخص‌شده را به صورت در لحظه (on-the-fly) / جریانی اعمال نمود.
.SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-\-ot, \-\-datatype, \-\-output\-data\-type <OUTPUT\-DATA\-TYPE>
نوع داده خروجی از میان
\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
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
بسیاری از فرمت‌ها دارای یک یا چند گزینه ساخت اختیاری هستند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. به عنوان مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و کاشی‌بندی (tiled) بودن فایل پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ساخت در دسترس بسته به درایور فرمت متفاوت هستند و برخی از فرمت‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات مربوط به همان فرمت مرجع اصلی اطلاعات درباره گزینه‌های ساخت درایور است.
برای مشاهده گزینه‌های ساخت مجاز برای هر فرمت، مستندات اختصاصی
\fI\%Raster drivers\fP
را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
کدام فرمت رستر خروجی استفاده شود. مقادیر مجاز را می‌توان از طریق دستور زیر به دست آورد:
.sp
.nf
gdal \-\-formats | grep raster | grep rw | sort
.fi
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
به برنامه اجازه می‌دهد فایل یا مجموعه داده مقصد موجود را بازنویسی کند.
در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه داده مقصد از قبل وجود داشته باشد،
\fBgdal\fP
خطا می‌دهد.
.UNINDENT
.SH "کد وضعیت خروجی (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر برمی‌گرداند (خطاهای غیر مسدودکننده که به عنوان هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: تبدیل به نوع داده Float32"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster set\-type \-\-datatype Float32 byte.tif float32.tif \-\-overwrite
.EE
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.