.\" 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_POLYGONIZE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal_polygonize \- تولید یک لایه عارضه چندضلعی از یک رستر
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_polygonize [\-\-help] [\-\-help\-general]
                   [\-8] [\-o <name>=<value>]... [\-nomask]
                   [\-mask <filename>] <raster_file> [\-b <band>]
                   [\-q] [\-f <ogr_format>] [\-lco <name>=<value>]...
                   [\-overwrite] <out_file> [<layer>] [<fieldname>]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
این ابزار برای تمام نواحی متصل پیکسل‌ها در رستر که مقدار پیکسلی یکسانی دارند،
چندضلعی‌های (polygon) برداری ایجاد می‌کند. هر چندضلعی با یک مشخصه (attribute)
ایجاد می‌شود که مقدار پیکسل مربوط به آن را نشان می‌دهد. همچنین می‌توان یک
ماسک رستری مشخص کرد تا معلوم شود کدام پیکسل‌ها واجد شرایط پردازش هستند.
.sp
این ابزار در صورتی که منبع داده برداری خروجی وجود نداشته باشد آن را ایجاد می‌کند،
در غیر این صورت تلاش خواهد کرد داده‌ها را به منبع موجود الحاق (append) کند.
.sp
این ابزار بر پایه تابع :\fI\%GDALPolygonize()\fP پیاده‌سازی شده که حاوی جزئیات
بیشتری درباره الگوریتم است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
دستور gdal_polygonize یک ابزار پایتون است و تنها در صورتی در دسترس خواهد بود که اتصالات پایتون GDAL نصب و موجود باشند.
.UNINDENT
.UNINDENT
.sp
\fBراهنمایی:\fP
.INDENT 0.0
.INDENT 3.5
معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
دستور \fI\%gdal raster polygonize\fP\& را ببینید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
ارائه یک پیام کاربردی کوتاه برای گزینه‌های عمومی خط فرمان GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-8
استفاده از همبندی ۸-گانه. پیش‌فرض همبندی ۴-گانه است.
.UNINDENT
.INDENT 0.0
.TP
.B \-nomask
عدم استفاده از ماسک اعتبار پیش‌فرض برای باند ورودی (مانند ماسک‌های nodata یا alpha).
.UNINDENT
.INDENT 0.0
.TP
.B \-mask <filename>
استفاده از اولین باند فایل مشخص‌شده به عنوان ماسک اعتبار (صفر نامعتبر، و غیرصفر معتبر است). در صورت عدم تعیین، ماسک اعتبار پیش‌فرض برای باند ورودی (مانند ماسک‌های nodata یا alpha) استفاده خواهد شد (مگر اینکه \-nomask تعیین شده باشد).
.UNINDENT
.INDENT 0.0
.TP
.B <raster_file>
فایل رستری مبدأ که چندضلعی‌ها از آن استخراج می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-b <band>
باندی در <raster_file> که چندضلعی‌ها از آن ساخته می‌شوند. این مقدار همچنین می‌تواند برابر با \(dqmask\(dq قرار گیرد تا نشان دهد که باید از باند ماسکِ باند اول استفاده شود (یا \(dqmask,band_number\(dq برای ماسک باندی خاص).
.UNINDENT
.INDENT 0.0
.TP
.B \-f <ogr_format>
انتخاب قالب خروجی. در صورت عدم تعیین، قالب از روی پسوند فایل حدس زده می‌شود. از نام کوتاه قالب استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-o <NAME>=<VALUE>
در نسخه 3.7 اضافه شد.

.sp
گزینه چندضلعی‌سازی (Polygonize). به مستندات :\fI\%GDALPolygonize()\fP مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-lco <NAME>=<VALUE>
در نسخه 3.7 اضافه شد.

.sp
گزینه ایجاد لایه (وابسته به قالب انتخابی).
.UNINDENT
.INDENT 0.0
.TP
.B \-overwrite
در نسخه 3.8 اضافه شد.

.sp
بازنویسی لایه خروجی در صورتی که از قبل وجود داشته باشد.
.UNINDENT
.INDENT 0.0
.TP
.B <out_file>
فایل برداری مقصد که چندضلعی‌ها در آن نوشته خواهند شد.
.UNINDENT
.INDENT 0.0
.TP
.B <layer>
نام لایه ایجادشده برای نگهداری عارضه‌های چندضلعی.
.UNINDENT
.INDENT 0.0
.TP
.B <fieldname>
نام فیلدی که باید ایجاد شود (پیش‌فرض \(dqDN\(dq است).
.UNINDENT
.INDENT 0.0
.TP
.B \-q
اجرای اسکریپت در حالت بی‌صدا. نمایش پیشرفت متوقف شده و پیام‌های معمول نمایش داده نمی‌شوند.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0، و در صورت بروز خطا مقدار غیرصفر را بازمی‌گرداند
(خطاهای غیرمسدودکننده که به شکل هشدار ارسال می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).
.SH "نویسندگان (AUTHORS)"
Frank Warmerdam <warmerdam@pobox.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.