.\" 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_MERGE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal_merge \- موزاییک کردن مجموعه‌ای از تصاویر.
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_merge [\-\-help] [\-\-help\-general]
              [\-o <out_filename>] [\-of <out_format>] [\-co <NAME>=<VALUE>]...
              [\-ps <pixelsize_x> <pixelsize_y>] [\-tap] [\-separate] [\-q] [\-v] [\-pct]
              [\-ul_lr <ulx> <uly> <lrx> <lry>] [\-init \(dq<value>[ <value>]...\(dq]
              [\-n <nodata_value>] [\-a_nodata <output_nodata_value>]
              [\-ot <datatype>] [\-createonly] <input_file> [<input_file>]...
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
این ابزار به‌طور خودکار مجموعه‌ای از تصاویر را به‌صورت موزاییکی درمی‌آورد. تمام تصاویر باید در یک سامانهٔ مختصات یکسان بوده و تعداد باندهای برابری داشته باشند، اما می‌توانند هم‌پوشانی داشته و وضوح آن‌ها متفاوت باشد. در نواحی هم‌پوشانی، آخرین تصویر بر روی تصاویر قبلی رونویسی خواهد شد. مقادیر nodata/شفافیت (transparency) به‌صورت باند به باند در نظر گرفته می‌شوند؛ به این معنی که یک پیکسل nodata/شفاف در یک باند مبدأ، مقدار nodata/شفاف را روی تمام باندهای پیکسل مقصد در رستر حاصل اعمال نمی‌کند و همچنین مقادیر پیکسل‌های معتبر را بازنویسی نخواهد کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ابزار gdal_merge یک ابزار پایتونی است و تنها در صورتی در دسترس خواهد بود که بایندینگ‌های پایتون GDAL در دسترس باشند.
.UNINDENT
.UNINDENT
.sp
\fBنکتهٔ کاربردی:\fP
.INDENT 0.0
.INDENT 3.5
معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
دستور \fI\%gdal raster mosaic\fP را ببینید\&.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
نمایش یک پیام راهنمای مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-o <out_filename>
نام فایل خروجی که در صورت عدم وجود، ایجاد خواهد شد (پیش‌فرض: \(dqout.tif\(dq).
.UNINDENT
.INDENT 0.0
.TP
.B \-of <format>
انتخاب قالب خروجی. در صورت عدم تعیین، قالب از روی پسوند فایل حدس زده می‌شود. از نام کوتاه قالب استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-co <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینهٔ اختیاری ساخت دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای نمونه، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و کاشی‌بندی (tiled) بودن فایل پشتیبانی می‌کند.
.sp
گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینهٔ ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینهٔ خط فرمان
\fI\%\-\-format\fP
مشاهده کرد، اما مستندات قالب، منبع موثق و نهایی اطلاعات دربارهٔ گزینه‌های ساخت درایور است. برای مشاهدهٔ گزینه‌های ساخت مجاز هر قالب، مستندات اختصاصی قالب \fI\%Raster drivers\fP را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-ot <type>
اجبار باندهای تصویر خروجی به داشتن نوع داده‌ای خاص که توسط درایور پشتیبانی می‌شود؛ این مقدار می‌تواند یکی از موارد روبرو باشد: \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 \-ps <pixelsize_x> <pixelsize_y>
اندازهٔ پیکسل مورد استفاده برای فایل خروجی. در صورت عدم تعیین، وضوح اولین فایل ورودی استفاده خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-tap
(پیکسل‌های هم‌تراز با هدف - target aligned pixels) مختصات محدودهٔ فایل خروجی را با مقادیر \-tr تراز می‌کند، به‌گونه‌ای که محدودهٔ تراز‌شده شامل حداقل محدوده باشد. هم‌ترازی به این معنی است که مقادیر xmin / resx، ymin / resy، xmax / resx و ymax / resy اعدادی صحیح باشند.
.UNINDENT
.INDENT 0.0
.TP
.B \-ul_lr <ulx> <uly> <lrx> <lry>
محدودهٔ فایل خروجی. در صورت عدم تعیین، مجموع محدودهٔ همهٔ فایل‌های ورودی استفاده خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-quiet
نادیده گرفتن پیام‌های پیشرفت.
.UNINDENT
.INDENT 0.0
.TP
.B \-v
تولید خروجی پرجزئیات (verbose) از عملیات موزاییک‌سازی به هنگام انجام آن‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B \-separate
قرار دادن هر فایل ورودی در یک باند مجزا.
.UNINDENT
.INDENT 0.0
.TP
.B \-pct
دریافت یک جدول شبه‌رنگ (pseudo-color) از اولین تصویر ورودی و استفاده از آن برای خروجی. ادغام تصاویر شبه‌رنگی به این روش بر این فرض استوار است که همهٔ فایل‌های ورودی از جدول رنگ یکسانی استفاده می‌کنند.
.UNINDENT
.INDENT 0.0
.TP
.B \-n <nodata_value>
نادیده گرفتن پیکسل‌هایی از فایل‌های در حال ادغام که دارای این مقدار پیکسل هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-a_nodata <output_nodata_value>
اختصاص یک مقدار nodata مشخص به باندهای خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-init <\(dqvalue(s)\(dq>
مقداردهی اولیهٔ باندهای تصویر خروجی با این مقادیر. با این حال، در فایل خروجی به عنوان مقدار nodata علامت‌گذاری نمی‌شود. اگر تنها یک مقدار داده شود، همان مقدار در تمام باندها به کار می‌رود.
.UNINDENT
.INDENT 0.0
.TP
.B \-createonly
فایل خروجی ایجاد شده (و احتمالاً از پیش مقداردهی اولیه می‌شود)، اما هیچ داده‌ای از تصاویر ورودی در آن کپی نمی‌شود.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز تلقی می‌گردند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: ساخت تصویری با پیکسل‌های مقداردهی اولیه شده به 255 در تمام باندها
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_merge \-init 255 \-o out.tif in1.tif in2.tif
.EE
.UNINDENT
.UNINDENT
.SS مثال ۲: ساخت یک تصویر RGB با نمایش رنگ آبی در پیکسل‌های فاقد داده
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_merge \-init \(dq0 0 255\(dq \-o out.tif in1.tif in2.tif
.EE
.UNINDENT
.UNINDENT
.sp
دو باند اول با مقدار 0 و باند سوم با مقدار 255 مقداردهی اولیه خواهند شد.
.SS مثال ۳: ارسال فهرست بزرگی از فایل‌ها به gdal_merge
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ls \-1 *.tif > tiff_list.txt
.EE
.UNINDENT
.UNINDENT
.sp
می‌توان فهرست بزرگی از فایل‌ها را با فهرست کردن آن‌ها در یک فایل متنی با استفاده از دستور بالا در لینوکس، یا:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dir /b /s *.tif > tiff_list.txt
.EE
.UNINDENT
.UNINDENT
.sp
در ویندوز، به \fBgdal_merge\fP ارسال کرد. سپس می‌توان فایل متنی را با استفاده از \fI\-\-optfile\fP به \fBgdal_merge\fP منتقل کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_merge \-o mosaic.tif \-\-optfile tiff_list.txt
.EE
.UNINDENT
.UNINDENT
.SS مثال ۴: ساخت یک تصویر RGB با ادغام ۳ باند مختلف طیف خاکستری
.sp
عملیات «ادغام از طریق پشته‌سازی» (merging by stacking) را با پرچم \fI\%\-separate\fP انجام دهید. با فرض داشتن سه فایل مقیاس خاکستری که یک محدوده را پوشش می‌دهند، می‌توانید دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_merge \-separate 1.tif 2.tif 3.tif \-o rgb.tif
.EE
.UNINDENT
.UNINDENT
.sp
این دستور \fB1.tif\fP را به قرمز، \fB2.tif\fP را به سبز و \fB3.tif\fP را به آبی نگاشت می‌کند.
.SS مثال ۵: تعیین اولویت هم‌پوشانی
.sp
آخرین تصویر در خط ورودی، در بالای پشتهٔ تصویر نهایی قرار می‌گیرد. همچنین ممکن است برای مشخص کردن مقداری که اگر از قبل به عنوان nodata تعریف نشده است نباید در تصویر مقصد کپی شود، نیاز به استفاده از \fI\%\-n\fP داشته باشید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_merge \-o merge.tif \-n 0 image1.tif image2.tif image3.tif image4.tif
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer <silke@intevation.de>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.