.\" 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-VECTOR-RASTERIZE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-rasterize \- حک کردن هندسه‌های برداری درون یک رستر .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal vector rasterize [OPTIONS] هندسه‌های برداری را درون یک رستر حک می‌کند. آرگومان‌های موضعی: \-i, \-\-input مجموعه‌داده‌های برداری ورودی [الزامی] \-o, \-\-output مجموعه‌داده رستری خروجی [الزامی] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها در دسترس نیست] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی \-\-co, \-\-creation\-option = گزینه ایجاد [تکرارپذیر] \-\-overwrite تعیین مجاز بودن بازنویسی مجموعه‌داده خروجی موجود \-b, \-\-band باند(هایی) که مقادیر درون آن‌ها حک می‌شوند (اندیس مبتنی بر 1) [تکرارپذیر] \-\-invert معکوس کردن رستر‌سازی \-\-all\-touched فعال کردن گزینه رستر‌سازی ALL_TOUCHED \-\-burn مقدار حک [تکرارپذیر] \-a, \-\-attribute\-name نام صفت \-\-3d مشخص می‌کند که مقدار حک باید از مقادیر Z عارضه استخراج شود \-l, \-\-input\-layer نام لایه ورودی مانعة‌الجمع با \-\-sql \-\-where بند where در SQL \-\-sql دستور select در SQL مانعة‌الجمع با \-\-input\-layer \-\-dialect گویش SQL \-\-nodata تخصیص یک مقدار مشخص nodata به باندهای خروجی \-\-init مقداردهی اولیه باندهای خروجی با مقدار مشخص‌شده [تکرارپذیر] \-\-crs بازنویسی سیستم تصویر برای فایل خروجی \-\-transformer\-option = تنظیم گزینه تبدیل مناسب برای ارسال به GDALCreateGenImgProjTransformer2 [تکرارپذیر] \-\-extent ,,, تنظیم محدوده زمین‌مرجع هدف [۴ مقدار] \-\-resolution , تنظیم تفکیک‌پذیری هدف [۲ مقدار] مانعة‌الجمع با \-\-size \-\-tap, \-\-target\-aligned\-pixels (پیکسل‌های هم‌تراز هدف) تراز کردن مختصات محدوده فایل خروجی با مقادیر تفکیک‌پذیری وابسته به \-\-resolution \-\-size , تنظیم اندازه هدف بر حسب پیکسل و خط [۲ مقدار] مانعة‌الجمع با \-\-resolution \-\-ot, \-\-datatype, \-\-output\-data\-type نوع داده خروجی. OUTPUT\-DATA\-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 \-\-optimization اجبار به استفاده از الگوریتم مشخص‌شده (نتایج یکسان هستند). OPTIMIZATION=AUTO|RASTER|VECTOR (پیش‌فرض: AUTO) \-\-add افزودن به رستر موجود \-\-update تعیین باز شدن مجموعه‌داده موجود در حالت به‌روزرسانی گزینه‌های پیشرفته: \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] .EE .UNINDENT .UNINDENT.SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal vector rasterize\fP هندسه‌های برداری را درون یک رستر درج می‌کند (burn می‌کند). .sp به‌طور پیش‌فرض (مگر اینکه \fI\%\-\-update\fP یا \fI\%\-\-add\fP مشخص شده باشد)، یک رستر جدید با تفکیک‌پذیری (\fI\%\-\-resolution\fP) یا اندازه مشخص (\fI\%\-\-size\fP) ایجاد می‌شود. مقادیر پیکسل‌ها یا بر روی یک مقدار ثابت (مقدار ۱، یا مقداری دیگر که با \fI\%\-\-burn\fP مشخص شده است)، مقدار Z هندسه‌های عارضه (با \fI\%\-\-3d\fP)، و یا مقدار فیلد مشخص‌شده با \fI\%\-\-attribute\-name\fP تنظیم خواهند شد\&. .sp تصویر سمت چپ رفتار پیش‌فرض رستری‌سازی را نشان می‌دهد، که در آن تنها پیکسل‌های روی مسیر ترسیم خط گنجانده می‌شوند. .sp تصویر سمت راست تأثیر \fI\%\-\-all\-touched\fP را نمایش می‌دهد، جایی که هر پیکسلی که با چندضلعی‌های ورودی تماس داشته باشد، گنجانده می‌شود. .sp از نسخه GDAL 3.12، این الگوریتم می‌تواند بخشی از یک \fI\%gdal pipeline\fP باشد\&. .sp گزینه‌های زیر در دسترس هستند: .sp افزوده‌شده در نسخه 3.12. .SH "خروجی GDALG (مجموعه‌داده در لحظه / جاری) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس فایل حاصل می‌تواند با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه‌داده رستر باز شود و خط لوله مشخص‌شده را به‌صورت در‌لحظه / جریانی اعمال نماید. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 با این حال، این الگوریتم به‌طور بومی با جریان‌سازی سازگار نیست. در نتیجه یک مجموعه‌داده موقت تولید خواهد شد که ممکن است زمان پردازش قابل‌توجهی را هنگام باز شدن ایجاد کند. .UNINDENT .UNINDENT .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-3d نشان می‌دهد که مقدار درج (burn) باید از مقادیر \(dqZ\(dq عارضه استخراج شود. برای نقاط و خطوط کار می‌کند (درون‌یابی خطی در طول هر پاره‌خط). برای چندضلعی‌ها، تنها در صورتی به‌درستی کار می‌کند که مسطح باشند (مقدار Z یکسان برای تمام رأس‌ها). .UNINDENT .INDENT 0.0 .TP .B \-\-add به جای درج یک مقدار جدید، این گزینه مقدار جدید را به رستر موجود اضافه می‌کند؛ شامل \fB\-\-update\fP نیز می‌شود\&. به عنوان مثال، برای نقشه‌های حرارتی مناسب است. .UNINDENT .INDENT 0.0 .TP .B \-\-all\-touched گزینه رستری‌سازی ALL_TOUCHED را فعال می‌کند. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 هنگامی که این گزینه فعال است، ترتیب عوارض ورودی (خطوط یا چندضلعی‌ها) می‌تواند بر نتایج تأثیر بگذارد. وقتی دو عارضه با یکدیگر تماس پیدا می‌کنند، آخرین عارضه (یعنی بالاترین عارضه) مقدار پیکسل درج‌شده در لبه را تعیین می‌کند. ممکن است بخواهید از گزینه \fI\-\-sql\fP برای مرتب‌سازی مجدد عوارض (ORDER BY) جهت دستیابی به نتیجه‌ای قابل‌پیش‌بینی‌تر استفاده کنید. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-a, \-\-attribute\-name نام مشخصه / فیلدی که مقدار درج باید از آن برای هر عارضه بازیابی شود. GDAL تلاش می‌کند مقدار فیلد را به عنوان یک عدد تجزیه کند. اگر این کار ناموفق باشد، مقدار صفر نوشته خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-band, \-b باند(هایی) که مقادیر باید در آن‌ها درج شوند. می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-burn مقدار درج. می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-crs سیستم تصویر را برای فایل خروجی بازنویسی (override) می‌کند. در صورت عدم تعیین، سیستم تصویر فایل برداری ورودی (در صورت موجود بودن) استفاده خواهد شد. هنگام استفاده از این گزینه، هیچ بازتصویرسازی (reprojection) از عوارض از CRS وکتور ورودی به CRS مشخص‌شده رستر خروجی انجام نمی‌شود؛ بنابراین تنها برای تصحیح یک CRS مبدأ نامعتبر از این گزینه استفاده کنید. \fB\fP می‌تواند هر یک از ساختارهای معمول GDAL/OGR، از جمله WKT کامل، PROJ.4، EPSG:n یا فایلی حاوی WKT باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-extent ,,, محدوده‌های مختصات‌دار (زمین‌مرجع) را تنظیم می‌کند. مقادیر باید بر حسب واحدهای زمین‌مرجع بیان شوند. در صورت عدم تعیین، محدوده فایل خروجی همان محدوده لایه‌های برداری خواهد بود. .UNINDENT .INDENT 0.0 .TP .B \-\-init باندهای خروجی را از پیش با مقدار مشخص‌شده مقداردهی اولیه می‌کند. می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-l, \-\-input\-layer لایه(هایی) از منبع داده را مشخص می‌کند که برای عوارض ورودی استفاده خواهند شد. می‌تواند چندین بار مشخص شود، اما حداقل یک نام لایه یا گزینه \-sql باید مشخص گردد (نه هر دو). .UNINDENT .INDENT 0.0 .TP .B \-\-invert معکوس کردن رستری‌سازی. مقدار درج ثابت، یا مقدار درج مرتبط با اولین عارضه را در تمام بخش‌هایی از تصویر که درون چندضلعی داده‌شده قرار ندارند، درج می‌کند. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 هنگامی که عوارض برداری حاوی یک چندضلعی تودرتو درون چندضلعی دیگر باشند (مانند یک جزیره در یک دریاچه)، GDAL باید همراه با GEOS ساخته شده باشد تا نتایج درستی حاصل شود. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-nodata یک مقدار nodata مشخص را به باندهای خروجی اختصاص می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-optimization الگوریتم مورداستفاده را تحمیل می‌کند (نتایج یکسان هستند). حالت raster در بیشتر موارد استفاده می‌شود و عملیات خواندن/نوشتن را بهینه‌سازی می‌کند. حالت vector در مواقعی که تعداد مناسبی از عوارض ورودی وجود دارد مفید است و استفاده از CPU را بهینه می‌کند. این حالت برای کارآمد بودن باید با تصاویر کاشی‌بندی‌شده (tiled) استفاده شود. حالت auto (پیش‌فرض) الگوریتم را بر اساس ویژگی‌های ورودی و خروجی انتخاب می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-ot, \-\-datatype, \-\-output\-data\-type باندهای خروجی را وادار می‌کند تا از نوع داده مشخص‌شده باشند. پیش‌فرض \fBFloat64\fP است، مگر اینکه فیلد مشخصه جهت درج از نوع \fBInt64\fP باشد که در این صورت، چنانچه درایور خروجی از آن پشتیبانی کند، \fBInt64\fP برای نوع داده رستر خروجی استفاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-resolution , تفکیک‌پذیری (رزولوشن) هدف را تنظیم می‌کند. مقادیر باید بر حسب واحدهای زمین‌مرجع بیان شوند. هر دو مقدار باید مثبت باشند. توجه داشته باشید که \fI\-\-resolution\fP نمی‌تواند همراه با \fI\-\-size\fP استفاده شود\&. .UNINDENT .INDENT 0.0 .TP .B \-\-size , اندازه فایل خروجی را بر حسب پیکسل و خط (سطر) تنظیم می‌کند. توجه داشته باشید که \fI\-\-size\fP نمی‌تواند همراه با \fI\-\-resolution\fP استفاده شود\&. اگر یکی از دو مقدار بر روی 0 تنظیم شود، از مقدار دیگر محاسبه خواهد شد تا نسبت ابعاد (aspect ratio) محدوده حفظ شود. .UNINDENT .INDENT 0.0 .TP .B \-\-sql |@ یک عبارت SQL برای ارزیابی روی منبع داده جهت تولید لایه‌ای مجازی از عوارض برای درج شدن. از ساختار @filename می‌توان برای اشاره به این که محتوا در فایل مشخص‌شده قرار دارد استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-dialect گویش SQL. .sp به‌طور پیش‌فرض، هنگام استفاده از \fBgdal vector sql\fP از SQL بومی یک RDBMS استفاده می‌شود\&. در صورت استفاده از \fBsql\fP به عنوان مرحله‌ای از \fBgdal vector pipeline\fP، این امر تنها در صورتی صادق است که مرحله قبل از \fBsql\fP، مرحله \fBread\fP باشد؛ در غیر این صورت از گویش \fI\%OGRSQL\fP استفاده می‌شود. .sp اگر یک منبع داده به‌طور بومی از SQL پشتیبانی نکند، پیش‌فرض استفاده از گویش \fBOGRSQL\fP است که می‌تواند با هر منبع داده دیگری نیز مشخص شود. .sp گویش \fI\%SQL SQLite dialect\fP را می‌توان با مقادیر گویش \fBSQLITE\fP و \fBINDIRECT_SQLITE\fP انتخاب کرد و این مورد را می‌توان با هر منبع داده‌ای استفاده نمود. تغییر گویش پیش‌فرض ممکن است سودمند باشد زیرا قابلیت‌های گویش‌های مختلف SQL متفاوت است. .sp گویش‌های پشتیبانی‌شده را می‌توان با \fBgdal \-\-format\fP بررسی کرد\&. برای مثال: .INDENT 7.0 .INDENT 3.5 .sp .EX $ gdal \-\-format \(dqPostgreSQL\(dq [...] Supported SQL dialects: NATIVE OGRSQL SQLITE [...] $ gdal \-\-format \(dqESRI Shapefile\(dq [...] Supported SQL dialects: OGRSQL SQLITE [...] .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-tap, \-\-target\-aligned\-pixels (پیکسل‌های هم‌تراز با هدف) مختصات محدوده فایل خروجی را با مقادیر \fI\-\-resolution\fP هم‌تراز می‌کند، به‌گونه‌ای که محدوده هم‌تراز‌شده شامل حداقل محدوده باشد. هم‌ترازی به این معناست که xmin / resx، ymin / resy، xmax / resx و ymax / resy مقادیر صحیح باشند. گزینه \fI\%\-\-tap\fP به \fI\%\-\-resolution\fP نیاز دارد\&. .UNINDENT .INDENT 0.0.TP .B \-\-transformer\-option = یک گزینه تبدیل‌کننده (transformer) مناسب برای ارسال به GDALCreateGenImgProjTransformer2() تنظیم می‌کند. این گزینه هنگام تبدیل مختصات هندسه‌ها به فضای پیکسلی رستر هدف استفاده می‌شود. برای مثال، می‌توان از این گزینه برای تعیین گزینه‌های تبدیل‌کننده مربوط به RPC استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-where یک عبارت پرس‌وجوی اختیاری به سبک SQL WHERE برای اعمال جهت انتخاب عوارضی (features) از لایه(های) ورودی که باید رایت شوند (burn in). .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه ساخت (creation option) اختیاری دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای نمونه، درایور GeoTIFF از گزینه‌های ساختی برای کنترل فشرده‌سازی و کاشی‌بندی شدن فایل (tiled) پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساختِ در دسترس بر اساس درایور قالب متغیر هستند و برخی قالب‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به همان قالب منبع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای مشاهده گزینه‌های ساخت مجاز هر قالب، به مستندات اختصاصی قالب \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/درایور مورد تلاش برای باز کردن فایل(های) ورودی. به طور کلی نیازی به تعیین آن نیست، اما در مواردی که تشخیص خودکار درایور در انتخاب درایور مناسب ناموفق باشد، می‌تواند برای نادیده گرفتن تشخیص خودکار استفاده شود. این گزینه را می‌توان چندین بار برای تعیین چندین درایور کاندید تکرار کرد. توجه داشته باشید که این کار آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند. به طور خاص، برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه داده (مختص به هر قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-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 \-\-update اینکه آیا مجموعه داده خروجی موجود در حالت به‌روزرسانی (update mode) باز شود یا خیر. .UNINDENT .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: رایت کردن یک Shapefile در یک رستر" .INDENT 0.0 .INDENT 3.5 دستور زیر تمام چندضلعی‌ها را از \fBmask.shp\fP با رنگ قرمز (RGB = 255,0,0) بر روی فایل TIFF رنگی \fBwork.tif\fP رایت (burn) می‌کند. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector rasterize \-b 1,2,3 \-\-burn 255,0,0 \-l mask mask.shp work.tif .EE .UNINDENT .UNINDENT .UNINDENT .UNINDENT.SS مثال ۲: دستور زیر تمام ساختمان‌های \(dqclass A\(dq را با استخراج ارتفاع از ویژگی ROOF_H در فایل ارتفاع خروجی حک می‌کند. .sp حک کردن یک shapefile در یک رستر با استفاده از شرط where مشخص برای انتخاب عوارض .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector rasterize \-a ROOF_H \-\-where \(dqclass=\(aqA\(aq\(dq \-l footprints footprints.shp city_dem.tif .EE .UNINDENT .UNINDENT .SS مثال ۳: دستور زیر تمام چندضلعی‌ها را از footprint.shp با رنگ قرمز در یک فایل TIFF جدید 1000x1000 با فرمت rgb حک می‌کند. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 از \fI\-b\fP استفاده نمی‌شود؛ ترتیب گزینه‌های \fI\-\-burn\fP باندهای رستر خروجی را تعیین می‌کند. .UNINDENT .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector rasterize \-\-burn 255,0,0 \-\-ot Byte \-\-size 1000,1000 \-l footprints footprints.shp mask.tif .EE .UNINDENT .UNINDENT .SS مثال ۴: حک کردن یک shapefile در یک رستر با استفاده از شرط where مشخص برای انتخاب عوارض، و محدود کردن محدوده به عوارض انتخاب‌شده .INDENT 0.0 .INDENT 3.5 .sp .EX gdal pipeline read /vsizip/vsicurl/https://www2.census.gov/geo/tiger/TIGER2025/STATE/tl_2025_us_state.zip ! \e filter \-\-where \(dqstusps = \(aqCA\(aq\(dq \-\-update\-extent ! \e rasterize \-\-burn 1 \-\-size 1500,1500 \-\-datatype Byte ! \e write out.png \-\-overwrite .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Alessandro Pasotti .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .