.\" 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 "RGB2PCT" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
rgb2pct \- تبدیل یک تصویر ۲۴ بیتی RGB به تصویر ۸ بیتی دارای پالت رنگی
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
rgb2pct [\-\-help] [\-\-help\-general] [\-\-creation\-option OPTION]
           [\-n colors | \-pct palette_file] [\-of format] <source_file> <dest_file>
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
این ابزار با استفاده از الگوریتم برش میانه (median cut) روی یک هیستوگرام RGB کاهش‌نمونه‌برداری‌شده، یک جدول شبه‌رنگ (pseudo\-color) بهینه را برای تصویر RGB داده‌شده محاسبه می‌کند. سپس با استفاده از جدول رنگ، تصویر را به یک تصویر شبه‌رنگی تبدیل می‌کند. در این تبدیل برای بیشینه‌سازی کیفیت بصری تصویر خروجی، از ترام‌ریزی فلوید\-اشتاینبرگ (Floyd\-Steinberg dithering یا انتشار خطا) استفاده می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
دستور rgb2pct یک ابزار پایتون است و تنها در صورتی که بایندرهای پایتون GDAL در دسترس باشند قابل استفاده است.
.UNINDENT
.UNINDENT
.sp
\fBنکته مفید:\fP
.INDENT 0.0
.INDENT 3.5
دستور معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
به \fI\%gdal raster rgb\-to\-palette\fP\& مراجعه کنید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
نمایش یک پیام کوتاه درباره نحوه استفاده از گزینه‌های عمومی خط فرمان GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-n <color>
انتخاب تعداد رنگ‌ها در جدول رنگ تولیدشده. مقدار پیش‌فرض 256 است. باید عددی بین 2 تا 256 باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-creation\-option OPTION
پارامترهای ساخت اختیاری برای درایور GeoTIFF، برای نمونه \(dqCOMPRESS=LZW\(dq. این گزینه می‌تواند چندین بار مشخص شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-pct <palette_file>
استخراج جدول رنگ از <palette_file> به‌جای محاسبه آن. می‌تواند برای اعمال یک جدول رنگ یکسان روی چندین فایل استفاده شود. <palette_file> باید یک فایل رستر در یکی از فرمت‌های پشتیبانی‌شده توسط GDAL به همراه یک پالت رنگی، یا یک فایل رنگ در یکی از فرمت‌های پشتیبانی‌شده (txt، qml، qlr) باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-of <format>
انتخاب فرمت خروجی. در صورت عدم تعیین، فرمت از روی پسوند فایل حدس زده می‌شود. از نام کوتاه فرمت استفاده کنید. تنها باید از فرمت‌های خروجی پشتیبانی‌کننده از جدول‌های شبه‌رنگ استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B <source_file>
فایل ورودی RGB.
.UNINDENT
.INDENT 0.0
.TP
.B <dest_file>
فایل شبه‌رنگی خروجی که ایجاد خواهد شد.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده‌ای که به‌صورت هشدار اعلام می‌شوند، اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.sp
اگر تمایل به ایجاد دستی پالت وجود داشته باشد، احتمالاً ساده‌ترین فرمت متنی، فرمت GDAL VRT است. در مثال زیر، یک VRT در یک ویرایشگر متنی با یک پالت کوچک ۴ رنگی با رنگ‌های RGBA معادل 238/238/238/255، 237/237/237/255، 236/236/236/255 و 229/229/229/255 ایجاد شده است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ rgb2pct \-pct palette.vrt rgb.tif pseudo\-colored.tif
$ more < palette.vrt
<VRTDataset rasterXSize=\(dq226\(dq rasterYSize=\(dq271\(dq>
    <VRTRasterBand dataType=\(dqByte\(dq band=\(dq1\(dq>
        <ColorInterp>Palette</ColorInterp>
        <ColorTable>
        <Entry c1=\(dq238\(dq c2=\(dq238\(dq c3=\(dq238\(dq c4=\(dq255\(dq/>
        <Entry c1=\(dq237\(dq c2=\(dq237\(dq c3=\(dq237\(dq c4=\(dq255\(dq/>
        <Entry c1=\(dq236\(dq c2=\(dq236\(dq c3=\(dq236\(dq c4=\(dq255\(dq/>
        <Entry c1=\(dq229\(dq c2=\(dq229\(dq c3=\(dq229\(dq c4=\(dq255\(dq/>
        </ColorTable>
    </VRTRasterBand>
</VRTDataset>
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Frank Warmerdam <warmerdam@pobox.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.