.\" 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_TRANSLATE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal_translate \- تبدیل داده‌های رستری میان قالب‌های مختلف .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal_translate [\-\-help] [\-\-long\-usage] [\-\-help\-general] [\-ot Byte|Int8|[U]Int{16|32|64}|CInt{16|32}|[C]Float{32|64}] [\-if ]... [\-of ] [\-\-quiet] [\-b ]... [\-mask ] [\-expand gray|rgb|rgba] [[\-strict]|[\-not_strict]] [\-outsize ] [\-tr ] [\-ovr |AUTO|AUTO\-|NONE] [\-sds] [\-r nearest,bilinear,cubic,cubicspline,lanczos,average,mode] [[\-scale [ [ ]]]...| [\-scale_X [ [ ]]]...| [\-unscale]] [[\-exponent ]|[\-exponent_X ]...] [\-srcwin ] [\-projwin ] [\-projwin_srs ] [\-epo] [\-eco] [\-a_srs ] [\-a_coord_epoch ] [\-a_ullr ] [\-a_nodata |none] [\-a_gt ] [\-a_scale ] [\-a_offset ] [\-nogcp] [\-gcp []]... [\-colorinterp {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...},...] [\-colorinterp_X {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...}]... [[\-stats]|[\-approx_stats]] [\-norat] [\-noxmp] [\-co =]... [\-mo =]... [\-dmo :=]... [\-oo =]... .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp ابزار \fBgdal_translate\fP می‌تواند برای تبدیل داده‌های رستری میان قالب‌های مختلف و احتمالاً انجام برخی عملیات مانند برش مکانی (subsetting)، بازنمونه‌برداری (resampling) و تغییر مقیاس پیکسل‌ها در طول این فرایند استفاده شود. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 معادل‌ها در رابط خط فرمان جدید \(dqgdal\(dq: .INDENT 0.0 .IP \(bu 2 \fI\%gdal raster convert\fP برای تبدیل قالب. .IP \(bu 2 \fI\%gdal raster clip\fP برای برش مکانی. .IP \(bu 2 \fI\%gdal raster nodata\-to\-alpha\fP برای افزودن کانال آلفا از مقادیر nodata. .IP \(bu 2 \fI\%gdal raster resize\fP برای تغییر اندازه تصویر. .IP \(bu 2 \fI\%gdal raster scale\fP برای مقیاس‌بندی مقادیر پیکسل. .IP \(bu 2 \fI\%gdal raster set\-type\fP برای تغییر نوع داده باند. .UNINDENT .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 \-ot اجبار باندهای تصویر خروجی به داشتن یک نوع داده مشخص که توسط درایور پشتیبانی می‌شود؛ می‌تواند یکی از موارد زیر باشد: \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\&. .UNINDENT .INDENT 0.0 .TP .B \-strict فعال‌سازی حالت سخت‌گیرانه. در این حالت، GDAL به جای انجام بی‌سروصدای عملیاتی که ممکن است منجر به از دست رفتن اطلاعات شوند (مانند تبدیل‌های نوع داده‌ای که نمی‌توانند دقیقاً حفظ شوند)، با شکست مواجه می‌شود. .sp رفتار دقیق این گزینه به درایور وابسته است. بیشتر درایورهای رستری از آن برای اعمال حفظ دقیق نوع داده ورودی استفاده می‌کنند و در صورتی که عملیات درخواستی نتواند بدون از دست رفتن داده انجام شود، خطا گزارش می‌دهند. \fI\%مثال ۵\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-if نام قالب/درایور برای اقدام به باز کردن فایل(های) ورودی. به‌طور کلی مشخص کردن آن ضروری نیست، اما می‌توان از آن برای چشم‌پوشی از تشخیص خودکار درایور، در زمان‌هایی که در انتخاب درایور مناسب ناموفق است، استفاده کرد. این گزینه می‌تواند چندین بار تکرار شود تا چندین درایور نامزد مشخص شوند. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند. به‌ویژه، برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند. .sp اضافه‌شده در نسخه 3.2. .UNINDENT .INDENT 0.0 .TP .B \-of انتخاب قالب خروجی. در صورت عدم تعیین، قالب از روی پسوند فایل حدس زده می‌شود. از نام کوتاه قالب استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-b انتخاب باند ورودی \fBband\fP برای خروجی. شماره‌گذاری باندها از ۱ است. می‌توان از چندین سوئیچ \fI\%\-b\fP برای انتخاب مجموعه‌ای از باندهای ورودی جهت نوشتن در فایل خروجی، یا برای مرتب‌سازی مجدد باندها استفاده کرد. \fBband\fP همچنین می‌تواند روی \(dqmask,1\(dq (یا فقط \(dqmask\(dq) تنظیم شود تا به معنی باند ماسکِ نخستین باند از مجموعه داده ورودی باشد. .UNINDENT .INDENT 0.0 .TP .B \-mask انتخاب یک باند ورودی \fBband\fP برای ایجاد باند ماسک مجموعه داده خروجی. شماره‌گذاری باندها از ۱ است. \fBband\fP می‌تواند روی \(dqnone\(dq تنظیم شود تا از کپی کردن ماسک سراسری مجموعه داده ورودی در صورت وجود جلوگیری کند. در غیر این صورت به‌طور پیش‌فرض کپی می‌شود (\(dqauto\(dq)، مگر اینکه ماسک یک کانال آلفا باشد، یا صراحتاً برای یک باند معمولی مجموعه داده خروجی استفاده شود (\(dq\-b mask\(dq). همچنین \fBband\fP می‌تواند روی \(dqmask,1\(dq (یا فقط \(dqmask\(dq) تنظیم شود تا به معنی باند ماسکِ باند اول مجموعه داده ورودی باشد. .UNINDENT .INDENT 0.0 .TP .B \-expand gray|rgb|rgba برای بازنمود یک مجموعه داده با ۱ باند دارای جدول رنگ به صورت یک مجموعه داده با ۳ باند (RGB) یا ۴ باند (RGBA). برای درایورهای خروجی مانند JPEG، JPEG2000، MrSID، ECW که از مجموعه‌داده‌های دارای شاخص رنگ پشتیبانی نمی‌کنند مفید است. مقدار \(aqgray\(aq امکان بسط یک مجموعه داده دارای جدول رنگ را که تنها حاوی سطوح خاکستری است به یک مجموعه داده با شاخص خاکستری فراهم می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-outsize [%]|0 [%]|0 تنظیم اندازه فایل خروجی. اندازه خروجی بر حسب پیکسل و سطر است، مگر اینکه \(aq%\(aq اضافه شده باشد که در این صورت به عنوان کسری از اندازه تصویر ورودی خواهد بود. اگر یکی از این ۲ مقدار روی 0 تنظیم شود، مقدار آن از روی مقدار دیگر و با حفظ نسبت ابعاد مجموعه داده منبع تعیین خواهد شد. .UNINDENT .INDENT 0.0.TP .B \-tr تنظیم تفکیک‌پذیری هدف. مقادیر باید در واحدهای زمین‌مرجع‌شده (georeferenced) بیان شوند. هر دو باید مقادیر مثبتی باشند. این گزینه با \fI\%\-outsize\fP، \fI\%\-a_ullr\fP و \fI\%\-a_gt\fP ناسازگار (مانعة‌الجمع) است\&. .UNINDENT .INDENT 0.0 .TP .B \-ovr {|AUTO|AUTO\-|NONE} در نگارش 3.6 اضافه شد. .sp برای تعیین اینکه کدام سطح نمای کلی (overview) فایل منبع باید استفاده شود. انتخاب پیش‌فرض، AUTO، سطحی از نمای کلی را انتخاب می‌کند که تفکیک‌پذیری آن به تفکیک‌پذیری هدف نزدیک‌تر باشد. برای انتخاب سطحی خاص، یک مقدار عدد صحیح (مبتنی بر صفر، یعنی 0=نخستین سطح نمای کلی) مشخص کنید. عبارت AUTO\-n را که در آن n یک عدد صحیح بزرگ‌تر یا مساوی با 1 است مشخص کنید تا سطح نمای کلی زیر AUTO انتخاب شود. یا NONE را مشخص کنید تا استفاده از تفکیک‌پذیری پایه اجبار شود (می‌تواند زمانی مفید باشد که نماهای کلی با یک روش بازنمونه‌برداری کم‌کیفیت ایجاد شده باشند، و یک روش بازنمونه‌برداری باکیفیت‌تر توسط \fI\%\-r\fP تعیین شده باشد\&.) .sp هنگامی که \fI\%\-ovr\fP به صورت یک مقدار عدد صحیح مشخص شده باشد و هیچ‌کدام از \fI\%\-outsize\fP یا \fI\%\-tr\fP تعیین نشده باشند، اندازه نمای کلی به عنوان اندازه خروجی استفاده خواهد شد. .sp هنگامی که \fI\%\-ovr\fP مشخص شده باشد، مقادیر \fI\%\-srcwin\fP باید به صورت آفست پیکسلی و اندازه مجموعه‌داده منبع با تفکیک‌پذیری کامل بیان شوند. به همین ترتیب، هنگام استفاده از \fI\%\-outsize\fP با مقادیر درصدی، آن‌ها به اندازه مجموعه‌داده منبع با تفکیک‌پذیری کامل اشاره دارند. .UNINDENT .INDENT 0.0 .TP .B \-r {nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode} انتخاب الگوریتم بازنمونه‌برداری (resampling). .sp \fBnearest\fP (پیش‌فرض) یک بازنمونه‌بردار نزدیک‌ترین همسایه (نمونه‌برداری ساده) را اعمال می‌کند. .sp \fBaverage\fP میانگین تمام پیکسل‌های مشارکت‌کننده غیر NODATA را محاسبه می‌کند. از GDAL 3.1 به بعد، این یک میانگین وزنی است که وزن پیکسل‌های منبعی را که به طور کامل در پیکسل هدف مشارکت ندارند، به درستی لحاظ می‌کند. .sp \fBrms\fP ریشه میانگین مربعات / میانگین مربعی تمام پیکسل‌های مشارکت‌کننده غیر NODATA را محاسبه می‌کند (GDAL >= 3.3). .sp \fBbilinear\fP یک هسته پیچش درون‌یابی دوخطی (bilinear) را اعمال می‌کند. .sp \fBcubic\fP یک هسته پیچش مکعبی (cubic) را اعمال می‌کند. .sp \fBcubicspline\fP یک هسته پیچش B\-Spline اعمال می‌کند. .sp \fBlanczos\fP یک هسته پیچش سینک پنجره‌دار لانچوس (Lanczos windowed sinc) را اعمال می‌کند. .sp \fBmode\fP مقداری را انتخاب می‌کند که بیشترین تکرار را در بین تمام نقاط نمونه‌برداری‌شده دارد. .UNINDENT .INDENT 0.0 .TP .B \-scale [ [ ]] تغییر مقیاس مقادیر پیکسل‌های ورودی از بازه \fBsrc_min\fP تا \fBsrc_max\fP به بازه \fBdst_min\fP تا \fBdst_max\fP\&. در صورت حذف شدن، بازه خروجی از کمترین مقدار تا بیشترین مقدار مجاز برای انواع داده عدد صحیح (به عنوان مثال از 0 تا 255 برای خروجی Byte) یا از 0 تا 1 برای انواع داده ممیز شناور خواهد بود. در صورت حذف شدن، بازه ورودی به طور خودکار از کل مجموعه‌داده منبع محاسبه می‌شود (نه فقط پنجره مورد نظر که احتمالاً توسط \fI\%\-srcwin\fP یا \fI\%\-projwin\fP مشخص شده است). این ممکن است در مجموعه‌داده‌های منبع بزرگ عملیاتی کند باشد، و در صورت استفاده چندباره از آن برای فراخوانی‌های متعدد gdal_translate، ممکن است فراخوانی پیشین \fBgdalinfo \-stats {source_dataset}\fP برای پیش‌محاسبه آمار، برای فرمت‌هایی که از ذخیره‌سازی محاسبات آماری پشتیبانی می‌کنند (GeoTIFF، VRT...) سودمند باشد. توجه داشته باشید که مقادیر مشخص‌شده پس از \fI\%\-scale\fP تنها برای محاسبه یک مقیاس و آفست جهت اعمال روی مقادیر رستر ورودی استفاده می‌شوند. به ویژه، \fBsrc_min\fP و \fBsrc_max\fP برای برش دادن (clip) مقادیر ورودی استفاده نمی‌شوند مگر اینکه \fI\%\-exponent\fP نیز مشخص شده باشد. به جای بریده شدن، مقادیر منبعی که خارج از بازه \fBsrc_min\fP و \fBsrc_max\fP هستند، به مقادیری خارج از بازه \fBdst_min\fP و \fBdst_max\fP مقیاس‌بندی می‌شوند\&. اگر برش دادن بدون مقیاس‌بندی نمایی مورد نظر باشد، می‌توان از \fB\-exponent 1\fP استفاده کرد. گزینه \fI\%\-scale\fP می‌تواند چندین بار تکرار شود (در صورت مشخص شدنِ تنها یک بار، برای تمام باندهای مجموعه‌داده خروجی نیز اعمال می‌شود) تا پارامترها به ازای هر باند مشخص شوند. همچنین امکان استفاده از ساختار \fB\-scale_bn\fP وجود دارد که در آن bn شماره باند است (مانند \fB\-scale_2\fP برای باند دوم مجموعه‌داده خروجی) تا پارامترهای یک یا چند باند خاص تعیین گردند. .UNINDENT .INDENT 0.0 .TP .B \-exponent اعمال مقیاس‌بندی غیرخطی با یک تابع توانی. مقدار \fBexp_val\fP توانِ تابع توانی است (باید مثبت باشد). این گزینه باید همراه با گزینه \fI\%\-scale\fP استفاده شود. اگر تنها یک بار مشخص شود، \fI\%\-exponent\fP برای تمام باندهای تصویر خروجی اعمال می‌شود. این گزینه می‌تواند چندین بار تکرار شود تا پارامترها به ازای هر باند مشخص شوند. همچنین استفاده از ساختار \fB\-exponent_bn\fP که در آن bn شماره باند است (مانند \fB\-exponent_2\fP برای باند دوم مجموعه‌داده خروجی) برای تعیین پارامترهای یک یا چند باند مشخص امکان‌پذیر است. .sp مقدار مقیاس‌شده \fBDst\fP از مقدار منبع \fBSrc\fP با فرمول زیر محاسبه می‌شود: .sp .ce {Dst} = \eleft( {Dst}_{max} \- {Dst}_{min} \eright) \etimes \eoperatorname{max} \eleft( 0, \eoperatorname{min} \eleft( 1, \eleft( \efrac{{Src} \- {Src}_{min}}{{Src}_{max}\-{Src}_{min}} \eright)^{exp\e_val} \eright) \eright) + {Dst}_{min} .ce 0 .UNINDENT .INDENT 0.0 .TP .B \-unscale اعمال فراداده مقیاس/آفست (scale/offset) برای باندها جهت تبدیل مقادیر دارای مقیاس خطی به مقادیر بدون مقیاس. همچنین اغلب لازم است که نوع داده خروجی توسط سوییچ \fI\%\-ot\fP بازنشانی شود. مقدار بدون مقیاس از مقدار خام مقیاس‌شده با فرمول زیر محاسبه می‌شود: .sp .ce {unscaled\e_value} = {scaled\e_value} * {scale} + {offset} .ce 0 .UNINDENT .INDENT 0.0 .TP .B \-srcwin یک پنجره فرعی را برای کپی‌کردن بر اساس موقعیت پیکسل/سطر از تصویر منبع انتخاب می‌کند. آفست‌های پیکسل/سطر (\fBxoff\fP و \fByoff\fP) از گوشه بالا و سمت چپ تصویر اندازه‌گیری می‌شوند. اگر پنجره فرعی فراتر از محدوده‌های مجموعه‌داده منبع امتداد یابد، پیکسل‌های خروجی با مقدار صفر نوشته خواهند شد، مگر اینکه یک مقدار NoData در مجموعه‌داده منبع یا توسط \fI\%\-a_nodata\fP تعریف شده باشد\&. در غیر این صورت، چنانچه توسط گزینه‌های \fI\%\-epo\fP یا \fI\%\-eco\fP تعیین شده باشد، دستور \fBgdal_translate\fP می‌تواند در این شرایط یک خطا صادر کند\&. .UNINDENT .INDENT 0.0 .TP .B \-projwin یک پنجره فرعی را از تصویر منبع برای کپی‌کردن (مشابه \fI\%\-srcwin\fP) انتخاب می‌کند اما با گوشه‌هایی که در مختصات زمین‌مرجع‌شده داده شده‌اند (به طور پیش‌فرض در SRS مجموعه‌داده بیان می‌شود. با \fI\%\-projwin_srs\fP قابل تغییر است). اگر پنجره فرعی فراتر از محدوده‌های مجموعه‌داده منبع امتداد یابد، پیکسل‌های خروجی با مقدار صفر نوشته خواهند شد، مگر اینکه یک مقدار NoData در مجموعه‌داده منبع یا توسط \fI\%\-a_nodata\fP تعریف شده باشد\&. در غیر این صورت، چنانچه توسط گزینه‌های \fI\%\-epo\fP یا \fI\%\-eco\fP تعیین شده باشد، \fBgdal_translate\fP می‌تواند در این شرایط یک خطا صادر کند\&. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 از GDAL 3.11 به بعد، محدوده توصیف‌شده توسط \fI\%\-projwin\fP به SRS مجموعه‌داده تبدیل شده و برای انتخاب پنجره فرعی استفاده خواهد شد. پیش از GDAL 3.11، تنها دو نقطه گوشه به SRS مجموعه‌داده تبدیل می‌شدند، و از این دو نقطه تبدیل‌شده برای تعریف یک محدوده در SRS مجموعه‌داده استفاده می‌شد. بسته به SRS مورد استفاده، پنجره فرعی انتخاب‌شده در GDAL 3.11 ممکن است به طور قابل توجهی بزرگ‌تر از نگارش‌های پیشین باشد. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 هنگام استفاده از بازنمونه‌برداری نزدیک‌ترین همسایه، پنجره مشخص‌شده توسط \fI\%\-projwin\fP در صورت لزوم گسترش می‌یابد (برای GDAL < 3.11 گرد می‌شود) تا با مرزهای پیکسل‌های ورودی همخوانی داشته باشد. برای سایر الگوریتم‌های بازنمونه‌برداری، پنجره تغییری نمی‌کند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-projwin_srs سیستم مرجع مکانی (SRS) را که مختصات ارائه‌شده با \fI\%\-projwin\fP باید در آن تفسیر شوند مشخص می‌کند\&. مقدار می‌تواند هر یک از قالب‌های معمول GDAL/OGR، قالب کامل WKT، PROJ.4، EPSG:n یا فایلی حاوی WKT باشد. .sp \fBهشدار:\fP .INDENT 7.0 .INDENT 3.5 این کار باعث بازپرتواَفکنی مجموعه‌داده به SRS مشخص‌شده نمی‌شود. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-epo (خطا هنگام قرارگیری جزئی در خارج / Error when Partially Outside) اگر این گزینه تنظیم شود، مقادیر \fI\%\-srcwin\fP یا \fI\%\-projwin\fP که تا حدی خارج از محدوده رستر منبع قرار می‌گیرند، به عنوان خطا در نظر گرفته خواهند شد. رفتار پیش‌فرض پذیرش چنین درخواست‌هایی است. .UNINDENT .INDENT 0.0.TP .B \-eco (Error when Completely Outside) همانند \fI\%\-epo\fP، با این تفاوت که معیار صدور خطا، قرار گرفتن کامل درخواست در خارج از محدوده رستر منبع است. .UNINDENT .INDENT 0.0 .TP .B \-a_srs بازنویسی سیستم تصویر فایل خروجی. می‌تواند همراه با \fI\%\-a_ullr\fP یا \fI\%\-a_gt\fP برای تعیین محدوده در این سیستم تصویر استفاده شود. .sp سیستم‌های مرجع مختصاتی که می‌توان ارسال کرد، هر موردی است که توسط فراخوانی \fI\%OGRSpatialReference::SetFromUserInput()\fP پشتیبانی می‌شود؛ از جمله CRSهای تصویرشده، جغرافیایی یا مرکب EPSG (مانند EPSG:4296)، یک تعریف CRS به زبان متن شناخته‌شده (WKT)، اعلان‌های PROJ.4، یا نام یک فایل .prj حاوی تعریف WKT CRS. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 هیچ تصویر مجددی انجام نمی‌شود. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-a_coord_epoch در نسخه 3.4 اضافه شد. .sp اختصاص یک دوره زمانی مختصات (coordinate epoch)، مرتبط با SRS خروجی. زمانی کاربرد دارد که SRS خروجی یک CRS پویا باشد. .UNINDENT .INDENT 0.0 .TP .B \-a_scale تنظیم مقدار مقیاس‌بندی باند. هیچ تغییری در مقادیر پیکسل‌ها داده نمی‌شود. توجه داشته باشید که \fI\%\-unscale\fP گزینه \fI\%\-a_scale\fP را لحاظ نمی‌کند. برای مثال می‌توانید \fB\-scale 0 1 \fP را برای اعمال چندتایی (offset, scale) مشخص کنید، به عنوان معادل این ۲ مرحله: \fBgdal_translate input.tif tmp.vrt \-a_scale scale \-a_offset offset\fP و به دنبال آن \fBgdal_translate tmp.vrt output.tif \-unscale\fP .UNINDENT .INDENT 0.0 .TP .B \-a_offset تنظیم مقدار آفست باند. هیچ تغییری در مقادیر پیکسل‌ها داده نمی‌شود. توجه داشته باشید که \fI\%\-unscale\fP گزینه \fI\%\-a_offset\fP را لحاظ نمی‌کند. برای مثال می‌توانید \fB\-scale 0 1 \fP را برای اعمال چندتایی (offset, scale) مشخص کنید، به عنوان معادل این ۲ مرحله: \fBgdal_translate input.tif tmp.vrt \-a_scale scale \-a_offset offset\fP و به دنبال آن \fBgdal_translate tmp.vrt output.tif \-unscale\fP .UNINDENT .INDENT 0.0 .TP .B \-a_ullr اختصاص/بازنویسی مرزهای زمین‌مرجع فایل خروجی. این گزینه مرزهای زمین‌مرجع را به فایل خروجی اختصاص می‌دهد و آنچه را که از فایل منبع مشتق می‌شد نادیده می‌گیرد. بنابراین این کار باعث تغییر سیستم تصویر به SRS مشخص‌شده نمی‌شود. این گزینه با \fI\%\-a_gt\fP مانعة‌الجمع است. .UNINDENT .INDENT 0.0 .TP .B \-a_gt اختصاص/بازنویسی تبدیل زمین‌مرجع (geotransform) فایل خروجی. این گزینه تبدیل زمین‌مرجع را به فایل خروجی اختصاص می‌دهد و آنچه را که از فایل منبع مشتق می‌شد نادیده می‌گیرد. بنابراین این کار باعث تغییر سیستم تصویر به SRS مشخص‌شده نمی‌شود. به \fI\%Geotransform Tutorial\fP مراجعه کنید. این گزینه با \fI\%\-a_ullr\fP مانعة‌الجمع است. .sp در نسخه 3.8 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-a_nodata اختصاص یک مقدار nodata مشخص به باندهای خروجی. در صورتی که فایل منبع دارای مقدار nodata باشد، این گزینه می‌تواند روی \fBnone\fP تنظیم شود تا از اختصاص مقدار nodata به فایل خروجی جلوگیری شود. توجه داشته باشید که اگر مجموعه داده ورودی مقداری برای nodata داشته باشد، این گزینه باعث تغییر مقادیر پیکسلی که برابر با آن مقدار nodata هستند به مقدار مشخص‌شده با این گزینه نمی‌شود. .UNINDENT .INDENT 0.0 .TP .B \-colorinterp_X بازنویسی تفسیر رنگ باند X (که در آن X شماره باند معتبری است که از ۱ شروع می‌شود). .UNINDENT .INDENT 0.0 .TP .B \-colorinterp {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...},... بازنویسی تفسیر رنگ تمام باندهای مشخص‌شده. برای مثال \-colorinterp red,green,blue,alpha برای یک مجموعه داده خروجی ۴ بانده. .UNINDENT .INDENT 0.0 .TP .B \-mo = ارسال یک کلید و مقدار فراداده (metadata) برای تنظیم روی مجموعه داده خروجی در صورت امکان. .UNINDENT .INDENT 0.0 .TP .B \-dmo DOMAIN:META\-TAG=VALUE ارسال یک کلید و مقدار فراداده در دامنه (domain) مشخص‌شده برای تنظیم روی مجموعه داده خروجی در صورت امکان. .sp در نسخه 3.9 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-co = بسیاری از قالب‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های مربوط به فایل ایجادشده استفاده کرد. برای مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و اینکه آیا فایل باید کاشی‌بندی (tiled) شود، پشتیبانی می‌کند. .sp گزینه‌های ساخت موجود بر اساس درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-format\fP مشاهده کرد، اما مستندات قالب، منبع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای مشاهده گزینه‌های ساخت معتبر برای هر قالب، به مستندات اختصاصی قالب در \fI\%Raster drivers\fP مراجعه کنید. .sp علاوه بر گزینه‌های ساخت اختصاصی درایور، ابزار gdal_translate (و \fI\%GDALTranslate()\fP و \fI\%GDALCreateCopy()\fP) گزینه‌های زیر را تشخیص می‌دهند: .INDENT 7.0 .IP \(bu 2 \fBAPPEND_SUBDATASET=[YES​/​NO]: \fP پیش‌فرض آن \fBNO\fP است. .sp می‌تواند روی YES تنظیم شود تا از تخریب قبلی مجموعه داده موجود جلوگیری شود، برای درایورهایی که از افزودن چندین زیرمجموعه داده پشتیبانی می‌کنند (مانند GTIFF و NITF). .IP \(bu 2 \fBCOPY_SRC_MDD=[AUTO​/​YES​/​NO]: \fP (GDAL >= 3.8) پیش‌فرض آن \fBAUTO\fP است. .sp مشخص می‌کند که آیا دامنه‌های فراداده مجموعه داده منبع باید به مجموعه داده مقصد کپی شوند یا خیر. در حالت پیش‌فرض AUTO، فقط دامنه‌های \(dqامن\(dq (safe) کپی خواهند شد، که شامل دامنه فراداده پیش‌فرض است (برخی درایورها ممکن است دامنه‌های دیگری مانند IMD، RPC و GEOLOCATION را نیز شامل شوند). هنگام تنظیم روی YES، همه دامنه‌ها کپی خواهند شد (به جز معدودی دامنه‌های رزروشده مانند IMAGE_STRUCTURE یا DERIVED_SUBDATASETS). در حال حاضر فقط توسط درایورهای GTiff، COG، VRT، PNG و JPEG پشتیبانی می‌شود. .sp هنگام تنظیم روی NO، هیچ فراداده‌ای از منبع کپی نخواهد شد. .IP \(bu 2 \fBSRC_MDD=: \fP (GDAL >= 3.8) .sp مشخص می‌کند کدام دامنه فراداده منبع باید کپی شود. این گزینه فهرست دامنه‌های فراداده منبع که باید کپی شوند را محدود می‌کند (در صورت تنظیم نشدن، متضمن COPY_SRC_MDD=YES است). این گزینه را می‌توان به تعداد دامنه‌های منبع مشخص کرد. دامنه فراداده پیش‌فرض، رشته خالی \(dq\(dq است (زمانی که رشته خالی عملی نباشد، می‌توان از \(dq_DEFAULT_\(dq نیز استفاده کرد). در حال حاضر فقط توسط درایورهای GTiff، COG، VRT، PNG و JPEG پشتیبانی می‌شود. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-nogcp GCPهای موجود در مجموعه داده منبع در مجموعه داده خروجی کپی نشوند. .UNINDENT .INDENT 0.0 .TP .B \-gcp [] افزودن نقطه کنترل زمینی مشخص‌شده به مجموعه داده خروجی. این گزینه می‌تواند چندین بار برای ارائه مجموعه‌ای از GCPها مشخص شود. .UNINDENT .INDENT 0.0 .TP .B \-q جلوگیری از نمایش ناظر پیشرفت و سایر خروجی‌های غیرخطا. .UNINDENT .INDENT 0.0 .TP .B \-sds کپی کردن تمام زیرمجموعه‌های داده این فایل به فایل‌های خروجی مجزا. برای قالب‌هایی مانند HDF که دارای زیرمجموعه داده (subdataset) هستند استفاده می‌شود. .UNINDENT .INDENT 0.0.TP .B \-stats اجبار به محاسبه (یا محاسبه مجدد) آمارها. .UNINDENT .INDENT 0.0 .TP .B \-norat عدم کپی RAT منبع در مجموعه‌داده مقصد. .UNINDENT .INDENT 0.0 .TP .B \-noxmp عدم کپی فراداده XMP موجود در مجموعه‌داده منبع به مجموعه‌داده خروجی، زمانی که درایور قادر به کپی آن باشد. .sp در نسخه 3.2 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-oo = گزینه باز کردن مجموعه‌داده (وابسته به قالب). .UNINDENT .INDENT 0.0 .TP .B نام مجموعه‌داده منبع. می‌تواند نام فایل، URL منبع داده یا نام زیرمجموعه‌داده برای فایل‌های چندمجموعه‌داده‌ای باشد. .UNINDENT .INDENT 0.0 .TP .B نام فایل مقصد. .UNINDENT .SH "مدیریت NODATA / ماسک اعتبار منبع در حین بازنمونه‌برداری (NODATA / SOURCE VALIDITY MASK HANDLING DURING RESAMPLING)" .sp مقادیر ماسک‌شده، چه از طریق فراداده مقدار nodata تنظیم‌شده روی باند منبع شناسایی شده باشند، چه یک باند ماسک یا یک باند آلفا، در حین بازنمونه‌برداری (هنگام استفاده از \fI\%\-outsize\fP یا \fI\%\-tr\fP) استفاده نخواهند شد. .sp جزئیات نحوه در نظر گرفته شدن آن به هسته بازنمونه‌برداری بستگی دارد: .INDENT 0.0 .IP \(bu 2 برای بازنمونه‌برداری nearest، برای هر پیکسل هدف، یکی از پیکسل‌های منبع با احتمال مشارکت (به روشی وابسته به پیاده‌سازی) انتخاب می‌شود. مقدار آن به همان صورت استفاده می‌شود، خواه معتبر باشد یا نامعتبر. .IP \(bu 2 برای bilinear، cubic، cubicspline و lanczos، برای هر پیکسل هدف، وزن پیکسل‌های منبع مشارکت‌کننده در صورت ماسک بودن روی صفر تنظیم می‌شود تا نادیده گرفته شوند. یک ویژگی خاص دیگر برای cubic و lanczos وجود دارد: با توجه به اینکه برخی از وزن‌ها در هسته منفی هستند، چنین راهبردی می‌تواند در صورت تناوب پیکسل‌های معتبر و نامعتبر منجر به overshoot/undershoot شدیدی شود. در نتیجه، در صورتی که در هر یک از جهات افقی یا عمودی، حداکثر تعداد پیکسل‌های معتبر منبع در هر بُعد کمتر از شعاع هسته بازنمونه‌برداری باشد، پیکسل هدف به عنوان nodata در نظر گرفته می‌شود. .IP \(bu 2 برای سایر روش‌های بازنمونه‌برداری، پیکسل‌های منبع مشارکت‌کننده در پیکسل هدف در صورت ماسک بودن نادیده گرفته می‌شوند. تنها پیکسل‌های معتبر در نظر گرفته می‌شوند. در صورتی که هیچ پیکسلی وجود نداشته باشد، پیکسل هدف به عنوان nodata لحاظ می‌شود. .UNINDENT .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "رابط برنامه‌نویسی C (C API)" .sp این ابزار همچنین از طریق C با \fI\%GDALTranslate()\fP\& قابل فراخوانی است. .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: ایجاد یک GeoTIFF کاشی‌بندی‌شده (Tiled)" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_translate \-of GTiff \-co \(dqTILED=YES\(dq utm.tif utm_tiled.tif .EE .UNINDENT .UNINDENT .SS "مثال ۲: ایجاد یک TIFF فشرده‌شده با JPEG همراه با ماسک داخلی از یک مجموعه‌داده RGBA" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_translate rgba.tif withmask.tif \-b 1 \-b 2 \-b 3 \-mask 4 \-co COMPRESS=JPEG \e \-co PHOTOMETRIC=YCBCR \-\-config GDAL_TIFF_INTERNAL_MASK YES .EE .UNINDENT .UNINDENT.SS "مثال ۳: ایجاد یک مجموعه‌داده RGBA از یک مجموعه‌داده RGB همراه با ماسک" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_translate withmask.tif rgba.tif \-b 1 \-b 2 \-b 3 \-b mask .EE .UNINDENT .UNINDENT .SS "مثال ۴: استخراج زیرمجموعه با استفاده از \-projwin و \-outsize" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_translate \-projwin \-20037500 10037500 0 0 \-outsize 100 100 frmt_wms_googlemaps_tms.xml junk.png .EE .UNINDENT .UNINDENT .SS "مثال ۵: استفاده از حالت سخت‌گیرانه با نوع داده پشتیبانی‌نشده" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal_create test.tif \-bands 3 \-ot Int16 \-outsize 1 1 $ gdal_translate \-strict test.tif test.webp ERROR 6: WEBP driver doesn\(aqt support data type Int16. Only UInt8 bands supported. .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Frank Warmerdam , Silke Reimer .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .