.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Ppmtopcx User Manual" 0 "29 March 2026" "netpbm documentation"

.SH "نام (NAME)"

ppmtopcx \- تبدیل یک تصویر PPM به یک فایل PCX

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBppmtopcx\fP

[\fB-24bit\fP]

[\fB-8bit\fP]

[\fB-packed\fP]

[\fB-stdpalette\fP]

[\fB-palette=\fP\fIpalettefile\fP]

[\fB-planes=\fP\fIplanes\fP]

[\fB-xpos=\fP\fIcols\fP]

[\fB-ypos=\fP\fIrows\fP]

[\fIppmfile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBppmtopcx\fP یک تصویر PPM را به عنوان ورودی خوانده و یک فایل PCX به عنوان خروجی تولید می‌کند. نوع فایل PCX به تعداد رنگ‌های موجود در تصویر ورودی بستگی دارد:


.TP
۱۶ رنگ یا کمتر:
فایل PCX هشت بیتی (۱ بیت/صفحه، ۱ تا ۴ صفحه یا ۱ تا ۴ بیت/صفحه، ۱ صفحه)

.TP
بیش از ۱۶ رنگ، اما نه بیشتر از ۲۵۶ رنگ:
فایل PCX با ۲۵۶ رنگ (۸ بیت/صفحه، ۱ صفحه)

.TP
بیش از ۲۵۶ رنگ:
فایل PCX رنگ واقعی یا truecolor (۲۴ بیتی) (۸ بیت/صفحه، ۳ صفحه)


.PP
می‌توانید با استفاده از گزینه‌های زیر برخی از این موارد را لغو کرده و قالب را به صورت صریح انتخاب کنید.

.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک بین تمامی برنامه‌های مبتنی بر libnetpbm
(به‌ویژه \fB-quiet\fP، به 
.UR index.html#commonoptions
گزینه‌های مشترک
.UE
\& مراجعه کنید)، \fBppmtopcx\fP گزینه‌های خط فرمان زیر را می‌شناسد:


.TP
\fB-24bit\fP
تولید یک فایل PCX رنگ واقعی (truecolor) ۲۴ بیتی، حتی اگر تصویر دارای ۲۵۶ رنگ یا کمتر باشد.

.TP
\fB-8bit\fP
تولید یک فایل PCX هشت بیتی (۲۵۶ رنگ)، حتی اگر تصویر دارای ۱۶ رنگ یا کمتر باشد.
.sp
این گزینه در Netpbm 10.18 (اوت ۲۰۰۳) اضافه شد.

.TP
\fB-packed\fP
استفاده از قالب «پیکسل فشرده» (packed pixel) برای فایل‌هایی با ۱۶ رنگ یا کمتر: ۱، ۲، یا ۴ بیت/پیکسل، ۱ صفحه.

.TP
\fB-stdpalette\fP
به جای محاسبه یک پالت از رنگ‌های درون تصویر، از یک پالت ۱۶ رنگ استاندارد و توکار استفاده می‌کند. اگر تصویر حاوی رنگی باشد که در پالت استاندارد وجود ندارد، \fBppmtopcx\fP با شکست مواجه می‌شود.
.sp
پالت استاندارد نه‌تنها مجموعه‌ای از رنگ‌ها، بلکه یک نگاشت مشخص از نمایه‌های پالت به رنگ‌ها است؛ برای مثال، قرمز برابر با ۴ است.
.sp
می‌توانید از \fBpnmremap\fP به همراه یک تصویر PPM مناسب از پالت استاندارد استفاده کنید تا تصویر خود را طوری تطبیق دهید که دقیقاً از همان رنگ‌های موجود در پالت استفاده کند، تا \fBppmtopcx -stdpalette\fP بتواند روی آن کار کند.
.sp
فایل \fBpcxstd.ppm\fP، که بخشی از Netpbm است، شامل پالت استاندارد می‌باشد.
.sp
اگرچه سرآیند PCX دقیقاً مشخص می‌کند چه پالتی در فایل استفاده شده است، برخی از مفسرهای قدیمی‌تر PCX از این اطلاعات استفاده نمی‌کنند. آن‌ها در عوض پالت استاندارد را فرض می‌کنند. اگر از گزینه \fB-stdpalette\fP استفاده نکنید، ممکن است \fBppmtopcx\fP تصویری ایجاد کند که از پالت متفاوتی استفاده می‌کند (یک بازآرایی از همان رنگ‌ها) و سپس یکی از این مفسرهای قدیمی‌تر، رنگ‌های تصویر را به اشتباه تفسیر خواهد کرد.
.sp
نمی‌توانید این گزینه را هم‌زمان با \fB-palette\fP مشخص کنید.
.sp
این گزینه در Netpbm 10.22 (آوریل ۲۰۰۴) جدید بود.

.TP
\fB-palette=\fP\fIpalettefile\fP
به جای محاسبه پالت از رنگ‌های موجود در تصویر، از پالت فایل \fIpalettefile\fP استفاده می‌کند. اگر تصویر حاوی رنگی باشد که در آن پالت وجود ندارد، \fBppmtopcx\fP با شکست مواجه می‌شود.
.sp
فایل پالت باید یک تصویر PPM باشد که به ازای هر رنگ در پالت، یک پیکسل داشته باشد. نسبت ابعاد تصویر پالت اهمیتی ندارد. ترتیب رنگ‌ها در پالت PCX، ترتیب پیکسل‌ها در تصویر PPM بر اساس ترتیب خواندن استاندارد غربی (از چپ به راست، از بالا به پایین) است. در صورت وجود رنگ تکراری در پالت، \fBppmtopcx\fP در ساخت شطرنجی (raster) PCX، به دلخواه یکی از آن‌ها را انتخاب می‌کند.
.sp
شما تنها زمانی به این گزینه نیاز خواهید داشت که یک خواننده PCX داشته باشید که نتواند پالت موجود در فایل PCX را بخواند و در عوض پالت خاصی را فرض کند. همچنین گزینه \fB-stdpalette\fP را ببینید.
.sp
اگر تصویر ورودی شما ممکن است حاوی رنگ‌هایی به جز رنگ‌های موجود در پالت شما باشد، می‌توانید با \fBpnmremap\fP تصویر ورودی را به تصویری تبدیل کنید که فقط شامل رنگ‌های پالت شما باشد.
.sp
نمی‌توانید این گزینه را همراه با \fB-stdpalette\fP مشخص کنید.
.sp
این گزینه در Netpbm 10.25 (اکتبر ۲۰۰۴) جدید بود.

.TP
\fB-planes=\fP\fIplanes\fP
تولید یک فایل PCX با \fIplanes\fP صفحه، حتی اگر تعداد رنگ‌های تصویر با تعداد کمتری قابل نمایش باشد. این کار فایل را بزرگ‌تر می‌کند، اما برخی از مفسرهای PCX تنها قادر به پردازش تعداد مشخصی از صفحات هستند.
.sp
این گزینه تنها زمانی معنا دارد که \fBppmtopcx\fP تصویری در قالب پالت ۱۶ رنگ بدون پیکسل‌های فشرده (packed pixels) تولید کند. در نتیجه، نمی‌توانید این گزینه را همراه با \fB-24bit\fP، \fB-8bit\fP یا \fB-packed\fP مشخص کنید.
.sp
مقادیر معتبر برای \fIplanes\fP عبارتند از ۱، ۲، ۳ و ۴. به‌طور پیش‌فرض، \fBppmtopcx\fP کمترین تعداد صفحاتی را که می‌تواند رنگ‌های تصویر را نمایش دهد انتخاب می‌کند؛ مثلاً اگر ۵ رنگ وجود داشته باشد، \fBppmtopcx\fP تعداد ۳ صفحه را انتخاب می‌کند.
.sp
این گزینه در Netpbm 10.21 (مارس ۲۰۰۴) جدید بود.
     
.TP
\fB-xpos=\fP\fIcols\fP

.TP
\fB-ypos=\fP\fIrows\fP
این گزینه‌ها موقعیت تصویر را در یک محدوده (مثلاً روی صفحه نمایش) بر حسب ستون‌ها به سمت راست از لبه چپ و سطرها به سمت پایین از لبه بالا تعیین می‌کنند. قالب PCX حاوی اطلاعات موقعیت تصویر است. این مورد را با موقعیت یک ناحیه مورد نظر در درون تصویر اشتباه نگیرید. برای نمونه، استفاده از \fBpnmpad\fP برای افزودن یک حاشیه ۱۰ پیکسلی در سمت چپ به تصویر و سپس تبدیل آن تصویر به PCX با xpos = 0، همانند تبدیل تصویر اصلی به PCX و تنظیم xpos = 10 نیست.
.sp
مقادیر می‌توانند از \-32767 تا 32768 باشند.
.sp
پیش‌فرض برای هر کدام صفر است.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pcxtoppm" (1)\c
\&،
.BR "ppm" (1)\c
\&

.UN authors
.SH "نویسندگان (AUTHORS)"

حق نشر (C) ۱۹۹۴ متعلق به Ingo Wilken (\fIIngo.Wilken@informatik.uni-oldenburg.de\fP)
.PP
بر اساس کارهای پیشین Michael Davidson.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmtopcx.html
.PP