.TH ocrdesktop 1 27/09/2015 "manpage template generated by scriptst"
.SH "نام (NAME)"
.B ocrdesktop 
\- خواندن و تعامل با محتوای میزکار گرافیکی از طریق OCR
.SH "خلاصه دستور (SYNOPSIS)"
\fBocrdesktop\fR [\fIoptions\fR...]
.SH "توضیحات (DESCRIPTION)"
.P
ابزار OCRdesktop یک ابزار دسترس‌پذیری سودمند برای دریافت محتوای صفحه به عنوان متن از طریق فناوری OCR است.
این ابزار تصویری از پنجره یا فضای کاری فعلی می‌گیرد، آن را برای دستیابی به نتایج بهتر آماده می‌سازد و از tesseract برای تشخیص متن روی آن استفاده می‌کند.
نتیجه در یک ناحیه متنی مجهز به مکان‌نما (caret) در فهرستی مفصل همراه با مختصات نمایش داده می‌شود، جایی که می‌تواند کلیک‌ها را روی متن شبیه‌سازی کند،
یا نتایج می‌توانند به کلیپ‌بورد فرستاده شوند.
دو نمای اصلی وجود دارد.
.P
1. \fIنمای حالت مرور (browse mode view)\fR:
.br
در این نما نتایج OCR در یک ناحیه متنی قابل پیمایش با مکان‌نما نمایش داده می‌شوند.
.br
دکمه‌هایی برای انجام کلیک‌های ماوس، تغییر نماها و غیره وجود دارد
که در یک چیدمان منوی سنتی در دسترس هستند و با f10 باز می‌شوند.
.P
2. \fIنمای با جزئیات (detailed view)\fR:
.br
در این نما می‌توانید متاداده‌های موارد نمایش‌یافته را مشاهده کنید.
.br
هر رشته متنی خروجی در ستون اول یک جدول نمایش داده می‌شود.
.br
ستون دوم اندازه قلم (فونت) استفاده‌شده را مشخص می‌کند.
.br
ستون سوم اطلاعات رنگ را در صورت در دسترس بودن نشان می‌دهد.
.br
ستون بعدی مختصات X برای آن مورد را در بر دارد.
.br
ستون پس از آن مختصات Y آن را شامل می‌شود.
.br
در نهایت، مقدار درصدی برای میزان اطمینان از دقت نمایش داده می‌شود.
.br
همچنین می‌توانید با استفاده از کلید tab قلم به‌کاررفته برای نمایش خروجی را مشاهده کرده و تغییر دهید.
.br
میانبر تعویض بین این دو نما control v است.
.SS راه‌اندازی (Setup)
دستور ocrdesktop را به یک میانبر صفحه‌کلید در محیط میزکار خود اختصاص دهید.
.br
برای نمونه، در Gnome یا Unity می‌توانید این کار را از طریق Gnome Control Center در پنجره Keyboard در زبانه Shortcuts انجام دهید.
.br
برای زبان‌هایی غیر از انگلیسی، کد زبان خود را با
ocrdesktop -l <languagecode> تنظیم کنید. از کدهای زبان tesseract
برای <languagecode> استفاده نمایید.
.br
همچنین می‌توانید هنگام راه‌اندازی OCRdesktop از پارامترهای دیگر برای گسترش کارایی استفاده کنید،
.br
البته برنامه را می‌توان از طریق جعبه اجرای میزکار (run box) یا dash نیز اجرا کرد،
اما اجرای آن از ترمینال ممکن است مطلوب نباشد
زیرا پنجره ترمینال در تصویر ضبط‌شده توسط ocrdesktop خواهد افتاد.
.br
\fIنکته:\fR حداقل دو میانبر بسازید، یکی بدون گزینه
برای تصویربرداری تنها از پنجره فعال، و دیگری با -d
برای گرفتن تصویر از کل میزکار.
.SS کاربرد (Usage)
.P
\fBocrdesktop\fR هنگامی که بدون هیچ گزینه خط فرمانی اجرا شود،
خروجی پردازش‌شده پنجره فعال را نشان می‌دهد.
.br
دستور ocrdesktop را با سوییچ -d اجرا کنید تا کل میزکار پردازش شود.
.br
چنانچه کیفیت OCR در پردازش اولیه تصویر گرفته‌شده مطلوب نباشد، گزینه‌های تبدیلی وجود دارند که ممکن است دقت بازشناسی نویسه‌ها را بهبود بخشند.
.br
برای استفاده از این گزینه‌ها، با استفاده از یک یا چند پرچم تبدیل، تصاویر جدیدی بگیرید. گزینه‌های تبدیل موجود عبارتند از:
.br
\fB-i\fR رنگ یا تنوع رنگی پیش‌زمینه و پس‌زمینه را معکوس می‌کند.
.br
\fB-g\fR به‌جای رنگ‌های اصلی از مقیاس خاکستری استفاده می‌کند.
.br
\fB-b\fR از یک روش آستانه‌ای (barrier) سیاه و سفید استفاده می‌کند.
این روش از مقیاس خاکستری استفاده کرده و آستانه‌ای تعیین می‌کند که تمام سایه‌های
تیره‌تر از آستانه سیاه در نظر گرفته می‌شوند، و هر چیز روشن‌تر،
سفید به شمار می‌آید. مقدار پیش‌فرض آستانه ۲۰۰ است، اما می‌توان آن را در
خط فرمان تنظیم کرد. این روش هنگام کار با رنگ‌های بسیار
روشن یا متن‌های ناواضح مفید است.
.br
منوها را باز کنید تا همه گزینه‌های در دسترس را ببینید.
.br
آن‌ها به سه دسته تقسیم می‌شوند: ocrdesktop، interact و macros.
برای همه گزینه‌های ocrdesktop میانبرهای صفحه‌کلید وجود دارد.
در ocrdesktop گزینه‌های تغییر نما، ارسال به کلیپ‌بورد و خروج را می‌یابید.
منوی interact دارای کنترل‌هایی برای کلیک‌های شبیه‌سازی‌شده ماوس و غیره است.
منوی macros به شما امکان بارگذاری، تخلیه و ذخیره ماکروها را می‌دهد.
.SS ماکروها (Macros)
در بیشتر محیط‌های میزکار، میانبرهای سراسری تا زمانی که منوها باز هستند کار نمی‌کنند،
برای نمونه، منوی فایل در نوار منوی بالای اکثر برنامه‌ها.
برنامه ocrdesktop می‌تواند از «پیش‌کلیک‌ها» (preclicks) استفاده کند؛ ماکروهایی که می‌توانند پیش از گرفتن تصویر از صفحه اجرا شوند.
این قابلیت به شما امکان می‌دهد تمام منوها را ببندید و اجازه دهید OCRdesktop پیش از بازشناسی پنجره،
روی منو کلیک کند.
.P
برای استفاده از ماکروهای پیش‌کلیک، روی preclick در منوی interact کلیک کنید، یا
از میانبر control p استفاده نمایید.
سپس یک کلیک ماوس را انتخاب کنید تا پیش از شروع بعدی OCRdesktop اجرا شود.
پس از آنکه روی دکمه شروع کلیک ماوس زدید، هیچ اتفاقی رخ نخواهد داد.
دفعه بعد که OCRdesktop را اجرا کنید، خواهد پرسید چه کاری انجام دهد.
می‌توانید روی Run کلیک کنید تا تمام کلیک‌های ذخیره‌شده اجرا شوند.
سپس OCRdesktop برای اجرای OCR روی صفحه، همان‌گونه که پس از انجام عمل کلیک قرار گرفته است، تصویربرداری می‌کند.
از گزینه Save As و مجدداً Preclick و Save As استفاده کنید تا
کلیک دوم نیز ذخیره شود، برای نمونه برای باز کردن یک زیرمنو.
.br
همچنین می‌توانید میانبرهای صفحه‌کلید را به ماکروهای پیش‌کلیک بفرستید.
برای ورود به حالت ضبط میانبر، کلیدهای Ctrl+k را فشار دهید یا
گزینه Send Key را در منوی Interact انتخاب کنید.
اکنون هر کلیدی که فشار می‌دهید به ماکروی پیش‌کلیک فعال فعلی افزوده می‌شود.
فشردن F4 از حالت ضبط خارج می‌شود.
خروج از حالت ضبط میانبر ممکن است تا ۲ ثانیه تأخیر داشته باشد.
.br
می‌توانید به تعداد دلخواه عملیات ماوس ذخیره کنید.
.br
گزینه unload را در پنجره ماکرو انتخاب کنید تا ماکرو پاک شده و از بین برود. اگر Cancel را فشار دهید، هیچ کلیک ماوسی انجام نمی‌شود، اما پنجره اصلی باز خواهد شد. ماکرو
حذف نخواهد شد و دفعه بعد که OCRDesktop را شروع کنید از شما پرسیده می‌شود که آیا می‌خواهید کلیک‌های ذخیره‌شده خود را اجرا کنید یا خیر.
.br
\fIنکته:\fR ماکروها در ~/.activeOCRMacro.ocrm ذخیره می‌شوند.
گزینه Save As به شما اجازه می‌دهد در صورت تمایل ماکروها را در مکان دیگری ذخیره کنید.
این گزینه پنجره استاندارد انتخاب فایلی را باز می‌کند که در آن نام
و مکان فایل ماکروی خود را انتخاب می‌کنید.
.SH "گزینه‌ها (OPTIONS)"
\fB-b\fR  تبدیل به سیاه و سفید پیش از انجام OCR: \fB-t\fI برای تعیین نقطه آستانه اختیاری است\fR
.br
\fB-c\fR   ارسال خروجی متنی به کلیپ‌بورد
.br 
\fB-d\fR   انجام OCR بر روی کل میزکار، و نه تنها پنجره فعال
.br
\fB-g\fR   تبدیل رنگ‌ها به مقیاس خاکستری پیش از انجام OCR
.br
\fB-h\fR   نمایش یک پیام راهنمای کوتاه
.br
\fB-i\fR   معکوس کردن رنگ‌های پیش‌زمینه و پس‌زمینه پیش از انجام OCR
.br
\fB-m\fR   اجرای ماکرو: \fIمسیر فایل ماکرو به همراه \fR-m\fI الزامی است\fR
.br
\fB-n\fR   هیچ رابط گرافیکی (GUI) نمایش داده نمی‌شود: \fIهمراه با -c یا -m اجرا شود\fR
.br
\fB-p\fR   چاپ پیام‌های اشکال‌زدایی (debug)
.br 
.SH "وضعیت خروج (EXIT STATUS)"
.br
.SH "فایل‌ها (FILES)"
.I /usr/bin/ocrdesktop
.RS
فایل اجرایی
.RE
.I /usr/share/man/man1/ocrdesktop.1.gz
.RS
همین صفحهٔ راهنما
.RE
.SH "گزارش باگ‌ها (BUGS)"
خروج از حالت ضبط میانبر ممکن است تا ۲ ثانیه تأخیر داشته باشد.
.br
لطفاً باگ‌ها را گزارش کرده و/یا اصلاحات یا بهبودهای کد را به
chrys87@web.de ارسال کنید.
.SH "نویسندگان (AUTHORS)"
برنامه ocrdesktop توسط Chrys <chrys87@web.de> نوشته شده است.
.br
B.H. این صفحهٔ راهنما را نوشته است.
.SH "وب‌گاه (WEBSITE)"
https://aur.archlinux.org/packages/ocrdesktop
.br
https://wiki.archlinux.org/index.php?title=Ocrdesktop&redirect=no

.SH "همچنین ببینید (SEE ALSO)"
.BR tesseract(1)
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
## شما می‌توانید این اثر را تحت مجوز GNU General Public License3 یا
## به صورت اختیاری تحت هر نسخهٔ بعدی GPL در صورت نیاز پروژه‌تان توزیع کنید. http://fsf.org