نکته: نحو گزینه‌های نسخه‌های قدیمی‌تر

در Netpbm 10.30 (اکتبر ۲۰۰۵)، نحو خط فرمان pnmtopng به نحو استاندارد خط فرمان Netpbm تغییر یافت. پیش از آن، نمی‌توانستید از دو خط تیره برای مشخص کردن گزینه استفاده کنید و نمی‌توانستید از علامت مساوی برای جدا کردن نام گزینه از مقدارش استفاده کنید. همچنین گزینه‌ها باید قبل از آرگومان‌های غیرگزینه‌ای برنامه می‌آمدند.

علاوه بر این، گزینه‌های -chroma، -phys و -time به ترتیب با -rgb، -size و -modtime جایگزین شدند. تنها تفاوت (برای مثال در -phys/-size) این است که -phys چندین آرگومان برنامه را به عنوان آرگومان گزینه دریافت می‌کرد، در حالی که -size یک آرگومان برنامه‌ی منفرد دریافت می‌کند که از چند کلمه تشکیل شده است. برای مثال، دستور پوسته قدیمی

   pnmtopng -phys 800 800 0 input.pnm > output.png

معادل با دستور جدید پوسته است:

   pnmtopng -size "800 800 0" input.pnm > output.png

اگر برنامه‌ای می‌نویسید که باید با هر دو نسخه جدید و قدیم کار کند، ابتدا آن را با نحو جدید اجرا کنید و اگر با خطای "unrecognized option" مواجه شد، به نحو قدیمی بازگردید.

گزینه‌های کنونی

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

-verbose

باعث می‌شود pnmtopng اطلاعاتی را درباره قالب فایل خروجی نمایش دهد.

 

-downscale

این گزینه به pnmtopng امکان می‌دهد تا مقادیر حداکثر (maxval) بزرگتر از ۶۵۵۳۵ را به ۱۶ بیت مقیاس‌بندی کند. از آنجا که این کار به معنی از دست رفتن داده‌های تصویر است، pnmtopng به صورت پیش‌فرض آن را انجام نمی‌دهد.

 

-interlace

باعث می‌شود فایل PNG به صورت درهم‌بافته (interlaced) و در قالب Adam7 ایجاد شود. قالب درهم‌بافته قالبی است که در آن داده‌های شطرنجی (raster) با یک بازنمایی با تفکیک‌پذیری پایین از کل تصویر آغاز می‌شود، سپس با اطلاعات بیشتر برای کل تصویر، بعد اطلاعات باز هم بیشتر و غیره ادامه می‌یابد. به طور خاص در Adam7، هفت گذر متوالی از این دست برای کل تصویر وجود دارد. این ویژگی زمانی مفید است که تصویر را از طریق یک خط ارتباطی کُند دریافت می‌کنید و شخصی منتظر مشاهده آن است. ساده‌ترین کار در چنین حالتی این است که تا رسیدن کامل تصویر صبر کنید و سپس آن را بلافاصله نمایش دهید، اما در این صورت کاربر تا رسیدن کل تصویر با خیره شدن به یک فضای خالی وقت خود را تلف می‌کند. در قالب استاندارد غیر درهم‌بافته، داده‌ها سطر به سطر از بالا شروع به رسیدن می‌کنند، بنابراین نمایشگر می‌تواند هر سطر تصویر را به محض دریافت نشان دهد و به تدریج تا پایین رسم کند. اما با یک تصویر درهم‌بافته، نمایشگر می‌تواند کار را با نشان دادن یک نسخه با تفکیک‌پذیری پایین از تصویر آغاز کند و سپس با رسیدن داده‌های بیشتر، به تدریج کیفیت نمایش را بهبود بخشد.

 

-alpha=filename

این گزینه کانال شفافیت (آلفا) تصویر را مشخص می‌کند. شما کانال شفافیت را به صورت یک ماسک شفافیت استاندارد PGM ارائه می‌دهید (به مشخصات PGM(1) مراجعه کنید). لزوماً pnmtopng اطلاعات شفافیت را به عنوان یک کانال شفافیت در قالب PNG ذخیره نمی‌کند. اگر بتواند اطلاعات شفافیت را از طریق یک پالت نمایش دهد، به منظور ایجاد یک فایل PNG کوچکتر این کار را انجام خواهد داد. pnmtopng حتی پالت را مرتب می‌کند تا بتواند رنگ‌های مات را از بخش شفافیت پالت حذف کرده و در فضای اشغال‌شده توسط پالت صرفه‌جویی کند.

 

-transparent=color

pnmtopng رنگ مشخص‌شده را به عنوان رنگ شفاف در تصویر PNG علامت‌گذاری می‌کند.

رنگ (color) را همان‌طور که برای آرگومان روتین کتابخانه‌ای pnm_parsecolor() شرح داده شده است مشخص کنید. برای مثال red یا rgb:ff/00/0d. اگر رنگی که مشخص کرده‌اید در تصویر وجود نداشته باشد، pnmtopng به جای آن نزدیک‌ترین رنگ موجود در تصویر به رنگ مشخص‌شده را انتخاب می‌کند. نزدیکی به عنوان فاصله دکارتی بین رنگ‌ها در فضای RGB اندازه‌گیری می‌شود. اگر چند رنگ فاصله‌ی یکسانی داشته باشند، pnmtopng یکی از آن‌ها را به صورت دلخواه انتخاب می‌کند.

با این حال، اگر در ابتدای مشخصات رنگ یک علامت "=" قرار دهید، مثلاً:

                    -transparent =red

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

-background=color

باعث می‌شود pnmtopng یک تکه (chunk) رنگ پس‌زمینه در خروجی PNG ایجاد کند که می‌تواند برای تبدیلات بعدی کانال شفافیت یا رنگ شفاف استفاده شود. مقدار color را همانند -transparent مشخص کنید.

 

-palette=palettefile

این گزینه پالت مورد استفاده در PNG را مشخص می‌کند. این گزینه pnmtopng را مجبور به ایجاد نوع پالت‌دار (colormapped) تصویر PNG می‌کند -- اگر این کار ممکن نباشد، pnmtopng با خطا شکست می‌خورد. اگر پالتی که مشخص می‌کنید دقیقاً شامل رنگ‌های موجود در تصویر نباشد، pnmtopng با شکست مواجه می‌شود. از آنجا که pnmtopng در صورت لزوم به طور خودکار یک PNG پالت‌دار با پالت درست ایجاد می‌کند، تنها دلیلی که ممکن است گزینه -palette را مشخص کنید این است که ترتیب قرارگیری رنگ‌ها در پالت برایتان مهم باشد. پالت PNG رنگ‌ها را با همان ترتیبی که در پالت مشخص کرده‌اید در خود جای می‌دهد.

شما پالت را با نام بردن از یک فایل PPM مشخص می‌کنید که برای هر رنگ موجود در پالت، دارای یک پیکسل است.

به عنوان حالتی دیگر، این وضعیت را در نظر بگیرید که یک پالت دارید و می‌خواهید مطمئن شوید که PNG شما فقط شامل رنگ‌هایی از این پالت است و در صورت نیاز تقریب زده شود. برای شما مهم نیست که PNG در داخل از چه اندیس‌هایی برای رنگ‌ها استفاده می‌کند (یعنی ترتیب پالت PNG). در این حالت، نیازی به -palette ندارید. تصویر ورودی Netpbm و PPM پالت خود را به pnmremap بدهید. برخلاف آنچه ممکن است فکر کنید، استفاده از -palette در این حالت حتی از کار pnmtopng هم نخواهد کاست.

-gamma=value

باعث می‌شود pnmtopng یک تکه (chunk) با نام gAMA ایجاد کند. این اطلاعات به توصیف نحوه تفسیر مقادیر رنگ در PNG کمک می‌کند. بدون تکه gAMA، هر ابزاری که PNG را تفسیر می‌کند باید این اطلاعات را جداگانه به دست آورد (یا صرفاً یک مقدار استاندارد را فرض کند). اگر ورودی شما یک تصویر PPM یا PGM واقعی باشد، باید -gamma=.52 را مشخص کنید. اما گاهی اوقات افراد تصاویری تولید می‌کنند که در ظاهر PPM هستند، با این تفاوت که تصویر از تابع تبدیل گامایی متفاوت از آنچه برای PPM مشخص شده استفاده می‌کند. یک نمونه رایج از این حالت زمانی است که تصویر توسط سخت‌افزارهای ساده‌ای ایجاد می‌شود که توانایی محاسبات دیجیتال ندارند. همچنین، برخی برنامه‌های ساده که تصاویر را از ابتدا تولید می‌کنند، این کار را با یک تبدیل گاما انجام می‌دهند که در آن مقدار گاما ۱.۰ است.

 

-hist

از این پارامتر برای ایجاد تکه‌ای (chunk) استفاده کنید که فراوانی (یا هیستوگرام) رنگ‌های موجود در تصویر را مشخص می‌کند.

-text=filename

این گزینه به شما اجازه می‌دهد رشته‌های متنی دلخواه را به عنوان چانک‌های tEXt در خروجی PNG بگنجانید.

filename نام فایلی است که شامل رشته‌های متنی شماست.

خروجی شامل یک چانک tEXt متمایز به ازای هر مدخل در فایل خواهد بود.

در اینجا نمونه‌ای از یک فایل رشته‌های متنی آورده شده است:

	Title           PNG file
	Author          John Doe
	Description     how to include a text chunk
                        PNG file
	"Creation Date" 2015-may-11
	Software        pamtopng

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

کلمه نخست در هر مدخل، کلید رشته متنی است (برای نمونه 'Title'). این کلید از ستون اول خط آغاز می‌شود و تا پیش از نخستین نویسه جداکننده یا انتهای خط (هر کدام که زودتر باشد) ادامه می‌یابد. می‌توانید کلید را در گیومه دوتایی (double quotes) محصور کنید که در این صورت کلید می‌تواند شامل چندین کلمه باشد. گیومه‌ها جزئی از کلید نیستند. خود رشته متنی پس از کلید و هرگونه نویسه جداکننده بعد از آن، به‌علاوه متن موجود در سطرهای ادامه بعدی آغاز می‌شود.

هیچ محدودیتی در طول خط فایل یا مدخل یا کلید یا رشته متنی وجود ندارد. همچنین هیچ محدودیتی در تعداد مدخل‌ها نیست.

-ztxt=filename

همانند -text است، با این تفاوت که رشته متنی در خروجی PNG فشرده‌سازی می‌شود. pnmtopng به جای چانک‌های tEXt از چانک‌های zTXt استفاده می‌کند، مگر اینکه کلید رشته متنی با 'A' یا 'T' شروع شود. این استثنای عجیب برای سازگاری عقروعو وجود دارد؛ ما نمی‌دانیم چرا این برنامه در ابتدا بدین صورت طراحی شده بود، جز اینکه این تمایز برای شناسایی تقریبی کلیدهای 'Author' و 'Title' در نظر گرفته شده بود.

 

-rgb=chroma_list

این گزینه مشخص می‌کند که مقادیر مؤلفه‌های قرمز، سبز و آبی یک پیکسل چگونه یک رنگ خاص را تعیین می‌کنند؛ این کار با مشخص کردن مختصات رنگی (chromaticities) این ۳ منبع نور اولیه و رنگ سفید (یعنی شدت کامل هر سه) انجام می‌شود.

مقدار chroma_list فهرستی از ۸ عدد اعشاری ممیز شناور است که با فاصله از هم جدا شده‌اند: مختصات رنگی X و Y در استاندارد CIE-1931 (دقیقاً به همین ترتیب) برای هر یک از رنگ‌های سفید، قرمز، سبز و آبی، به همان ترتیب مذکور.

این اطلاعات در چانک cHRM متعلق به PNG قرار می‌گیرد.

در دستور شل، مطمئن شوید که از علامت‌های نقل‌قول استفاده می‌کنید تا فاصله‌ها در chroma_list باعث نشوند شل آن‌ها را به عنوان چندین آرگومان دستور شناسایی کند.

این گزینه در Netpbm 10.30 (اکتبر ۲۰۰۵) جدید بود. پیش از آن، گزینه -chroma همین کار را اما با نحو کمی متفاوت انجام می‌داد.

-size="x y unit"

این گزینه نسبت ابعاد (aspect ratio) پیکسل‌های منفرد تصویر و همچنین رزولوشن فیزیکی آن را تعیین می‌کند.

unit می‌تواند 0 یا 1 باشد. وقتی 1 است، گزینه رزولوشن فیزیکی تصویر را بر حسب پیکسل بر متر مشخص می‌کند. برای نمونه، -size="10000 15000 1"; بدین معناست که هنگام نمایش تصویر، ۱۰٬۰۰۰ پیکسل در راستای افقی باید ۱ متر و ۱۵٬۰۰۰ پیکسل در راستای عمودی باید یک متر را اشغال کنند. و حتی اگر این توصیه برای اندازه کلی تصویر نمایش‌داده‌شده رعایت نشود، دست‌کم باید طوری نمایش داده شود که ارتفاع هر پیکسل ۱٫۵ برابر عرض آن باشد.

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

این اطلاعات در چانک pHYS متعلق به PNG قرار می‌گیرد.

هنگامی که -size را مشخص نکنید، pnmtopng تصویر را بدون چانک pHYS ایجاد می‌کند، که به معنای پیکسل‌های مربعی بدون رزولوشن مطلق است.

این گزینه در Netpbm 10.30 (اکتبر ۲۰۰۵) جدید بود. پیش از آن، گزینه -phys همین کار را اما با نحو کمی متفاوت انجام می‌داد.

-srgbintent=intent

این گزینه تصریح می‌کند که ورودی یک تصویر شبه-Netpbm است که از فضای رنگی sRGB استفاده می‌کند (برخلاف Netpbm واقعی) و نحوه مد نظر شما برای رندر شدن رنگ‌ها را مشخص می‌کند. این گزینه باعث می‌شود pnmtopng یک چانک sRGB را در تصویر PNG بگنجاند که این مقصود را معین می‌کند؛ بنابراین برای اطلاعات بیشتر درباره معنای دقیق آن، به مستندات PNG مراجعه کنید.

intent یکی از موارد زیر است:

• perceptual
• relativecolorimetric
• saturation
• absolutecolorimetric

  این گزینه در Netpbm 10.71 (ژوئن ۲۰۱۵) جدید بود. پیش از آن، pnmtopng هرگز چانک sRGB تولید نمی‌کرد.

-modtime="[yy]yy-mm-dd hh:mm:ss"

این گزینه به شما اجازه می‌دهد مقدار زمان تغییر را برای قرار گرفتن در خروجی PNG مشخص کنید. می‌توانید پارامتر سال را به صورت یک مقدار دو رقمی یا چهار رقمی مشخص نمایید.

این گزینه در Netpbm 10.30 (اکتبر ۲۰۰۵) جدید بود. پیش از آن، گزینه -time همین کار را اما با نحو کمی متفاوت انجام می‌داد.

-filter=n

این گزینه منسوخ شده است. قبل از Netpbm 10.22 (آوریل ۲۰۰۴)، این تنها روش برای تعیین فیلتر سطر بود. این گزینه یک نوع واحد از فیلتر سطر را با عدد مشخص می‌کند که pnmtopng باید در هر سطر به کار ببرد.

در Netpbm فعلی از گزینه‌های -nofilter، -sub، -up، -avg و -paeth استفاده کنید.

-nofilter

-sub

-up

-avg

-paeth

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

این گزینه‌ها در Netpbm 10.22 (آوریل ۲۰۰۴) جدید بودند. پیش از آن، می‌توانستید از گزینه -filter برای مشخص کردن یک نوع فیلتر سطر مجاز استفاده کنید. حالت پیش‌فرض در زمانی که هیچ گزینه فیلتری تعیین نمی‌کردید نیز یکسان بود.

-compression=n

این گزینه سطح فشرده‌سازی را در فشرده‌سازی zlib تعیین می‌کند. سطحی از 0 برای بدون فشرده‌سازی (بیشترین سرعت) تا 9 برای بیشترین فشرده‌سازی (کمترین سرعت) را انتخاب کنید.

مقدار پیش‌فرض، همان مقدار پیش‌فرض کتابخانه zlib است.

-comp_mem_level=n

این گزینه سطح مصرف حافظه در فشرده‌سازی zlib را تنظیم می‌کند. سطحی از 1 برای کمترین مصرف حافظه (و کمترین سرعت) تا 9 برای بیشترین مصرف حافظه (و بیشترین سرعت) را انتخاب کنید.

مقدار پیش‌فرض، همان مقدار پیش‌فرض کتابخانه zlib است.

این گزینه در Netpbm 10.30 (اکتبر ۲۰۰۵) جدید بود.

-comp_strategy={huffman_only|filtered}

این گزینه راهبرد فشرده‌سازی در فشرده‌سازی zlib را تنظیم می‌کند. برای آگاهی از ماهیت این راهبردها، مستندات Zlib را ببینید..sp مقدار پیش‌فرض، پیش‌فرض کتابخانه zlib است.

این گزینه در Netpbm 10.30 (اکتبر ۲۰۰۵) اضافه شد.

-comp_method=deflated

این گزینه هیچ کاری انجام نمی‌دهد. تنها برای کامل بودن منطقی و سازگاری احتمالی با نسخه‌های آینده گنجانده شده است. این گزینه از نظر تئوری روش فشرده‌سازی zlib را مشخص می‌کند، اما کتابخانه Z امروزه تنها یک روش را می‌شناسد، بنابراین چیزی برای انتخاب وجود ندارد.

مقدار پیش‌فرض، پیش‌فرض کتابخانه zlib است.

این گزینه در Netpbm 10.30 (اکتبر ۲۰۰۵) اضافه شد.

-comp_window_bits=N

این گزینه مشخص می‌کند الگوریتم فشرده‌سازی zlib از پنجره‌ای با چه اندازه‌ای استفاده کند. این مقدار، لگاریتم مبنای ۲ اندازه پنجره بر حسب بایت است، بنابراین ۸ به معنی ۲۵۶ بایت است. مقدار باید بین ۸ تا ۱۵ باشد (یعنی از ۲۵۶ بایت تا 32K).

برای جزئیات بیشتر درباره ماهیت این اندازه پنجره، به مستندات Zlib مراجعه کنید.

مقدار پیش‌فرض، پیش‌فرض کتابخانه zlib است.

این گزینه در Netpbm 10.30 (اکتبر ۲۰۰۵) اضافه شد.

-comp_buffer_size=N

این گزینه اندازه قطعاتی را تعیین می‌کند که pnmtopng فشرده‌سازی zlib را روی آن‌ها انجام می‌دهد. هر قطعه فشرده‌شده در یک چانک (chunk) IDAT در PNG قرار می‌گیرد. بنابراین هرچه این مقدار بزرگ‌تر باشد، فایل PNG چانک‌های IDAT کمتری خواهد داشت. از نظر تئوری، این کار فایل PNG را کوچک‌تر می‌کند زیرا ۱) سربار کمتری به ازای هر چانک IDAT وجود خواهد داشت، و ۲) الگوریتم فشرده‌سازی داده‌های بیشتری برای پردازش در اختیار دارد. اما در عمل، این تفاوت احتمالاً در مقادیر بالاتر از حدود 8K (که مقدار پیش‌فرض است) محسوس نخواهد بود.

مقدار n اندازه قطعه فشرده‌شده (یعنی بافر فشرده‌سازی) بر حسب بایت است.

این گزینه در Netpbm 10.30 (اکتبر ۲۰۰۵) اضافه شد.

-force

هنگامی که این گزینه مشخص شود، pnmtopng بهینه‌سازی‌های خود را محدود می‌کند. خروجی PNG حاصل تا حد امکان شبیه به ورودی Netpbm خواهد بود. به عنوان مثال، خروجی PNG پالت‌بندی‌شده (paletted) نخواهد بود و کانال شفافیت به صورت یک کانال شفافیت کامل نمایش داده می‌شود، حتی اگر نمایش این اطلاعات با یک چانک شفافیت به صورت خلاصه‌تر امکان‌پذیر باشد.

 

-libversion

این گزینه باعث می‌شود pnmtopng اطلاعات نسخه مربوط به خود و کتابخانه‌های مورد استفاده‌اش را علاوه بر تمام عملکردهای عادی خود نمایش دهد. این مورد را با گزینه عمومی -version در Netpbm اشتباه نگیرید، که فقط اطلاعات نسخه کتابخانه Netpbm را نمایش داده و کار دیگری انجام نمی‌دهد.

نمی‌توان از این گزینه در برنامه‌ای که pnmtopng را فراخوانی می‌کند و نیاز به دانستن نسخه آن دارد استفاده کرد. عملکرد آن در طول تاریخچه pnmtopng تغییرات زیادی داشته است. این گزینه فقط برای بررسی توسط کاربر مناسب است.