.\" 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 "Pamtotga User Manual" 0 "06 November 2018" "netpbm documentation"

.SH "نام (NAME)"
pamtotga \- تبدیل یک تصویر Netpbm به یک پروندهٔ TrueVision Targa

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

\fBpamtotga\fP
[\fB-mono|-cmap|-cmap16|-rgb\fP]
[\fB-norle\fP]
[\fB-name=\fP\fIname\fP
[\fB-verhose\fP]
[\fIpamfile\fP]
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. می‌توانید به‌جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه استفاده کنید. همچنین می‌توانید بین نام یک گزینه و مقدار آن، از نویسهٔ فاصله یا علامت مساوی استفاده کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamtotga\fP یک تصویر PBM، PGM، PPM یا PAM را به‌عنوان ورودی می‌خواند و یک پروندهٔ TrueVision Targa در خروجی تولید می‌کند. تصویر PAM می‌تواند از نوع BLACKANDWHITE، GRAYSCALE، RGB یا RGB_ALPHA باشد.
.PP
برای ایجاد یک تصویر TGA دارای شفافیت (یعنی همراه با ماسک شفافیت)، از ورودی PAM با نوع RGB_ALPHA استفاده کنید. برخی از برنامه‌های Netpbm که تصاویری دارای ماسک شفافیت تولید می‌کنند، آن‌ها را در همین قالب ایجاد می‌کنند. برای روشی دیگر جهت ساخت جریان ورودی مناسب، به
.BR "\fBpamstack\fP" (1)\c
\& مراجعه کنید.
.PP
روشن نیست که آیا برنامه‌ای به‌جز \fBpamtotga\fP از TGAهای دارای شفافیت پشتیبانی می‌کند یا خیر. پیشینهٔ این ویژگی در \fBpamtotga\fP مشخص نیست. قالبی که \fBpamtotga\fP تولید می‌کند در واقع همانند یک تصویر معمولی RGB TGA است، با این تفاوت که یک صفحهٔ (plane) چهارم برای شفافیت به آن افزوده شده است. فیلد PixelSize در سرآیند TGA به‌جای ۲۴ بیت، مقدار ۳۲ بیت را مشخص می‌کند و بخش شطرنجی (raster) یک بایت اضافه در انتهای هر پیکسل دارد. مقدار این بایت دقیقاً همان مفهومی را دارد که در یک تصویر PAM با maxval برابر با ۲۵۵ تعریف می‌شود.

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


.TP
\fB-cmap\fP
باعث می‌شود پروندهٔ Targa خروجی برای کاهش اندازه از یک جدول رنگ یا پالت (color map) استفاده کند.
.sp
هر رنگ در جدول رنگ ۳ بایت است (۸ بیت برای هر کدام از رنگ‌های قرمز، سبز و آبی)، مگر اینکه ورودی سیاه‌وسفید یا طیف خاکستری (grayscale) باشد که در این صورت هر رنگ در پالت با یک بایت نشان داده می‌شود.
.sp
ورودی نباید بیش از ۲۵۶ رنگ متمایز داشته باشد و نباید حاوی اطلاعات شفافیت باشد.
.sp
(محدودیت شفافیت، مربوط به قالب پرونده نیست، بلکه از جانب \fBpamtotga\fP است؛ پیاده‌سازی جدول رنگی که حاوی اطلاعات شفافیت باشد دشوارتر است).

.TP
\fB-cmap16\fP
مشابه \fB-cmap\fP است، با این تفاوت که هر مدخل جدول رنگ برای ورودی تمام‌رنگی ۵ بیت برای هر یک از رنگ‌های قرمز، سبز و آبی است که به‌صورت دو بایت (۱۶ بیت) ذخیره می‌شود.
.sp
محدودیت‌ها همانند \fB-cmap\fP هستند.
.sp
این گزینه در Netpbm 10.85 (دسامبر ۲۰۱۸) افزوده شد.
    
.TP
\fB-mono\fP
پروندهٔ Targa خروجی را از نوع تک‌رنگ ۸ بیتی (monochrome) می‌سازد. ورودی باید PBM یا PGM یا یک PAM با نوع چندتایی BLACKANDWHITE یا GRAYSCALE باشد.
به \fB-cmap\fP مراجعه کنید.
.sp
می‌توانید حداکثر یکی از گزینه‌های \fB-mono\fP، \fB-cmap\fP و \fB-rgb\fP را مشخص کنید. اگر هیچ‌کدام را مشخص نکنید، محدودترین نوع تصویر سازگار به‌صورت پیش‌فرض استفاده می‌شود؛ که در آن monochrome محدودتر از colormapped و آن نیز به نوبهٔ خود محدودتر از unmapped است.

.TP
\fB-rgb\fP
پروندهٔ Targa خروجی را از نوع رنگی ۲۴ بیتی نگاشت‌نشده (unmapped) می‌سازد. به \fB-cmap\fP مراجعه کنید.

.TP
\fB-norle\fP
از کدگذاری طول اجرا (RLE - run-length encoding) در پروندهٔ Targa خروجی استفاده نمی‌کند.
پرونده‌های کدگذاری‌شده با طول اجرا کوچک‌تر هستند، اما برخی از برنامه‌های خوانندهٔ Targa قادر به خواندن پرونده‌های کدگذاری‌شده با RLE نیستند.

.TP
\fB-name=\fP\fIname\fP
این مقدار برای شناسهٔ تصویر (image ID) ذکرشده در سرآیند پروندهٔ خروجی TGA است. \fBpamtotga\fP در صورت لزوم آن را مطابق با استانداردهای TGA کوتاه می‌کند.
.sp
به‌طور پیش‌فرض، \fBpamtotga\fP از آرگومان نام پروندهٔ ورودی تا نخستین نقطه (یا در صورت عدم وجود نقطه، کل نام) استفاده می‌کند و آن را بر اساس استانداردهای TGA در صورت نیاز کوتاه می‌کند. اگر ورودی استاندارد (Standard Input) را تعیین کنید (یا پیش‌فرض بر آن باشد)، \fBpamtotga\fP شناسهٔ تصویر را از سرآیند TGA حذف می‌کند.

.TP
\fB-verbose\fP
باعث می‌شود \fBpamtotga\fP پیام‌هایی را دربارهٔ فرایند تبدیل نمایش دهد.

      


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "tgatoppm" (1)\c
\&،
.BR "pnmquant" (1)\c
\&،
.BR "pamstack" (1)\c
\&،
.BR "pam" (1)\c
\&
.BR "pnm" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
این برنامه تا پیش از Netpbm 10.6 (ژوئیه ۲۰۰۲) \fBppmtotga\fP نامیده می‌شد. با این حال این نام‌گذاری همواره نامناسب بود، زیرا برنامه‌ای در ردهٔ PPM نمی‌توانست تفاوت میان ورودی PGM و PPM را تشخیص دهد (همه شبیه PPM به نظر می‌رسیدند)، و در نتیجه قادر نبود نوع تصویر خروجی Targa را بر پایهٔ نوع ورودی انتخاب کند. همچنین در Netpbm 10.6 قابلیت کار با کانال شفافیت اضافه شد، بنابراین به برنامه‌ای از ردهٔ PAM تبدیل گردید.
.PP
در Netpbm 10.15 (آوریل ۲۰۰۳)، این برنامه به نخستین برنامه در بستهٔ Netpbm تبدیل شد که کانال شفافیت را در یک PAM شناسایی می‌کرد. این برنامه نوع چندتایی (tuple type) «RGBA» را تشخیص می‌داد. اما هنگامی که بعداً این نوع تصویر PAM به مشخصات رسمی PAM افزوده شد، با نوع چندتایی «RGB_ALPHA» مشخص گردید. بنابراین در Netpbm 10.26 (ژانویه ۲۰۰۵)، \fBpamtotga\fP تغییر یافت تا به‌جای «RGBA»، نوع «RGB_ALPHA» را شناسایی کند.

.UN author
.SH "نویسنده (AUTHOR)"

کپی‌رایت (C) ۱۹۸۹، ۱۹۹۱ توسط Mark Shand و Jef Poskanzer.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات مرجع اصلی در آدرس زیر قرار دارند:
.IP
.B http://netpbm.sourceforge.net/doc/pamtotga.html
.PP