.\" 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-CONVERT" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-raster-convert \- تبدیل یک مجموعه‌داده رستر
.sp
در نگارش 3.11 اضافه شد.

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

Convert 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

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 convert\fP می‌توان برای تبدیل داده‌های رَستِر (شطرنجی) بین فرمت‌های مختلف استفاده کرد.
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-append
الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده جدید به یک فایل خروجی موجود.
تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده‌ها پشتیبانی می‌کنند، مانند
\fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP.
این گزینه همچنین در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
.UNINDENT
.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 \-\-if, \-\-input\-format <format>
نام فرمت/درایور که باید برای باز کردن فایل(های) ورودی امتحان شود. عموماً تعیین آن ضروری نیست، اما می‌تواند برای صرف‌نظر از تشخیص خودکار درایور، در هنگامی که در انتخاب درایور مناسب ناموفق است، استفاده شود.
این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود.
توجه داشته باشید که این گزینه آن درایورها را به باز کردن مجموعه‌داده مجبور نمی‌کند. به‌ویژه، برخی از درایورها الزاماتی برای پسوند فایل دارند.
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
گزینه باز کردن مجموعه‌داده (مخصوص هر فرمت).
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
تعیین اینکه کدام فرمت رستر خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر مشاهده کرد:
\fBgdal \-\-formats | grep raster | grep rw | sort\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
اجازه دادن به برنامه برای بازنویسی روی فایل یا مجموعه‌داده هدف موجود.
در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده هدف از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-\-quiet
غیرفعال کردن نوار پیشرفت و برخی پیام‌های هشدار.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: تبدیل فایل utm.tif به یک GeoTIFF بهینه‌شده برای ابر با استفاده از فشرده‌سازی JPEG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster convert \-\-format=COG \-\-co COMPRESS=JPEG utm.tif utm_cog.tif
.EE
.UNINDENT
.UNINDENT
.SS مثال ۲: تبدیل فایل utm.tif به رستر GeoPackage
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster convert utm.tif utm.gpkg
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.