| GDAL-RASTER-RGB-TO-PALETTE(1) | GDAL | GDAL-RASTER-RGB-TO-PALETTE(1) |
نام (NAME)
gdal-raster-rgb-to-palette - تبدیل یک تصویر RGB به یک تصویر شبه‌رنگی / دارای پالت رنگ
اضافه‌شده در نسخهٔ 3.12.
خلاصه دستور (SYNOPSIS)
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> قالب خروجی (مقدار "GDALG" مجاز است) [در خط‌لوله‌ها در دسترس نیست]
--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> گزینه‌های باز کردن [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست]
توضیحات (DESCRIPTION)
دستور gdal raster rgb-to-palette یک جدول شبه‌رنگی (pseudo-color) بهینه را برای یک تصویر RGB مشخص با استفاده از الگوریتم برش میانه (median cut) بر روی هیستوگرام RGB کاهش‌یافته محاسبه می‌کند، مگر اینکه جدول رنگی با گزینهٔ --color-map ارائه شده باشد. سپس با استفاده از جدول رنگ، تصویر را به یک تصویر شبه‌رنگی تبدیل می‌کند. این تبدیل به‌طور پیش‌فرض از ترام‌ریزی فلوید-اشتاینبرگ (Floyd-Steinberg dithering یا انتشار خطا) برای به حداکثر رساندن کیفیت بصری تصویر خروجی بهره می‌برد.
این زیردستور همچنین به‌عنوان یک مرحلهٔ احتمالی در gdal raster pipeline در دسترس است.
خروجی GDALG (مجموعه‌دادهٔ زنده / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))
این برنامه از سریال‌سازی خط فرمان به‌صورت یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به‌عنوان یک مجموعه‌دادهٔ رستر با استفاده از درایور GDALG: GDAL Streamed Algorithm باز کرد و خط‌لولهٔ مشخص‌شده را به‌صورت زنده / جریانی (on-the-fly / streamed) اعمال نمود.
نکته:
گزینه‌های ویژهٔ برنامه (PROGRAM-SPECIFIC OPTIONS)
- --color-count <COLOR-COUNT>
- انتخاب تعداد رنگ‌ها در جدول رنگ تولیدشده. پیش‌فرض ۲۵۶ است. باید بین ۲ و ۲۵۶ باشد.
- --color-map <FILENAME>
- استخراج جدول رنگ از <FILENAME> به‌جای محاسبهٔ آن. می‌تواند برای داشتن یک جدول رنگ یکپارچه برای چندین فایل استفاده شود. مقدار <FILENAME> باید یا یک فایل رستر در قالبی با پشتیبانی GDAL و دارای پالت باشد، یا یک فایل رنگ در قالبی پشتیبانی‌شده (.txt، QGIS .qml، QGIS .qlr).
- --output-nodata <VALUE>
- اضافه‌شده
در نسخهٔ 3.13.
مقدار nodata خروجی را مشخص می‌کند که برای پیکسل‌های ورودی با مقدار nodata مبدأ یا پیکسل‌هایی که به‌دلیل وجود یک باند ماسک (مانند باند آلفا) شفاف هستند، استفاده خواهد شد. مقدار nodata مقصد باید بین ۰ و ۲۵۵ باشد. اگر مقدار nodata در مبدأ وجود داشته باشد یا یک باند ماسک در سطح کل مجموعه‌داده به باندهای مبدأ متصل باشد، و --output-nodata مشخص نشده باشد، مقدار پیش‌فرض آن ۰ خواهد بود.
- --no-dither
- اضافه‌شده
در نسخهٔ 3.13.
غیرفعال‌سازی ترام‌ریزی فلوید-اشتاینبرگ (انتشار خطا). این گزینه ممکن است برای بهبود نرخ فشرده‌سازی با اجتناب از «نویز» اضافه‌شده توسط انتشار خطا مفید باشد.
- --bit-depth 5|8
- اضافه‌شده
در نسخهٔ 3.13.
عمق بیتی هر یک از مؤلفه‌های R، G و B در جدول رنگ خروجی. مقدار پیش‌فرض ۵ است، به این معنی که هر مؤلفه به ۳۲ = ۲ ^ ۵ مقدار محدود می‌شود. تنظیم عمق بیتی روی ۸ دقت و وفاداری جدول رنگ خروجی را به بهای زمان محاسبهٔ طولانی‌تر افزایش می‌دهد.
گزینه‌های استاندارد (STANDARD OPTIONS)
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
قالب‌ها یک
یا چند
گزینهٔ
اختیاری
ساخت دارند
که
می‌توانند
برای کنترل
ویژگی‌های
خاص فایل
ایجادشده
استفاده
شوند. برای
مثال،
درایور GeoTIFF از
گزینه‌های
ساخت برای
کنترل
فشرده‌سازی
و تعیین
اینکه آیا
فایل باید
کاشی‌کاری‌شده
(tiled) باشد
پشتیبانی
می‌کند.
می‌تواند تکرار شود.
گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینهٔ ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینهٔ خط فرمان --formats مشاهده کرد، اما مستندات خود قالب، منبع نهایی اطلاعات دربارهٔ گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز در هر قالب، مستندات اختصاصی هر قالب را در Raster drivers ببینید.
- -f, --of, --format, --output-format <OUTPUT-FORMAT>
- تعیین قالب رستر خروجی مورد استفاده. مقادیر مجاز را می‌توان با این دستور مشاهده کرد: gdal --formats | grep raster | grep rw | sort
- --overwrite
- اجازه به برنامه برای رونویسی روی فایل یا مجموعه‌دادهٔ هدف موجود. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌دادهٔ هدف از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود.
وضعیت خروج (EXIT STATUS)
این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیر مسدودکننده که به‌صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز تلقی می‌شوند).
مثال‌ها (EXAMPLES)
مثال ۱
تبدیل یک فایل TIFF به یک تصویر PNG دارای پالت رنگ
$ gdal raster rgb-to-palette input.tif output.png
نویسندگان (AUTHORS)
Even Rouault <even.rouault@spatialys.com>
کپی‌رایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |