.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "UNPAPER" "1" "Aug 04, 2026" "" "unpaper"
.SH "نام (NAME)"
unpaper \- ابزار پس‌پردازش برگه‌های اسکن‌شده کاغذ
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBunpaper\fP [\fIگزینه‌ها\fP] (\fIالگوهای ورودی\fP \fIالگوهای خروجی\fP | \fIفایل‌های ورودی\fP \fIفایل‌های خروجی\fP)
.SH "نمای کلی (OVERVIEW)"
.sp
برنامه \fBunpaper\fP یک ابزار پس‌پردازش برای برگه‌های اسکن‌شده کاغذ است، به‌ویژه برای صفحه‌های کتابی که از فتوکپی‌های پیش‌تر ایجادشده اسکن شده‌اند. هدف اصلی، خواناتر کردن صفحه‌های اسکن‌شده کتاب بر روی صفحه‌نمایش پس از تبدیل به PDF است. علاوه بر این، \fBunpaper\fP ممکن است برای بهبود کیفیت صفحه‌های اسکن‌شده پیش از انجام نویسه‌خوانی نوری (OCR) نیز مفید باشد.
.sp
برنامه \fBunpaper\fP تلاش می‌کند تصاویر اسکن‌شده را با حذف لبه‌های تیره که در طول اسکن یا کپی‌کردن در نواحی خارج از محتوای اصلی صفحه ایجاد شده‌اند (مانند نواحی تیره میان سمت چپ و سمت راست اسکن دوصفحه‌ای کتاب)، پاک‌سازی کند. این برنامه همچنین سعی می‌کند ناترازی مرکز و چرخش صفحه‌ها را تشخیص داده و هر صفحه را با چرخاندن به زاویه صحیح، به‌طور خودکار تراز کند. این فرآیند «چرخش‌زدایی» (\(dqdeskewing\(dq) نامیده می‌شود. توجه داشته باشید که پردازش خودکار گاهی اوقات با شکست مواجه می‌شود. همواره ایده خوبی است که نتایج \fBunpaper\fP را به‌صورت دستی بررسی کنید و تنظیمات پارامترها را بر اساس نیازهای ورودی تغییر دهید. هر مرحله پردازش را می‌توان برای هر برگه به‌صورت جداگانه نیز غیرفعال کرد.
.sp
فایل‌های ورودی و خروجی می‌توانند در قالب‌های \fB\&.pbm\fP، \fB\&.pgm\fP یا \fB\&.ppm\fP باشند، بنابراین به‌طور کلی در قالب \fB\&.pnm\fP هستند؛ قالبی که توسط ابزارهای اسکن لینوکس مانند \fBscanimage\fP و \fBscanadf\fP نیز استفاده می‌شود. تبدیل به PDF را می‌توان برای مثال با ابزارهای لینوکسی \fBpgm2tiff\fP، \fBtiffcp\fP و \fBtiff2pdf\fP انجام داد.
.SH "فایل‌های ورودی و خروجی (INPUT AND OUTPUT FILES)"
.sp
فایل‌های ورودی و خروجی باید با استفاده از الگوها یا فهرستی مرتب از فایل‌های ورودی و خروجی تعیین شوند؛ در صورت استفاده از الگوها، مانند \fB%04d\fP، پیش از باز کردن فایل برای ورودی یا خروجی، شماره برگه ورودی و خروجی جایگزین آن‌ها می‌شود.
.sp
اگر از الگوها استفاده نمی‌کنید، برنامه بسته به آنچه به \fB\-\-input\-pages\fP ارسال شده، یک یا دو فایل ورودی، و بسته به آنچه به \fB\-\-output\-pages\fP ارسال شده، یک یا دو فایل خروجی را به ترتیب انتظار دارد.
.sp
نبود نام‌های فایل خروجی خطایی مهلک است و پردازش را متوقف خواهد کرد؛ نبود نام‌های فایل ورودی اولیه نیز مهلک است، و همچنین در صورتی که محدوده‌ای از برگه‌ها از طریق \fB\-\-sheet\fP یا \fB\-\-end\-sheet\fP تعریف شده باشد، نبود هرگونه فایل ورودی مهلک خواهد بود.
.sp
دستور \fBunpaper\fP فایل‌ها را در قالب PNM می‌پذیرد، به این معنی که ممکن است در قالب‌های \fB\&.pbm\fP، \fB\&.pgm\fP، \fB\&.ppm\fP یا \fB\&.pnm\fP باشند؛ یعنی همان قالبی که توسط ابزارهای خط فرمان اسکن لینوکس مانند \fBscanimage\fP و \fBscanadf\fP تولید می‌شود..SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-l { single | double | none } ; \-\-layout { single | double | none }
تنظیم گزینه‌های چیدمان پیش‌فرض برای یک برگه:
.INDENT 7.0
.TP
.B \fBsingle\fP
یک صفحه در هر برگه.
.TP
.B \fBdouble\fP
دو صفحه در هر برگه، جهت افقی (یک صفحه در نیمه چپ، یک صفحه در نیمه راست).
.TP
.B \fBnone\fP
بدون چیدمان خودکار، \fBmask\-scan\-points\fP می‌تواند به صورت جداگانه مشخص شود.
.UNINDENT
.sp
استفاده از \fBsingle\fP یا \fBdouble\fP به‌طور خودکار \fB\-\-mask\-scan\-points\fP مربوطه را تنظیم می‌کند. پیش‌فرض \fBsingle\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B \-start sheet ; \-\-start\-sheet start\-sheet
شماره نخستین برگه برای پردازش در حالت چندبرگه‌ای. (پیش‌فرض: 1)
.UNINDENT
.INDENT 0.0
.TP
.B \-end sheet ; \-\-end\-sheet sheet
شماره آخرین برگه برای پردازش در حالت چندبرگه‌ای. مقدار \-1 نشان‌دهنده پردازش تا زمانی است که هیچ فایل ورودی دیگری با شماره صفحه مربوطه در دسترس نباشد (پیش‌فرض: \-1)
.UNINDENT
.INDENT 0.0
.TP
.B \-# sheet\-range ; \-\-sheet sheet\-range
به‌طور اختیاری مشخص می‌کند کدام برگه‌ها در محدوده بین start\-sheet و end\-sheet پردازش شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-x sheet\-range ; \-\-exclude sheet\-range
برگه‌هایی را در محدوده بین start\-sheet و end\-sheet از پردازش مستثنی می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-pre\-rotate { \-90 | 90 }
تصویر را قبل از هر پردازش دیگری در جهت عقربه‌های ساعت (\fB90\fP) یا خلاف جهت عقربه‌های ساعت (\fB\-90\fP) می‌چرخاند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-post\-rotate { \-90 | 90 }
تصویر را پس از انجام هر پردازش دیگری در جهت عقربه‌های ساعت (\fB90\fP) یا خلاف جهت عقربه‌های ساعت (\fB\-90\fP) می‌چرخاند.
.UNINDENT
.INDENT 0.0
.TP
.B \-M { v | h | v,h } ; \-\-pre\-mirror { v | h | v,h }
تصویر را پس از پیش‌چرخش احتمالی آینه‌ای می‌کند. می‌توان \fBv\fP (برای آینه‌ای عمودی)، \fBh\fP (برای آینه‌ای افقی) یا \fBv,h\fP (برای هر دو) را تعیین کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-post\-mirror { v | h | v,h }
تصویر را پس از هر پردازش دیگری به‌جز پس‌چرخش احتمالی، آینه‌ای می‌کند. می‌توان \fBv\fP (برای آینه‌ای عمودی)، \fBh\fP (برای آینه‌ای افقی) یا \fBv,h\fP (برای هر دو) را تعیین کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-pre\-shift h, v
تصویر را پیش از پردازش‌های بعدی جابه‌جا می‌کند. مقادیر h (جابه‌جایی افقی) و v (جابه‌جایی عمودی) می‌توانند مثبت یا منفی باشند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-post\-shift h, v
تصویر را پس از سایر پردازش‌ها جابه‌جا می‌کند. مقادیر h (جابه‌جایی افقی) و v (جابه‌جایی عمودی) می‌توانند مثبت یا منفی باشند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-pre\-wipe left, top, right, bottom
پیش از پردازش‌های بعدی، یک ناحیه را به‌صورت دستی پاک می‌کند. هر پیکسل در ناحیه پاک‌شده به رنگ سفید درمی‌آید. می‌توان با تکرار چندین‌باره این گزینه، چندین ناحیه را برای پاک کردن مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-post\-wipe left, top, right, bottom
پس از پردازش، یک ناحیه را به‌صورت دستی پاک می‌کند. هر پیکسل در ناحیه پاک‌شده به رنگ سفید درمی‌آید. می‌توان با تکرار چندین‌باره این گزینه، چندین ناحیه را برای پاک کردن مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-pre\-border left, top, right, bottom
ناحیه حاشیه برگه را پیش از پردازش‌های بعدی پاک می‌کند. هر پیکسل در ناحیه حاشیه به رنگ سفید درمی‌آید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-post\-border left, top, right, bottom
ناحیه حاشیه برگه را پس از سایر پردازش‌ها پاک می‌کند. هر پیکسل در ناحیه حاشیه به رنگ سفید درمی‌آید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-pre\-mask x1, y1, x2, y2
ماسک‌هایی را برای اعمال قبل از هر پردازش دیگری مشخص می‌کند. هر پیکسل خارج از ماسک سفید خواهد شد، مگر اینکه ماسک دیگری شامل آن پیکسل باشد.
.sp
تنها پیکسل‌های درون یک ماسک باقی خواهند ماند. می‌توان چندین ماسک را مشخص کرد. هیچ اصلاح انحرافی (deskewing) روی ماسک‌های تعیین‌شده توسط \fB\-\-pre\-mask\fP اعمال نخواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-s { width, height | size\-name } ; \-\-size { width, height | size\-name }
اندازه برگه را پیش از اعمال سایر پردازش‌ها تغییر می‌دهد. محتوای برگه برای تناسب با اندازه مناسب مقیاس‌بندی می‌شود، اما نسبت ابعاد حفظ می‌گردد. در عوض، در صورتی که نسبت ابعاد برگه تغییر کند، محتوای مقیاس‌شده در مرکز برگه قرار می‌گیرد.
.sp
مقادیر ممکن برای size\-name عبارتند از: \fBa5\fP، \fBa4\fP، \fBa3\fP، \fBletter\fP، \fBlegal\fP\&. تمامی نام‌های اندازه را می‌توان در جهت افقی (landscape) چرخانده‌شده نیز به کار برد؛ از \fBa4\-landscape\fP، \fBletter\-landscape\fP و غیره استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-post\-size { width, height | size\-name }
اندازه برگه را پس از اعمال مراحل پردازشی دیگر، با حفظ نسبت ابعاد محتوا تغییر می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-stretch { width, height | size\-name }
اندازه برگه را پیش از اعمال پردازش‌های دیگر تغییر می‌دهد. محتوای برگه تا اندازه مشخص‌شده کشیده می‌شود که ممکن است نسبت ابعاد را تغییر دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-post\-stretch { width, height | size\-name }
اندازه برگه را پس از اعمال پردازش‌های دیگر تغییر می‌دهد. محتوای برگه تا اندازه مشخص‌شده کشیده می‌شود که ممکن است نسبت ابعاد را تغییر دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-z factor ; \-\-zoom factor
اندازه برگه را بر اساس ضریب داده‌شده پیش از انجام پردازش‌های دیگر تغییر می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-post\-zoom factor
اندازه برگه را بر اساس ضریب داده‌شده پس از انجام پردازش‌ها تغییر می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-bn { v | h | v, h } ; \-\-blackfilter\-scan\-direction { v | h | v, h }
جهت‌هایی برای جستجوی نواحی کاملاً سیاه. می‌توان \fBv\fP (برای جستجوی عمودی)، \fBh\fP (برای جستجوی افقی) یا \fBv,h\fP (برای هر دو) را تعیین کرد. فیلتر سیاهی با حرکت یک نوار مجازی در سراسر هر صفحه کار می‌کند. میزان تیرگی درون نوار مجازی تعیین می‌شود و اگر از \fBblackfilter\-scan\-threshold\fP فراتر رود، پیکسل‌های سیاه در آن ناحیه پر می‌شوند. هنگام پر کردن، تیرگی هر پیکسل توسط \fBblack\-threshold\fP تعیین می‌شود. سپس نوار به اندازه \fBblackfilter\-scan\-step\fP در جهت پویش حرکت داده می‌شود. به محض برخورد با حاشیه صفحه، نوار به اندازه \fBblackfilter\-scan\-size\fP به سمت پایین (پویش افقی) یا راست (پویش عمودی) حرکت می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-bs { size | h\-size, v\-size } ; \-\-blackfilter\-scan\-size { size | h\-size, v\-size }
اندازه نوار مجازی در جهت پویش (به معنی عرض برای گذر افقی، ارتفاع برای گذر عمودی) که برای تشخیص ناحیه سیاه استفاده می‌شود. می‌توان دو مقدار را تعیین کرد تا اندازه برای گذر پویش افقی و گذر عمودی به‌صورت جداگانه تنظیم شود. (پیش‌فرض: \fB20,20\fP)
.UNINDENT
.INDENT 0.0.TP
.B \-bd { depth | h\-depth, v\-depth } ; \-\-blackfilter\-scan\-depth { depth | h\-depth, v\-depth }
عمق میلهٔ مجازی در جهت غیر پویشی (به معنای ارتفاع برای گذر افقی، و عرض برای گذر عمودی) که برای تشخیص ناحیهٔ سیاه به کار می‌رود. می‌توان دو مقدار مشخص کرد تا عمق برای گذر پویش افقی و گذر عمودی به طور مجزا تنظیم شود. (پیش‌فرض:
\fB500,500\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-bp { step | h\-step, v\-step } ; \-\-blackfilter\-scan\-step { step | h\-step, v\-step }
گام‌های جابه‌جایی میلهٔ مجازی برای تشخیص ناحیهٔ سیاه. می‌توان دو مقدار مشخص کرد تا گام برای گذر پویش افقی و گذر عمودی به طور مجزا تنظیم شود. (پیش‌فرض: \fB5,5\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-bt threshold ; \-\-blackfilter\-scan\-threshold threshold
نسبت پیکسل‌های تاریک که فراتر از آن، یک ناحیهٔ سیاه تشخیص داده می‌شود.
(پیش‌فرض: \fB0.95\fP).
.UNINDENT
.INDENT 0.0
.TP
.B \-bx left, top, right, bottom ; \-\-blackfilter\-scan\-exclude left, top, right, bottom
ناحیه‌ای که blackfilter نباید روی آن اعمال شود. این گزینه برای جلوگیری از عمل کردن blackfilter روی محتوای درونی صفحه کاربرد دارد. می‌توان این گزینه را چندین بار برای تعیین بیش از یک ناحیه مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-bi intensity ; \-\-blackfilter\-intensity intensity
شدت مورد استفاده برای حذف نواحی سیاه. این عمل پیکسل‌های اطراف میلهٔ پویش مجازی را حذف می‌کند. مقادیر بزرگ‌تر پیکسل‌های نوفهٔ (noise) کمتری را در اطراف نواحی سیاه پیشین باقی می‌گذارند، اما ممکن است محتوای صفحه را نیز حذف کنند.
(پیش‌فرض: \fB20\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-ni intensity ; \-noisefilter\-intensity intensity
شدت مورد استفاده برای حذف پیکسل‌های منفرد یا خوشه‌های بسیار کوچک پیکسل‌ها. هر خوشه‌ای که تنها شامل حداکثر به تعداد intensity پیکسل تاریک متصل به هم باشد، حذف خواهد شد. (پیش‌فرض: \fB4\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-ls { size | h\-size, v\-size } ; \-\-blurfilter\-size { size | h\-size, v\-size }
اندازهٔ ناحیهٔ blurfilter برای جستجوی خوشه‌های پیکسلی \(dqتنها\(dq.
(پیش‌فرض: \fB100,100\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-lp { step | h\-step, v\-step } ; \-\-blurfilter\-step { step | h\-step, v\-step }
اندازهٔ گام‌های \(dqمات‌سازی\(dq در هر جهت. (پیش‌فرض: \fB50,50\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-li ratio ; \-\-blurfilter\-intensity ratio
شدت نسبی برای حذف خوشه‌های بسیار کوچک پیکسل‌ها. هر ناحیهٔ مات‌شده‌ای که حداکثر شامل نسبت ratio پیکسل تاریک باشد پاک‌سازی خواهد شد. (پیش‌فرض: \fB0.01\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-gs { size | h\-size, v\-size } ; \-\-grayfilter\-size { size | h\-size, v\-size }
اندازهٔ ماسک grayfilter برای جستجوی نواحی پیکسلی \(dqصرفاً خاکستری\(dq.
(پیش‌فرض: \fB50,50\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-gp { step | h\-step, v\-step } ; \-\-grayfilter\-step { step | h\-step, v\-step }
اندازهٔ گام‌های جابه‌جایی ماسک grayfilter در هر جهت. (پیش‌فرض:
\fB20,20\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-gt ratio ; \-\-grayfilter\-threshold ratio
شدت نسبی خاکستری بودن که در موارد عدم وجود پیکسل سیاه در ماسک، پیش از پاک‌سازی ماسک grayfilter پذیرفته می‌شود.
(پیش‌فرض: \fB0.5\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-p x, y; \-\-mask\-scan\-point x, y
تنظیم دستی نقطهٔ شروع برای تشخیص ماسک. می‌توان چندین گزینهٔ
\fB\-\-mask\-scan\-point\fP را برای تشخیص چندین ماسک تعیین کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-m x1, y1, x2, y2; \-\-mask x1, y1, x2, y2
افزودن دستی یک ماسک، علاوه بر ماسک‌هایی که به طور خودکار در اطراف مختصات \fB\-\-mask\-scan\-point\fP تشخیص داده شده‌اند (مگر اینکه
\fB\-\-no\-mask\-scan\fP مشخص شده باشد).
.sp
هر پیکسلی خارج از یک ماسک به رنگ سفید درمی‌آید، مگر اینکه ماسک دیگری آن پیکسل را بپوشاند.
.UNINDENT
.INDENT 0.0
.TP
.B \-mn { v \e| h \e| v,h }; \-\-mask\-scan\-direction { v \e| h \e| v,h }
جهت‌هایی برای جستجوی لبه‌های ماسک، با شروع از مختصات \-\-mask\-scan\-point. می‌توان هر یک از مقادیر \fBv\fP (برای بازتاب عمودی)،
\fBh\fP (برای بازتاب افقی) یا \fBv,h\fP (برای هر دو) را مشخص کرد.
(پیش‌فرض: \fBh\fP، زیرا \fBv\fP ممکن است پاراگراف‌های متنی را در برگه‌های تک‌صفحه‌ای برش دهد)
.UNINDENT
.INDENT 0.0
.TP
.B \-ms { size \e| h\-size, v\-size }; \-\-mask\-scan\-size { size \e| h\-size, v\-size }
عرض میلهٔ مجازی مورد استفاده برای تشخیص ماسک. می‌توان دو مقدار مشخص کرد تا اندازهٔ افقی و عمودی به صورت مجزا تعیین شوند. (پیش‌فرض:
\fB50,50\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-md { depth \e| h\-depth, v\-depth }; \-\-mask\-scan\-depth { depth \e| h\-depth, v\-depth }
ارتفاع میلهٔ مجازی مورد استفاده برای تشخیص ماسک. (پیش‌فرض:
\fB\-1,\-1\fP، با استفاده از کل عرض یا ارتفاع برگه)
.UNINDENT
.INDENT 0.0
.TP
.B \-mp { step \e| h\-step, v\-step }; \-\-mask\-scan\-step { step \e| h\-step, v\-step }
گام‌های جابه‌جایی میلهٔ مجازی برای تشخیص ماسک. (پیش‌فرض: \fB5,5\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-mt { threshold \e| h\-threshold, v\-threshold }; \-\-mask\-scan\-threshold { threshold \e| h\-threshold, v\-threshold }
نسبت پیکسل‌های تاریک که پایین‌تر از آن یک لبه تشخیص داده می‌شود، نسبت به بیشینهٔ سیاهی در هنگام شمارش از مختصات اولیه به سمت یک لبه. (پیش‌فرض: \fB0.1\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-mm w, h; \-\-mask\-scan\-minimum w, h
حداقل اندازهٔ مجاز برای یک ماسک به صورت خودکار شناسایی‌شده. ماسک‌های شناسایی‌شده که کوچک‌تر از این اندازه باشند نادیده گرفته شده و اندازهٔ آن‌ها برابر با مقدار مشخص‌شده توسط mask\-scan\-maximum تنظیم می‌شود. (پیش‌فرض: \fB100,100\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-mM w, h; \-\-mask\-scan\-maximum w, h
حداکثر اندازهٔ مجاز برای یک ماسک به صورت خودکار شناسایی‌شده. ماسک‌های شناسایی‌شده که بزرگ‌تر از این اندازه باشند، در هر جهت به صورت مجزا به این مقدار حداکثر کوچک خواهند شد. (پیش‌فرض: اندازهٔ برگه، یا اندازهٔ صفحهٔ حاصل از گزینهٔ
\fB\-\-layout\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-mc color; \-\-mask\-color color
مقدار رنگی که با آن، پیکسل‌های پوشش داده‌نشده توسط هرگونه ماسک پاک‌سازی می‌شوند. برای آزمایش به منظور مصورسازی اثر ماسک‌گذاری مفید است.
(توجه داشته باشید که یک مقدار RGB مورد انتظار است: R*65536 + G*256 + B.)
.UNINDENT
.INDENT 0.0
.TP
.B \-dn { left \e| top \e| right \e| bottom },...; \-\-deskew\-scan\-direction { left \e| top \e| right \e| bottom },...
لبه‌هایی که چرخش از سمت آن‌ها پویش می‌شود. هر لبه از یک ماسک می‌تواند برای تشخیص چرخش ماسک به کار رود. اگر چندین لبه مشخص شده باشد، مقدار میانگین استفاده خواهد شد، مگر اینکه انحراف آماری از مقدار \fB\-\-deskew\-scan\-deviation\fP\& فراتر رود. از \fBleft\fP برای پویش از لبهٔ چپ، \fBtop\fP برای پویش از لبهٔ بالا، \fBright\fP برای پویش از لبهٔ راست، و \fBbottom\fP برای پویش از پایین استفاده کنید. می‌توان جهت‌های متعدد را با کاما از یکدیگر جدا کرد. (پیش‌فرض:
\fBleft,right\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-ds pixels; \-\-deskew\-scan\-size pixels
اندازهٔ خط مجازی برای تشخیص چرخش. (پیش‌فرض: \fB1500\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-dd ratio; \-\-deskew\-scan\-depth ratio
میزان پیکسل‌های تاریک برای انباشت تا زمان توقف پویش، نسبت به اندازهٔ میلهٔ پویش. (پیش‌فرض: \fB0.5\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-dr degrees; \-\-deskew\-scan\-range degrees
محدوده‌ای که باید در آن به دنبال چرخش گشت، از \-degrees تا +degrees چرخش. (پیش‌فرض: \fB5.0\fP)
.UNINDENT
.INDENT 0.0.TP
.B \-dp degrees; \-\-deskew\-scan\-step degrees
گام‌های بین هر مرحله تشخیص زاویه چرخش. مقادیر کمتر منجر به نتایج بهتر می‌شوند اما سرعت پردازش را کاهش می‌دهند. (پیش‌فرض: \fB0.1\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-dv deviation; \-\-deskew\-scan\-deviation deviation
حداکثر انحراف آماری مجاز میان نتایج حاصل از لبه‌های تشخیص‌داده‌شده. در صورت فراتر رفتن از این حد، چرخشی اعمال نمی‌شود. (پیش‌فرض: \fB1.0\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-W left, top, right, bottom; \-\-wipe left, top, right, bottom
پاک‌کردن دستی یک ناحیه. تمام پیکسل‌های موجود در ناحیه پاک‌شده به رنگ سفید درمی‌آیند. چندین ناحیه \fB\-\-wipe\fP را می‌توان مشخص کرد. این مورد پس از اصلاح کجی (deskewing) و پیش از پویش خودکار حاشیه اعمال می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-mw { size \e| left, right }; \-\-middle\-wipe { size \e| left, right }
اگر \fB\-\-layout\fP روی \fBdouble\fP تنظیم شده باشد، این گزینه اندازه ناحیه میانی بین دو صفحه روی برگه را برای پاک‌کردن مشخص می‌کند. این گزینه زمانی که blackfilter موفق به حذف برخی نواحی سیاه نمی‌شود (مانند لکه‌های ناشی از فتوکپی در فاصله میان دو صفحه) می‌تواند مفید باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-B left, top, right, bottom; \-\-border left, top, right, bottom
افزودن دستی حاشیه. تمام پیکسل‌های موجود در ناحیه حاشیه به رنگ سفید درمی‌آیند. این مورد پس از اصلاح کجی و پیش از پویش خودکار حاشیه اعمال می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-Bn { v \e| h \e| v,h }; \-\-border\-scan\-direction { v \e| h \e| v,h }
جهت‌هایی که باید در آن‌ها به دنبال حاشیه بیرونی جستجو شود. می‌توان مقدار \fBv\fP (برای آینه‌کاری عمودی)، \fBh\fP (برای آینه‌کاری افقی) یا \fBv,h\fP (برای هر دو) را مشخص کرد. (پیش‌فرض: \fBv\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-Bs { size \e| h\-size, v\-size }; \-\-border\-scan\-size { size \e| h\-size, v\-size }
عرض نوار مجازی استفاده‌شده برای تشخیص حاشیه. می‌توان دو مقدار را برای تعیین جداگانه اندازه‌های افقی و عمودی مشخص کرد. (پیش‌فرض: \fB5,5\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-Bp { step \e| h\-step, v\-step }; \-\-border\-scan\-step { step \e| h\-step, v\-step }
گام‌های جابه‌جایی نوار مجازی برای تشخیص حاشیه. (پیش‌فرض: \fB5,5\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-Bt threshold; \-\-border\-scan\-threshold threshold
تعداد مطلق پیکسل‌های تیره پوشانده‌شده توسط ماسک پویش حاشیه که بالاتر از آن یک حاشیه شناسایی می‌شود. (پیش‌فرض: \fB5\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-Ba { left \e| top \e| right \e| bottom }; \-\-border\-align { left \e| top \e| right \e| bottom }
جهتی که ناحیه حاشیه تشخیص‌داده‌شده باید به آن سمت جابه‌جا شود. از \fB\-\-border\-margin\fP برای مشخص کردن فاصله‌های افقی و عمودی که باید از لبه برگه حفظ شوند، استفاده کنید. (پیش‌فرض: \fBnone\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-Bm vertical, horizontal; \-\-border\-margin vertical, horizontal
فاصله‌ای که هنگام تراز کردن یک ناحیه حاشیه باید از لبه برگه حفظ شود. می‌توان از پسوندهای اندازه‌گیری مانند cm و in استفاده کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-w threshold; \-\-white\-threshold threshold
نسبت روشنایی که بالاتر از آن یک پیکسل، سفید در نظر گرفته می‌شود. (پیش‌فرض: \fB0.9\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-b threshold; \-\-black\-threshold threshold
نسبت روشنایی که پایین‌تر از آن یک پیکسل، سیاه (غیرخاکستری) در نظر گرفته می‌شود. این مقدار توسط gray\-filter و blackfilter استفاده می‌شود. این مقدار همچنین هنگام تبدیل تصویر در مقیاس خاکستری به حالت سیاه‌وسفید نیز کاربرد دارد. (پیش‌فرض: \fB0.33\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-ip { 1 \e| 2 }; \-\-input\-pages { 1 \e| 2 }
اگر \fB2\fP مشخص شده باشد، به جای یک تصویر، دو تصویر ورودی خوانده شده و پیش از پردازش‌های بعدی، به‌صورت داخلی درون یک برگه با چینش دوتایی ترکیب می‌شوند. پیش از ترکیب داخلی، گزینه \fB\-\-pre\-rotation\fP می‌تواند به‌صورت اختیاری و جداگانه به‌عنوان نخستین مرحله پردازش روی هر دو تصویر ورودی اعمال شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-op { 1 \e| 2 }; \-\-output\-pages { 1 \e| 2 }
اگر \fB2\fP مشخص شده باشد، در نتیجه تفکیک یک برگه با چینش دوتایی پس از پردازش، به جای یک تصویر، دو تصویر خروجی ذخیره می‌شود. پس از تفکیک برگه، گزینه \fB\-\-post\-rotation\fP می‌تواند به‌صورت اختیاری و جداگانه به‌عنوان واپسین مرحله پردازش روی هر دو تصویر خروجی اعمال شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-S { width, height \e| size\-name }; \-\-sheet\-size { width, height \e| size\-name }
اجبار به استفاده از اندازه برگه ثابت. معمولاً اندازه برگه بر اساس اندازه تصویر ورودی (اگر \fBinput\-pages=1\fP باشد) یا دو برابر اندازه صفحه نخست در یک مجموعه ورودی دوصفحه‌ای (اگر \fBinput\-pages=2\fP باشد) تعیین می‌شود. اگر تصویر ورودی کوچکتر از اندازه مشخص‌شده در اینجا باشد، در مرکز قرار گرفته و حاشیه سفیدی دور آن را در برگه احاطه می‌کند. اگر تصویر ورودی بزرگتر باشد، در مرکز قرار گرفته و لبه‌های آن برش می‌خورند. این گزینه همچنین می‌تواند برای داشتن تصاویر خروجی با ابعاد یکنواخت در صورت تفاوت در اندازه تصاویر ورودی، مفید باشد. نام‌های استاندارد اندازه مانند \fBa4\-landscape\fP، \fBletter\fP و غیره قابل استفاده هستند (نگاه کنید به \fB\-\-size\fP). (پیش‌فرض: مطابق فایل ورودی)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-sheet\-background { black \e| white }
رنگی را تعیین می‌کند که برگه پیش از بارگذاری و قرار گرفتن هرگونه تصویری، با آن پر می‌شود. این گزینه در مواردی که اندازه برگه و اندازه تصویر با یکدیگر متفاوت است می‌تواند مفید باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-blackfilter sheet\-range
پویش ناحیه سیاه را غیرفعال می‌کند. می‌توان اندیس‌های منفرد برگه را مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-noisefilter sheet\-range
فیلتر نویز (noisefilter) را غیرفعال می‌کند. می‌توان اندیس‌های منفرد برگه را مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-blurfilter sheet\-range
فیلتر تاری (blurfilter) را غیرفعال می‌کند. می‌توان اندیس‌های منفرد برگه را مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-grayfilter sheet\-range
فیلتر خاکستری (grayfilter) را غیرفعال می‌کند. می‌توان اندیس‌های منفرد برگه را مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-mask\-scan sheet\-range
تشخیص ماسک را غیرفعال می‌کند. ماسک‌هایی که به‌صراحت توسط \fB\-\-mask\fP تعیین شده‌اند همچنان اعمال خواهند شد. می‌توان اندیس‌های منفرد برگه را مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-mask\-center sheet\-range
تراز خودکار هر ماسک به مرکز را غیرفعال می‌کند. در صورت تنظیم گزینه \fB\-\-layout\fP، تراز به مرکز به‌طور پیش‌فرض انجام می‌شود. می‌توان اندیس‌های منفرد برگه را مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-deskew sheet\-range
اصلاح کجی (deskewing) را غیرفعال می‌کند. می‌توان اندیس‌های منفرد برگه را مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-wipe sheet\-range
نواحی پاک‌سازی صریح را غیرفعال می‌کند. این بدان معناست که اثر پارامتر \fB\-\-wipe\fP را می‌توان به‌طور جداگانه برای هر برگه غیرفعال کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-border sheet\-range
حاشیه‌های صریحاً تعیین‌شده را غیرفعال می‌کند. این بدان معناست که اثر پارامتر \fB\-\-border\fP را می‌توان به‌طور جداگانه برای هر برگه غیرفعال کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-border\-scan sheet\-range
پویش حاشیه از لبه‌های برگه را غیرفعال می‌کند. می‌توان اندیس‌های منفرد برگه را مشخص کرد.
.UNINDENT
.INDENT 0.0.TP
.B \-\-no\-border\-align sheet\-range
غیرفعال‌سازی هم‌تراز کردن ناحیه شناسایی‌شده توسط پویش حاشیه (نگاه کنید به
\fB\-\-border\-align\fP). نمایه‌های برگه به‌طور مجزا قابل تعیین هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-n sheet\-range; \-\-no\-processing sheet\-range
عدم اعمال هرگونه پردازش روی یک برگه به جز چرخش و قرینه‌سازی قبل/بعد، و تبدیل‌های عمق فایل در زمان ذخیره‌سازی. این گزینه همان اثری را دارد که تنظیم هم‌زمان تمام گزینه‌های \fB\-\-no\-xxx\fP با یکدیگر دارد. نمایه‌های برگه به‌طور مجزا قابل تعیین هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-interpolate { nearest \e| linear \e| cubic }
تنظیم تابع درونیابی (interpolation) مورد استفاده برای رفع کجی و کشیدگی. گزینه
\fBcubic\fP بهترین کیفیت تصویر را ارائه می‌دهد، در حالی که \fBnearest\fP
سریع‌ترین است. (پیش‌فرض: \fBcubic\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-multi\-pages
غیرفعال‌سازی پردازش چندصفحه‌ای حتی اگر نام فایل ورودی حاوی یک
\fB%\fP باشد (که معمولاً نشان‌دهنده شروع یک جانگهدار برای شمارنده صفحه است).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dpi dpi
تعداد نقطه در اینچ مورد استفاده برای تبدیل مقادیر اندازه سنجیده‌شده، مانند
\fB21cm,27.9cm\fP\&. توجه داشته باشید که این پارامتر باید پیش از مشخص کردن هر مقدار اندازه‌ای با پسوند یکای سنجش بیاید. (پیش‌فرض: \fB300\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-t { pbm \e| pgm \e| ppm }; \-\-type { pbm \e| pgm> \e| ppm }
نوع فایل خروجی (و عمق بیت). اگر مشخص نشود، قالبی با همان قالب پیکسلی فایل‌های ورودی اصلی، یا نزدیک‌ترین به آن، استفاده خواهد شد.
.INDENT 7.0
.TP
.B \fBpbm\fP
نقشه بیتی قابل‌حمل (Portable Bit Map)، تصویر خام تک‌رنگ.
.TP
.B \fBpgm\fP
نقشه خاکستری قابل‌حمل (Portable Grayscale Map)، تصویر خام طیف خاکستری ۸ بیت در هر پیکسل.
.TP
.B \fBppm\fP
نقشه پیکسلی قابل‌حمل (Portable Pixel Map)، تصویر خام RGB با ۲۴ بیت در هر پیکسل.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-T ; \-\-test\-only
هیچ خروجی‌ای نوشته نمی‌شود. ممکن است در ترکیب با
\fB\-\-verbose\fP برای دریافت اطلاعات درباره ورودی مفید باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-si nr; \-\-start\-input nr
تنظیم نخستین شماره صفحه برای جایگزینی با \(aq%d\(aq در نام فایل‌های ورودی.
هر بار که توالی فایل‌های ورودی تکرار شود، این شماره ۱ واحد افزایش می‌یابد.
(پیش‌فرض: (startsheet\-1)*inputpages+1)
.UNINDENT
.INDENT 0.0
.TP
.B \-so nr; \-\-start\-output nr
تنظیم نخستین شماره صفحه برای جایگزینی با \(aq%d\(aq در نام فایل‌های خروجی.
هر بار که توالی فایل‌های خروجی تکرار شود، این شماره ۱ واحد افزایش می‌یابد.
(پیش‌فرض: (startsheet\-1)*outputpages+1)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-insert\-blank nr [,nr...]
استفاده از ورودی خالی به جای یک فایل ورودی از توالی فایل‌های ورودی در موقعیت‌های نمایه مشخص‌شده. توالی فایل‌های ورودی موقتاً متوقف شده و پس از آن با فایل ورودی بعدی ادامه خواهد یافت. این می‌تواند برای درج محتوای خالی در یک توالی از تصاویر ورودی مفید باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-replace\-blank nr [,nr...]
مانند \fB\-\-insert\-blank\fP، اما تصاویر ورودی در موقعیت‌های نمایه مشخص‌شده با محتوای خالی جایگزین شده و بنابراین نادیده گرفته خواهند شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
اجازه رونویسی فایل‌های موجود. در غیر این صورت، چنانچه فایل خروجی مورد نظر برای نوشتن از قبل وجود داشته باشد، برنامه با خطا متوقف می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-q ; \-\-quiet
حالت بی‌صدا، بدون هیچ خروجی‌ای.
.UNINDENT
.INDENT 0.0
.TP
.B \-v ; \-\-verbose
خروجی پرگو، پیام‌های اطلاعاتی بیشتر.
.UNINDENT
.INDENT 0.0
.TP
.B \-vv
خروجی حتی پرگوتر، نمایش تنظیمات پارامترها پیش از پردازش.
.UNINDENT
.INDENT 0.0
.TP
.B \-V ; \-\-version
نمایش اطلاعات نسخه و ساخت برنامه.
.UNINDENT.SH "نویسندگان (AUTHORS)"
نویسندگان unpaper
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2020، نویسندگان unpaper
.\" End of generated man page.