.\" 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 "GDAL2TILES" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal2tiles \- ایجاد دایرکتوری با کاشی‌های TMS، فایل‌های KML و نمایشگرهای وب ساده .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal2tiles [\-\-help] [\-\-help\-general] [\-\-legacy] [\-p ] [\-r resampling] [\-s ] [\-z ] [\-e] [\-a nodata] [\-v] [\-q] [\-h] [\-k] [\-n] [\-u ] [\-w ] [\-t ] [\-c <copyright>] [\-\-processes=<NB_PROCESSES>] [\-\-mpi] [\-\-xyz] [\-\-tilesize=<PIXELS>] \-\-tiledriver=<DRIVER> [\-\-tmscompatible] [\-\-excluded\-values=<EXCLUDED_VALUES>] [\-\-excluded\-values\-pct\-threshold=<EXCLUDED_VALUES_PCT_THRESHOLD>] [\-\-nodata\-values\-pct\-threshold=<NODATA_VALUES_PCT_THRESHOLD>] [\-g <googlekey] [\-b <bingkey>] <input_file> [<output_dir>] [<COMMON_OPTIONS>] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp \fBهشدار:\fP .INDENT 0.0 .INDENT 3.5 از نسخه GDAL 3.13، دستور \fBgdal2tiles\fP منسوخ شده است و به‌طور پیش‌فرض به \fI\%gdal raster tile\fP نگاشت می‌شود. در حال حاضر، می‌توانید با مشخص کردن \fI\-\-legacy\fP استفاده از کد قدیمی را اجبار کنید، اما حالت قدیمی در GDAL 3.15 حذف خواهد شد. اگر به استفاده از حالت قدیمی نیاز دارید و راهکاری با استفاده از gdal raster tile پیدا نمی‌کنید، لطفاً یک تیکت در \X'tty: link https://github.com/OSGeo/GDAL'\fI\%https://github.com/OSGeo/GDAL\fP\X'tty: link' ثبت کنید. .UNINDENT .UNINDENT .sp این ابزار دایرکتوری‌ای شامل کاشی‌های (tiles) کوچک و متادیتا، مطابق با مشخصات Tile Map Service متعلق به OSGeo تولید می‌کند. صفحات وب ساده با نمایشگرهای مبتنی بر Google Maps، OpenLayers و Leaflet نیز تولید می‌شوند \- بنابراین هر کسی می‌تواند به‌راحتی نقشه‌های شما را به‌صورت برخط مرور کند و نیازی به نصب یا پیکربندی نرم‌افزارهای خاص (مانند MapServer) ندارید و نقشه با سرعت بسیار بالایی در مرورگر وب نمایش داده می‌شود. شما تنها نیاز دارید دایرکتوری تولیدشده را روی یک سرور وب بارگذاری کنید. .sp ابزار GDAL2Tiles همچنین در صورتی که نقشه ارائه‌شده از سیستم تصویر EPSG:4326 استفاده کند، متادیتای لازم را برای Google Earth (به‌صورت KML SuperOverlay) ایجاد می‌کند. .sp فایل‌های World و زمین‌مرجع‌سازی تعبیه‌شده در طول فرایند تولید کاشی استفاده می‌شوند، اما می‌توانید تصویری بدون زمین‌مرجع‌سازی مناسب را نیز منتشر کنید. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 ورودی‌هایی با نوع داده غیر بایتی (مانند \fBInt16\fP، \fBUInt16\fP و...) به نوع داده \fBByte\fP محدود (clamped) خواهند شد که باعث ایجاد نتایج نادرست می‌شود. برای جلوگیری از این مشکل، لازم است با استفاده از ابزار \fIgdal_translate\fP مقیاس داده ورودی را به نوع داده \fBByte\fP تغییر دهید. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 گزینه‌های پیکربندی درایورهای ورودی ممکن است بر خروجی gdal2tiles تأثیر بگذارند. یک نمونه از گزینه پیکربندی درایور GDAL_PDF_DPI است که می‌توان آن را در \fI\%Configuration options\fP یافت. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 ابزار gdal2tiles یک ابزار پایتونی است و تنها در صورتی در دسترس خواهد بود که بایندرهای پایتون GDAL نصب و موجود باشند. .UNINDENT .UNINDENT .sp \fBنکته کاربردی:\fP .INDENT 0.0 .INDENT 3.5 معادل در رابط خط فرمان جدید \(dqgdal\(dq: .sp ببینید: \fI\%gdal raster tile\fP .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-help نمایش این پیام راهنما و خروج .UNINDENT .INDENT 0.0 .TP .B \-\-help\-general نمایش پیام راهنمای مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج. .UNINDENT .INDENT 0.0 .TP .B \-\-legacy اضافه‌شده در نسخه 3.13. .sp اجبار به استفاده از پایه‌کد قدیمی (legacy). از GDAL 3.13، به‌طور پیش‌فرض gdal2tiles با استفاده از \fI\%gdal raster tile\fP پیاده‌سازی شده است. .UNINDENT .INDENT 0.0 .TP .B \-p <PROFILE>, \-\-profile=<PROFILE> پروفایل برش کاشی (mercator، geodetic، raster) \- پیش‌فرض \(aqmercator\(aq (سازگار با Google Maps). .sp از GDAL 3.2، پروفایل‌های اضافی از طریق فایل‌های tms_XXXX.json موجود در دایرکتوری داده‌های GDAL در دسترس هستند (به شرطی که تمام سطوح بزرگ‌نمایی از مبدأ و ابعاد کاشی یکسان استفاده کنند و تفکیک‌پذیری بین سطوح متوالی با ضریب دو تغییر کند). .UNINDENT .INDENT 0.0 .TP .B \-r <RESAMPLING>, \-\-resampling=<RESAMPLING> روش بازنمونه‌برداری (average، near، bilinear، cubic، cubicspline، lanczos، mode، max، min، med، q1، q3) \- پیش‌فرض \(aqaverage\(aq. .UNINDENT .INDENT 0.0 .TP .B \-s <SRS>, \-\-s_srs=<SRS> سیستم مرجع مکانی مورد استفاده برای داده ورودی مبدأ. .UNINDENT .INDENT 0.0 .TP .B \-\-xyz تولید کاشی‌های XYZ (استاندارد OSM Slippy Map) به جای TMS. در حالت پیش‌فرض (TMS)، کاشی‌های y=0 جنوبی‌ترین کاشی‌ها هستند، در حالی که در حالت XYZ (که توسط OGC WMTS نیز استفاده می‌شود)، کاشی‌های y=0 شمالی‌ترین کاشی‌ها به شمار می‌روند. .sp اضافه‌شده در نسخه 3.1. .UNINDENT .INDENT 0.0 .TP .B \-d, \-\-tmscompatible هنگام استفاده از پروفایل geodetic، تفکیک‌پذیری پایه را 0.703125 یا ۲ کاشی در سطح بزرگ‌نمایی ۰ مشخص می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-z <ZOOM>, \-\-zoom=<ZOOM> سطوح بزرگ‌نمایی برای رندر کردن (فرمت: \(aq2\-5\(aq، \(aq10\-\(aq یا \(aq10\(aq). .UNINDENT .INDENT 0.0 .TP .B \-e, \-\-resume حالت ادامه (resume). تنها فایل‌های ناموجود را تولید می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-a <NODATA>, \-\-srcnodata=<NODATA> مقداری در مجموعه‌داده ورودی که شفاف در نظر گرفته می‌شود. اگر مجموعه‌داده ورودی از قبل مقدار nodata وابسته داشته باشد، با مقدار مشخص‌شده جایگزین می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-v, \-\-verbose تولید خروجی پرجزئیات از فرایند تولید کاشی. .sp از GDAL 3.7، این خروجی پرجزئیات از طریق شیء \fBlogging.getLogger(\(dqgdal2tiles\(dq)\fP منتشر می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-x, \-\-exclude مستثنی کردن کاشی‌های شفاف از مجموعه‌کاشی حاصل. .UNINDENT .INDENT 0.0 .TP .B \-q, \-\-quiet غیرفعال کردن پیام‌ها و وضعیت در stdout. .UNINDENT .INDENT 0.0 .TP .B \-\-processes=<NB_PROCESSES> تعداد فرایندهای موازی مورد استفاده برای تولید کاشی، جهت افزایش سرعت محاسبات. .UNINDENT .INDENT 0.0.TP .B \-\-mpi در نسخه 3.5 اضافه شد. .sp فرض می‌کند که توسط mpiexec اجرا شده است، موازی‌سازی MPI را فعال کرده و \-\-processes را نادیده می‌گیرد. نیازمند یک محیط کاری MPI و بسته MPI برای پایتون (mpi4py) است. کاربر باید بر اساس میزان حافظه در هر گره و تعداد فرایندهای اجرا شده در هر گره، متغیر GDAL_CACHEMAX را روی اندازه حافظه موقت (cache) مناسبی برای هر فرایند تنظیم کند. .sp \fBهشدار:\fP .INDENT 7.0 .INDENT 3.5 حالت \-\-mpi در حالت غیرمیراثی \fI\%gdal raster tile\fP پشتیبانی نمی‌شود. می‌توانید برای ادامه \fI\%\-\-legacy\fP را مشخص کنید، اما این حالت میراثی در GDAL 3.15 حذف خواهد شد. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-tilesize=<PIXELS> در نسخه 3.1 اضافه شد. .sp عرض و ارتفاع کاشی بر حسب پیکسل. مقدار پیش‌فرض 256 است. .UNINDENT .INDENT 0.0 .TP .B \-\-tiledriver=<DRIVER> مشخص می‌کند که از کدام درایور خروجی برای کاشی‌ها استفاده شود و فرمت فایل کاشی‌ها را تعیین می‌کند. در حال حاضر PNG، WEBP و JPEG (JPEG در GDAL 3.9 اضافه شد) پشتیبانی می‌شوند. مقدار پیش‌فرض PNG است. پیکربندی اضافی برای درایورهای WEBP و JPEG در ادامه مستند شده است. .sp در نسخه 3.6 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-\-excluded\-values=<EXCLUDED_VALUES> چندتایی مقادیر جدا شده با کاما (معمولاً \(dqR,G,B\(dq) که در طول بازنمونه‌برداری (resampling) به عنوان پیکسل‌های مبدأ مشارکت‌کننده نادیده گرفته می‌شوند. تعداد مقادیر درون چندتایی باید با تعداد باندها، بدون احتساب باند آلفا، یکسان باشد. چندین چندتایی از مقادیر مستثنی‌شده را می‌توان با استفاده از نحو \(dq(R1,G1,B2),(R2,G2,B2)\(dq مشخص کرد. در حال حاضر فقط توسط Average در نظر گرفته می‌شود. این مفهوم تا حدی شبیه به nodata/alpha است، اما تفاوت اصلی در این است که هنگام تعیین اعتبار/تراکم پیکسل هدف، پیکسل‌های منطبق بر یکی از چندتایی‌های مقادیر مستثنی‌شده همچنان معتبر در نظر گرفته می‌شوند. .sp در نسخه 3.9 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-\-excluded\-values\-pct\-threshold=EXCLUDED_VALUES_PCT_THRESHOLD حداقل درصد پیکسل‌های مبدأ که باید روی یکی از \-\-excluded\-values تنظیم شده باشند تا باعث شود مقدار مستثنی‌شده‌ای که در میان پیکسل‌های مبدأ در اکثریت است، به عنوان مقدار پیکسل هدف استفاده شود. مقدار پیش‌فرض 50(%) است. .sp در نسخه 3.9 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-\-nodata\-values\-pct\-threshold=<NODATA_VALUES_PCT_THRESHOLD> حداقل درصد پیکسل‌های مبدأ که باید روی nodata (یا alpha=0 یا هر روش دیگری برای بیان پیکسل شفاف) باشند تا مقدار پیکسل هدف شفاف شود. مقدار پیش‌فرض 100 (%) است، به این معنی که یک پیکسل هدف تنها در صورتی شفاف است که تمام پیکسل‌های مبدأ مشارکت‌کننده شفاف باشند. فقط برای بازنمونه‌برداری average در نظر گرفته می‌شود. .sp در نسخه 3.9 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-h, \-\-help نمایش پیام راهنما و خروج. .UNINDENT .INDENT 0.0 .TP .B \-\-version نمایش شماره نسخه برنامه و خروج. .UNINDENT .SS "گزینه‌های KML (Google Earth)" .sp گزینه‌ها برای فراداده SuperOverlay تولیدشده Google Earth .INDENT 0.0 .TP .B \-k, \-\-force\-kml تولید KML برای Google Earth \- پیش‌فرض برای نمایه \(aqgeodetic\(aq و \(aqraster\(aq در EPSG:4326. برای مجموعه‌داده‌ای با تصویرسازی (projection) متفاوت با احتیاط استفاده شود! .UNINDENT .INDENT 0.0 .TP .B \-n, \-\-no\-kml جلوگیری از تولید خودکار فایل‌های KML برای EPSG:4326. .UNINDENT .INDENT 0.0 .TP .B \-u <URL>, \-\-url=<URL> نشانی URL که کاشی‌های تولیدشده قرار است در آن منتشر شوند. .UNINDENT .SS "گزینه‌های نمایشگر وب (Web viewer)" .sp گزینه‌ها برای نمایشگرهای HTML تولیدشده به سبک Google Maps .INDENT 0.0 .TP .B \-w <WEBVIEWER>, \-\-webviewer=<WEBVIEWER> نمایشگر وب برای تولید (all, google, openlayers, leaflet, mapml, none) \- پیش‌فرض \(aqall\(aq است. .UNINDENT .INDENT 0.0 .TP .B \-t <TITLE>, \-\-title=<TITLE> عنوان نقشه. .UNINDENT .INDENT 0.0 .TP .B \-c <COPYRIGHT>, \-\-copyright=<COPYRIGHT> حق نشر (کپی‌رایت) برای نقشه. .UNINDENT .INDENT 0.0 .TP .B \-g <GOOGLEKEY>, \-\-googlekey=<GOOGLEKEY> کلید API مربوط به Google Maps از \X'tty: link https://developers.google.com/maps/get-started'\fI\%https://developers.google.com/maps/get\-started\fP\X'tty: link'\&. .UNINDENT .INDENT 0.0 .TP .B \-b <BINGKEY>, \-\-bingkey=<BINGKEY> کلید API مربوط به Bing Maps از \X'tty: link https://www.bingmapsportal.com'\fI\%https://www.bingmapsportal.com\fP\X'tty: link' .UNINDENT.SS گزینه‌های MapML .sp پشتیبانی از MapML در GDAL 3.2 اضافه شده است. هنگامی که \-\-webviewer=mapml مشخص شود، \-\-xyz و همچنین در صورت استفاده از \-\-profile=geodetic، گزینه \-\-tmscompatible به‌طور ضمنی اعمال می‌شوند. .sp پروفایل‌های زیر پشتیبانی می‌شوند: .INDENT 0.0 .IP \(bu 2 mercator: به طرح کاشی‌کاری OSMTILE در MapML نگاشت می‌شود .IP \(bu 2 geodetic: به طرح کاشی‌کاری WGS84 در MapML نگاشت می‌شود .IP \(bu 2 APSTILE: برگرفته از فایل داده tms_MapML_APSTILE.json .UNINDENT .sp فایل MapML تولیدشده در پوشه خروجی \fBmapml.mapml\fP است. .sp گزینه‌های موجود عبارتند از: .INDENT 0.0 .TP .B \-\-mapml\-template=<filename> نام فایل یک فایل قالب mapml که متغیرها در آن جایگزین خواهند شد. در صورت عدم تعیین، از فایل عمومی template_tiles.mapml موجود در منابع داده GDAL استفاده خواهد شد .UNINDENT .sp گزینه \-\-url نیز برای جایگزینی \fB${URL}\fP در فایل قالب MapML استفاده می‌شود. .SS گزینه‌های WEBP .sp پشتیبانی از درایور کاشی WEBP در GDAL 3.6 اضافه شده است. این قابلیت با استفاده از \-\-tiledriver=WEBP فعال می‌شود. .sp گزینه‌های پیکربندی زیر برای سفارشی‌سازی بیشتر خروجی WebP در دسترس هستند: .INDENT 0.0 .TP .B \-\-webp\-quality=<QUALITY> شناسه QUALITY یک عدد صحیح بین 1\-100 است. پیش‌فرض 75 است. .UNINDENT .INDENT 0.0 .TP .B \-\-webp\-lossless استفاده از فشرده‌سازی بدون‌اتلاف (lossless) در WEBP، پیش‌فرض اتلافی (lossy) است .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 می‌توانید به مستندات \fI\%WEBP driver\fP در GDAL مراجعه کنید .UNINDENT .UNINDENT .SS گزینه‌های JPEG .sp پشتیبانی از درایور کاشی JPEG در GDAL 3.9 اضافه شده است. این قابلیت با استفاده از \-\-tiledriver=JPEG فعال می‌شود. .sp توجه داشته باشید که JPEG از شفافیت پشتیبانی نمی‌کند، از این رو کاشی‌های لبه در نواحی پوشش‌داده‌نشده توسط رستر مبدا، پیکسل‌های سیاه را نمایش خواهند داد. .sp گزینه‌های پیکربندی زیر برای سفارشی‌سازی بیشتر خروجی JPEG در دسترس هستند: .INDENT 0.0 .TP .B \-\-\-jpeg\-quality=JPEG_QUALITY شناسه QUALITY یک عدد صحیح بین 1\-100 است. پیش‌فرض 75 است. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال 1: مثال پایه .INDENT 0.0 .INDENT 3.5 .sp .EX gdal2tiles \-\-zoom=2\-5 input.tif output_folder .EE .UNINDENT .UNINDENT .SS مثال 2: تولید MapML .INDENT 0.0 .INDENT 3.5 .sp .EX gdal2tiles \-\-zoom=16\-18 \-w mapml \-p APSTILE \-\-url \(dqhttps://example.com\(dq input.tif output_folder .EE .UNINDENT .UNINDENT .SS مثال 3: مثال MPI .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .INDENT 3.5 .sp .EX mpiexec \-n $NB_PROCESSES gdal2tiles \-\-mpi \-\-config GDAL_CACHEMAX 500 \-\-zoom=2\-5 input.tif output_folder .EE .UNINDENT .UNINDENT .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Klokan Petr Pridal <klokan@klokan.cz> .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .