\
.\" 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 "Pbmnoise User Manual" 0 "18 December 2021" "netpbm documentation"

.SH "نام (NAME)"
pbmnoise \- ایجاد یک تصویر PBM متشکل از نویز سفید

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

\fBpbmnoise\fP \fIwidth\fP \fIheight\fP

[\fB-ratio=\fP\fIM\fP\fB/\fP\fIN\fP]
[\fB-pack\fP]
[\fB-randomseed=\fP\fIinteger\fP]
[\fB-endian=\fP]{\fBbig\fP|\fBlittle\fP|\fBnative\fP|\fBswap\fP}] 
.PP
کوتاه‌ترین پیشوند یکتای گزینه‌ها پذیرفته می‌شود. می‌توانید برای مشخص کردن
گزینه‌ها به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید
به جای علامت مساوی از فاصله برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه
\fBpbmnoise\fP
یک تصویر PBM با پیکسل‌های تصادفی ایجاد می‌کند. شما احتمال سیاه یا سفید بودن هر پیکسل را مشخص می‌کنید (در واقع، نسبت پیکسل‌های سیاه به سفید در تصویر).
.PP
شما ابعاد تصویر را با آرگومان‌های
\fIwidth\fP
(عرض) و
\fIheight\fP
(ارتفاع) تعیین می‌کنید.


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


.TP
\fB-ratio=\fP\fIM\fP\fB/\fP\fIN\fP
نسبت پیکسل‌های سیاه در تصویر تولیدشده.
.sp
به طور دقیق، این احتمال سیاه بودن هر پیکسل مشخص را نشان می‌دهد.
بر اساس قانون اعداد بزرگ، می‌توان انتظار داشت که نسبت پیکسل‌های سیاه در یک تصویر به اندازه کافی بزرگ، نزدیک به این کسر باشد.
.sp
مقدار این گزینه یک کسر است. مخرج باید ۱ یا توانی از ۲ (عدد صحیح) تا ۶۵۵۳۶ باشد. صورت کسر باید ۰ یا یک عدد صحیح مثبت باشد که از مخرج بیشتر نشود.
.sp
مقدار پیش‌فرض ۱/۲ است، به این معنی که تصویر خروجی اساساً تعداد برابری پیکسل سیاه و سفید دارد.
.sp
اگر نسبت ۰ باشد تصویر خروجی کاملاً سفید خواهد بود. اگر ۱ باشد، خروجی کاملاً سیاه است.

.TP
\fB-pack\fP
این برنامه پیکسل‌ها را در واحدهای ۳۲ بیتی تولید می‌کند و به طور پیش‌فرض پیکسل‌های کسری باقیمانده در انتهای سطر را نادیده می‌گیرد. در صورت تعیین این گزینه، پیکسل‌های بلااستفاده به سطر بعدی منتقل می‌شوند که با مقداری هزینه سربار، از هدررفت جلوگیری می‌کند.
.sp
استفاده از این گزینه هنگام کوچک بودن عرض تصویر، کارایی را بهبود می‌بخشد.

.TP
\fB-randomseed=\fP\fIinteger\fP
این مقدار بذر (seed) برای مولد اعداد تصادفی است که پیکسل‌ها را تولید می‌کند.
.sp
از این گزینه برای اطمینان از دریافت تصویر یکسان در دفعات مختلف اجرا استفاده کنید.
.sp
به طور پیش‌فرض،
\fBpbmnoise\fP
از بذری که از ساعت سیستم و شناسه فرایند (PID) مشتق شده استفاده می‌کند، که نتایجی نسبتاً غیرهمبسته در دفعات اجرای چندگانه به شما می‌دهد.

.TP
\fB-endian=\fP\fImode\fP
برنامه
\fBpbmnoise\fP
درون خود اعداد صحیح ۳۲ بیتی تصادفی تولید می‌کند و از کدگذاری باینری سیستم برای آن اعداد به عنوان رشته‌های پیکسلی استفاده می‌نماید. از آنجا که اعداد صحیح تصادفی هستند، در حالت عادی فرقی نمی‌کند که چه کدگذاری باینری برای آن‌ها به کار رفته است، اما اگر به نتایج یکسان بین ماشین‌های مختلف با استفاده از یک مولد اعداد تصادفی نیاز داشته باشید، این موضوع اهمیت پیدا می‌کند. به همین دلیل (عمدتاً برای آزمایش برنامه)، این گزینه به شما اجازه می‌دهد که ترتیب بایت‌ها را بین big-endian و little-endian کنترل کنید.
.sp
مقدار
\fImode\fP
یکی از موارد زیر است:


.TP
\fBbig\fP
اجبار خروجی به big-endian با مرتب‌سازی مجدد بایت‌ها در ماشین‌های little-endian. در ماشین‌های big-endian تأثیری ندارد.

.TP
\fBlittle\fP
مشابه مورد قبل، اجبار خروجی به little-endian.

.TP
\fBnative\fP
عدم تغییر در ترتیب بایت‌ها (حالت بومی سیستم). این مقدار پیش‌فرض است.

.TP
\fBswap\fP
تعویض دائمی ترتیب بایت‌ها، صرف‌نظر از endianness سیستم.




.UN examples
.SH "مثال‌ها (EXAMPLES)"
.PP
دستور زیر یک تصویر PBM تصادفی تولید می‌کند که تقریباً یک‌سوم پیکسل‌های آن سیاه هستند:
.nf
\f(CW
  pbmnoise -ratio=11/32 1200 1200 > random.pbm
\fP
.fi
.PP
دستور زیر یک روش جایگزین برای تولید تصویر تصادفی PBM است که به جای
\fBpbmnoise\fP
از
\fBpgmnoise\fP
و
\fBpgmtopbm\fP
استفاده می‌کند. این روش کارایی کمتری دارد:
.nf
\f(CW
  pgmnoise -maxval=100 1200 1200 | \e
    pgmtopbm -threshold -value=0.333 > random.pbm
\fP
.fi
.PP
دستور زیر یک تصویر PPM تصادفی با maxval برابر ۱ تولید می‌کند:
.nf
\f(CW
  pbmnoise 600 400 > red.pbm
  pbmnoise 600 400 > green.pbm
  pbmnoise 600 400 > blue.pbm
  rgb3topbm red.pbm green.pbm blue.pbm > random.ppm
\fP
.fi


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pbm" (1)\c
\&
.BR "pgmnoise" (1)\c
\&
.BR "pgmtopbm" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور
\fBpbmnoise\fP
در Netpbm 10.97 (دسامبر 2021) جدید بود.
.PP
در نسخه‌های پیشین Netpbm، می‌توانید از
\fBpgmnoise\fP
استفاده کنید.

  
.UN author
.SH "نویسنده (AUTHOR)"
.PP
این برنامه توسط Akira F Urushibata نوشته شده و در دسامبر 2021 به مالکیت عمومی (public domain) واگذار شده است.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' از Netpbm و از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارند:
.IP
.B http://netpbm.sourceforge.net/doc/pbmnoise.html
.PP