.\" 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 "GDALTINDEX" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdaltindex \- ساخت یک shapefile به عنوان نمایه کاشی رستر. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdaltindex [\-\-help] [\-\-long\-usage] [\-\-help\-general] [\-overwrite] [\-recursive] [\-filename_filter ]... [\-min_pixel_size ] [\-max_pixel_size ] [\-of ] [\-tileindex ] [\-write_absolute_path] [\-skip_different_projection] [\-t_srs ] [\-src_srs_name ] [\-src_srs_format {AUTO|WKT|EPSG|PROJ}] [\-lyr_name ] [\-lco =]... [\-gti_filename ] [\-tr ] [\-te ] [\-ot ] [\-bandcount ] [\-nodata ]... [\-colorinterp ]... [\-mask] [\-mo =]... [\-fetch_md ]... [\-\-quiet] ... .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp این برنامه یک مجموعه داده پشتیبانی‌شده توسط OGR را ایجاد می‌کند که برای هر فایل رستر ورودی یک رکورد، یک مشخصه حاوی نام فایل، و یک هندسه چندضلعی که محدوده رستر را مشخص می‌کند دارد. این خروجی برای استفاده در \X'tty: link http://mapserver.org'\fI\%MapServer\fP\X'tty: link' به عنوان یک نمایه کاشی رستر، یا به عنوان ورودی برای درایور \fI\%GTI\fP مناسب است. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 معادل در رابط خط فرمان جدید \(dqgdal\(dq: .sp ببینید: \fI\%gdal raster index\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 \-overwrite در نگارش 3.9 اضافه شد. .sp رونویسی نمایه کاشی در صورت وجود داشتن از قبل. .UNINDENT .INDENT 0.0 .TP .B \-recursive در نگارش 3.9 اضافه شد. .sp اینکه آیا دایرکتوری‌های مشخص‌شده در باید به‌صورت بازگشتی پیمایش شوند یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-filename_filter در نگارش 3.9 اضافه شد. .sp الگویی که نام‌های فایل‌های موجود در دایرکتوری‌های مشخص‌شده توسط باید از آن پیروی کنند. \(aq*\(aq یک نویسه عام (wildcard) است که با هر تعداد از هر نویسه‌ای از جمله هیچ تطابق دارد. \(aq?\(aq یک نویسه عام است که با یک نویسه منفرد مطابقت می‌کند. مقایسه‌ها بدون حساسیت به بزرگی و کوچکی حروف انجام می‌شوند. می‌توان چندین فیلتر مشخص کرد. .sp برای مثال: \fB\-filename_filter \(dq*.tif\(dq \-filename_filter \(dq*.tiff\(dq\fP .UNINDENT .INDENT 0.0 .TP .B \-min_pixel_size در نگارش 3.9 اضافه شد. .sp حداقل اندازه پیکسل از نظر وسعت مکانی به ازای هر پیکسل (تفکیک‌پذیری) که یک رستر باید داشته باشد تا انتخاب شود. اندازه پیکسل پس از بازتصویر وسعت آن به SRS هدف تعریف‌شده توسط \fI\%\-t_srs\fP ارزیابی می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-max_pixel_size در نگارش 3.9 اضافه شد. .sp حداکثر اندازه پیکسل از نظر وسعت مکانی به ازای هر پیکسل (تفکیک‌پذیری) که یک رستر باید داشته باشد تا انتخاب شود. اندازه پیکسل پس از بازتصویر وسعت آن به SRS هدف تعریف‌شده توسط \fI\%\-t_srs\fP ارزیابی می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-of قالب OGR فایل نمایه کاشی خروجی. در صورت مشخص نشدن، قالب از پسوند پرونده حدس زده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-tileindex نام فیلد خروجی برای نگهداری مسیر/مکان فایل رسترهای نمایه‌شده. نام فیلد پیش‌فرض نمایه کاشی \fBlocation\fP است. .UNINDENT .INDENT 0.0 .TP .B \-write_absolute_path مسیر مطلق فایل‌های رستر در فایل نمایه کاشی ذخیره می‌شود. به‌طور پیش‌فرض، نام فایل‌های رستر دقیقاً همان‌گونه که در خط فرمان مشخص شده‌اند در فایل قرار می‌گیرند. .UNINDENT .INDENT 0.0 .TP .B \-skip_different_projection تنها فایل‌هایی که تصویر سیستم مختصات یکسانی با فایل‌های درج‌شده قبلی در tileindex دارند درج خواهند شد (مگر اینکه \fI\%\-t_srs\fP مشخص شده باشد). حالت پیش‌فرض تصویر را بررسی نمی‌کند و تمام ورودی‌ها را می‌پذیرد. .UNINDENT .INDENT 0.0 .TP .B \-t_srs هندسه‌های فایل‌های ورودی به سامانه مرجع مختصات هدف تبدیل خواهند شد. حالت پیش‌فرض، چندضلعی‌های مستطیلی ساده‌ای در همان سامانه مرجع مختصات رسترهای ورودی ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-src_srs_name نام فیلد برای ذخیره SRS هر کاشی. این نام فیلد می‌تواند به عنوان مقدار کلیدواژه TILESRS در MapServer استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-src_srs_format {AUTO|WKT|EPSG|PROJ} قالبی که SRS هر کاشی باید با آن نوشته شود. انواع می‌توانند \fBAUTO\fP، \fBWKT\fP، \fBEPSG\fP، \fBPROJ\fP باشند. این گزینه باید به همراه \fI\%\-src_srs_format\fP استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-lyr_name نام لایه برای ایجاد یا الحاق به آن در فایل نمایه کاشی خروجی. .UNINDENT .INDENT 0.0 .TP .B \-lco = در نگارش 3.9 اضافه شد. .sp گزینه ایجاد لایه (مخصوص قالب) .UNINDENT .INDENT 0.0 .TP .B نام فایل خروجی برای ایجاد یا الحاق به آن. در صورت عدم وجود، مجموعه داده پیش‌فرض ایجاد خواهد شد، در غیر این صورت به مجموعه داده موجود الحاق می‌شود. .UNINDENT .INDENT 0.0.TP .B فایل‌های رستر ورودی GDAL، می‌توانند چندین فایل باشند که با فاصله از هم جدا شده‌اند. همچنین می‌توان از نویسه‌های عمومی (Wildcardها) نیز استفاده کرد. مکان فایل‌ها را با همان ساختاری که در اینجا مشخص شده ذخیره می‌کند، مگر اینکه گزینهٔ \fI\%\-write_absolute_path\fP نیز استفاده شود. .sp از GDAL 3.9 به بعد، این مقدار می‌تواند نام یک دایرکتوری نیز باشد. \fI\%\-recursive\fP را نیز می‌توان برای پیمایش بازگشتی زیردایرکتوری‌ها به کار برد. .sp همچنین امکان استفاده از گزینهٔ عمومی \fB\-\-optfile filelist.txt\fP برای تعیین فهرستی از فایل‌های مبدأ وجود دارد. .UNINDENT .SH "گزینه‌های ویژه برای استفاده توسط درایور GDAL GTI (OPTIONS SPECIFIC TO USE BY THE GDAL GTI DRIVER)" .sp دستور gdaltindex می‌تواند برای تولید یک نمایه تایل (tile index) مناسب برای استفاده توسط درایور \fI\%GTI\fP استفاده شود. دو امکان وجود دارد: .INDENT 0.0 .IP \(bu 2 یا استفادهٔ مستقیم از نمایه تایل برداری تولید شده توسط gdaltindex به عنوان ورودی درایور GTI .IP \(bu 2 یا تولید یک فایل پوششی کوچک XML .gti، برای استفادهٔ آسان‌تر با فرمت‌های غیرفایلی مانند پایگاه‌های داده، یا برای فرمت‌های برداری که از تنظیم موارد فرادادهٔ لایه پشتیبانی نمی‌کنند. .UNINDENT .sp فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند برای نمونه عبارتند از GeoPackage (\fB\-of GPKG\fP)، FlatGeoBuf (\fB\-of FlatGeoBuf\fP) یا PostGIS (\fB\-of PG\fP) .sp تنظیم \fI\%\-tr\fP و \fI\%\-ot\fP توصیه می‌شود تا درایور GTI مجبور نباشد با باز کردن نخستین تایل موجود در نمایه، آن‌ها را استنتاج کند. اگر تایل‌ها دارای باند nodata یا mask باشند، \fI\%\-nodata\fP و \fI\%\-mask\fP نیز باید تنظیم شوند. .sp در چارچوب GTI، محدودهٔ (extent) تمامی تایل‌های ارجاع‌داده‌شده در نمایه تایل باید در یک SRS واحد بیان شود. در نتیجه، اگر تایل‌های ورودی ممکن است دارای SRS متفاوتی باشند، باید \fI\%\-t_srs\fP یا \fI\%\-skip_different_projection\fP مشخص شود. .INDENT 0.0 .TP .B \-gti_filename در نسخهٔ 3.9 اضافه شد. .sp نام فایل نمایه تایل مجازی XML برای تولید، که می‌تواند به عنوان ورودی برای درایور GDAL GTI / Virtual Raster Tile Index استفاده شود. این گزینه زمانی می‌تواند مفید باشد که نمایه تایل را در یک فرمت برداری می‌نویسید که از نوشتن موارد فرادادهٔ لایه پشتیبانی نمی‌کند. .UNINDENT .INDENT 0.0 .TP .B \-tr در نسخهٔ 3.9 اضافه شد. .sp وضوح (resolution) هدف در واحد SRS بر پیکسل. .sp در صورت تعیین \fI\%\-gti_filename\fP در فایل XML Virtual Tile Index، یا به عنوان موارد فرادادهٔ لایهٔ \fBRESX\fP و \fBRESY\fP برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-te در نسخهٔ 3.9 اضافه شد. .sp محدودهٔ (extent) هدف در واحد SRS. .sp در صورت تعیین \fI\%\-gti_filename\fP در فایل XML Virtual Tile Index، یا به عنوان موارد فرادادهٔ لایهٔ \fBMINX\fP، \fBMINY\fP، \fBMAXX\fP و \fBMAXY\fP برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-ot در نسخهٔ 3.9 اضافه شد. .sp نوع دادهٔ تایل‌های نمایه تایل: \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 .sp در صورت تعیین \fI\%\-gti_filename\fP در فایل XML Virtual Tile Index، یا به عنوان مورد فرادادهٔ لایهٔ \fBDATA_TYPE\fP برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-bandcount در نسخهٔ 3.9 اضافه شد. .sp تعداد باندهای تایل‌های نمایه تایل. .sp در صورت تعیین \fI\%\-gti_filename\fP در فایل XML Virtual Tile Index، یا به عنوان مورد فرادادهٔ لایهٔ \fBBAND_COUNT\fP برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود. .sp ترکیبی از تایل‌های با N و 1+N باند مجاز است، به شرطی که تفسیر رنگ باند (1+N)ام از نوع alpha باشد. در این شرایط مقدار 1+N باید به عنوان تعداد باند نوشته شود. .sp اگر \fI\%\-nodata\fP یا \fI\%\-colorinterp\fP مشخص شده باشند و چندین مقدار داشته باشند، تعداد باندها نیز از آن تعداد استنتاج می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-nodata [,...] در نسخهٔ 3.9 اضافه شد. .sp مقدار nodata تایل‌های نمایه تایل. .sp در صورت تعیین \fI\%\-gti_filename\fP در فایل XML Virtual Tile Index، یا به عنوان مورد فرادادهٔ لایهٔ \fBNODATA\fP برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-colorinterp [,...] در نسخهٔ 3.9 اضافه شد. .sp تفسیر رنگ تایل‌های نمایه تایل: \fBred\fP، \fBgreen\fP، \fBblue\fP، \fBalpha\fP، \fBgray\fP، \fBundefined\fP\&. .sp در صورت تعیین \fI\%\-gti_filename\fP در فایل XML Virtual Tile Index، یا به عنوان مورد فرادادهٔ لایهٔ \fBCOLOR_INTERPRETATION\fP برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-mask در نسخهٔ 3.9 اضافه شد. .sp آیا تایل‌های موجود در نمایه تایل دارای باند ماسک هستند یا خیر. .sp در صورت تعیین \fI\%\-gti_filename\fP در فایل XML Virtual Tile Index، یا به عنوان مورد فرادادهٔ لایهٔ \fBMASK_BAND\fP برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-mo = در نسخهٔ 3.9 اضافه شد. .sp نوشتن یک مورد فرادادهٔ دلخواه برای لایه، در فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند. این گزینه می‌تواند تکرار شود. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 این گزینه نمی‌تواند همراه با \fI\%\-gti_filename\fP استفاده شود. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-fetch_md در نسخهٔ 3.9 اضافه شد. .sp دریافت یک مورد فراداده از تایل رستر و نوشتن آن به عنوان یک فیلد در نمایه تایل. .sp باید نام مورد فرادادهٔ رستر باشد. می‌توان از \fB{PIXEL_SIZE}\fP به عنوان یک نام ویژه برای تعیین اندازهٔ پیکسل استفاده کرد. .sp باید نام فیلدی باشد که در نمایه تایل ایجاد می‌شود. .sp باید نام نوع فیلد ایجادشونده باشد. یکی از مقادیر \fBString\fP، \fBInteger\fP، \fBInteger64\fP، \fBReal\fP، \fBDate\fP، \fBDateTime\fP .sp این گزینه می‌تواند تکرار شود. .sp برای نمونه: \fB\-fetch_md TIFFTAG_DATETIME creation_date DateTime\fP .UNINDENT.SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱" .sp تولید یک shapefile (\fBdoq_index.shp\fP) با یک رکورد به ازای هر تصویری که این ابزار در پوشهٔ \fBdoq\fP پیدا می‌کند. هر رکورد حاوی اطلاعاتی است که به مکان تصویر اشاره دارد و همچنین یک شکل مستطیل محاطی که محدودهٔ تصویر را نشان می‌دهد: .INDENT 0.0 .INDENT 3.5 .sp .EX gdaltindex doq_index.shp doq/*.tif .EE .UNINDENT .UNINDENT .SS "مثال ۲" .sp اجرای همان دستور قبلی، اما این بار به جای Shapefile یک GeoPackage ایجاد می‌کنیم. .INDENT 0.0 .INDENT 3.5 .sp .EX gdaltindex \-of GPKG doq_index.gpkg doq/*.tif .EE .UNINDENT .UNINDENT .SS "مثال ۳" .sp گزینهٔ \fI\%\-t_srs\fP همچنین می‌تواند برای تبدیل تمام رسترهای ورودی به یک سیستم تصویر خروجی یکسان استفاده شود: .INDENT 0.0 .INDENT 3.5 .sp .EX gdaltindex \-t_srs EPSG:4326 \-src_srs_name src_srs tile_index_mixed_srs.shp *.tif .EE .UNINDENT .UNINDENT .SS "مثال ۴" .sp ایجاد یک نمایه کاشی (tile index) از فایل‌های فهرست‌شده در یک فایل متنی، با متاداده‌های مناسب جهت استفاده توسط درایور GDAL GTI / Virtual Raster Tile Index. .INDENT 0.0 .INDENT 3.5 .sp .EX gdaltindex tile_index.gti.gpkg \-ot Byte \-tr 60 60 \-colorinterp Red,Green,Blue \-\-optfile my_list.txt .EE .UNINDENT .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "رابط برنامه‌نویسی C (C API)" .sp این ابزار همچنین از طریق C با \fI\%GDALTileIndex()\fP\& قابل فراخوانی است. .SH "همچنین ببینید (SEE ALSO)" .sp برای سایر گزینه‌های خط فرمان، و به‌ویژه سوئیچ \fI\%\-\-optfile\fP که می‌تواند برای تعیین فهرستی از مجموعه‌داده‌های ورودی استفاده شود، بخش \fI\%Common options for raster programs\fP را ببینید. .SH "نویسندگان (AUTHORS)" Frank Warmerdam .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .