نام (NAME)

pamtotga - تبدیل یک تصویر Netpbm به یک پروندهٔ TrueVision Targa

خلاصه دستور (SYNOPSIS)

pamtotga [-mono|-cmap|-cmap16|-rgb] [-norle] [-name=name [-verhose] [pamfile]

تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. می‌توانید به‌جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه استفاده کنید. همچنین می‌توانید بین نام یک گزینه و مقدار آن، از نویسهٔ فاصله یا علامت مساوی استفاده کنید.

توضیحات (DESCRIPTION)

این برنامه بخشی از Netpbm(1) است.

دستور pamtotga یک تصویر PBM، PGM، PPM یا PAM را به‌عنوان ورودی می‌خواند و یک پروندهٔ TrueVision Targa در خروجی تولید می‌کند. تصویر PAM می‌تواند از نوع BLACKANDWHITE، GRAYSCALE، RGB یا RGB_ALPHA باشد.

برای ایجاد یک تصویر TGA دارای شفافیت (یعنی همراه با ماسک شفافیت)، از ورودی PAM با نوع RGB_ALPHA استفاده کنید. برخی از برنامه‌های Netpbm که تصاویری دارای ماسک شفافیت تولید می‌کنند، آن‌ها را در همین قالب ایجاد می‌کنند. برای روشی دیگر جهت ساخت جریان ورودی مناسب، به pamstack(1) مراجعه کنید.

روشن نیست که آیا برنامه‌ای به‌جز pamtotga از TGAهای دارای شفافیت پشتیبانی می‌کند یا خیر. پیشینهٔ این ویژگی در pamtotga مشخص نیست. قالبی که pamtotga تولید می‌کند در واقع همانند یک تصویر معمولی RGB TGA است، با این تفاوت که یک صفحهٔ (plane) چهارم برای شفافیت به آن افزوده شده است. فیلد PixelSize در سرآیند TGA به‌جای ۲۴ بیت، مقدار ۳۲ بیت را مشخص می‌کند و بخش شطرنجی (raster) یک بایت اضافه در انتهای هر پیکسل دارد. مقدار این بایت دقیقاً همان مفهومی را دارد که در یک تصویر PAM با maxval برابر با ۲۵۵ تعریف می‌شود.

گزینه‌ها (OPTIONS)

علاوه بر گزینه‌های مشترک در تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه -quiet؛ به گزینه‌های عمومی (Common Options) مراجعه کنید)، pamtotga گزینه‌های خط فرمان زیر را نیز می‌شناسد:

-cmap

باعث می‌شود پروندهٔ Targa خروجی برای کاهش اندازه از یک جدول رنگ یا پالت (color map) استفاده کند.

هر رنگ در جدول رنگ ۳ بایت است (۸ بیت برای هر کدام از رنگ‌های قرمز، سبز و آبی)، مگر اینکه ورودی سیاه‌وسفید یا طیف خاکستری (grayscale) باشد که در این صورت هر رنگ در پالت با یک بایت نشان داده می‌شود.

ورودی نباید بیش از ۲۵۶ رنگ متمایز داشته باشد و نباید حاوی اطلاعات شفافیت باشد.

(محدودیت شفافیت، مربوط به قالب پرونده نیست، بلکه از جانب pamtotga است؛ پیاده‌سازی جدول رنگی که حاوی اطلاعات شفافیت باشد دشوارتر است).

-cmap16

مشابه -cmap است، با این تفاوت که هر مدخل جدول رنگ برای ورودی تمام‌رنگی ۵ بیت برای هر یک از رنگ‌های قرمز، سبز و آبی است که به‌صورت دو بایت (۱۶ بیت) ذخیره می‌شود.

محدودیت‌ها همانند -cmap هستند.

این گزینه در Netpbm 10.85 (دسامبر ۲۰۱۸) افزوده شد.

-mono

پروندهٔ Targa خروجی را از نوع تک‌رنگ ۸ بیتی (monochrome) می‌سازد. ورودی باید PBM یا PGM یا یک PAM با نوع چندتایی BLACKANDWHITE یا GRAYSCALE باشد. به -cmap مراجعه کنید.

می‌توانید حداکثر یکی از گزینه‌های -mono، -cmap و -rgb را مشخص کنید. اگر هیچ‌کدام را مشخص نکنید، محدودترین نوع تصویر سازگار به‌صورت پیش‌فرض استفاده می‌شود؛ که در آن monochrome محدودتر از colormapped و آن نیز به نوبهٔ خود محدودتر از unmapped است.

-rgb

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

-norle

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

-name=name

این مقدار برای شناسهٔ تصویر (image ID) ذکرشده در سرآیند پروندهٔ خروجی TGA است. pamtotga در صورت لزوم آن را مطابق با استانداردهای TGA کوتاه می‌کند.

به‌طور پیش‌فرض، pamtotga از آرگومان نام پروندهٔ ورودی تا نخستین نقطه (یا در صورت عدم وجود نقطه، کل نام) استفاده می‌کند و آن را بر اساس استانداردهای TGA در صورت نیاز کوتاه می‌کند. اگر ورودی استاندارد (Standard Input) را تعیین کنید (یا پیش‌فرض بر آن باشد)، pamtotga شناسهٔ تصویر را از سرآیند TGA حذف می‌کند.

-verbose

باعث می‌شود pamtotga پیام‌هایی را دربارهٔ فرایند تبدیل نمایش دهد.

همچنین ببینید (SEE ALSO)

tgatoppm(1)، pnmquant(1)، pamstack(1)، pam(1) pnm(1)

تاریخچه (HISTORY)

این برنامه تا پیش از Netpbm 10.6 (ژوئیه ۲۰۰۲) ppmtotga نامیده می‌شد. با این حال این نام‌گذاری همواره نامناسب بود، زیرا برنامه‌ای در ردهٔ PPM نمی‌توانست تفاوت میان ورودی PGM و PPM را تشخیص دهد (همه شبیه PPM به نظر می‌رسیدند)، و در نتیجه قادر نبود نوع تصویر خروجی Targa را بر پایهٔ نوع ورودی انتخاب کند. همچنین در Netpbm 10.6 قابلیت کار با کانال شفافیت اضافه شد، بنابراین به برنامه‌ای از ردهٔ PAM تبدیل گردید.

در Netpbm 10.15 (آوریل ۲۰۰۳)، این برنامه به نخستین برنامه در بستهٔ Netpbm تبدیل شد که کانال شفافیت را در یک PAM شناسایی می‌کرد. این برنامه نوع چندتایی (tuple type) «RGBA» را تشخیص می‌داد. اما هنگامی که بعداً این نوع تصویر PAM به مشخصات رسمی PAM افزوده شد، با نوع چندتایی «RGB_ALPHA» مشخص گردید. بنابراین در Netpbm 10.26 (ژانویه ۲۰۰۵)، pamtotga تغییر یافت تا به‌جای «RGBA»، نوع «RGB_ALPHA» را شناسایی کند.

نویسنده (AUTHOR)

کپی‌رایت (C) ۱۹۸۹، ۱۹۹۱ توسط Mark Shand و Jef Poskanzer.

منبع مستندات (DOCUMENT SOURCE)

این صفحهٔ راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات مرجع اصلی در آدرس زیر قرار دارند:

http://netpbm.sourceforge.net/doc/pamtotga.html