.\" 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 "Ppmshadow User Manual" 0 "24 June 2017" "netpbm documentation"

.SH "نام (NAME)"
ppmshadow \- افزودن سایه‌های شبیه‌سازی‌شده به یک تصویر PPM

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

\fBppmshadow\fP
[\fB-b\fP \fIblur_size\fP]
[\fB-k\fP]
[\fB-t\fP]
[\fB-x\fP \fIxoffset\fP]
[\fB-y\fP \fIyoffset\fP]
[\fIppmfile\fP]


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBppmshadow\fP یک سایه شبیه‌سازی‌شده به یک تصویر اضافه می‌کند و این جلوه را پدید می‌آورد که محتویات تصویر بالای صفحه شناور هستند و سایه‌ای پراکنده بر روی پس‌زمینه می‌اندازند. سایه‌ها می‌توانند سیاه باشند (مانند سایه حاصل از اجسام کدر) یا نیمه‌شفاف باشند (به طوری که سایه رنگ جسمی را که بر آن سایه افکنده به خود می‌گیرد). شما می‌توانید میزان وضوح سایه و میزان جابجایی آن از تصویر را با گزینه‌های خط فرمان مشخص کنید.
.PP
برنامه \fBppmshadow\fP تصویر شما را به عنوان پیش‌زمینه‌ای بر روی یک پس‌زمینه در نظر می‌گیرد. رنگ پس‌زمینه، هر رنگی است که پیکسل گوشه بالا سمت چپ تصویر شما دارد. پس‌زمینه شامل تمام پیکسل‌هایی است که آن رنگ را دارند و پیش‌زمینه هر چیز دیگری غیر از آن است. سایه‌ای که \fBppmshadow\fP تولید می‌کند، سایه پیش‌زمینه است که بر روی پس‌زمینه انداخته می‌شود.
.PP
اندازه سایه برابر با اندازه پیش‌زمینه است، به اضافه مقداری حاشیه محو که با گزینه \fB-b\fP تعیین می‌شود. این سایه به گونه‌ای برش داده می‌شود تا درون تصویر شما بگنجد. ابعاد تصویر خروجی با ابعاد تصویر ورودی یکسان است.
.PP
می‌توانید پیش از اجرای \fBppmshadow\fP روی یک تصویر، از \fBpamcomp\fP برای قرار دادن یک تصویر پیش‌زمینه روی پس‌زمینه استفاده کنید. همچنین می‌توانید از \fBppmmake\fP برای ساخت تصویر پس‌زمینه (تنها تصویری با یک رنگ یکدست) استفاده نمایید.
.PP
خروجی دارای همان ابعاد و مقدار maxval ورودی است.
.PP
اگر عمق رنگ (maxval) تصویر بسیار پایین باشد، محوسازی برای ایجاد حاشیه‌های سایه جلوه مطلوبی نخواهد داشت -- شما برای به دست آوردن تمام طیف‌های مورد نیاز جهت ایجاد یک گرادیان یکدست به یک maxval بالا نیاز دارید. بنابراین اگر ورودی شما دارای maxval پایینی است (از جمله به ویژه اگر ورودی PBM باشد، که یعنی maxval آن ۱ است)، آن را از طریق \fBpamdepth\fP عبور دهید تا مقدار maxval آن افزایش یابد. معمولاً مقدار ۲۵۵ انتخاب مناسبی است.
.PP
ورودی یک فایل PPM است که با آرگومان خط فرمان \fIppmfile\fP مشخص می‌شود؛ اگر \fIppmfile\fP را تعیین نکنید، ورودی، ورودی استاندارد (Standard Input) خواهد بود.
.PP
خروجی یک فایل PPM است که در خروجی استاندارد (Standard Output) نوشته می‌شود.


.UN options
.SH "گزینه‌ها (OPTIONS)"

دستور \fBppmshadow\fP گزینه‌های خط فرمان زیر را می‌شناسد:


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

.TP
\fB-k\fP
فایل‌های تصویری موقت میانی را نگه می‌دارد. در هنگام اشکال‌زدایی، این فایل‌های میانی سرنخ‌های بسیاری درباره منشأ خطا ارائه می‌دهند. برای فهرستی از محتویات هر فایل، به بخش
.UR #tempfiles
زیر
.UE
\& مراجعه کنید.

.TP
\fB-t\fP
اجزای غیر پس‌زمینه در تصویر را نیمه‌شفاف در نظر می‌گیرد -- این اجزا به جای سایه سیاه که حالت پیش‌فرض است، سایه‌ای از رنگ خود می‌اندازند. این کار اغلب باعث ایجاد تصاویری تار و ناخوانا می‌شود، اما در برخی شرایط ممکن است جلوه بهتری داشته باشد.

.TP
\fB-x\fP\fI xoffset\fP
جابجایی منبع نور به سمت چپ تصویر را تعیین می‌کند. تنظیمات بزرگ‌تر \fBxoffset\fP، سایه را به سمت راست منتقل می‌کنند، همانند نوری که از فاصله‌ای دورتر در سمت چپ می‌تابد. در صورت عدم تعیین، جابجایی افقی برابر با نصف \fIblur_size \fP (در بالا)، به سمت چپ است.

.TP
\fB-y\fP\fI yoffset\fP
جابجایی منبع نور در بالای تصویر را مشخص می‌کند. مقادیر بزرگ‌تر سایه را به سمت پایین جابجا می‌کنند، متناظر با بردن نور به ارتفاعی بالاتر در بالای تصویر. اگر \fB-y\fP را مشخص نکنید، پیش‌فرض جابجایی عمودی برابر با جابجایی افقی (در بالا)، به سمت بالا خواهد بود.


.PP
دستور \fBppmshadow\fP گزینه‌های مشترک تمام برنامه‌های مبتنی بر libnetpbm را نمی‌پذیرد (نگاه کنید به 
.UR index.html#commonoptions
 Common Options
.UE
\&.) با این وجود، گزینه \fB-version\fP کار می‌کند.

.UN limitations
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
تصویر مبدأ باید در لبه‌ها و در جهتی که سایه انداخته می‌شود فضای کافی برای گنجاندن سایه داشته باشد -- در غیر این صورت ممکن است برخی از مراحل داخلی با شکست مواجه شوند. معمولاً می‌توانید پیش از پردازش تصویر با \fBppmshadow\fP، حاشیه تصویری را که بیش از حد فشرده برش خورده است با \fBpnmmargin\fP گسترش دهید.
.PP
پیکسل‌های سیاه و پیکسل‌هایی با رنگ مشابه پس‌زمینه تصویر، سایه نمی‌اندازند. اگر این موضوع باعث ایجاد «حفره‌های» ناخواسته در سایه می‌شود، نواحی تداخل‌کننده را با رنگی پر کنید که مقادیر RGB آن به اندازه ۱ واحد با رنگ سیاه یا رنگ پس‌زمینه متفاوت باشد، که برای بیننده غیرقابل‌تشخیص خواهد بود. از آنجا که مقایسه دقیق انجام می‌شود، نواحی تغییر یافته اکنون سایه خواهند انداخت.
.PP
رنگ پس‌زمینه تصویر مبدأ (که در خروجی حفظ می‌شود) به عنوان رنگ پیکسل گوشه بالا سمت چپ تصویر ورودی فرض می‌شود. اگر آن پیکسل بخشی از پس‌زمینه نیست، کافی است یک کادر یک‌پیکسلی در بالای تصویر اضافه کنید، تصویر سایه‌دار را تولید کنید و سپس کادر را از آن حذف نمایید.
.PP
اگر در حین کار خطایی رخ دهد، پیام‌های خطای حاصل از برنامه‌های مختلف Netpbm که توسط \fBppmshadow\fP فراخوانی می‌شوند، عموماً هیچ سرنخ یا سرنخ اندکی درباره اینکه اشکال کار \fBppmshadow\fP در کجا بوده است ارائه می‌دهند. در این حالت، گزینه \fB-k\fP را مشخص کرده و نتایج میانی را در فایل‌های موقت (که این گزینه باعث نگهداری آن‌ها می‌شود) بررسی کنید. اگر دستوراتی را که \fBppmshadow\fP روی این فایل‌ها اجرا می‌کند به صورت دستی اجرا نمایید، می‌توانید علت مشکل را پیدا کنید. در مواردی که با مشکل مواجه می‌شوید و می‌خواهید فرآیند تولید تصویر را در طول مسیر به طور دستی تنظیم کنید، می‌توانید فایل‌های میانی را با گزینه \fB-k \fP نگه دارید، آن‌ها را به طور مناسب با یک ویرایشگر تصویر ویرایش کنید و سپس با استفاده از مراحلی که در کد \fBppmshadow\fP به کار رفته، مجدداً آن‌ها را با یکدیگر ترکیب نمایید.
.PP
سایه‌ها به طور پیش‌فرض سیاه هستند، مانند سایه ایجاد شده توسط ماده‌ای کدر در تصویر که مانع عبور نور سفید می‌شود. برای شبیه‌سازی ماده نیمه‌شفاف از گزینه \fB-t\fP استفاده کنید که در آن سایه، رنگ شیء سایه‌افکن را به خود می‌گیرد. اگر تضاد رنگی (کنتراست) میان تصویر و پس‌زمینه ناکافی باشد، گزینه \fB-t\fP ممکن است نتایج نامطلوبی ایجاد کند که شبیه به یک محوشدگی ساده از تصویر اصلی به نظر می‌رسد.
.PP
از آنجا که در گذشته حداکثر maxval در Netpbm برابر با ۲۵۵ بود، که بدان معناست بزرگ‌ترین هسته کانولوشنی که \fBpnmconvol\fP می‌توانست استفاده کند ۱۱ در ۱۱ بود، \fBppmshadow\fP شامل یک راه‌حل موقت زشت و مصرف‌کننده زمان پردازنده (CPU) است که در صورت درخواست تاری بیشتر از ۱۱، یک کانولوشن اولیه با یک هسته ۱۱ در ۱۱ انجام می‌دهد، سپس \fBpnmsmooth\fP را (که خود برنامه‌ای است که \fBpnmconvol\fP را با یک هسته ۳ در ۳ فراخوانی می‌کند) به تعداد دفعاتی که میزان تاری درخواست‌شده از ۱۱ بیشتر است اجرا می‌نماید. این کار ناخوشایند است، اما در شرایط نادری که به تاری بیشتر از ۱۱ نیاز دارید، کار را پیش می‌برد.
.PP
اگر قصد دارید تصویری را با وضوح بالا تولید کنید و سپس با \fBpamscale\fP برای رفع لبه‌های دندانه‌دار از طریق بازنمونه‌برداری آن را به اندازه مخصوص انتشار کاهش دهید، بهتر است سایه را پیش از کوچک کردن مقیاس، در تصویر اصلی با وضوح بالا ایجاد کنید. اگر ابتدا مقیاس را تغییر دهید و سپس سایه را اضافه کنید، به دلیل اینکه پیکسل‌های بازنمونه‌برداری‌شده بین تصویر و پس‌زمینه روی سایه را می‌پوشانند، یک نوار دندانه‌دار ناخوشایند میان لبه شیء و سایه آن شکل خواهد گرفت.

.UN exitstatus
.SH "وضعیت خروج (EXIT STATUS)"

دستور \fBppmshadow\fP در صورتی که پردازش بدون خطا انجام شود وضعیت 0، و در صورتی که خطایی مانع از تولید خروجی شود، یک کد خطای غیرصفر یونیکس بازمی‌گرداند. برخی از خطاها ممکن است منجر به خاتمه ناگهانی اسکریپت شوند، که معمولاً با نمایش پیام‌های خطا از مؤلفه‌های مختلف Netpbm مورد استفاده همراه است بدون آنکه یک کد خطای غیرصفر بازگردانده شود. هنگامی که این حالت پیش می‌آید، فایل خروجی خالی خواهد بود، بنابراین اگر نیاز دارید بدانید آیا برنامه با موفقیت عمل کرده است یا خیر، حتماً این مورد را بررسی کنید.

.UN tempfiles
.SH "فایل‌های موقت (TEMPORARY FILES)"
.PP
دستور \fBppmshadow\fP هنگام اجرا تعدادی فایل موقت ایجاد می‌کند. این برنامه یک دایرکتوری جدید برای آن‌ها در دایرکتوری مشخص‌شده توسط متغیر محیطی \fBTMPDIR\fP می‌سازد که در صورت تنظیم نشدن، پیش‌فرض آن \fB/tmp\fP است.
.PP
در حالت عادی، \fBppmshadow\fP یک نام یکتا برای دایرکتوری موقت پیدا می‌کند و هر فایل موقت را به محض پایان کار حذف کرده و پس از اتمام هیچ پسماندی بر جای نمی‌گذارد. برای نگهداری فایل‌های میانی به منظور اشکال‌زدایی، از گزینه خط فرمان \fB-k\fP استفاده کنید. در این حالت، نام دایرکتوری \fBppmshadow\fP\fIpid\fP خواهد بود که در آن \fIpid\fP شناسه فرآیند مربوط به فرآیند \fBppmshadow\fP است، و اگر \fBppmshadow\fP به دلیل اینکه نام از قبل در حال استفاده است نتواند آن دایرکتوری را ایجاد کند، برنامه با شکست مواجه می‌شود.
.PP
فایل‌های موقت عبارتند از: 


.TP
\fBinfile.ppm\fP
یک نسخه کپی از ورودی.

.TP
\fBbackground.ppm\fP
تصویر خالی با رنگ پس‌زمینه تصویر مبدأ.

.TP
\fBbgmask.ppm\fP
ماسک باینری مثبت.

.TP
\fBconvkernel.ppm\fP
هسته کانولوشن برای محوسازی سایه.

.TP
\fBblurredlackshad.ppm\fP
تصویر سایه محوشده پیش از اعمال رنگ.

.TP
\fBblurred.ppm\fP
تصویر سایه محوشده و رنگ‌آمیزی‌شده.

.TP
\fBshadow.ppm\fP
تصویر سایه برش‌خورده، جابجاشده مطابق با تنظیمات درخواستی.

.TP
\fBshadback.ppm\fP
سایه تولید شده ضرب‌در ماسک مثبت.




.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnm" (1)\c
\&،
.BR "pnmmargin" (1)\c
\&،
.BR "pnmconvol" (1)\c
\&،
.BR "pamscale" (1)\c
\&،
.BR "pnmsmooth" (1)\c
\&،
.BR "ppm" (1)\c
\&

.UN author
.SH "نویسندگان (AUTHORS)"

John Walker 
.UR http://www.fourmilab.ch
http://www.fourmilab.ch
.UE
\&، ۸ اوت ۱۹۹۷

.UN copyright
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
این نرم‌افزار در مالکیت عمومی (Public Domain) قرار دارد. بدین وسیله مجوز استفاده، رونوشت‌برداری، تغییر و توزیع این نرم‌افزار و مستندات آن برای هر هدفی و بدون دریافت هزینه، بدون هیچ قید و شرط یا محدودیتی اعطا می‌شود.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از روی منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmshadow.html
.PP