.\" 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-RGB-TO-PALETTE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-raster-rgb-to-palette \- تبدیل یک تصویر RGB به یک تصویر شبه‌رنگی / دارای پالت رنگ
.sp
اضافه‌شده در نسخهٔ 3.12.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal raster rgb\-to\-palette [OPTIONS] <INPUT> <OUTPUT>

Convert a RGB image into a pseudo\-color / paletted image.

Positional arguments:
  \-i, \-\-input <INPUT>                                  مجموعه‌داده‌های رستر ورودی [الزامی] [در خط‌لوله‌ها در دسترس نیست]
  \-o, \-\-output <OUTPUT>                                مجموعه‌دادهٔ رستر خروجی [الزامی] [در خط‌لوله‌ها در دسترس نیست]

Common Options:
  \-h, \-\-help                                           نمایش پیام راهنما و خروج
  \-\-json\-usage                                         نمایش نحوهٔ استفاده به‌صورت سند JSON و خروج
  \-\-config <KEY>=<VALUE>                               گزینهٔ پیکربندی [می‌تواند تکرار شود]
  \-q, \-\-quiet                                          حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها در دسترس نیست]

Options:
  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) [در خط‌لوله‌ها در دسترس نیست]
  \-\-co, \-\-creation\-option <KEY>=<VALUE>                گزینهٔ ساخت [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست]
  \-\-overwrite                                          مجاز بودن رونویسی مجموعه‌دادهٔ خروجی موجود [در خط‌لوله‌ها در دسترس نیست]
                                                       غیرقابل استفاده هم‌زمان با \-\-append
  \-\-append                                             الحاق به‌عنوان یک زیرمجموعه‌داده به خروجی موجود [در خط‌لوله‌ها در دسترس نیست]
                                                       غیرقابل استفاده هم‌زمان با \-\-overwrite
  \-\-color\-count <COLOR\-COUNT>                          انتخاب تعداد رنگ‌ها در جدول رنگ تولیدشده (پیش‌فرض: 256)
  \-\-color\-map <COLOR\-MAP>                              نام فایل نگاشت رنگ
  \-\-output\-nodata <OUTPUT\-NODATA>                      مقدار nodata خروجی
  \-\-no\-dither                                          غیرفعال‌سازی ترام‌ریزی فلوید\-اشتاینبرگ
  \-\-bit\-depth <BIT\-DEPTH>                              عمق بیتی مؤلفه‌های پالت رنگ (۸ بیت زمان محاسبه را طولانی‌تر می‌کند). BIT\-DEPTH=5|8 (پیش‌فرض: 5)

Advanced Options:
  \-\-if, \-\-input\-format <INPUT\-FORMAT>                  قالب‌های ورودی [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست]
  \-\-oo, \-\-open\-option <KEY>=<VALUE>                    گزینه‌های باز کردن [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal raster rgb\-to\-palette\fP یک جدول شبه‌رنگی (pseudo\-color) بهینه را
برای یک تصویر RGB مشخص با استفاده از الگوریتم برش میانه (median cut) بر روی هیستوگرام RGB
کاهش‌یافته محاسبه می‌کند، مگر اینکه جدول رنگی با گزینهٔ \fI\%\-\-color\-map\fP ارائه شده باشد.
سپس با استفاده از جدول رنگ، تصویر را به یک تصویر شبه‌رنگی تبدیل می‌کند.
این تبدیل به‌طور پیش‌فرض از ترام‌ریزی فلوید\-اشتاینبرگ (Floyd\-Steinberg dithering یا انتشار خطا)
برای به حداکثر رساندن کیفیت بصری تصویر خروجی بهره می‌برد.
.sp
این زیردستور همچنین به‌عنوان یک مرحلهٔ احتمالی در \fI\%gdal raster pipeline\fP در دسترس است.
.SH "خروجی GDALG (مجموعه‌دادهٔ زنده / جریانی) (GDALG OUTPUT (ON\-THE\-FLY / STREAMED DATASET))"
.sp
این برنامه از سریال‌سازی خط فرمان به‌صورت یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند.
فایل حاصل را می‌توان سپس به‌عنوان یک مجموعه‌دادهٔ رستر با استفاده از درایور
\fI\%GDALG: GDAL Streamed Algorithm\fP باز کرد و خط‌لولهٔ مشخص‌شده را به‌صورت زنده / جریانی
(on\-the\-fly / streamed) اعمال نمود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
با این حال، این الگوریتم به‌طور بومی با پردازش جریانی سازگار نیست. در نتیجه یک
مجموعه‌دادهٔ موقت تولید خواهد شد که ممکن است باعث زمان پردازش قابل‌توجهی
هنگام باز کردن شود.
.UNINDENT
.UNINDENT
.SH "گزینه‌های ویژهٔ برنامه (PROGRAM\-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-\-color\-count <COLOR\-COUNT>
انتخاب تعداد رنگ‌ها در جدول رنگ تولیدشده. پیش‌فرض ۲۵۶ است.
باید بین ۲ و ۲۵۶ باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-color\-map <FILENAME>
استخراج جدول رنگ از <FILENAME> به‌جای محاسبهٔ آن.
می‌تواند برای داشتن یک جدول رنگ یکپارچه برای چندین فایل استفاده شود.
مقدار <FILENAME> باید یا یک فایل رستر در قالبی با پشتیبانی GDAL و دارای پالت باشد،
یا یک فایل رنگ در قالبی پشتیبانی‌شده (.txt، QGIS .qml، QGIS .qlr).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-nodata <VALUE>
اضافه‌شده در نسخهٔ 3.13.

.sp
مقدار nodata خروجی را مشخص می‌کند که برای پیکسل‌های ورودی با مقدار nodata مبدأ یا
پیکسل‌هایی که به‌دلیل وجود یک باند ماسک (مانند باند آلفا) شفاف هستند، استفاده خواهد شد.
مقدار nodata مقصد باید بین ۰ و ۲۵۵ باشد.
اگر مقدار nodata در مبدأ وجود داشته باشد یا یک باند ماسک در سطح کل مجموعه‌داده به باندهای
مبدأ متصل باشد، و \fI\%\-\-output\-nodata\fP مشخص نشده باشد، مقدار پیش‌فرض آن
۰ خواهد بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-dither
اضافه‌شده در نسخهٔ 3.13.

.sp
غیرفعال‌سازی ترام‌ریزی فلوید\-اشتاینبرگ (انتشار خطا). این گزینه ممکن است برای بهبود
نرخ فشرده‌سازی با اجتناب از «نویز» اضافه‌شده توسط انتشار خطا مفید باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-bit\-depth 5|8
اضافه‌شده در نسخهٔ 3.13.

.sp
عمق بیتی هر یک از مؤلفه‌های R، G و B در جدول رنگ خروجی. مقدار پیش‌فرض
۵ است، به این معنی که هر مؤلفه به ۳۲ = ۲ ^ ۵ مقدار محدود می‌شود.
تنظیم عمق بیتی روی ۸ دقت و وفاداری جدول رنگ خروجی را به بهای زمان
محاسبهٔ طولانی‌تر افزایش می‌دهد.
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینهٔ اختیاری ساخت دارند که می‌توانند برای
کنترل ویژگی‌های خاص فایل ایجادشده استفاده شوند. برای مثال،
درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و تعیین اینکه
آیا فایل باید کاشی‌کاری‌شده (tiled) باشد پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های
ساده هیچ گزینهٔ ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را
می‌توان با گزینهٔ خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات خود قالب، منبع نهایی اطلاعات دربارهٔ گزینه‌های
ساخت درایور است.
برای گزینه‌های ساخت مجاز در هر قالب، مستندات اختصاصی هر قالب را در
\fI\%Raster drivers\fP ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-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
این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند
(خطاهای غیر مسدودکننده که به‌صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز تلقی می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱"
.sp
تبدیل یک فایل TIFF به یک تصویر PNG دارای پالت رنگ
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster rgb\-to\-palette input.tif output.png
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.