| Pamtilt User Manual(0) | Pamtilt User Manual(0) |
نام (NAME)
pamtilt - چاپ زاویه کجی یک فایل PGM
خلاصه دستور (SYNOPSIS)
pamtilt [-angle=maxangle] [-fast] [-quality=q] [-hstep=n] [-vstep=n] [-dstep=n] [-astep=n] [-verbose] [pgmfile]
مثال‌ها (EXAMPLES)
scanimage --mode Gray --resolution 300 >crooked.pgm pnmrotate -b white `pamtilt crooked.pgm` crooked.pgm >straight.pgm (سپس برش، اعمال آستانه و غیره)
توضیحات (DESCRIPTION)
این برنامه بخشی از Netpbm(1) است.
برنامهٔ pamtilt تلاش می‌کند زاویهٔ صحیح را برای رفع کجی (de-skewing) یک سند متنی اسکن‌شده پیدا کند. خروجی یک عدد ممیز شناور تنها (زاویه بر حسب درجه) برای استفاده به عنوان آرگومان به pnmrotate است.
«کجی سند» (Document skew) نامی است که به اتفاق رخ‌داده هنگام ورود زاویه‌دار صفحه به اسکنر تصویر اطلاق می‌شود: تصویر به‌دست‌آمده کج است. pamtilt با هدف کمک به تصحیح این وضعیت طراحی شده است.
pamtilt سه تکرار با گام‌های پیاپی دقیق‌تر انجام می‌دهد و زوایای احتمالی چرخش را می‌آزماید تا بهترین زاویه را پیدا کند. pamtilt برای صاف کردن تصاویری با خطوط افقی پررنگ بهترین عملکرد را دارد و روی عکس‌های معمولی عملکرد ضعیفی از خود نشان می‌دهد. اگر pamtilt به نتایج خود اطمینان نداشته باشد، مقدار ویژهٔ 00.00 را چاپ می‌کند؛ می‌توانید این مقدار را بررسی کنید یا آن را صرفاً به عنوان یک آرگومان معتبر به pnmrotate بفرستید.
pamtilt روی صفحهٔ (plane) نخست تصویر ورودی، که می‌تواند PNM یا PAM باشد، کار می‌کند و سایر صفحات را نادیده می‌گیرد. معمولاً ورودی PGM یا GRAYSCALE PAM است، بنابراین تنها یک صفحه وجود دارد.
pamtilt هم روی تصاویر دوحالتی (PBM، BLACKANDWHITE PAM) و هم روی تصاویر طیف خاکستری (grayscale) کار می‌کند، اما اگر پیش از اعمال آستانه (threshold) برای ساخت تصویر دوحالتی، اسکن و چرخش را در حالت طیف خاکستری انجام دهید، خطاهای تصویری (artifacts) را به حداقل خواهید رساند.
گزینه‌ها (OPTIONS)
علاوه بر گزینه‌های مشترک در تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه -quiet، به گزینه‌های عمومی (Common Options) مراجعه کنید)، pamtilt گزینه‌های خط فرمان زیر را نیز می‌شناسد:
- -angle=maxangle
- فرض می‌کند
حداکثر
زاویهٔ کجی
برابر با maxangle
(اندازه‌گیری‌شده
بر حسب
درجه) است.
مقدار
پیش‌فرض
برای اکثر
تصاویر،
حتی
تصاویری که
با بی‌دقتی
اسکن
شده‌اند،
کافی است.
پیش‌فرض 10.0 است.
- -fast
- برای افزایش سرعت، به قیمت کاهش دقت، از تکرار سوم صرف‌نظر می‌کند.
- -verbose
- اندازه‌گیری‌های محاسبه‌شده در هر زاویهٔ آزمایش‌شده را روی خروجی خطای استاندارد (Standard Error) نمایش می‌دهد.
در ادامه گزینه‌های دیگری آورده شده‌اند که می‌توانید برای تنظیم دقیق عملکرد pamtilt استفاده کنید، اما به‌ندرت به آن‌ها نیاز خواهد بود. مقادیر پیش‌فرض پاسخگوی طیف گسترده‌ای از اسناد ورودی هستند.
- -quality=q
- برای گزارش
یک نتیجهٔ
معتبر،
نسبت
سیگنال به
نویز (SNR)
حداقل q را
در تکرار
اول الزامی
می‌کند.
مقادیر
بزرگ‌تر
احتمال
به‌دست
آوردن
نتیجهٔ
نادرست را
کاهش
می‌دهند،
اما خطر
دریافت
نکردن هیچ
نتیجه‌ای
را به همراه
دارند.
پیش‌فرض 1.0 است.
- -hstep=n
- گام افقی را
برای بررسی
هر nـمین
ستون تنظیم
می‌کند. این
مقدار هم بر
زمان اجرا و
هم بر
حافظهٔ
مورد نیاز
اثر
می‌گذارد.
پیش‌فرض 11 است.
- -vstep=n
- گام عمودی
را برای
بررسی هر
nـمین سطر
تنظیم
می‌کند.
مقادیر
بزرگ‌تر
معمولاً
کار
می‌کنند و
زمان اجرا
را کاهش
می‌دهند،
اما خطر
نتایج
نادرست را
افزایش
می‌دهند.
پیش‌فرض 5 است.
- -dstep=n
- فاصلهٔ
عمودی مورد
استفاده
هنگام
بررسی
پیکسل‌ها
در یک ستون
را مشخص
می‌کند. هدف
از مقدار
پیش‌فرض،
به حداقل
رساندن اثر
نویز در
امتداد یک
مرز افقی
است.
پیش‌فرض 2 است.
- -astep=n
- گام زاویه
را برای
تکرار اول،
بر حسب درجه
تعیین
می‌کند.
پیش‌فرض 1.0 است.
مراجع (REFERENCES)
pamtilt الگوریتمی تا حدی ساده‌شده را پیاده‌سازی می‌کند که الهام‌گرفته از این مقاله است: “Measuring Document Image Skew and Orientation”، نوشتهٔ Bloomberg، Kopec، و Dasari. در SPIE Volume 2422, Document Recognition II، صفحات 302-316، فوریه 1995.
همچنین ببینید (SEE ALSO)
-
pnmrotate(1)
تاریخچه (HISTORY)
pamtilt در Netpbm 10.30 (اکتبر 2005) معرفی شد.
گرگ تاونسند (Gregg Townsend) آن را نوشت و در اوت 2005 برای برایان هندرسون (Bryan Henderson) ارسال کرد. برایان آن را برای انطباق با شیوه‌نامه‌های Netpbm مجدداً بازنویسی کرد.
منبع سند (DOCUMENT SOURCE)
این صفحهٔ راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
| 28 August 2005 | netpbm documentation |