.\" 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 "Pamsistoaglyph User Manual" 0 "05 April 2009" "netpbm documentation"

.SH "نام (NAME)"

pamsistoaglyph \- تبدیل یک استریوگرام تک‌تصویری به تصویر آناگلیف قرمز/فیروزه‌ای


.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBpamsistoaglyph\fP
[--\fBinvert\fP]
[--\fBsep\fP=\fInumber\fP]
[--\fBminsep\fP=\fInumber\fP]
[--\fBgray\fP=\fInumber\fP]
[\fIin_netpbmfile\fP
.PP
تمامی گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. می‌توانید بین نام یک گزینه و مقدار آن از نویسه فاصله یا علامت مساوی استفاده کنید.


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه \fBpamsistoaglyph\fP یک تصویر Netpbm را به عنوان ورودی می‌خواند و یک تصویر Netpbm را در خروجی تولید می‌کند.
.PP
برنامه \fBpamsistoaglyph\fP یک استریوگرام تک‌تصویری (SIS)، مانند موارد تولیدشده توسط
.BR "pamstereogram" (1)\c
\&،
را دریافت کرده و آن را به یک تصویر آناگلیف (anaglyphic) قرمز/فیروزه‌ای، مانند موارد تولیدشده توسط
.BR "ppm3d" (1)\c
\&،
تبدیل می‌کند.
بسیاری از افراد برای فریب دادن چشمان خود جهت تمرکز بر نقطه‌ای فراتر از تصویر پیش رویشان دچار مشکل می‌شوند و بنابراین نمی‌توانند شکل سه‌بعدیِ پنهان در یک استریوگرام تک‌تصویری را تشخیص دهند. ادراک سه‌بعدی استریوگرام‌های آناگلیف ساده‌تر است، اما نیاز به یک عینک قرمز/فیروزه‌ای دارند، نظیر عینک‌هایی که اغلب برای تماشای فیلم‌های سه‌بعدی به کار می‌روند. هدف \fBpamsistoaglyph\fP کمک به افرادی است که در تماشای استریوگرام‌های تک‌تصویری مشکل دارند تا بتوانند این جلوه سه‌بعدی جذاب را مشاهده کنند.
.PP
برنامه \fBpamsistoaglyph\fP می‌تواند استریوگرام‌های تک‌تصویری با نقاط تصادفی (SIRDS)، استریوگرام‌های کاغذدیواری و حتی استریوگرام‌های دوتصویری را به تصاویر آناگلیف تبدیل کند.


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


.TP
\fB--invert\fP
تصاویر چشم چپ و راست را جابه‌جا می‌کند. \fBpamsistoaglyph\fP فرض می‌کند که ورودی آن نشان‌دهنده یک استریوگرام چشم‌موازی (wall-eyed) است و تصویر آناگلیف را متناسب با آن تولید می‌کند. اگر تصویر تولیدشده در جایی که باید به سمت بیرون برجسته باشد به درون صفحه فرورفته به نظر برسد (و برعکس)، معمولاً حاکی از آن است که تصویر ورودی نمایانگر یک استریوگرام چشم‌متقاطع (cross-eyed) است. برای تصحیح عمق تصویر از \fB--invert\fP استفاده کنید.

.TP
\fB--sep\fP=\fInumber\fP
فاصله بر حسب پیکسل میان تصاویر چشم چپ و راست را تعیین می‌کند. اساساً این مقدار متناظر با فاصله میان تکرارهای الگوی پس‌زمینه است. استفاده از گزینه \fB--sep\fP به ندرت لازم است، زیرا \fBpamsistoaglyph\fP در تشخیص خودکار فاصله تفکیک چشم‌ها عملکرد بسیار مناسبی دارد.

.TP
\fB--minsep\fP=\fInumber\fP
این گزینه مشابه \fB--sep\fP است، اما \fBpamsistoaglyph\fP را تنها به یک \fIحداقل\fP فاصله تفکیک چشم محدود می‌کند. هر فاصله‌ای بزرگ‌تر از \fInumber\fP قابل قبول خواهد بود. استفاده از گزینه \fB--minsep\fP به ندرت ضروری است، زیرا \fBpamsistoaglyph\fP در تشخیص خودکار فاصله تفکیک چشم عملکرد خوبی دارد. مقدار پیش‌فرض برای حداقل فاصله تفکیک چشم، ۱۰٪ عرض تصویر است؛ به نظر می‌رسد این مقدار در عمل به خوبی کار می‌کند.

.TP
\fB--gray\fP=\fInumber\fP
تعداد سطوح خاکستری مورد استفاده را هنگام جستجو برای فاصله بهینه تفکیک چشم‌ها محدود می‌کند. از آنجا که \fBpamsistoaglyph\fP به دنبال الگوهای تکرارشونده می‌گردد، نسبت به سردرگمی حاصل از تغییرات جزئی رنگ حساس است. با تبدیل تصویر ورودی به مقیاس خاکستری (grayscale) و محدود ساختن تعداد سطوح خاکستری، \fBpamsistoaglyph\fP اثرات تغییرات ناخواسته در رنگ را کاهش می‌دهد (برای مثال، تغییراتی که در اثر تبدیل از یک تصویر JPEG بی‌کیفیت ایجاد می‌شوند). مقدار پیش‌فرض ۶۳ به نظر می‌رسد عملکرد مناسبی دارد، بنابراین استفاده از گزینه \fB--gray\fP به ندرت لازم خواهد بود.



.UN notes
.SH "نکات (NOTES)"
.PP
الگوریتم تطبیق به‌کاررفته در \fBpamsistoaglyph\fP منحصراً برای این برنامه توسعه یافته است. تا آنجا که نویسنده آگاهی دارد، هیچ الگوریتم پیشینی برای تبدیل استریوگرام‌ها به تصاویر آناگلیف وجود ندارد. این الگوریتم به شرح زیر کار می‌کند:


.IP \(bu
تصویر را به مقیاس خاکستری تبدیل می‌کند تا توانایی شناسایی تطابق‌ها افزایش یابد.

.IP \(bu
تعداد پیکسل‌هایی را که با \fIN\fP پیکسل جلوتر در تصویر مطابقت دارند، برای تمامی مقادیر \fIN\fP در بازه [1, \fIwidth\fP/2] می‌شمارد.

.IP \(bu
میانگین متحرک (mu) و انحراف معیار متحرک (sigma) تعداد پیکسل‌های منطبق را نگهداری می‌کند.

.IP \(bu
مقدار \fIN\fP متناظر با هر جهش (spike) در تعداد پیکسل‌های منطبق را ذخیره می‌کند. جهش به عنوان شمارشی تعریف می‌شود که از میانگین به اضافه یک، دو، یا سه برابر انحراف معیار فراتر رود. تنها نخستین جهش از یک ضریب انحراف معیار مشخص ذخیره می‌شود.

.IP \(bu
اگر شمارشی بزرگ‌تر از mu+3sigma مشاهده شد، مقدار \fIN\fP متناظر را برمی‌گرداند. در غیر این صورت، چنانچه شمارشی بزرگ‌تر از mu+2sigma مشاهده شد، مقدار \fIN\fP متناظر را برمی‌گرداند. در غیر این صورت، چنانچه شمارشی بزرگ‌تر از mu+sigma مشاهده شد، مقدار \fIN\fP متناظر را برمی‌گرداند. در غیر این صورت، آن \fIN\fPای را بازمی‌گرداند که حداقل میانگین فاصله بین پیکسل‌های منطبق را حاصل کند (یعنی،\ \fI#matches\fP تقسیم بر \fI#pixels\fP). اگر هیچ مقدار \fIN\fPای از حداقل مقدار مجاز تفکیک چشم‌ها فراتر نرود، مقدار صفر را به نشانه شکست بازمی‌گرداند.

.IP \(bu
اگر الگوریتم مقدار صفر را بازگرداند، الگوریتم به صورت مستقل بر روی هر سطر از تصویر ورودی بازاجرا می‌شود و میانه تمام مقادیر \fIN\fP که از حداقل مقدار مجاز تفکیک چشم‌ها بیشتر هستند بازگردانده می‌شود. اگر چنین \fIN\fPای یافت نشد، برنامه با یک پیام خطا متوقف می‌شود.


.UN history
.SH "تاریخچه (HISTORY)"
.PP
برنامه \fBpamsistoaglyph\fP توسط Scott Pakin در آوریل ۲۰۰۹ نوشته شد. این برنامه برای نخستین بار در Netpbm نگارش ۱۰.۴۷ (ژوئن ۲۰۰۹) منتشر شد.


.UN author
.SH "نویسندگان (AUTHORS)"
.PP
حق نشر \(C) ۲۰۰۹ متعلق به Scott
Pakin, \fIscott+pbm@pakin.org\fP است.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"



.IP \(bu

.BR "pamstereogram" (1)\c
\&
.IP \(bu

.BR "ppm3d" (1)\c
\&,
.IP \(bu

.UR http://en.wikipedia.org/wiki/Stereogram
http://en.wikipedia.org/wiki/Stereogram
.UE
\&
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار makeman در Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamsistoaglyph.html
.PP