\
.\" 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 "Pamditherbw User Manual" 0 "10 May 2010" "netpbm documentation"

.SH "نام (NAME)"

pamditherbw \- تبدیل و دیترینگ تصویر خاکستری به سیاه و سفید

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

\fBpamditherbw\fP

[\fB-floyd\fP | \fB-fs\fP
| \fB-atkinson\fP
| \fB-threshold\fP
| \fB-hilbert\fP
| \fB-dither8\fP | \fB-d8\fP | \fB-cluster3\fP
| \fB-c3\fP | \fB-cluster4\fP | \fB-c4\fP
| \fB-cluster8\fP | \fB-c8\fP]

[\fB-value\fP \fIval\fP]

[\fB-clump\fP \fIsize\fP]

[\fB-randomseed=\fP\fIinteger\fP]

[\fIpamfile\fP]
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها مخفف کرد.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه \fBpamditherbw\fP یک تصویر با مقیاس خاکستری (grayscale) را دیتر (dither) می‌کند. دیترینگ یعنی تبدیل هر سایه خاکستری به الگویی از پیکسل‌های سیاه و سفید که از دور شبیه به همان رنگ خاکستری به نظر می‌رسند.
.PP
ورودی باید یک تصویر PGM یا یک تصویر PAM با نوع تاپل GRAYSCALE باشد. با این حال، \fBpamditherbw\fP این موضوع را بررسی نمی‌کند، بنابراین اگر مثلاً یک تصویر PPM به آن بدهید، نتایج نامشخصی تولید می‌کند (در واقع فقط اولین کانال هر ورودی را دریافت کرده و به عنوان سطوح خاکستری با آن رفتار می‌کند).
.PP
خروجی یک تصویر PAM با نوع تاپل BLACKANDWHITE است. با استفاده از \fBpamtopnm\fP می‌توانید آن را به یک PBM تبدیل کنید (اگر نیاز دارید از آن در برنامه‌ای قدیمی‌تر استفاده کنید که PAM را متوجه نمی‌شود).
.PP
برای انجام برعکس دیترینگ، معمولاً می‌توانید تصویر را با \fBpamscale\fP کوچک کرده و سپس دوباره بزرگ کنید و احتمالاً نتیجه را با \fBpnmsmooth\fP یا \fBpnmconvol\fP هموار یا تار نمایید. یا از برنامه ویژه \fBpbmtopgm\fP استفاده کنید.
.PP
برای دیتر کردن یک تصویر رنگی (به منظور کاهش تعداد رنگ‌های پیکسل)، از \fBppmdither\fP استفاده کنید.
.PP
روش دیگر برای تبدیل تصویر در مقیاس خاکستری به یک تصویر سیاه و سفید، آستانه‌گذاری (thresholding) است. آستانه‌گذاری به سادگی به معنای جایگزینی هر پیکسل خاکستری با یک پیکسل سیاه یا سفید است، بسته به اینکه روشنایی آن بالاتر یا پایین‌تر از یک حد آستانه باشد. این مقدار آستانه ممکن است متغیر باشد. آستانه‌گذاری ساده در واقع حالت تقلیل‌یافته‌ای از دیترینگ است، بنابراین \fBpamditherbw\fP با گزینه \fB-threshold\fP خود آستانه‌گذاری بسیار ساده‌ای را انجام می‌دهد. اما برنامه \fBpamthreshold\fP آستانه‌گذاری پیچیده‌تر و پیشرفته‌تری را پیاده‌سازی می‌کند.
.PP
اگر تنها چیزی که می‌خواهید تبدیل یک تصویر PGM با maxval برابر با 1 به یک تصویر PBM است، \fBpamtopnm\fP این کار را انجام می‌دهد.


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

.UN quantmethod
.SS "روش کوانتیزاسیون (Quantization Method)"
.PP
روش کوانتیزاسیون پیش‌فرض، انتشار خطای فلوید-اشتاینبرگ دوطرفه (boustrophedonic Floyd-Steinberg error diffusion) است (\fB-floyd\fP یا \fB-fs\fP).
.PP
روش‌های دیگر نیز در دسترس هستند: آستانه‌گذاری ساده (\fB-threshold\fP)؛ دیتر مرتب‌شده بایر (\fB-dither8\fP) با ماتریس ۱۶×۱۶؛ روش
.UR http://www.tinrocket.com/projects/programming/graphics/00158
 اتکینسون (Atkinson)
.UE
\&؛ و سه اندازه مختلف از دیتر نقطه‌ای خوشه‌ای ۴۵ درجه (\fB-cluster3\fP، \fB-cluster4\fP، \fB-cluster8\fP).
.PP
یک روش نیم‌سایه‌زنی (halftoning) با منحنی فضاپرکن با استفاده از منحنی هیلبرت نیز در دسترس است (\fB-hilbert\fP).
.PP
روش‌های فلوید-اشتاینبرگ یا اتکینسون تقریباً همیشه خوش‌نماترین نتایج را ارائه می‌دهند؛ هرچند ظاهر زیبا همیشه آن چیزی نیست که می‌خواهید. به عنوان مثال، می‌توانید از آستانه‌گذاری در یک خط لوله پردازشی همراه با \fBpnmconvol\fP برای کارهایی نظیر لبه‌یابی یا تشخیص قله‌ها استفاده کنید. همچنین دیترینگ نقطه‌ای خوشه‌ای نمایی شبیه به چاپ روزنامه به تصویر می‌دهد که یک جلوه ویژه کاربردی است.
.PP
روش فلوید-اشتاینبرگ بسیار سنتی‌تر است، اما
.UR http://www.tinrocket.com/projects/programming/graphics/00158
 برخی ادعا می‌کنند
.UE
\& روش اتکینسون بهتر کار می‌کند.
.PP
روش منحنی هیلبرت برای پردازش تصاویر قبل از نمایش در دستگاه‌هایی که پیکسل‌های منفرد را به طور متمایز رندر نمی‌کنند (مانند چاپگرهای لیزری) مفید است. این روش دیترینگ می‌تواند نتایج بهتری نسبت به دیترینگی که معمولاً توسط خود چاپگرهای لیزری انجام می‌شود ارائه دهد. گزینه \fB-clump\fP تعداد پیکسل‌ها در یک دسته (clump) را تغییر می‌دهد. معمولاً یک تصویر PGM باید مقیاس‌بندی شود تا در صفحه چاپگر لیزری جا شود (۲۴۰۰ در ۳۰۰۰ پیکسل برای یک صفحه A4 با تفکیک‌پذیری 300 dpi)، و سپس به یک تصویر PBM دیتر شود قبل از آنکه به فایل پست‌اسکریپت تبدیل گردد. یک خط لوله چاپ ممکن است شبیه به این باشد:

.nf
    pamscale -xysize 2400 3000 image.pgm | pamditherbw -hilbert |  \e
      pamtopnm | pnmtops -scale 0.25 > image.ps 
.fi

.UN otheropts
.SS "سایر گزینه‌ها (Other Options)"



.TP
\fB-value\fP
این گزینه مقدار آستانه را برای فلوید-اشتاینبرگ، اتکینسون و آستانه‌گذاری ساده تغییر می‌دهد. این مقدار باید یک عدد حقیقی بین 0 و 1 باشد. مقدار بالاتر از 0.5 به معنای تصاویر تیره‌تر است؛ مقدار کمتر از 0.5 به معنای تصاویر روشن‌تر است.

.TP
\fB-clump\fP
این گزینه تعداد پیکسل‌ها در یک دسته (clump) را هنگام استفاده از روش منحنی هیلبرت تغییر می‌دهد. این مقدار معمولاً عددی صحیح بین ۲ و ۱۰۰ است (پیش‌فرض ۵ است). اندازه‌های کوچک‌تر دسته تصویر را کمتر لکه‌دار می‌کنند و دانه‌دانه بودن کمتری دارند، اما به نظر می‌رسد مقداری از خطی بودن مقیاس خاکستری را از بین می‌برند.

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




.UN references
.SH "مراجع (REFERENCES)"
.PP
تنها مرجعی که برای این مباحث نیاز دارید کتاب "Digital Halftoning" اثر Robert Ulichney، انتشارات MIT Press با شابک 0-262-21009-6 است.
.PP
روش فضاپرکن منحنی هیلبرت برگرفته از مقاله "Digital Halftoning with Space Filling Curves" اثر Luiz Velho در مجله Computer Graphics، دوره ۲۵، شماره ۴، مجموعه مقالات SIGGRAPH '91، صفحه ۸۱ با شابک 0-89791-436-8 است.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamtopnm" (1)\c
\&,
.BR "pgmtopgm" (1)\c
\&,
.BR "pbmtopgm" (1)\c
\&,
.BR "pamthreshold" (1)\c
\&,
.BR "pbmreduce" (1)\c
\&,
.BR "pnmconvol" (1)\c
\&,
.BR "pamscale" (1)\c
\&,
.BR "pam" (1)\c
\&,
.BR "pnm" (1)\c
\&,

.UN history
.SH "تاریخچه (HISTORY)"
.PP
برنامه \fBpamditherbw\fP در Netpbm نسخه 10.23 (ژوئیه ۲۰۰۴) جدید بود، اما در اصل همان برنامه \fBpgmtopbm\fP است که عملاً از ابتدا وجود داشته است. تفاوت \fBpamditherbw\fP با سلف خود در این است که روشنایی‌ها را به درستی جمع می‌زند (با استفاده از تبدیلات گاما؛ \fBpgmtopbm\fP فقط آن‌ها را به طور خطی جمع می‌کرد) و علاوه بر PGM و PBM، ورودی PAM را نیز می‌پذیرد و خروجی PAM تولید می‌کند.
.PP
برنامه \fBpamditherbw\fP جایگزین و منسوخ‌کننده \fBpgmtopbm\fP است.
.PP
گزینه \fB-atkinson\fP در Netpbm نسخه 10.38 (مارس ۲۰۰۷) اضافه شد.

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

حق نشر (C) ۱۹۸۹ توسط Jef Poskanzer.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm تحت عنوان 'makeman' از منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamditherbw.html
.PP