.\" 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_FOOTPRINT" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal_footprint \- محاسبه ردپا (محدوده پوشش) یک رستر
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal_footprint [\-\-help] [\-\-long\-usage] [\-\-help\-general]
                      [\-b <band>]... [\-combine_bands VAR]
                      [[\-ovr <index>]|[\-srcnodata \(dq<value>[ <value>]...\(dq]]
                      [\-t_cs VAR] [\-t_srs <srs_def>] [\-split_polys]
                      [\-convex_hull] [\-densify <value>] [\-simplify <value>]
                      [\-min_ring_area <value>] [\-max_points <value>|unlimited]
                      [\-\-quiet] [\-oo <NAME>=<VALUE>]... [\-of <output_format>]
                      [[\-location_field_name <field_name>]|[\-no_location]]
                      [\-write_absolute_path] [\-lco <NAME>=<VALUE>]...
                      [\-dsco <NAME>=<VALUE>]... [\-lyr_name <value>] [\-overwrite]
                      <src_filename> <dst_filename>
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBgdal_footprint\fP می‌تواند برای محاسبه ردپا (Footprint) یا محدوده پوشش
یک فایل رستری با در نظر گرفتن مقادیر nodata (یا به طور کلی‌تر باند ماسک
متصل به باندهای رستر)، و تولید چندضلعی‌ها/چندچندضلعی‌ها (Polygons/MultiPolygons)
متناظر با نواحی دارای پیکسل‌های معتبر، و نوشتن در یک فایل برداری خروجی استفاده شود.
.sp
ابزار \fBnearblack\fP می‌تواند به عنوان یک مرحله پیش‌پردازش جهت تولید
باندهای ماسک مناسب اجرا شود.
.sp
\fBنکته کاربردی:\fP
.INDENT 0.0
.INDENT 3.5
معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
مشاهده کنید: \fI\%gdal raster footprint\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 <band>
باند(های) مورد نظر. بین ۱ تا تعداد باندهای رستر.
می‌تواند چندین بار تعیین شود. در صورت عدم تعیین، تمام باندها
لحاظ می‌شوند. نحوه ترکیب باندهای مختلف با استفاده از
\fI\%\-combine_bands\fP کنترل می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-combine_bands union|intersection
تعیین نحوه ترکیب باندهای ماسک مربوط به باندهای انتخاب‌شده برای تولید
یک باند ماسک منفرد، پیش از برداری‌سازی.
مقدار پیش‌فرض \fBunion\fP است: یعنی یک پیکسل در صورتی معتبر است که حداقل
برای یکی از باندهای انتخاب‌شده معتبر باشد.
\fBintersection\fP به این معناست که یک پیکسل تنها در صورتی معتبر است که برای تمام
باندهای انتخاب‌شده معتبر باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-ovr <index>
تعیین اینکه کدام سطح نمای کلی (Overview) از فایل منبع باید استفاده شود، زمانی که نماهای کلی
روی رستر منبع موجود باشند. به‌طور پیش‌فرض از سطح وضوح کامل
استفاده می‌شود. شاخص بر پایه ۰ است، یعنی ۰ بیانگر اولین سطح نمای کلی است.
این گزینه با \fI\%\-srcnodata\fP ناسازگار و مانعة‌الجمع است.
.UNINDENT
.INDENT 0.0
.TP
.B \-srcnodata \(dq<value>[ <value>]...\(dq
تنظیم مقادیر nodata برای باندهای ورودی (می‌توان مقادیر متفاوتی برای هر باند ارائه داد).
اگر یک مقدار واحد مشخص شود، برای تمام باندهای انتخاب‌شده اعمال می‌شود.
اگر بیش از یک مقدار ارائه شود، باید به تعداد باندهای انتخاب‌شده مقدار وجود داشته باشد،
و تمام مقادیر باید در علامت نقل‌قول (کوتیشن) قرار گیرند تا
به عنوان یک آرگومان واحد به سیستم‌عامل فرستاده شوند.
اگر این گزینه مشخص نشود، باند ماسک ذاتی هر یک از باندهای انتخاب‌شده
استفاده خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-t_cs pixel|georef
دستگاه مختصات هدف. به‌طور پیش‌فرض اگر مجموعه‌داده ورودی دارای ارجاع مکانی (زمین‌مرجع) باشد،
\fBgeoref\fP اعمال می‌شود، به این معنی که هندسه ردپا به صورت
مختصات در دستگاه مرجع مکانی (CRS) رستر (یا سیستم تعیین‌شده با \fI\%\-t_srs\fP) بیان خواهد شد.
در صورت تعیین \fBpixel\fP، مختصات هندسه ردپا
شاخص‌های ستون و سطر خواهند بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-t_srs <srs_def>
دستگاه مرجع مکانی (CRS) هدف برای فایل خروجی. <srs_def> می‌تواند هر یک
از قالب‌های متداول GDAL/OGR، قالب کامل WKT، عبارت PROJ.4، شناسه EPSG:n یا فایلی حاوی
WKT باشد.
تعیین این گزینه به منزله \-t_cs georef است.
ردپا از CRS رستر مبدأ به CRS تعیین‌شده بازتصویرسازی می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-split_polys
در صورت تعیین، چندچندضلعی‌ها (Multipolygons) به چندین عارضه تفکیک می‌شوند که هر یک شامل یک
چندضلعی منفرد است.
.UNINDENT
.INDENT 0.0
.TP
.B \-convex_hull
در صورت تعیین، پوش محدب (Convex Hull) چندضلعی‌ها (یا چندچندضلعی‌ها) محاسبه می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-densify <value>
مقدار مشخص‌شده برای این گزینه، حداکثر فاصله مجاز بین ۲
نقطه متوالی از هندسه خروجی است.
واحد فاصله در صورت برابر بودن \fI\%\-t_cs\fP با \fBpixel\fP بر حسب پیکسل،
یا در غیر این صورت بر حسب واحدهای زمین‌مرجع رستر مبدأ است.
این گزینه پیش از بازتصویرسازی حاصل از \fI\%\-t_srs\fP اعمال می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-simplify <value>
مقدار تعیین‌شده برای این گزینه، میزان رواداری (Tolerance) مورد استفاده برای ادغام
نقاط متوالی هندسه خروجی با استفاده از روش
\fI\%OGRGeometry::Simplify()\fP است.
واحد فاصله در صورت برابر بودن \fI\%\-t_cs\fP با \fBpixel\fP بر حسب پیکسل،
یا در غیر این صورت بر حسب واحدهای زمین‌مرجع مجموعه‌داده برداری هدف است.
این گزینه پس از بازتصویرسازی حاصل از \fI\%\-t_srs\fP اعمال می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-min_ring_area <value>
حداقل مقدار مساحت یک حلقه (Ring).
واحد مساحت در صورت برابر بودن \fI\%\-t_cs\fP با \fBpixel\fP بر حسب پیکسل مربع،
یا در غیر این صورت بر حسب واحدهای زمین‌مرجع مجموعه‌داده برداری هدف است.
این گزینه پس از بازتصویرسازی حاصل از \fI\%\-t_srs\fP اعمال می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-max_points <value>|unlimited
حداکثر تعداد نقاط هر هندسه خروجی (بدون احتساب نقطه پایانی
هر حلقه، که همواره منطبق بر نقطه اول است).
مقدار پیش‌فرض ۱۰۰ است. می‌توان از \fBunlimited\fP برای حذف این محدودیت استفاده کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-oo <NAME>=<VALUE>
گزینه باز کردن مجموعه‌داده (مختص قالب).
.UNINDENT
.INDENT 0.0
.TP
.B \-of <ogr_format>
انتخاب قالب خروجی. از نام کوتاه قالب استفاده کنید. در صورت عدم تعیین،
از روی پسوند فایل حدس زده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-location_field_name <field_name>
در نسخه 3.9.0 اضافه شد.

.sp
نام فیلدی را در مجموعه‌داده برداری حاصل تعیین می‌کند که مسیر
مجموعه‌داده ورودی در آن ذخیره خواهد شد. نام پیش‌فرض فیلد
\(dqlocation\(dq است. برای جلوگیری از نوشتن مسیر مجموعه‌داده ورودی، از
\fI\%\-no_location\fP استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-no_location
در نسخه 3.9.0 اضافه شد.

.sp
نوشتن مسیر مجموعه‌داده ورودی به عنوان یک فیلد در مجموعه‌داده
برداری خروجی را غیرفعال می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-write_absolute_path
در نسخه 3.9.0 اضافه شد.

.sp
نوشتن مسیر مطلق مجموعه‌داده ورودی را فعال می‌کند. به‌طور پیش‌فرض،
نام فایل دقیقاً همان‌طور که در خط فرمان وارد شده در فیلد مکان نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-lco <NAME>=<VALUE>
گزینه ایجاد لایه (مختص قالب).
.UNINDENT
.INDENT 0.0
.TP
.B \-dsco <NAME>=<VALUE>
گزینه ایجاد مجموعه‌داده (مختص قالب).
.UNINDENT
.INDENT 0.0
.TP
.B \-lyr_name <value>
نام لایه هدف. در صورت عدم تعیین، برابر با \fBfootprint\fP خواهد بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-overwrite
بازنویسی لایه هدف در صورت وجود.
.UNINDENT
.INDENT 0.0
.TP
.B <src_filename>
نام فایل رستری مبدأ.
.UNINDENT
.INDENT 0.0
.TP
.B <dst_filename>
نام فایل برداری مقصد. اگر فایل و لایه خروجی وجود داشته باشند،
ردپای جدید به آن‌ها الحاق می‌شود، مگر اینکه از \fI\%\-overwrite\fP استفاده شود.
.UNINDENT
.sp
عملیات هندسی پس از برداری‌سازی به ترتیب زیر اعمال می‌شوند:
.INDENT 0.0
.IP \(bu 2
تفکیک اختیاری چندضلعی‌ها (\fI\%\-split_polys\fP)
.IP \(bu 2
متراکم‌سازی اختیاری نقاط (\fI\%\-densify\fP)
.IP \(bu 2
بازتصویرسازی اختیاری (\fI\%\-t_srs\fP)
.IP \(bu 2
فیلتر کردن اختیاری بر اساس حداقل مساحت حلقه (\fI\%\-min_ring_area\fP)
.IP \(bu 2
اعمال اختیاری پوش محدب (\fI\%\-convex_hull\fP)
.IP \(bu 2
ساده‌سازی اختیاری (\fI\%\-simplify\fP)
.IP \(bu 2
محدود کردن تعداد نقاط (\fI\%\-max_points\fP)
.UNINDENT
.SH "کد وضعیت خروجی (RETURN STATUS CODE)"
.sp
برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند
(خطاهای غیرمسدودکننده که به صورت هشدار ارسال می‌شوند به عنوان اجرای
موفق در نظر گرفته می‌شوند).
.SH "رابط سی (C API)"
.sp
این ابزار از طریق C نیز با تابع \fI\%GDALFootprint()\fP قابل فراخوانی است.
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: محاسبه ردپای یک فایل GeoTIFF به عنوان یک فایل GeoJSON
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_footprint \-t_srs EPSG:4326 input.tif output.geojson
.EE
.UNINDENT
.UNINDENT
.sp
ردپا با استفاده از مختصات طول و عرض جغرافیایی WGS84 نوشته خواهد شد،
بدون توجه به دستگاه مرجع مکانی مورد استفاده در رستر ورودی.
.SH "نویسنده (AUTHOR)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.