\
.\" 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 "Pnmshear User Manual" 0 "22 March 2020" "netpbm documentation"

.SH "نام (NAME)"
pnmshear \- کج کردن یک تصویر PNM با زاویه مشخص

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

\fBpnmshear\fP

[\fB-noantialias\fP] [\fB-background=\fP\fIcolor\fP]
\fIangle\fP [\fIpnmfile\fP]
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. می‌توانید به‌جای یک خط تیره از دو خط تیره برای مشخص کردن یک گزینه استفاده کنید. همچنین می‌توانید بین نام یک گزینه و مقدار آن از فاصله یا علامت مساوی استفاده کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpnmshear\fP یک تصویر PNM را به عنوان ورودی می‌خواند، آن را با زاویه مشخص‌شده کج (shear) می‌کند و یک تصویر PNM به عنوان خروجی تولید می‌نماید. اگر فایل ورودی رنگی باشد، خروجی نیز رنگی خواهد بود؛ در غیر این صورت مقیاس خاکستری خواهد بود. زاویه بر حسب درجه (نقطه شناور یا اعشاری) مشخص می‌شود و بیانگر این مفهوم است:

.nf
    +-------+  +-------+
    |       |  |\e       \e
    |  OLD  |  | \e  NEW  \e
    |       |  |an\e       \e
    +-------+  |gle+-------+
.fi

اگر زاویه منفی باشد، تصویر در جهت دیگر کج می‌شود:
.nf
    +-------+  |-an+-------+
    |       |  |gl/       /
    |  OLD  |  |e/  NEW  /
    |       |  |/       /
    +-------+  +-------+
.fi

زاویه نباید بیش از حد به ۹۰ یا ۹۰- درجه نزدیک باشد، در غیر این صورت عرض تصویر حاصل به طرز نامعقولی بزرگ خواهد شد. در واقع، اگر خیلی نزدیک شود، عرض تصویر به اندازه‌ای بزرگ می‌شود که \fBpnmshear\fP قادر به انجام محاسبات در اندازه‌های کلمه (word sizes) مورد استفاده نخواهد بود و برنامه این مسئله را تشخیص داده و با خطا متوقف می‌شود.
.PP
دستور \fBpnmshear\fP عملیات کج‌کردن را با پیمایش روی پیکسل‌های مبدا و توزیع کسرهایی از آن‌ها به هر یک از پیکسل‌های مقصد انجام می‌دهد. این امر دارای اثر «ضد پلگی» (anti-aliasing) است؛ یعنی از لبه‌های دندانه‌دار و اعوجاج‌های مشابه جلوگیری می‌کند. با این حال، به این معنا نیز هست که رنگ‌های اصلی تصویر تغییر می‌یابند و معمولاً تعداد رنگ‌ها بیشتر از مقدار اولیه می‌شود. اگر لازم است دقیقاً همان مجموعه رنگ‌های اولیه را حفظ کنید، به گزینه \fB-noantialias\fP مراجعه نمایید. اگر افزایش تعداد رنگ‌های پالت مشکلی ایجاد می‌کند، می‌توانید خروجی را از طریق \fBpnmquant\fP پردازش کنید.

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


.TP
\fB-background=\fP\fIcolor\fP
رنگ پس‌زمینه‌ای را تعیین می‌کند که تصویر کج‌شده روی آن قرار می‌گیرد.
.sp
رنگ (\fIcolor\fP) را همان‌طور که برای آرگومان تابع کتابخانه‌ای
.UR libnetpbm_image.html#colorname
\fBpnm_parsecolor()\fP
.UE
توصیف شده مشخص کنید.
.sp
به‌طور پیش‌فرض، اگر این گزینه را مشخص نکنید، \fBpnmshear\fP رنگی را انتخاب می‌کند که به نظرش رنگ پس‌زمینه تصویر اصلی است. برنامه این رنگ را به شکلی نسبتاً ساده، با محاسبه میانگین رنگ‌های دو گوشه بالای تصویر تعیین می‌کند.
.sp
این گزینه در Netpbm 10.37 (دسامبر ۲۰۰۶) اضافه شد. پیش از آن، \fBpnmshear\fP همواره رفتاری مشابه حالت پیش‌فرض کنونی داشت.

.TP
\fB-noantialias\fP
این گزینه \fBpnmshear\fP را وادار می‌کند تا صرفاً پیکسل‌ها را جابه‌جا کند، به‌جای اینکه پیکسل‌های خروجی را از ترکیب چند پیکسل ورودی تولید نماید. روش دوم ممکن است باعث شود خروجی حاوی رنگ‌هایی باشد که در ورودی وجود نداشتند که این امر شاید مطلوب نباشد. همچنین احتمالاً باعث می‌شود خروجی دارای تعداد زیادی رنگ باشد. اگر به تعداد کمی رنگ نیاز دارید، اما اهمیتی ندارد که دقیقاً همان رنگ‌های ورودی باشند، به‌جای استفاده از \fB-noantialias\fP، می‌توانید خروجی را به \fBpnmquant\fP ارسال کنید.
.sp
توجه داشته باشید برای اطمینان از اینکه خروجی شامل رنگ‌هایی غیر از رنگ‌های ورودی نباشد، باید رنگ پس‌زمینه را نیز مد نظر قرار دهید. به گزینه \fB-background\fP مراجعه کنید.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmrotate" (1)\c
\&,
.BR "pamflip" (1)\c
\&,
.BR "pamhomography" (1)\c
\&,
.BR "pnmquant" (1)\c
\&,
.BR "pamrestack" (1)\c
\&,
.BR "pnm" (1)\c
\&


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

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