\
.\" 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 "Pamseq User Manual" 0 "4 August 2024" "netpbm documentation"


.SH "نام (NAME)"

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

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

\fBpamseq\fP
[\fB-tupletype=\fP\fItupletype\fP]
\fIdepth\fP
\fImaxval\fP
[\fB-min=\fP\fIn\fP\fB,\fP\fIn\fP\fB,\fP...]
[\fB-max=\fP\fIn\fP\fB,\fP\fIn\fP\fB,\fP...]
[\fB-step=\fP\fIn\fP\fB,\fP\fIn\fP\fB,\fP...]
.PP
تمامی گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. می‌توانید برای تعیین یک گزینه به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید بین نام گزینه و مقدار آن از فاصله یا علامت مساوی استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamseq\fP یک تصویر PAM با عمق مشخص‌شده و مقدار maxval تعیین‌شده تولید می‌کند که شامل یک سطر منفرد است. این سطر شامل تاپل‌هایی است که مقادیر نمونه را در یک توالی عددی در خود دارند.
.PP
برای مثال:

.nf
\f(CW
    pamseq 1 4
\fP
.fi

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

.nf
    0 1 2 3 4
.fi

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

.nf
\f(CW
    pamseq 2 2
\fP
.fi

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

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

.nf
\f(CW
    pamseq 1 255 -min=4 -max=8 -step=2
\fP
.fi

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

.nf
    4 6 8
.fi

در دو بعد:

.nf
\f(CW
    pamseq 2 255 -min=0,4 -max=2,8 -step=1,2
\fP
.fi

.nf
    (0,4) (0,6) (0,8) (1,4) (1,6) (1,8) (2,4) (2,6) (2,8)
.fi
.PP
دستور \fBpamseq\fP ابتدا بالاترین شماره صفحه را تغییر می‌دهد، سپس صفحه با شماره کمتر را و الی آخر. در هر صفحه، برنامه مقادیر را از نمونه با مقدار کم به زیاد تغییر می‌دهد.

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


.TP
\fB-tupletype\fP
این مقدار صفت "tuple_type" برای تصویر PAM ایجادشده است. می‌تواند هر رشته‌ای تا حداکثر ۲۵۵ نویسه باشد.

.TP
\fB-min=\fP\fIn\fP\fB,\fP\fIn\fP\fB,\fP...
این گزینه مقدار آغازین توالی در هر صفحه را مشخص می‌کند. تعداد اعداد جداشده با ویرگول باید برابر با تعداد صفحات تصویر (عمق آن) باشد. هر عدد باید یک عدد کامل و حداکثر برابر با مقدار maxval تصویر باشد. عدد اول برای صفحهٔ ۰، عدد دوم برای صفحهٔ ۱ و به همین ترتیب است.
.sp
مقدار پیش‌فرض در هر صفحه ۰ است.
.sp
این گزینه در Netpbm نسخهٔ 10.99 (ژوئن ۲۰۲۲) اضافه شد.

.TP
\fB-max=\fP\fIn\fP\fB,\fP\fIn\fP\fB,\fP...
.sp
این گزینه مشابه \fB-min\fP است و مقدار پایانی توالی را مشخص می‌کند. توالی هیچ مقداری بالاتر از این نخواهد داشت.
.sp
هر مقدار باید حداقل به بزرگی مقدار متناظر در \fB-min\fP باشد.
.sp
مقدار پیش‌فرض در هر صفحه برابر با مقدار maxval است.
.sp
این گزینه در Netpbm نسخهٔ 10.99 (ژوئن ۲۰۲۲) اضافه شد.

.TP
\fB-step=\fP\fIn\fP\fB,\fP\fIn\fP\fB,\fP...
.sp
این گزینه مشابه \fB-min\fP است و مقدار گام توالی (اختلاف بین دو عدد متوالی) را مشخص می‌کند.
.sp
هر مقدار باید مثبت بوده و از maxval بزرگ‌تر نباشد.
.sp
در صورتی که مقادیر آغازین (\fB-min\fP) و پایانی (\fB-max\fP) یکسان باشند، مقدار گام تأثیری ندارد اما همچنان باید مقداری معتبر باشد.
.sp
مقدار پیش‌فرض در هر صفحه ۱ است.
.sp
این گزینه در Netpbm نسخهٔ 10.99 (ژوئن ۲۰۲۲) اضافه شد.



.UN usage
.SH "نحوه استفاده (USAGE)"
.PP
برای ایجاد یک شیب ساده از مقادیر 0..255، به عنوان ورودی برای محاسبات مختلف ماتریسی، دستور زیر را امتحان کنید:
.nf
\f(CW
  pamseq 1 255 
\fP
.fi
(پیش از ایجاد \fBpamseq\fP، برنامهٔ \fBpgmramp\fP اغلب برای این منظور استفاده می‌شد).
.PP
برای ایجاد یک جدول رنگی PPM از تمامی رنگ‌های ممکن قابل نمایش با maxval برابر با ۵، این دستور را اجرا کنید:
.nf
\f(CW
  pamseq 3 5 -tupletype=RGB | pamtopnm
\fP
.fi

مجدداً، در یک برنامه مدرن مبتنی بر کتابخانه Netpbm، نیازی به \fBpamtopnm\fP ندارید زیرا یک تصویر PAM با حالت RGB معادل یک تصویر PPM است.
.PP
می‌توانید از چنین جدول رنگی با
.BR "pnmremap" (1)\c
\& برای کوانتیزه‌سازی رنگ‌ها در یک تصویر استفاده کنید. با مقدار maxval برابر با ۵ که در مثال آورده شده است، یک جدول رنگی از مجموعه رنگ‌های «امن وب» (web safe) طبق تعریف Netscape به دست می‌آورید. بیشتر مرورگرهای وب تضمین می‌کنند که می‌توانند حداقل این ۲۱۶ رنگ (۲۱۵ رنگ به علاوه رنگ سیاه) را نمایش دهند.
.PP
دستور \fBpamrestack\fP اغلب می‌تواند از سطر منفرد \fBpamseq\fP یک تصویر دوبعدی سودمند تولید کند.

.nf
\f(CW
    pamseq 2 255 -min=0,4 -max=2,8 -step=1,2 | pamrestack -width=3
\fP
.fi

.nf
    (0,4) (0,6) (0,8)
    (1,4) (1,6) (1,8)
    (2,4) (2,6) (2,8)
.fi
  

  
.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmremap" (1)\c
\&,
.BR "pamtopnm" (1)\c
\&,
.BR "pamrestack" (1)\c
\&,
.BR "pam" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"

دستور \fBpamseq\fP در ژوئن ۲۰۰۲ به Netpbm اضافه شد.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamseq.html
.PP