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

.SH "توضیحات (DESCRIPTION)"
.sp
عملیات \fBwrite\fP فقط برای استفاده در یک \fI\%gdal pipeline\fP است و یک
مجموعه‌داده رستر را می‌نویسد. این آخرین مرحله از یک پایپ‌لاین است.
.sp
برای نوشتن یک مجموعه‌داده موقت در میانهٔ یک پایپ‌لاین، از \fI\%gdal raster materialize\fP\& استفاده کنید.
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
* write [OPTIONS] <OUTPUT>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

نوشتن یک مجموعه‌داده رستر.

آرگومان‌های موقعیتی:
  \-o, \-\-output <OUTPUT>                                مجموعه‌داده رستر خروجی [الزامی]

گزینه‌ها:
  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  قالب خروجی (\(dqGDALG\(dq مجاز است)
  \-\-co, \-\-creation\-option <KEY>=<VALUE>                گزینه ساخت [امکان تکرار دارد]
  \-\-overwrite                                          تعیین این‌که آیا بازنویسی مجموعه‌داده خروجی موجود مجاز است یا خیر
                                                       مانعة‌الجمع با \-\-append
  \-\-append                                             الحاق به عنوان زیرمجموعه‌داده به خروجی موجود
                                                       مانعة‌الجمع با \-\-overwrite
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.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 \-\-co, \-\-creation\-option <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ساختی برای کنترل فشرده‌سازی و این‌که آیا فایل باید کاشی‌کاری‌شده (tiled) باشد یا خیر، پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات قالب، مرجع قطعی اطلاعات درباره گزینه‌های ساخت درایور است.
برای گزینه‌های ساخت مجاز هر قالب، مستندات اختصاصی قالب \fI\%Raster drivers\fP را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
به برنامه اجازه می‌دهد فایل یا مجموعه‌داده مقصد موجود را بازنویسی کند.
در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-append
رستر ورودی را به عنوان یک زیرمجموعه‌داده جدید به فایل خروجی موجود الحاق می‌کند.
فقط با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده پشتیبانی می‌کنند، مانند
\fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP\&.
این گزینه همچنین مجموعه‌داده خروجی را در صورتی که هنوز وجود نداشته باشد، ایجاد می‌کند.
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: نوشتن یک فایل GeoTIFF
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster pipeline ... [other commands here] ... ! write out.tif \-\-overwrite
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.