.\" 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_CREATE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal_create \- ایجاد یک فایل رستر (بدون مجموعه داده منبع)
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal_create [\-\-help] [\-\-long\-usage] [\-\-help\-general]
                   [\-ot Byte|Int8|[U]Int{16|32|64}|CInt{16|32}|[C]Float{32|64}]
                   [\-of <output_format>] [\-outsize <xsize> <ysize>]
                   [\-bands <count>] [\-burn <value>]... [\-a_srs <srs_def>]
                   [\-a_ullr <ulx> <uly> <lrx> <lry>] [\-a_nodata <value>]
                   [\-mo <NAME>=<VALUE>]... [\-co <NAME>=<VALUE>]... [\-\-quiet]
                   [\-if <input_dataset>]
                   <out_dataset>
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBgdal_create\fP می‌تواند برای مقداردهی اولیه یک فایل رستر جدید
بر اساس ابعاد، تعداد باندها و تنظیم پارامترهای گوناگون، مانند CRS،
geotransform، مقدار nodata و متادیتا استفاده شود. همچنین می‌تواند در موارد خاص
مانند ساخت یک فایل PDF از یک فایل ترکیب‌بندی XML به کار رود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
ببینید \fI\%gdal raster create\fP\&.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
نمایش یک پیام کاربرد مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-\-quiet
عدم نمایش پیام‌های پیشرفت و سایر خروجی‌های غیرخطا.
.UNINDENT
.INDENT 0.0
.TP
.B \-ot <type>
اجبار باندهای تصویر خروجی به داشتن یک نوع داده مشخص که توسط
درایور پشتیبانی می‌شود؛ که می‌تواند یکی از موارد زیر باشد: \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 یا \fBCFloat64\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-of <format>
انتخاب قالب خروجی. در صورت عدم تعیین، قالب از روی پسوند
حدس زده می‌شود. از نام کوتاه قالب استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-outsize <xsize> <ysize>
تنظیم اندازه فایل خروجی بر حسب پیکسل. مقدار اول عرض و مقدار دوم
ارتفاع است.
.UNINDENT
.INDENT 0.0
.TP
.B \-bands <count>
تعداد باندها. در صورت مشخص شدن \-outsize پیش‌فرض برابر با 1 و در غیر این صورت 0 است.
.UNINDENT
.INDENT 0.0
.TP
.B \-burn <value>
یک مقدار ثابت برای درج (burn) در یک باند. می‌توان فهرستی از گزینه‌های \fI\%\-burn\fP
را ارائه کرد، یکی به ازای هر باند (مقدار اول روی باند اول اعمال می‌شود،
مقدار دوم روی باند دوم، و غیره). اگر تنها یک مقدار مشخص شود،
بر روی تمام باندها اعمال خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-a_srs <srs_def>
بازنویسی سیستم تصویر برای فایل خروجی. مقدار <srs_def> می‌تواند هر یک از
حالت‌های معمول GDAL/OGR، ساختار کامل WKT، PROJ.4، EPSG:n یا فایلی حاوی
WKT باشد. هیچ بازتصویرسازی‌ای (reprojection) انجام نمی‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-a_ullr <ulx> <uly> <lrx> <lry>
تخصیص مرزهای مکانیِ مختصات‌دار (georeferenced bounds) فایل خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-a_nodata <value>
اختصاص یک مقدار مشخص nodata به باندهای خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-mo <META\-TAG>=<VALUE>
ارسال یک کلید و مقدار متادیتا برای اعمال روی مجموعه داده خروجی در صورت امکان.
.UNINDENT
.INDENT 0.0
.TP
.B \-co <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینه ساخت (creation option) اختیاری دارند که می‌توانند
برای کنترل ویژگی‌های اختصاصی فایل ایجادشده استفاده شوند. برای مثال،
درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و تعیین این‌که
آیا فایل باید به صورت تایل‌بندی‌شده (tiled) باشد، پشتیبانی می‌کند.
.sp
گزینه‌های ساخت موجود بسته به درایور قالب متغیر هستند، و برخی
قالب‌های ساده اصولاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های
پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان
\fI\%\-\-format\fP
مشاهده کرد، اما مستندات مربوط به قالب، منبع قطعی اطلاعات درباره گزینه‌های ساخت درایور است.
برای مشاهده گزینه‌های ساخت مجاز هر قالب، مستندات اختصاصی قالب را در بخش \fI\%Raster drivers\fP
ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-if <input_dataset>
در نسخه 3.3 اضافه شد.

.sp
نام مجموعه داده ورودی GDAL که به عنوان الگو برای مقادیر پیش‌فرض
گزینه‌های \-outsize، \-bands، \-ot، \-a_srs، \-a_ullr و \-a_nodata عمل می‌کند.
توجه داشته باشید که مقادیر پیکسل‌ها کپی \fIنخواهند\fP شد.
.UNINDENT
.INDENT 0.0
.TP
.B <out_dataset>
نام فایل مقصد.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0، و در صورت بروز خطا
مقداری غیر از صفر بازمی‌گرداند (خطاهای غیرمسدودکننده‌ای که به صورت هشدار صادر می‌شوند،
اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: مقداردهی اولیه یک فایل GeoTIFF جدید با مقدار یکنواخت 10
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_create \-outsize 20 20 \-a_srs EPSG:4326 \-a_ullr 2 50 3 49 \-burn 10 out.tif
.EE
.UNINDENT
.UNINDENT
.SS مثال ۲: ایجاد یک فایل PDF از یک فایل ترکیب‌بندی XML
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_create \-co COMPOSITION_FILE=composition.xml out.pdf
.EE
.UNINDENT
.UNINDENT
.SS مثال ۳: مقداردهی اولیه یک فایل GeoTIFF خالی از روی یک فایل ورودی
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_create \-if prototype.tif output.tif
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.