.\" 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-MAP" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-color-map \- تولید یک مجموعه داده RGB یا RGBA از یک تک‌باند با استفاده از نقشه‌ی رنگ .sp افزوده‌شده در نسخه 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster color\-map [OPTIONS] Generate a RGB or RGBA dataset from a single band, using a color map Positional arguments: \-i, \-\-input Input raster datasets [required] [not available in pipelines] \-o, \-\-output Output raster dataset [required] [not available in pipelines] Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] \-q, \-\-quiet Quiet mode (no progress bar or warning message) [not available in pipelines] Options: \-f, \-\-of, \-\-format, \-\-output\-format Output format (\(dqGDALG\(dq allowed) [not available in pipelines] \-\-co, \-\-creation\-option = Creation option [may be repeated] [not available in pipelines] \-\-overwrite Whether overwriting existing output dataset is allowed [not available in pipelines] Mutually exclusive with \-\-append \-\-append Append as a subdataset to existing output [not available in pipelines] Mutually exclusive with \-\-overwrite \-b, \-\-band Input band (1\-based index) (default: 1) \-\-color\-map Color map filename \-\-add\-alpha Adds an alpha mask band to the destination. \-\-color\-selection How to compute output colors from input values. COLOR\-SELECTION=interpolate|exact|nearest (default: interpolate) Advanced Options: \-\-if, \-\-input\-format Input formats [may be repeated] [not available in pipelines] \-\-oo, \-\-open\-option = Open options [may be repeated] [not available in pipelines] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster color\-map\fP با استفاده از یک نقشه‌ی رنگ (color map)—که یا مستقیماً به باند رستر متصل است یا از یک فایل متنی خارجی خوانده می‌شود—یک مجموعه داده RGB یا RGBA از یک باند منفرد تولید می‌کند. این ابزار معمولاً برای ایجاد نقشه‌های ارتفاع‌سنجی (\fI\%hypsometric\fP) از یک مدل رقومی ارتفاع (DEM) استفاده می‌شود. .sp این زیرفرمان همچنین به عنوان یک مرحله‌ی احتمالی در \fI\%gdal raster pipeline\fP در دسترس است. .SH "خروجی GDALG (مجموعه داده بلادرنگ / جریانی)" .sp این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه داده رستری باز کرد و خط لوله‌ی (pipeline) مشخص‌شده را به صورت بلادرنگ (on\-the\-fly) یا جریانی اعمال نمود. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-add\-alpha یک باند ماسک آلفا (alpha mask) به خروجی اضافه می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-b, \-\-band اندیس باندی که باید پردازش شود (شروع از ۱). .UNINDENT .INDENT 0.0 .TP .B \-\-color\-map نام فایل نقشه‌ی رنگ حاوی تناظر بین مقادیر گوناگون رستر و رنگ مورد نظر مربوطه. .sp در صورتی که باند رستر ورودی جدول رنگ پیوست‌شده نداشته باشد، این گزینه باید مشخص شود. .sp فایل پیکربندی رنگ متنی به طور کلی شامل ۴ ستون در هر خط است: مقدار رستر و مؤلفه‌های متناظر قرمز (Red)، سبز (Green) و آبی (Blue) (بین ۰ تا ۲۵۵). مقدار رستر می‌تواند هر مقدار ممیز شناور یا کلمه‌ی کلیدی \fBnv\fP برای مقدار nodata باشد. رستر را می‌توان به صورت درصد نیز بیان کرد: 0% کمترین مقدار موجود در رستر و 100% بیشترین مقدار آن خواهد بود. .sp می‌توان یک ستون اضافی اختیاری نیز برای مؤلفه‌ی آلفا اضافه کرد. اگر مشخص نشود، کدر بودن کامل (۲۵۵) در نظر گرفته می‌شود. .sp جداکننده‌های مختلف فیلد پذیرفته می‌شوند: ویرگول، تب، فاصله‌ها و \(aq:\(aq. .sp رنگ‌های رایج مورد استفاده در GRASS را نیز می‌توان با نام آن‌ها به جای سه‌گانه‌ی RGB مشخص کرد. فهرست پشتیبانی‌شده عبارت است از: white، black، red، green، blue، yellow، magenta، cyan، aqua، grey/gray، orange، brown، purple/violet و indigo. .INDENT 7.0 .INDENT 3.5 فایل‌های پالت GMT با پسوند \fB\&.cpt\fP نیز پشتیبانی می‌شوند (تنها با COLOR_MODEL = RGB). .UNINDENT .UNINDENT .sp نکته: نحو فایل پیکربندی رنگ از ساختار پشتیبانی‌شده در ابزار r.colors در GRASS گرفته شده است. فایل‌های جدول رنگ ESRI HDR با پسوند (.clr) نیز با این نحو مطابقت دارند. مؤلفه‌ی آلفا و پشتیبانی از تب و ویرگول به عنوان جداکننده، افزونه‌های مختص GDAL هستند. .sp برای مثال: .INDENT 7.0 .INDENT 3.5 .sp .EX 3500 white 2500 235:220:175 50% 190 185 135 700 240 250 150 0 50 180 50 nv 0 0 0 0 .EE .UNINDENT .UNINDENT .sp برای پیاده‌سازی حالت «گرد کردن به پایین» (\(dqround to the floor value\(dq)، مقدار رستر می‌تواند با یک مقدار جدید که کمی بالاتر از آستانه است تکرار شود. برای مثال برای داشتن رنگ قرمز در [0,10]، سبز در ]10,20] و آبی در ]20,30]: .INDENT 7.0 .INDENT 3.5 .sp .EX 0 red 10 red 10.001 green 20 green 20.001 blue 30 blue .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-color\-selection interpolate|exact|nearest نحوه‌ی محاسبه‌ی رنگ‌های خروجی بر اساس مقادیر ورودی: .INDENT 7.0 .IP \(bu 2 \fBinterpolate\fP (پیش‌فرض): هنگامی که مقدار رستر بین دو مدخل از نقشه‌ی رنگ قرار می‌گیرد، درون‌یابی خطی اعمال می‌شود. .IP \(bu 2 \fBexact\fP: تنها مقادیر رستر ورودی که دقیقاً منطبق با یک مدخل نقشه‌ی رنگ باشند رنگ‌آمیزی می‌شوند. اگر هیچ مدخل رنگی منطبقی یافت نشود، چهارگانه‌ی RGBA به صورت \(dq0,0,0,0\(dq استفاده خواهد شد. .IP \(bu 2 \fBnearest\fP: به مقادیر رستر ورودی، نزدیک‌ترین مدخل نقشه‌ی رنگ اختصاص می‌یابد. .UNINDENT .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 این گزینه تنها زمانی اعمال می‌شود که \fI\%\-\-color\-map\fP مشخص شده باشد. .UNINDENT .UNINDENT .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه‌ی ساخت اختیاری دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای نمونه، درایور GeoTIFF از گزینه‌های ساختی برای کنترل فشرده‌سازی و کاشی‌بندی بودن فایل پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه‌ی ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه‌ی خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به همان قالب، مرجع نهایی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر قالب، به مستندات اختصاصی بخش \fI\%Raster drivers\fP مراجعه کنید. .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 "وضعیت خروج (EXIT STATUS)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا کد غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار اعلام می‌شوند، اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: تولید یک مجموعه داده RGB از یک فایل DTED0 با استفاده از نقشه‌ی رنگ خارجی" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster color\-map \-\-color\-map=color\-map.txt n43.dt0 out.tif \-\-overwrite .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .