Pamseq User Manual(0) Pamseq User Manual(0)

pamseq - تولید تصویر PAM از یک توالی عددی از مقادیر تاپل

pamseq [-tupletype=tupletype] depth maxval [-min=n,n,...] [-max=n,n,...] [-step=n,n,...]

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

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

دستور pamseq یک تصویر PAM با عمق مشخص‌شده و مقدار maxval تعیین‌شده تولید می‌کند که شامل یک سطر منفرد است. این سطر شامل تاپل‌هایی است که مقادیر نمونه را در یک توالی عددی در خود دارند.

برای مثال:


    pamseq 1 4

تصویری به عرض ۵ پیکسل و ۱ سطر با تاپل‌هایی با عمق ۱ ایجاد می‌کند که شامل این نمونه‌ها به ترتیب از چپ به راست هستند:

0 1 2 3 4

مثال زیر از عمق ۲ استفاده می‌کند:


    pamseq 2 2

تصویر حاصل، تصویری به عرض ۹ پیکسل و ۱ سطر با عمق ۲ است که شامل این نمونه‌ها به ترتیب از چپ به راست می‌باشد:

(0,0) (0,1) (0,2) (1,0) (1,1) (1,2) (2,0) (2,1) 2,2)

می‌توانید مقادیر نمونهٔ آغازین و پایانی و گام تغییر را برای هر صفحه (plane) مشخص کنید. در اینجا مثالی از این حالت آورده شده است:


    pamseq 1 255 -min=4 -max=8 -step=2

این دستور مقادیر زیر را تولید می‌کند:

4 6 8

در دو بعد:


    pamseq 2 255 -min=0,4 -max=2,8 -step=1,2

(0,4) (0,6) (0,8) (1,4) (1,6) (1,8) (2,4) (2,6) (2,8)

دستور pamseq ابتدا بالاترین شماره صفحه را تغییر می‌دهد، سپس صفحه با شماره کمتر را و الی آخر. در هر صفحه، برنامه مقادیر را از نمونه با مقدار کم به زیاد تغییر می‌دهد.

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

این مقدار صفت "tuple_type" برای تصویر PAM ایجادشده است. می‌تواند هر رشته‌ای تا حداکثر ۲۵۵ نویسه باشد.
این گزینه مقدار آغازین توالی در هر صفحه را مشخص می‌کند. تعداد اعداد جداشده با ویرگول باید برابر با تعداد صفحات تصویر (عمق آن) باشد. هر عدد باید یک عدد کامل و حداکثر برابر با مقدار maxval تصویر باشد. عدد اول برای صفحهٔ ۰، عدد دوم برای صفحهٔ ۱ و به همین ترتیب است.

مقدار پیش‌فرض در هر صفحه ۰ است.

این گزینه در Netpbm نسخهٔ 10.99 (ژوئن ۲۰۲۲) اضافه شد.

این گزینه مشابه -min است و مقدار پایانی توالی را مشخص می‌کند. توالی هیچ مقداری بالاتر از این نخواهد داشت.

هر مقدار باید حداقل به بزرگی مقدار متناظر در -min باشد.

مقدار پیش‌فرض در هر صفحه برابر با مقدار maxval است.

این گزینه در Netpbm نسخهٔ 10.99 (ژوئن ۲۰۲۲) اضافه شد.

این گزینه مشابه -min است و مقدار گام توالی (اختلاف بین دو عدد متوالی) را مشخص می‌کند.

هر مقدار باید مثبت بوده و از maxval بزرگ‌تر نباشد.

در صورتی که مقادیر آغازین (-min) و پایانی (-max) یکسان باشند، مقدار گام تأثیری ندارد اما همچنان باید مقداری معتبر باشد.

مقدار پیش‌فرض در هر صفحه ۱ است.

این گزینه در Netpbm نسخهٔ 10.99 (ژوئن ۲۰۲۲) اضافه شد.

برای ایجاد یک شیب ساده از مقادیر 0..255، به عنوان ورودی برای محاسبات مختلف ماتریسی، دستور زیر را امتحان کنید:


  pamseq 1 255

(پیش از ایجاد pamseq، برنامهٔ pgmramp اغلب برای این منظور استفاده می‌شد).

برای ایجاد یک جدول رنگی PPM از تمامی رنگ‌های ممکن قابل نمایش با maxval برابر با ۵، این دستور را اجرا کنید:


  pamseq 3 5 -tupletype=RGB | pamtopnm

مجدداً، در یک برنامه مدرن مبتنی بر کتابخانه Netpbm، نیازی به pamtopnm ندارید زیرا یک تصویر PAM با حالت RGB معادل یک تصویر PPM است.

می‌توانید از چنین جدول رنگی با pnmremap(1) برای کوانتیزه‌سازی رنگ‌ها در یک تصویر استفاده کنید. با مقدار maxval برابر با ۵ که در مثال آورده شده است، یک جدول رنگی از مجموعه رنگ‌های «امن وب» (web safe) طبق تعریف Netscape به دست می‌آورید. بیشتر مرورگرهای وب تضمین می‌کنند که می‌توانند حداقل این ۲۱۶ رنگ (۲۱۵ رنگ به علاوه رنگ سیاه) را نمایش دهند.

دستور pamrestack اغلب می‌تواند از سطر منفرد pamseq یک تصویر دوبعدی سودمند تولید کند.


    pamseq 2 255 -min=0,4 -max=2,8 -step=1,2 | pamrestack -width=3

(0,4) (0,6) (0,8)
(1,4) (1,6) (1,8)
(2,4) (2,6) (2,8)

pnmremap(1), pamtopnm(1), pamrestack(1), pam(1)

دستور pamseq در ژوئن ۲۰۰۲ به Netpbm اضافه شد.

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

http://netpbm.sourceforge.net/doc/pamseq.html
4 August 2024 netpbm documentation