.\" 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_RASTERIZE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal_rasterize \- حک کردن هندسه‌های برداری درون یک رستر. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal_rasterize [\-\-help] [\-\-long\-usage] [\-\-help\-general] [\-b ]... [\-i] [\-at] [[\-burn ]...|[\-a ]|[\-3d]] [\-add] [[\-l ]...|[\-sql ]] [\-where ] [\-dialect ] [\-a_nodata ] [\-init ]... [\-a_srs ] [\-to =]... [\-te ] [[\-tr ]|[\-ts ]] [\-tap] [\-optim AUTO|VECTOR|RASTER] [\-co =]... [\-ot Byte|Int8|[U]Int{16|32|64}|CInt{16|32}|[C]Float{32|64}] [\-of ] [\-\-quiet] [\-oo =]... .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp این برنامه هندسه‌های برداری (نقطه‌ها، خطوط و چندضلعی‌ها) را در باند(های) یک تصویر رستری حک (رستریزه) می‌کند. داده‌های برداری از قالب‌های برداری پشتیبانی‌شده توسط OGR خوانده می‌شوند. اگر رستر خروجی از قبل وجود داشته باشد، پیکسل‌های تغییریافته به‌صورت درجا (in\-place) به‌روزرسانی می‌شوند. .sp تغییر سیستم مختصات بی‌درنگ (On the fly) داده‌های برداری به سیستم مختصات داده‌های رستری پشتیبانی می‌شود. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 معادل در رابط خط فرمان جدید \(dqgdal\(dq: .sp دستور \fI\%gdal vector rasterize\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 \-b باند(هایی) که مقادیر باید در آن‌ها حک شوند. می‌توان از چندین آرگومان \-b برای حک کردن در فهرستی از باندها استفاده کرد. پیش‌فرض حک کردن در باند ۱ است. هنگام ایجاد یک رستر جدید استفاده نمی‌شود. .UNINDENT .INDENT 0.0 .TP .B \-i معکوس کردن رستری‌سازی. مقدار ثابت یا مقدار مرتبط با اولین عارضه در تمام بخش‌هایی از تصویر که درون چندضلعی مشخص‌شده \fIنیستند\fP، حک می‌شود. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 هنگامی که عوارض برداری حاوی یک چندضلعی درون چندضلعی دیگر باشند (مانند یک جزیره در یک دریاچه)، GDAL باید همراه با GEOS ساخته شده باشد تا نتایج درستی حاصل شود. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-at گزینه رستری‌سازی ALL_TOUCHED را فعال می‌کند تا تمام پیکسل‌هایی که توسط خطوط یا چندضلعی‌ها لمس می‌شوند به‌روزرسانی شوند، نه فقط پیکسل‌هایی که در مسیر رندر خط قرار دارند یا نقطه مرکزی آن‌ها درون چندضلعی است (رفتار برنامه هنگامی که چندضلعی فقط مرکز پیکسل را لمس می‌کند نامشخص است). به‌طور پیش‌فرض برای قوانین رندرینگ عادی غیرفعال است. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 هنگامی که این گزینه فعال است، ترتیب عوارض ورودی (خطوط یا چندضلعی‌ها) می‌تواند بر نتایج تأثیر بگذارد. زمانی که دو عارضه یکدیگر را لمس می‌کنند، آخرین عارضه (یعنی بالاترین) مقدار پیکسل حک‌شده در لبه را تعیین می‌کند. ممکن است بخواهید از گزینه \fI\%\-sql\fP برای مرتب‌سازی مجدد عوارض (ORDER BY) به منظور دستیابی به نتیجه‌ای قابل‌پیش‌بینی‌تر استفاده کنید. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-burn یک مقدار ثابت برای حک شدن در یک باند برای تمامی اشیاء. می‌توان فهرستی از گزینه‌های \fI\%\-burn\fP را ارائه داد؛ یک گزینه به ازای هر باندی که در آن نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-a یک فیلد ویژگی (attribute) را روی عوارض مشخص می‌کند تا به عنوان مقدار حک‌کردن استفاده شود. این مقدار در تمامی باندهای خروجی حک خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-3d نشان می‌دهد که مقدار حک‌کردن باید از مقادیر \(dqZ\(dq عارضه استخراج شود. برای نقطه‌ها و خطوط کار می‌کند (درون‌یابی خطی در طول هر پاره‌خط). برای چندضلعی‌ها، تنها در صورتی به‌درستی کار می‌کند که مسطح باشند (مقدار Z یکسان برای همه رأس‌ها). .UNINDENT .INDENT 0.0 .TP .B \-add به‌جای حک کردن یک مقدار جدید، مقدار جدید را به رستر موجود اضافه می‌کند. برای مثال برای نقشه‌های حرارتی (heatmaps) مناسب است. .UNINDENT .INDENT 0.0 .TP .B \-l لایه(هایی) از منبع داده را مشخص می‌کند که برای عوارض ورودی استفاده خواهند شد. می‌تواند چندین بار مشخص شود، اما حداقل یک نام لایه یا یک گزینه \fI\%\-sql\fP باید مشخص شود (نه هر دو). .UNINDENT .INDENT 0.0 .TP .B \-where یک عبارت پرس‌وجوی اختیاری به سبک WHERE در SQL برای اعمال جهت انتخاب عوارضی که باید از لایه(های) ورودی حک شوند. .UNINDENT .INDENT 0.0 .TP .B \-sql یک دستور SQL که روی منبع داده ارزیابی می‌شود تا یک لایه مجازی از عوارض برای حک شدن تولید کند. از نسخه 3.7 GDAL به بعد، نحو \fB@filename\fP می‌تواند برای مشخص کردن اینکه محتوا در نام فایل اشاره‌شده قرار دارد، استفاده شود. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 اگر گزینه \fI\%\-l\fP نیز تنظیم شده باشد، این گزینه نادیده گرفته خواهد شد. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0.TP .B \-dialect لهجهٔ SQL. در برخی موارد می‌توان با مقداردهی OGRSQL، از OGR SQL (بهینه‌سازی‌نشده) به‌جای SQL بومی یک RDBMS استفاده کرد. لهجهٔ \(dqSQLITE\(dq نیز می‌تواند با هر منبع داده‌ای استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-of انتخاب قالب خروجی. در صورت مشخص نشدن، قالب از روی پسوند حدس زده می‌شود. از نام کوتاه قالب استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-a_nodata اختصاص یک مقدار nodata مشخص‌شده به باندهای خروجی. .UNINDENT .INDENT 0.0 .TP .B \-init مقداردهی اولیهٔ باندهای تصویر خروجی با این مقادیر. با این حال، در فایل خروجی به عنوان مقدار nodata علامت‌گذاری نمی‌شود. اگر تنها یک مقدار داده شود، همان مقدار در تمام باندها استفاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-a_srs جایگزینی سیستم تصویر برای فایل خروجی. در صورت مشخص نشدن، از سیستم تصویر فایل برداری ورودی در صورت وجود استفاده خواهد شد. هنگام استفاده از این گزینه، هیچ بازتصویرسازی برای عوارض از SRS بردار ورودی به SRS مشخص‌شده برای رستر خروجی صورت نمی‌گیرد؛ بنابراین تنها برای تصحیح یک SRS مبدأ نامعتبر از این گزینه استفاده کنید. مقدار می‌تواند هر یک از قالب‌های معمول GDAL/OGR، یعنی WKT کامل، PROJ.4، EPSG:n یا فایلی حاوی WKT باشد. .UNINDENT .INDENT 0.0 .TP .B \-to = تنظیم یک گزینهٔ تبدیل‌کننده مناسب برای ارسال به \fI\%GDALCreateGenImgProjTransformer2()\fP\&. این گزینه هنگام تبدیل مختصات هندسه‌ها به فضای پیکسلی رستر مقصد استفاده می‌شود. برای مثال، این مورد می‌تواند برای تعیین گزینه‌های تبدیل‌کنندهٔ مرتبط با RPC استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-co = بسیاری از قالب‌ها یک یا چند گزینهٔ ایجاد اختیاری دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای نمونه، درایور GeoTIFF از گزینه‌های ایجادی برای کنترل فشرده‌سازی و کاشی‌بندی شدن فایل پشتیبانی می‌کند. .sp گزینه‌های ایجادِ در دسترس، بسته به درایور قالب متغیر است و برخی از قالب‌های ساده اصلاً هیچ گزینهٔ ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینهٔ خط فرمان \fI\%\-\-format\fP مشاهده کرد، اما مستندات قالب، منبع نهایی اطلاعات دربارهٔ گزینه‌های ایجاد درایور است. برای مشاهدهٔ گزینه‌های ایجاد مجاز برای هر قالب، به مستندات اختصاصی قالب \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-te تنظیم محدوده‌های زمین‌مرجع‌شده. مقادیر باید بر حسب واحدهای زمین‌مرجع بیان شوند. در صورت مشخص نشدن، محدودهٔ فایل خروجی همان محدودهٔ لایه‌های برداری خواهد بود. .UNINDENT .INDENT 0.0 .TP .B \-tr تنظیم تفکیک‌پذیری مقصد. مقادیر باید بر حسب واحدهای زمین‌مرجع بیان شوند. هر دو باید مقادیری مثبت باشند. .UNINDENT .INDENT 0.0 .TP .B \-tap (target aligned pixels) هم‌تراز کردن مختصات محدودهٔ فایل خروجی با مقادیر \fI\%\-tr\fP، به‌گونه‌ای که محدودهٔ هم‌تراز‌شده شامل حداقل محدوده باشد. هم‌ترازی بدین معناست که xmin / resx، ymin / resy، xmax / resx و ymax / resy مقادیری صحیح باشند. .UNINDENT .INDENT 0.0 .TP .B \-ts تنظیم اندازهٔ فایل خروجی بر حسب پیکسل و سطر. توجه داشته باشید که \fI\%\-ts\fP را نمی‌توان همراه با \fI\%\-tr\fP استفاده کرد. اگر یکی از دو مقدار روی 0 تنظیم شود، به منظور حفظ نسبت ابعاد، از روی مقدار دیگر محاسبه خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-ot اجبار باندهای خروجی به داشتن نوع دادهٔ مشخص‌شده. مقدار پیش‌فرض \fBFloat64\fP است، مگر اینکه فیلد مشخصه برای درج از نوع \fBInt64\fP باشد؛ در این حالت اگر درایور خروجی از آن پشتیبانی کند، \fBInt64\fP برای نوع دادهٔ رستر خروجی استفاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-optim {AUTO|VECTOR|RASTER} اجبار الگوریتم مورد استفاده (نتایج یکسان هستند). حالت رستر در بیشتر موارد استفاده می‌شود و عملیات خواندن/نوشتن را بهینه‌سازی می‌کند. حالت برداری با حجم بالایی از عوارض ورودی مفید است و مصرف پردازنده را بهینه‌سازی می‌کند، به شرطی که تصویر خروجی کاشی‌بندی شده باشد. حالت خودکار (پیش‌فرض) الگوریتم را بر اساس مشخصات ورودی و خروجی انتخاب می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-oo = در نگارش 3.7 اضافه شده است. .sp گزینهٔ باز کردن مجموعه داده مبدأ (مختص به هر قالب) .UNINDENT .INDENT 0.0 .TP .B هر منبع دادهٔ خواندنی که توسط OGR پشتیبانی می‌شود. .UNINDENT .INDENT 0.0 .TP .B فایل خروجی پشتیبانی‌شده توسط GDAL. باید از دسترسی در حالت به‌روزرسانی پشتیبانی کند. اگر این فایل از قبل وجود نداشته باشد، ایجاد خواهد شد. اگر رستر خروجی از قبل موجود باشد، پیکسل‌های متأثر در جای خود به‌روزرسانی می‌شوند. .UNINDENT .sp این برنامه در صورت استفاده از هر یک از گزینه‌های \fI\%\-of\fP، \fI\%\-a_nodata\fP، \fI\%\-init\fP، \fI\%\-a_srs\fP، \fI\%\-co\fP، \fI\%\-te\fP، \fI\%\-tr\fP، \fI\%\-tap\fP، \fI\%\-ts\fP یا \fI\%\-ot\fP، یک تصویر رستری مقصد جدید ایجاد می‌کند. تفکیک‌پذیری یا اندازه برای تمام رسترهای جدید باید با استفاده از گزینهٔ \fI\%\-tr\fP یا \fI\%\-ts\fP مشخص شود. اگر رستر مقصد از قبل موجود باشد و هر یک از این گزینه‌های مربوط به ایجاد استفاده شوند، رستر مقصد بازنویسی خواهد شد..SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp برنامه در صورت موفقیت کد وضعیت 0، و در صورت بروز خطا مقداری غیرصفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، به منزلهٔ اجرای موفق در نظر گرفته می‌شوند). .SH "رابط برنامه‌نویسی سی (C API)" .sp این ابزار همچنین از طریق \fI\%GDALRasterize()\fP\& در C قابل فراخوانی است. .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱" .sp دستور زیر تمام چندضلعی‌ها را از \fBmask.shp\fP با رنگ قرمز (RGB = 255,0,0) بر روی فایل TIFF از نوع RGB به نام \fBwork.tif\fP حک می‌کند. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_rasterize \-b 1 \-b 2 \-b 3 \-burn 255 \-burn 0 \-burn 0 \-l mask mask.shp work.tif .EE .UNINDENT .UNINDENT .SS "مثال ۲" .sp دستور زیر تمام ساختمان‌های \(dqclass A\(dq را درون فایل ارتفاعی خروجی حک می‌کند و بالاترین ارتفاع را از مشخصهٔ ROOF_H دریافت می‌نماید. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_rasterize \-a ROOF_H \-where \(dqclass=\(aqA\(aq\(dq \-l footprints footprints.shp city_dem.tif .EE .UNINDENT .UNINDENT .SS "مثال ۳" .sp دستور زیر تمام چندضلعی‌ها را از \fBfootprint.shp\fP با رنگ قرمز درون یک فایل TIFF جدید 1000x1000 با فرمت RGB حک می‌کند. توجه داشته باشید که از \fI\%\-b\fP استفاده نشده است؛ ترتیب گزینه‌های \fI\%\-burn\fP باندهای رستر خروجی را تعیین می‌کند. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_rasterize \-burn 255 \-burn 0 \-burn 0 \-ot Byte \-ts 1000 1000 \-l footprints footprints.shp mask.tif .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Frank Warmerdam .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .