.\" 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 "Pamtilt User Manual" 0 "28 August 2005" "netpbm documentation"

.SH "نام (NAME)"
pamtilt \- چاپ زاویه کجی یک فایل PGM

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

\fBpamtilt\fP
[\fB-angle=\fP\fImaxangle\fP]
[\fB-fast\fP]
[\fB-quality=\fP\fIq\fP]
[\fB-hstep=\fP\fIn\fP]
[\fB-vstep=\fP\fIn\fP]
[\fB-dstep=\fP\fIn\fP]
[\fB-astep=\fP\fIn\fP]
[\fB-verbose\fP]
[\fIpgmfile\fP]

.UN examples
.SH "مثال‌ها (EXAMPLES)"

.nf
\f(CW
    scanimage --mode Gray --resolution 300 >crooked.pgm
    pnmrotate -b white `pamtilt crooked.pgm` crooked.pgm >straight.pgm
\fP
    (سپس برش، اعمال آستانه و غیره)
.fi

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامهٔ \fBpamtilt\fP تلاش می‌کند زاویهٔ صحیح را برای رفع کجی (de-skewing) یک سند متنی اسکن‌شده پیدا کند. خروجی یک عدد ممیز شناور تنها (زاویه بر حسب درجه) برای استفاده به عنوان آرگومان به \fBpnmrotate\fP است.
.PP
«کجی سند» (Document skew) نامی است که به اتفاق رخ‌داده هنگام ورود زاویه‌دار صفحه به اسکنر تصویر اطلاق می‌شود: تصویر به‌دست‌آمده کج است. \fBpamtilt\fP با هدف کمک به تصحیح این وضعیت طراحی شده است.
.PP
\fBpamtilt\fP سه تکرار با گام‌های پیاپی دقیق‌تر انجام می‌دهد و زوایای احتمالی چرخش را می‌آزماید تا بهترین زاویه را پیدا کند. \fBpamtilt\fP برای صاف کردن تصاویری با خطوط افقی پررنگ بهترین عملکرد را دارد و روی عکس‌های معمولی عملکرد ضعیفی از خود نشان می‌دهد. اگر \fBpamtilt\fP به نتایج خود اطمینان نداشته باشد، مقدار ویژهٔ 00.00 را چاپ می‌کند؛ می‌توانید این مقدار را بررسی کنید یا آن را صرفاً به عنوان یک آرگومان معتبر به \fBpnmrotate\fP بفرستید.
.PP
\fBpamtilt\fP روی صفحهٔ (plane) نخست تصویر ورودی، که می‌تواند PNM یا PAM باشد، کار می‌کند و سایر صفحات را نادیده می‌گیرد. معمولاً ورودی PGM یا GRAYSCALE PAM است، بنابراین تنها یک صفحه وجود دارد.
.PP
\fBpamtilt\fP هم روی تصاویر دوحالتی (PBM، BLACKANDWHITE PAM) و هم روی تصاویر طیف خاکستری (grayscale) کار می‌کند، اما اگر پیش از اعمال آستانه (threshold) برای ساخت تصویر دوحالتی، اسکن و چرخش را در حالت طیف خاکستری انجام دهید، خطاهای تصویری (artifacts) را به حداقل خواهید رساند.
        
.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک در تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه \fB-quiet\fP، به
.UR index.html#commonoptions
گزینه‌های عمومی (Common Options)
.UE
\& مراجعه کنید)، \fBpamtilt\fP گزینه‌های خط فرمان زیر را نیز می‌شناسد:



.TP
\fB-angle=\fP\fImaxangle\fP
فرض می‌کند حداکثر زاویهٔ کجی برابر با \fImaxangle\fP (اندازه‌گیری‌شده بر حسب درجه) است. مقدار پیش‌فرض برای اکثر تصاویر، حتی تصاویری که با بی‌دقتی اسکن شده‌اند، کافی است.
.sp
پیش‌فرض 10.0 است.

.TP
\fB-fast\fP
برای افزایش سرعت، به قیمت کاهش دقت، از تکرار سوم صرف‌نظر می‌کند.

.TP
\fB-verbose\fP
اندازه‌گیری‌های محاسبه‌شده در هر زاویهٔ آزمایش‌شده را روی خروجی خطای استاندارد (Standard Error) نمایش می‌دهد.


.PP
در ادامه گزینه‌های دیگری آورده شده‌اند که می‌توانید برای تنظیم دقیق عملکرد \fBpamtilt\fP استفاده کنید، اما به‌ندرت به آن‌ها نیاز خواهد بود. مقادیر پیش‌فرض پاسخگوی طیف گسترده‌ای از اسناد ورودی هستند.


.TP

\fB-quality=\fP\fIq\fP
برای گزارش یک نتیجهٔ معتبر، نسبت سیگنال به نویز (SNR) حداقل \fIq\fP را در تکرار اول الزامی می‌کند. مقادیر بزرگ‌تر احتمال به‌دست آوردن نتیجهٔ نادرست را کاهش می‌دهند، اما خطر دریافت نکردن هیچ نتیجه‌ای را به همراه دارند.
.sp
پیش‌فرض 1.0 است.

.TP
\fB-hstep=\fP\fIn\fP
گام افقی را برای بررسی هر \fIn\fPـمین ستون تنظیم می‌کند. این مقدار هم بر زمان اجرا و هم بر حافظهٔ مورد نیاز اثر می‌گذارد.
.sp
پیش‌فرض 11 است.

.TP
\fB-vstep=\fP\fIn\fP
گام عمودی را برای بررسی هر \fIn\fPـمین سطر تنظیم می‌کند. مقادیر بزرگ‌تر معمولاً کار می‌کنند و زمان اجرا را کاهش می‌دهند، اما خطر نتایج نادرست را افزایش می‌دهند.
.sp
پیش‌فرض 5 است.

.TP
\fB-dstep=\fP\fIn\fP
فاصلهٔ عمودی مورد استفاده هنگام بررسی پیکسل‌ها در یک ستون را مشخص می‌کند. هدف از مقدار پیش‌فرض، به حداقل رساندن اثر نویز در امتداد یک مرز افقی است.
.sp
پیش‌فرض 2 است.

.TP
\fB-astep=\fP\fIn\fP
گام زاویه را برای تکرار اول، بر حسب درجه تعیین می‌کند.
.sp
پیش‌فرض 1.0 است.




.UN references
.SH "مراجع (REFERENCES)"
.PP
\fBpamtilt\fP الگوریتمی تا حدی ساده‌شده را پیاده‌سازی می‌کند که الهام‌گرفته از این مقاله است: \(lqMeasuring Document Image Skew and Orientation\(rq، نوشتهٔ Bloomberg، Kopec، و Dasari. در SPIE Volume 2422, Document Recognition II، صفحات 302-316، فوریه 1995.

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


.IP \(bu

.BR "\fBpnmrotate\fP" (1)\c
\&
.IP \(bu

.BR "pgm" (1)\c
\&


.UN history
.SH "تاریخچه (HISTORY)"
.PP
\fBpamtilt\fP در Netpbm 10.30 (اکتبر 2005) معرفی شد.
.PP
گرگ تاونسند (Gregg Townsend) آن را نوشت و در اوت 2005 برای برایان هندرسون (Bryan Henderson) ارسال کرد. برایان آن را برای انطباق با شیوه‌نامه‌های Netpbm مجدداً بازنویسی کرد.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamtilt.html
.PP