'\" t .\" 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-RASTER-COLOR-BLEND" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-color-blend \- استفاده از یک رستر مقیاس خاکستری برای جایگزینی شدت نور در مجموعه داده‌های RGB/RGBA .sp در نسخه 3.12 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal raster blend [گزینه‌ها] آمیختگی/ترکیب دو مجموعه داده رستر آرگومان‌های موضعی: \-i, \-\-color\-input, \-\-input مجموعه داده رستر ورودی [الزامی] [در خطوط لوله در دسترس نیست] \-\-overlay مجموعه داده لایه رویی [الزامی] \-o, \-\-output مجموعه داده رستر خروجی [الزامی] [در خطوط لوله در دسترس نیست] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش شیوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (عدم نمایش نوار پیشرفت یا پیام‌های هشدار) [در خطوط لوله در دسترس نیست] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) [در خطوط لوله در دسترس نیست] \-\-co, \-\-creation\-option = گزینه ایجاد [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-overwrite آیا رونویسی روی مجموعه داده خروجی موجود مجاز است [در خطوط لوله در دسترس نیست] ناسازگار با \-\-append \-\-append افزودن به عنوان زیرمجموعه‌داده به خروجی موجود [در خطوط لوله در دسترس نیست] ناسازگار با \-\-overwrite \-\-operator عملگر ترکیب. OPERATOR=src\-over|hsv\-value|multiply|screen|overlay|hard\-light|darken|lighten|color\-dodge|color\-burn (پیش‌فرض: src\-over) \-\-opacity درصد کدر بودن برای اعمال روی مجموعه داده رویی (0=کاملاً شفاف، 100=استفاده کامل از کدری لایه رویی) (پیش‌فرض: 100) گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster blend\fP به کاربر امکان می‌دهد دو مجموعه داده رستر (با اندازه یکسان) را با استفاده از یک عملیات آمیختگی انتخابی و یک تنظیمات کدر بودن (شفافیت) ترکیب کند. .sp این قابلیت می‌تواند به عنوان مثال برای رنگ‌آمیزی یک رستر سایه‌روشن پستی‌بلندی‌ها (hillshade) تولید شده توسط \fI\%gdal raster hillshade\fP با استفاده از یک رندرینگ ارتفاع‌سنجی (هیپسومتریک) از مدل رقومی ارتفاع (DEM) تولید شده توسط \fI\%gdal raster color\-map\fP در هنگام استفاده از عملگر آمیختگی \fBhsv\-value\fP استفاده شود. .sp عملگر استانداردتر آمیختگی \fBsrc\-over\fP که «آمیختگی آلفا» (alpha blending) را انجام می‌دهد نیز در دسترس است. .sp این زیردستور همچنین به عنوان یک مرحله بالقوه از \fI\%gdal raster pipeline\fP در دسترس است. .SH "خروجی GDALG (مجموعه داده درجا / جریانی)" .sp این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس فایل حاصل می‌تواند با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه داده رستر باز شود و خط لوله مشخص‌شده را به صورت درجا (on\-the\-fly) یا جریانی (streamed) اعمال کند. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-input نام مجموعه داده‌ای که مجموعه داده رویی در آن ترکیب و آمیخته می‌شود. الزامی است. .sp هنگام استفاده از عملگر آمیختگی \fBhsv\-value\fP، این باید یک رستر بایت (Byte) سه‌بانده یا چهاربانده باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-opacity میزان کدر بودن (Opacity) برای استفاده در آمیختگی مجموعه داده رویی، به صورت درصدی بین 0 تا 100. مقدار 0 بدین معنی است که مجموعه داده رویی کاملاً شفاف در نظر گرفته می‌شود. مقدار 100 بدین معنی است که مجموعه داده رویی در حداکثر کانال آلفای خود آمیخته می‌شود. پیش‌فرض 100 است. .UNINDENT .INDENT 0.0 .TP .B \-\-operator src\-over|hsv\-value|multiply|screen|overlay|hard\-light|lighten|darken انتخاب عملگر آمیختگی، که مشخص می‌کند مجموعه داده رویی چگونه با مجموعه داده ورودی ترکیب شود. مقدار پیش‌فرض \fBsrc\-over\fP است. .sp برای جزئیات بیشتر درباره هر عملگر، بخش \fI\%جزئیات عملیات‌های آمیختگی\fP را در ادامه ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-overlay نام مجموعه داده رویی (اورلی). الزامی است. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append افزودن رستر ورودی به عنوان یک زیرمجموعه‌داده (subdataset) جدید به یک فایل خروجی موجود. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده‌ها پشتیبانی می‌کنند مانند \fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP\&. اگر مجموعه داده خروجی هنوز وجود نداشته باشد، آن را نیز ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های دقیق فایل ایجادشده استفاده کرد. به عنوان مثال، درایور GeoTIFF از گزینه‌های ایجاد برای کنترل فشرده‌سازی و کاشی‌بندی شدن فایل پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ایجاد موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای هر قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات خود قالب، منبع قطعی اطلاعات درباره گزینه‌های ایجاد درایور است. برای گزینه‌های ایجاد معتبر هر قالب، به مستندات ویژه قالب در \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/درایوری که باید برای باز کردن فایل(های) ورودی امتحان شود. به طور کلی نیازی به تعیین آن نیست، اما می‌توان از آن برای چشم‌پوشی از تشخیص خودکار درایور در مواردی که در انتخاب درایور مناسب ناموفق است استفاده کرد. این گزینه می‌تواند چندین بار تکرار شود تا چند درایور کاندید مشخص شوند. توجه داشته باشید که این گزینه آن درایورها را وادار به باز کردن مجموعه داده نمی‌کند. به ویژه، برخی درایورها الزاماتی روی پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه داده (ویژه قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format تعیین قالب رستر خروجی برای استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: \fBgdal \-\-formats | grep raster | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد تا در صورت وجود فایل یا مجموعه داده مقصد، آن را بازنویسی کند. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه داده مقصد از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .SH "جزئیات عملیات‌های آمیختگی (DETAILS OF BLENDING OPERATIONS)" .sp در توصیف عملیات‌های آمیختگی، تمام مقادیر به بازه [0,1] نرمال‌سازی شده‌اند و مقدار هر کانال از پیش در مقدار کانال آلفا ضرب شده است (premultiplied). .sp علائم و نمادهای زیر استفاده شده‌اند: .INDENT 0.0 .IP \(bu 2 نماد overlay_{C} مقدار یکی از مؤلفه‌های قرمز، سبز یا آبی مجموعه داده رویی است، .IP \(bu 2 نماد overlay_{A} مقدار مؤلفه آلفای مجموعه داده رویی ضرب‌شده در \fI\%\-\-opacity\fP است، .IP \(bu 2 نماد input_{C} مقدار مؤلفه متناظر مجموعه داده ورودی است، .IP \(bu 2 نماد input_{A} مقدار مؤلفه آلفای مجموعه داده ورودی است، .IP \(bu 2 نماد output_{C} مؤلفه حاصل در مجموعه داده خروجی است، .IP \(bu 2 نماد opacity مقدار \fI\%\-\-opacity\fP است. .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 به منظور کارایی، پیاده‌سازی به جای محاسبات ممیز شناور در بازه [0,1]، از محاسبات اعداد صحیح در بازه [0,255] استفاده می‌کند. این موضوع تفاوت‌های جزئی با فرمول‌های توصیف‌شده در ادامه را توضیح می‌دهد. .UNINDENT .UNINDENT .sp برای تمام عملگرها (مگر در مواردی که خلاف آن مشخص شده باشد) کانال آلفا به صورت زیر محاسبه می‌شود: .sp .ce output_{A} = overlay_{A} + input_{A} \- overlay_{A} * input_{A} .ce 0 .sp عملگرهای آمیختگی زیر در دسترس هستند: .SH "نمای کلی عملگرهای آمیختگی رستر (OVERVIEW OF RASTER BLEND OPERATORS)" .TS box center; l|l|l. T{ عملگر T} T{ توضیحات T} T{ مثال T} _ T{ \fBsrc\-over\fP T} T{ آمیختگی آلفای استاندارد (ترکیب لایه رویی روی ورودی) T} T{ [تصویر: نمونه آمیختگی src-over] [تصویر] T} _ T{ \fBhsv\-value\fP T} T{ استفاده از مقدار روشنایی (Value) از لایه رویی و فام/اشباع (Hue/Saturation) از ورودی T} T{ [تصویر: نمونه آمیختگی hsv-value] [تصویر] T} _ T{ \fBmultiply\fP T} T{ ضرب رنگ‌های ورودی و لایه رویی T} T{ [تصویر: نمونه آمیختگی multiply] [تصویر] T} _ T{ \fBscreen\fP T} T{ متمم کردن و سپس ضرب رنگ‌ها T} T{ [تصویر: نمونه آمیختگی screen] [تصویر] T} _ T{ \fBoverlay\fP T} T{ ترکیب حالت‌های ضرب (Multiply) و غربال (Screen) T} T{ [تصویر: نمونه آمیختگی overlay] [تصویر] T} _ T{ \fBhard\-light\fP T} T{ ضرب یا غربال بسته به روشنایی لایه رویی T} T{ [تصویر: نمونه آمیختگی hard-light] [تصویر] T} _ T{ \fBdarken\fP T} T{ نگه‌داشتن حداقل مؤلفه‌های ورودی و لایه رویی T} T{ [تصویر: نمونه آمیختگی darken] [تصویر] T} _ T{ \fBlighten\fP T} T{ نگه‌داشتن حداکثر مؤلفه‌های ورودی و لایه رویی T} T{ [تصویر: نمونه آمیختگی lighten] [تصویر] T} _ T{ \fBcolor\-dodge\fP T} T{ روشن‌تر کردن ورودی بر اساس لایه رویی T} T{ [تصویر: نمونه آمیختگی color-dodge] [تصویر] T} _ T{ \fBcolor\-burn\fP T} T{ تیره‌تر کردن ورودی بر اساس لایه رویی T} T{ [تصویر: نمونه آمیختگی color-burn] [تصویر] T} .TE .INDENT 0.0 .IP \(bu 2 .INDENT 2.0 .TP .B عملگر \fBsrc\-over\fP آمیختگی آلفای استاندارد را با ترکیب مجموعه داده رویی بر روی مجموعه داده ورودی انجام می‌دهد. .sp فرمول زیر برای هر یک از مؤلفه‌های قرمز، سبز و آبی اعمال می‌شود: .sp .ce output_{C} * output_{A} = (overlay_{C} * overlay_{A} * opacity) + (input_{C} * input_{A} * (1 \- overlay_{A} * opacity)) .ce 0 .UNINDENT .IP \(bu 2 .INDENT 2.0 .TP .B عملگر \fBhsv\-value\fP رنگی با مقدار روشنایی (Value) لایه رویی و فام (Hue) و اشباع (Saturation) ورودی ایجاد می‌کند. این عملگر مراحل زیر را انجام می‌دهد: .INDENT 7.0 .IP \(bu 2 خواندن مؤلفه‌های RGB (قرمز، سبز، آبی) مجموعه داده ورودی .IP \(bu 2 تبدیل مؤلفه‌های RGB به فضای رنگی HSV (فام، اشباع، روشنایی) .IP \(bu 2 محاسبه مقدار خروجی output_{V} با استفاده از فرمول زیر: .UNINDENT .sp .ce output_{V} = (overlay_{V} * overlay_{A} * opacity) + (input_{V} * (1 \- overlay_{A} * opacity)) .ce 0 .sp اگر مجموعه داده رویی یک مجموعه داده RGB/RGBA باشد، مقدار overlay_{V} برابر با max(overlay_{R},overlay_{G},overlay_{B}) خواهد بود\&. .INDENT 7.0 .IP \(bu 2 تبدیل مجدد (فام، اشباع، :math:\fIoutput_{V}\fP) به RGB. .UNINDENT .sp اگر کانال آلفای مجموعه داده ورودی وجود داشته باشد، بدون تغییر حفظ می‌شود. .UNINDENT .IP \(bu 2 .INDENT 2.0 .TP .B عملگر \fBmultiply\fP رنگ‌های ورودی و لایه رویی را در هم ضرب می‌کند. رنگ حاصل همواره دست‌کم به اندازه یکی از دو رنگ تشکیل‌دهنده تیره است. .sp فرمول زیر برای هر یک از مؤلفه‌های قرمز، سبز و آبی اعمال می‌شود: .sp .ce output_{C} = overlay_{C} * input_{C} + input_{C} * (1 \- overlay_{A}) + overlay_{C} * (1 \- input_{A}) .ce 0 .UNINDENT .IP \(bu 2 عملگر \fBscreen\fP: ورودی و لایه رویی متمم شده و سپس در هم ضرب می‌شوند. رنگ حاصل همواره دست‌کم به اندازه یکی از دو رنگ تشکیل‌دهنده روشن است. غربال کردن هر رنگی با رنگ سفید، رنگ سفید تولید می‌کند. غربال کردن هر رنگی با رنگ سیاه، رنگ اصلی را بدون تغییر باقی می‌گذارد. .INDENT 2.0 .INDENT 3.5 فرمول زیر برای هر یک از مؤلفه‌های قرمز، سبز و آبی اعمال می‌شود: .sp .ce output_{C} = overlay_{C} + input_{C} \- overlay_{C} * input_{C} .ce 0 .UNINDENT .UNINDENT .IP \(bu 2 عملگر \fBoverlay\fP: این عملگر حالت‌های آمیختگی Multiply (ضرب) و Screen (غربال) را با نصف قدرت ترکیب می‌کند. بخش‌هایی از لایه رویی که در آن‌ها لایه ورودی روشن است روشن‌تر می‌شوند و بخش‌هایی که در آن‌ها لایه ورودی تیره است تیره‌تر می‌شوند. نواحی که لایه رویی خاکستری میانه است بدون تغییر باقی می‌مانند. .INDENT 2.0 .INDENT 3.5 فرمول زیر برای هر یک از مؤلفه‌های قرمز، سبز و آبی اعمال می‌شود: .sp اگر مؤلفه ورودی کمتر از 0.5 باشد (تیره): .sp .ce output_{C} = 2 * overlay_{C} * input_{C} + input_{C} * (1 \- overlay_{A}) + overlay_{C} * (1 \- input_{A}) .ce 0 .sp اگر مؤلفه ورودی بزرگتر یا مساوی 0.5 باشد (روشن): .sp .ce output_{C} = overlay_{A} * input_{A} \- 2 * (input_{A} \- input_{C}) * (overlay_{A} \- overlay_{C}) + input_{C} * (1 \- overlay_{A}) + overlay_{C} * (1 \- input_{A}) .ce 0 .UNINDENT .UNINDENT .IP \(bu 2 عملگر \fBhard\-light\fP: لایه رویی بسته به مقدار رنگ لایه رویی، برای ضرب یا غربال ورودی استفاده می‌شود. اگر مقدار رنگ لایه رویی روشن‌تر از خاکستری 50% باشد، ورودی غربال می‌شود، در غیر این صورت ضرب می‌شود. این ویژگی برای افزودن هایلایت‌ها یا سایه‌ها به یک تصویر مفید است. پیاده‌سازی آن مشابه \fBoverlay\fP است اما نقش ورودی و لایه رویی با یکدیگر جابه‌جا شده است. .INDENT 2.0 .INDENT 3.5 فرمول زیر برای هر یک از مؤلفه‌های قرمز، سبز و آبی اعمال می‌شود: .sp اگر مؤلفه لایه رویی کمتر از 0.5 باشد (تیره): .sp .ce output_{C} = overlay_{A} * input_{A} \- 2 * (input_{A} \- input_{C}) * (overlay_{A} \- overlay_{C}) + input_{C} * (1 \- overlay_{A}) + overlay_{C} * (1 \- input_{A}) .ce 0 .sp اگر مؤلفه لایه رویی بزرگتر یا مساوی 0.5 باشد (روشن): .sp .ce output_{C} = 2 * overlay_{C} * input_{C} + input_{C} * (1 \- overlay_{A}) + overlay_{C} * (1 \- input_{A}) .ce 0 .UNINDENT .UNINDENT .IP \(bu 2 عملگر \fBdarken\fP: تصویری ایجاد می‌کند که کوچک‌ترین مؤلفه‌های پیکسل‌های ورودی و لایه رویی را حفظ می‌کند. اگر پیکسل لایه رویی دارای مؤلفه‌های r1، g1 و b1 باشد و پیکسل ورودی دارای r2، g2 و b2 باشد، پیکسل حاصل [min(r1,r2), min(g1,g2), min(b1,b2)] خواهد بود. .INDENT 2.0 .INDENT 3.5 فرمول زیر برای هر یک از مؤلفه‌های قرمز، سبز و آبی اعمال می‌شود: .sp .ce output_{C} = min(overlay_{C}, input_{C}) + input_{C} * (1 \- overlay_{A}) + overlay_{C} * (1 \- input_{A}) .ce 0 .UNINDENT .UNINDENT .IP \(bu 2 عملگر \fBlighten\fP: این عملگر عکس عمل Darken عمل می‌کند. حداکثر مقدار هر مؤلفه را از میان پیکسل‌های لایه رویی و ورودی انتخاب می‌کند. اگر پیکسل لایه رویی دارای مؤلفه‌های r1، g1 و b1 باشد و پیکسل ورودی دارای r2، g2 و b2 باشد، پیکسل حاصل [max(r1,r2), max(g1,g2), max(b1,b2)] خواهد بود. .INDENT 2.0 .INDENT 3.5 فرمول زیر برای هر یک از مؤلفه‌های قرمز، سبز و آبی اعمال می‌شود: .sp .ce output_{C} = max(overlay_{C}, input_{C}) + input_{C} * (1 \- overlay_{A}) + overlay_{C} * (1 \- input_{A}) .ce 0 .UNINDENT .UNINDENT .IP \(bu 2 عملگر \fBcolor\-dodge\fP: لایه ورودی را بر لایه رویی معکوس‌شده تقسیم می‌کند. این کار لایه ورودی را بسته به مقدار لایه رویی روشن‌تر می‌کند: هر چه لایه رویی روشن‌تر باشد، رنگ آن تأثیر بیشتری بر لایه ورودی می‌گذارد. آمیختگی هر رنگی با رنگ سفید منجر به رنگ سفید می‌شود. آمیختگی با رنگ سیاه تصویر را تغییر نمی‌دهد. .INDENT 2.0 .INDENT 3.5 فرمول زیر برای هر یک از مؤلفه‌های قرمز، سبز و آبی اعمال می‌شود: .sp اگر مقدار overlay_{C} * input_{A} بزرگتر یا مساوی overlay_{A} * input_{A} باشد: .sp .ce output_{C} = overlay_{A} * input_{A} + input_{C} * (1 \- overlay_{A}) + overlay_{C} * (1 \- input_{A}) .ce 0 .sp اگر مقدار overlay_{C} * input_{A} کمتر از overlay_{A} * input_{A} باشد: .sp .ce output_{C} = input_{C} * overlay_{A} / (1 \- overlay_{C} / overlay_{A}) + overlay_{C} * (1 \- input_{A}) + input_{C} * (1 \- overlay_{A}) .ce 0 .UNINDENT .UNINDENT .IP \(bu 2 عملگر \fBcolor\-burn\fP: لایه ورودی معکوس‌شده را بر لایه رویی تقسیم کرده و سپس نتیجه را معکوس می‌کند. این کار لایه رویی را تیره کرده و کنتراست را برای انعکاس رنگ لایه ورودی افزایش می‌دهد. هرچه لایه ورودی تیره‌تر باشد، رنگ آن بیشتر استفاده می‌شود. .INDENT 2.0 .INDENT 3.5 فرمول زیر برای هر یک از مؤلفه‌های قرمز، سبز و آبی اعمال می‌شود: .sp اگر مقدار overlay_{C} * input_{A} بزرگتر یا مساوی overlay_{A} * input_{A} باشد: .sp .ce output_{C} = overlay_{A} * input_{A} + input_{C} * (1 \- overlay_{A}) + overlay_{C} * (1 \- input_{A}) .ce 0 .sp اگر مقدار overlay_{C} * input_{A} کمتر از overlay_{A} * input_{A} باشد: .sp .ce output_{C} = input_{C} * overlay_{A} / (1 \- overlay_{C} / overlay_{A}) + overlay_{C} * (1 \- input_{A}) + input_{C} * (1 \- overlay_{A}) .ce 0 .UNINDENT .UNINDENT .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: آمیختگی آلفای دو مجموعه داده با استفاده از کدر بودن ۷۵٪ برای مجموعه داده رویی." .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster blend \-\-opacity 75 source.tif overlay.tif out.tif .EE .UNINDENT .UNINDENT .SS "مثال ۲: ترکیب یک رندرینگ سایه‌روشن پستی‌بلندی و ارتفاع‌سنجی از یک DEM در یک رستر سایه‌روشن رنگی با استفاده از عملگر آمیختگی hsv-value." [تصویر: رندرینگ سایه‌روشن پستی‌بلندی از DEM] [تصویر] [تصویر: رندرینگ ارتفاع‌سنجی از DEM] [تصویر] .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster blend \-\-overlay=hillshade.tif \-\-operator=hsv\-value \e hypsometric.tif hypsometric_combined_with_hillshade.tif .EE .UNINDENT .UNINDENT [تصویر: سایه‌روشن پستی‌بلندی رنگ‌آمیزی‌شده] [تصویر] .SS "مثال ۳: ترکیب یک رندرینگ سایه‌روشن پستی‌بلندی و ارتفاع‌سنجی از یک DEM در یک رستر سایه‌روشن رنگی با استفاده از عملگر آمیختگی multiply." .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster blend \-\-overlay=hillshade.tif \-\-operator=multiply \e hypsometric.tif hypsometric_combined_with_hillshade.tif .EE .UNINDENT .UNINDENT [تصویر: سایه‌روشن پستی‌بلندی رنگ‌آمیزی‌شده] [تصویر] .SS "مثال ۴: ترکیب یک رندرینگ سایه‌روشن پستی‌بلندی و ارتفاع‌سنجی از یک DEM در یک رستر سایه‌روشن رنگی با استفاده از عملگر آمیختگی screen." .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster blend \-\-overlay=hillshade.tif \-\-operator=screen \e hypsometric.tif hypsometric_combined_with_hillshade.tif .EE .UNINDENT .UNINDENT [تصویر: سایه‌روشن پستی‌بلندی رنگ‌آمیزی‌شده] [تصویر] .SS "مثال ۵: ترکیب یک رندرینگ سایه‌روشن پستی‌بلندی و ارتفاع‌سنجی از یک DEM در یک رستر سایه‌روشن رنگی با استفاده از عملگر آمیختگی overlay." .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster blend \-\-overlay=hillshade.tif \-\-operator=overlay \e hypsometric.tif hypsometric_combined_with_hillshade.tif .EE .UNINDENT .UNINDENT [تصویر: سایه‌روشن پستی‌بلندی رنگ‌آمیزی‌شده] [تصویر] .SS "مثال ۶: ترکیب یک رندرینگ سایه‌روشن پستی‌بلندی و ارتفاع‌سنجی از یک DEM در یک رستر سایه‌روشن رنگی با استفاده از عملگر آمیختگی hard-light." .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster blend \-\-overlay=hillshade.tif \-\-operator=hard\-light \e hypsometric.tif hypsometric_combined_with_hillshade.tif .EE .UNINDENT .UNINDENT [تصویر: سایه‌روشن پستی‌بلندی رنگ‌آمیزی‌شده] [تصویر] .SS "مثال ۷: ترکیب یک رندرینگ سایه‌روشن پستی‌بلندی و ارتفاع‌سنجی از یک DEM در یک رستر سایه‌روشن رنگی با استفاده از عملگر آمیختگی darken." .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster blend \-\-overlay=hillshade.tif \-\-operator=darken \e hypsometric.tif hypsometric_combined_with_hillshade.tif .EE .UNINDENT .UNINDENT [تصویر: سایه‌روشن پستی‌بلندی رنگ‌آمیزی‌شده] [تصویر] .SS "مثال ۸: ترکیب یک رندرینگ سایه‌روشن پستی‌بلندی و ارتفاع‌سنجی از یک DEM در یک رستر سایه‌روشن رنگی با استفاده از عملگر آمیختگی lighten." .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster blend \-\-overlay=hillshade.tif \-\-operator=lighten \e hypsometric.tif hypsometric_combined_with_hillshade.tif .EE .UNINDENT .UNINDENT [تصویر: سایه‌روشن پستی‌بلندی رنگ‌آمیزی‌شده] [تصویر] .SS "مثال ۹: ترکیب یک رندرینگ سایه‌روشن پستی‌بلندی و ارتفاع‌سنجی از یک DEM در یک رستر سایه‌روشن رنگی با استفاده از عملگر آمیختگی color-dodge." .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster blend \-\-overlay=hillshade.tif \-\-operator=color\-dodge \e hypsometric.tif hypsometric_combined_with_hillshade.tif .EE .UNINDENT .UNINDENT [تصویر: سایه‌روشن پستی‌بلندی رنگ‌آمیزی‌شده] [تصویر] .SS "مثال ۱۰: ترکیب یک رندرینگ سایه‌روشن پستی‌بلندی و ارتفاع‌سنجی از یک DEM در یک رستر سایه‌روشن رنگی با استفاده از عملگر آمیختگی color-burn." .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster blend \-\-overlay=hillshade.tif \-\-operator=color\-burn \e hypsometric.tif hypsometric_combined_with_hillshade.tif .EE .UNINDENT .UNINDENT [تصویر: سایه‌روشن پستی‌بلندی رنگ‌آمیزی‌شده] [تصویر] .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .