\
.\" 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 "Pamshuffle User Manual" 0 "" "netpbm documentation"

Updated:
.SH "نام (NAME)"
pamshuffle \- درهم‌ریختن تصادفی پیکسل‌های یک تصویر Netpbm

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

\fBpamshuffle\fP
[\fB-column\fP
[\fB-randomseed\fP \fIinteger\fP]]
[\fIpamfile\fP]
.PP
کوتاه‌ترین حالت یکتای گزینه‌ها پذیرفته می‌شود. می‌توانید برای مشخص کردن گزینه‌ها به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید به جای علامت مساوی از فاصله خالی (whitespace) برای جداسازی نام گزینه از مقدار آن استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamshuffle\fP یک تصویر Netpbm را به عنوان ورودی خوانده و یک فایل خروجی تولید می‌کند که در آن پیکسل‌ها درهم‌ریخته (بُر خورده) شده‌اند. این عملیات تنها مکان پیکسل‌های موجود را تغییر می‌دهد؛ هیچ چیزی حذف یا اضافه نمی‌شود.
.PP
به‌طور پیش‌فرض، پیکسل‌ها مکان خود را در درون هر سطر به صورت مستقل تغییر می‌دهند، اما همچنین می‌توان همین درهم‌ریختن را روی تمام سطرها اعمال کرد، به این معنی که برنامه ستون‌های عمودی پیکسل‌ها را بُر می‌زند. در هر دو حالت، هیچ چینش مجدد عمودی رخ نمی‌دهد؛ این بدان معناست که تصاویری که کاملاً از خطوط افقی تشکیل شده‌اند، مانند پرچم‌های ملی آلمان، تایلند و اوکراین، بدون تغییر باقی می‌مانند.
.PP
برای بُر زدن به صورت عمودی یا انجام یک درهم‌ریزی کامل، از \fBpamshuffle\fP همراه با \fBpamflip\fP استفاده کنید. مثال‌های زیر را ببینید.
.PP
اگر فایل ورودی \fIpamfile\fP را مشخص نکنید، ورودی از ورودی استاندارد (Standard Input) خوانده می‌شود.
.PP
خروجی به خروجی استاندارد (Standard Output) ارسال می‌شود.
.PP
دستور \fBpamshuffle\fP روی جریان‌های چندتصویری کار می‌کند. این برنامه بر روی هر تصویر موجود در جریان به طور مستقل عمل کرده و یک جریان چندتصویری در خروجی تولید می‌نماید.
.PP
الگوریتم درهم‌ریختن، روش معروف
.UR https://en.wikipedia.org/wiki/Fisher%E2%80%93Yates_shuffle
فیشر-یتس (Fisher-Yates)
.UE
\& است.


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


.TP
\fB-column\fP
ستون‌های عمودی را بُر می‌زند، یعنی جابه‌جایی یکسانی را روی تمام سطرها انجام می‌دهد. بدون این گزینه، برنامه هر سطر را به صورت مستقل بُر می‌زند.

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



.UN examples
.SH "مثال‌ها (EXAMPLES)"
.PP
در مثال‌های زیر، خروجی به خروجی استاندارد ارسال می‌شود. احتمالاً مایل خواهید بود که آن را به مقصدی سودمند بازهدایت (redirect) کنید.


.IP \(bu

.sp
دستور \fBpamshuffle\fP زمانی مفید است که بخواهید خروجی منظم تولیدکننده‌های تصویر مانند \fBpamseq\fP و \fBpgmramp\fP را تصادفی‌سازی کنید.
.sp
تولید پنج جایگشت از اعداد صحیح ۰ تا ۱۵:

.nf
\f(CW
pgmramp -lr -maxval=15 16 5 | pamshuffle -plain
\fP
.fi

.IP \(bu
بُر زدن ستون‌ها:

.nf
\f(CW
pamshuffle -column image.ppm
\fP
.fi


.IP \(bu
بُر زدن سطرها:

.nf
\f(CW
pamflip -cw image.ppm | pamshuffle | pamflip -ccw
\fP
.fi

.IP \(bu
انجام درهم‌ریزی کامل (سطرها و ستون‌ها):

.nf
\f(CW
pamflip -cw image.ppm | pamshuffle | pamflip -ccw | pamshuffle
\fP
.fi




.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamseq" (1)\c
\&,
.BR "pgmramp" (1)\c
\&,
.BR "pamflip" (1)\c
\&,
.BR "ppmshift" (1)\c
\&,
.BR "ppmspread" (1)\c
\&,
.BR "pam" (1)\c
\&


.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamshuffle\fP در Netpbm نسخهٔ 10.99 (ژوئن ۲۰۲۲) معرفی شد.


.UN author
.SH "نویسنده (AUTHOR)"

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