.TH "Pamstereogram User Manual" 0 "2 January 2021" "netpbm documentation"
.SH "نام (NAME)"
pamstereogram \- ایجاد استریوگرام تک‌تصویری (SIS) از روی نقشه عمق PAM

.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBpamstereogram\fP
[\fB\-help\fP]
[\fB\-verbose\fP]
[\fB\-blackandwhite\fP | \fB\-grayscale\fP | \fB\-color\fP]
[\fB\-maxval=\fP\fIvalue\fP]
[\fB\-patfile=\fP\fIpamfile\fP]
[\fB\-texfile=\fP\fIpamfile\fP]
[\fB\-bgcolor=\fP\fIcolor\fP]
[\fB\-smoothing=\fP\fIpixels\fP]
[\fB\-xbegin=\fP\fIpixels\fP]
[\fB\-xshift=\fP\fIpixels\fP]
[\fB\-yshift=\fP\fIpixels\fP]
[\fB\-yfillshift\fP \fIpixels\fP]
[\fB\-magnifypat=\fP\fIscale\fP]
[\fB\-guidetop\fP]
[\fB\-guidebottom\fP]
[\fB\-guidesize=\fP\fIpixels\fP]
[\fB\-dpi=\fP\fIresolution\fP]
[\fB\-crosseyed\fP]
[\fB\-makemask\fP]
[\fB\-eyesep=\fP\fIinches\fP]
[\fB\-depth=\fP\fIfraction\fP]
[\fB\-planes=\fP\fInear_pixels\fP,\fIfar_pixels\fP]
[\fB\-randomseed=\fP\fIinteger\fP]
[\fB\-tileable\fP]
[\fIinfile\fP]

.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR Netpbm (1)
است.
.PP
دستور
\fBpamstereogram\fP
یک نقشه عمق (depth map) را به عنوان ورودی خوانده و یک استریوگرام تک‌تصویری (Single-Image Stereogram / SIS) در خروجی تولید می‌کند. استریوگرام تصویری دوبعدی است که اگر با چشمان رها و بدون تمرکز مستقیم به آن نگاه شود، به صورت سه‌بعدی نمایان می‌گردد و نیازی به عینک‌های ۳ بعدی ندارد.
.PP
این برنامه گزینه‌های متعددی برای کنترل نحوه تولید استریوگرام ارائه می‌دهد، از جمله: خروجی سیاه‌وسفید، خاکستری یا رنگی؛ استریوگرام نقاط تصادفی (SIRDS) یا بافت تکرارشونده؛ راهنماهای تمرکز چشم و تنظیم فاصله چشم‌ها.
.PP
خروجی یک تصویر PAM در خروجی استاندارد است. برای ساخت تصاویر سه‌بعدی با عینک‌های قرمز/آبی به
.BR ppm3d (1)
مراجعه فرمایید.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-verbose\fP
نمایش پیام‌های توصیفی درباره ابعاد، قالب و ویژگی‌های تصویر استریوگرام در حال تولید.
.TP
\fB\-blackandwhite\fP
تولید استریوگرام نقاط تصادفی سیاه‌وسفید تک‌بیتی (حالت پیش‌فرض).
.TP
\fB\-grayscale\fP
تولید استریوگرام نقاط تصادفی با طیف خاکستری.
.TP
\fB\-color\fP
تولید استریوگرام نقاط تصادفی رنگی.
.TP
\fB\-maxval=\fP\fIvalue\fP
تعیین حداکثر مقدار رنگ یا روشنایی خروجی.
.TP
\fB\-patfile=\fP\fIpamfile\fP
استفاده از یک فایل تصویری به عنوان الگوی پس‌زمینه تکرارشونده به جای نقاط تصادفی.
.TP
\fB\-texfile=\fP\fIpamfile\fP
تعیین یک فایل تصویری به عنوان بافت برای استریوگرام بافت‌دار نگاشت‌شده (Mapped-Texture Stereogram).
.TP
\fB\-bgcolor=\fP\fIcolor\fP
تعیین رنگ پس‌زمینه تصویر بافت.
.TP
\fB\-smoothing=\fP\fIpixels\fP
هموارسازی لبه‌ها و رفع اشکالات بصری ایجادشده در مرزهای نقشه عمق.
.TP
\fB\-xshift=\fP\fIpixels\fP, \fB\-yshift\fP \fIpixels\fP
جابه‌جایی افقی یا عمودی الگوی پس‌زمینه به میزان تعیین‌شده به پیکسل.
.TP
\fB\-magnifypat=\fP\fIscale\fP
بزرگ‌نمایی هر پیکسل در فایل الگو یا هر نقطه تصادفی با ضریب صحیح مشخص‌شده.
.TP
\fB\-guidebottom\fP, \fB\-guidetop\fP
ترسیم دو مربع راهنما در بالا یا پایین تصویر جهت کمک به تنظیم تمرکز چشم‌ها برای دیدن حالت سه‌بعدی.
.TP
\fB\-guidesize=\fP\fIpixels\fP
اندازه جعبه‌های راهنما بر حسب پیکسل (پیش‌فرض: ۲۰).
.TP
\fB\-dpi=\fP\fIresolution\fP
تعیین وضوح خروجی بر حسب نقطه بر اینچ (پیش‌فرض: ۱۰۰ DPI).
.TP
\fB\-crosseyed\fP
معکوس کردن سطوح عمق برای افرادی که چشمانشان را لوچ می‌کنند یا برای نقشه‌های عمقی که در آن‌ها رنگ‌های تیره‌تر به چشم نزدیک‌ترند.
.TP
\fB\-makemask\fP
تولید یک تصویر ماسک PAM به جای استریوگرام جهت نمایش محدودیت‌های رنگ‌آمیزی الگو.
.TP
\fB\-eyesep=\fP\fIinches\fP
فاصله میان دو چشم بر حسب اینچ (پیش‌فرض: ۲.۵ اینچ معادل ۶.۴ سانتی‌متر).
.TP
\fB\-depth=\fP\fIfraction\fP
تعیین عمق میدان تصویر خروجی (پیش‌فرض: 0.3333).
.TP
\fB\-planes=\fP\fInear_pixels\fP,\fIfar_pixels\fP
تعیین صریح فاصله میان پیکسل‌های تکراری در صفحه نزدیک و صفحه دور.
.TP
\fB\-randomseed=\fP\fIinteger\fP
تعیین بذر تصادفی (seed) جهت بازتولیدپذیری نتایج.
.TP
\fB\-tileable\fP
تولید تصویری که از نظر افقی قابلیت تکرار و کاشی‌کاری پیوسته داشته باشد.

.SH "پارامترها (PARAMETERS)"
تنها پارامتر، \fIinfile\fP، نام پرونده ورودی نقشه عمق PAM با عمق ۱ است. در صورت عدم تعیین، داده‌ها از stdin خوانده می‌شوند.

.SH "نکات (NOTES)"
.SS "استریوگرام بافت نگاشت‌شده (Mapped-texture Stereograms)"
در استریوگرام بافت‌دار (MTS)، تصویر سه‌بعدی با رنگ‌های واقعی رسم می‌شود. برای تولید آن باید هم نقشه عمق و هم پرونده بافت با ابعاد یکسان ارائه شوند.

.SH "مثال‌ها (EXAMPLES)"
تولید استریوگرام نقاط تصادفی رنگی برای نمایشگر با وضوح ۸۷ DPI:
.PP
.nf
pamstereogram depthmap.pam \e
    -dpi 87 -verbose -color -maxval 1 -magnifypat 3 \e
    >3d.pam
.fi
.PP
تولید استریوگرام با استفاده از یک فایل الگوی کاشی‌کاری‌شده:
.PP
.nf
pamstereogram depthmap.pam -patfile mypattern.ppm >3d.pam
.fi

.SH "همچنین ببینید (SEE ALSO)"
.BR pam (1),
.BR pamsistoaglyph (1),
.BR ppm3d (1)

.SH "تاریخچه (HISTORY)"
دستور \fBpamstereogram\fP در نگارش ۱۰.۲۲ بسته Netpbm (آوریل ۲۰۰۴) معرفی شد.

.SH "نویسنده (AUTHOR)"
حق نشر (C) 2006-2020 متعلق به Scott Pakin <scott+pbm@pakin.org>.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' بسته Netpbm تولید شده است.
.IP
<http://netpbm.sourceforge.net/doc/pamstereogram.html>