.\" Copyright (C) 2001-2019 Peter Selinger.
.\" This file is part of Potrace. It is free software and it is covered
.\" by the GNU General Public License. See the file COPYING for details.
.\" 
.TH potrace 1 "September 2019" "Version 1.16"
.SH "نام (NAME)"
potrace \- تبدیل تصاویر بیت‌مپ به گرافیک برداری.
.SH "خلاصه دستور (SYNOPSIS)"
.nf
.B potrace [\fIoptions\fP] [\fIfilename...\fP]
.fi
.SH "توضیحات (DESCRIPTION)"

\fBpotrace\fP ابزاری برای ردیابی بیت‌مپ است، بدین معنی که یک تصویر بیت‌مپ را به تصویری صاف و مقیاس‌پذیر تبدیل می‌کند. ورودی یک تصویر بیت‌مپ است، یعنی تصویری مبتنی بر پیکسل که تنها از دو رنگ سیاه و سفید تشکیل شده است. خروجی در قالب SVG، PDF، EPS، یا یکی از چندین قالب برداری دیگر خواهد بود. یک کاربرد رایج آن، ایجاد گرافیک برداری از داده‌های اسکن‌شده مانند نشان‌واره‌های شرکت‌ها یا دانشگاه‌ها، یادداشت‌های دست‌نویس و غیره است. تصویر حاصل برخلاف بیت‌مپ دندانه‌دار نیست، بلکه هموار است و می‌تواند در هر وضوحی رندر شود.

\fBpotrace\fP می‌تواند بیت‌مپ‌ها را در قالب‌های زیر بخواند: PBM، PGM، PPM (که در مجموع با نام PNM شناخته می‌شوند، \fBpnm\fP(5) را ببینید)، و همچنین BMP (قالب‌های بیت‌مپ Windows و OS/2). تصویر ورودی باید تنها از دو رنگ سیاه و سفید استفاده کند. اگر مقادیر پیکسلی دیگری در ورودی وجود داشته باشند، با استفاده از یک روش آستانه‌گذاری ساده به سیاه و سفید تبدیل خواهند شد.

در حال حاضر \fBpotrace\fP می‌تواند قالب‌های خروجی زیر را تولید کند: SVG، PDF، EPS، PostScript، DXF، GeoJSON، PGM، Gimppath، و XFig. ممکن است در آینده بک‌اندهای دیگری نیز اضافه شوند.
.SH "گزینه‌ها (OPTIONS)"

گزینه‌های زیر پشتیبانی می‌شوند. ابعاد (آرگومان‌های از نوع \fIdim\fP) می‌توانند واحدهای اختیاری داشته باشند، مانند 6.5in، 15cm، 100pt. واحد پیش‌فرض اینچ است (یا سانتی‌متر، در صورتی که هنگام کامپایل این‌گونه پیکربندی شده باشد؛ بخش COMPILE TIME CONFIGURATION را در زیر ببینید). برای قالب‌های خروجی مبتنی بر پیکسل مانند PGM، DXF، GeoJSON و Gimppath، واحد پیش‌فرض پیکسل است.
.SS "گزینه‌های عمومی:"
.TP 15
.B -h, --help
چاپ پیام راهنما و خروج.
.TP
.B -v, --version
چاپ اطلاعات نسخه و خروج. این گزینه همچنین مقادیر پیش‌فرضی را که در زمان کامپایل در این نسخه از \fBpotrace\fP گنجانده شده‌اند نمایش می‌دهد.
.TP
.B -l, --license
چاپ اطلاعات مجوز و خروج.
.PD
.SS "گزینه‌های ورودی/خروجی:"
.TP 15
.B \fIfilename\fP
هر فایل می‌تواند شامل یک تصویر ورودی یا چندین تصویر ورودیِ الحاق‌شده باشد. اگر آرگومان‌های نام فایل داده شوند، \fBpotrace\fP به طور پیش‌فرض برای هر نام فایل ورودی، یک فایل خروجی ایجاد می‌کند. نام فایل خروجی با تغییر پسوند نام فایل ورودی متناسب با بک‌اند انتخاب‌شده به دست می‌آید. اگر تغییر پسوند به دلیل یکسان شدن نام فایل‌های ورودی و خروجی امکان‌پذیر نباشد، نام فایل خروجی با افزودن پسوند «-out» به نام فایل ورودی ایجاد می‌شود. اگر هیچ نام فایلی مشخص نشود، \fBpotrace\fP به عنوان یک فیلتر عمل کرده، داده‌ها را از ورودی استاندارد می‌خواند و در خروجی استاندارد می‌نویسد. می‌توان از نام فایل «-» برای مشخص کردن ورودی استاندارد استفاده کرد.
.TP
.B -o \fIfilename\fP, --output \fIfilename\fP
نوشتن خروجی در این فایل. تمام خروجی‌ها به فایل مشخص‌شده هدایت می‌شوند. در صورت استفاده از این گزینه، تعیین چندین فایل ورودی تنها برای بک‌اندهای چندصفحه‌ای مجاز است (بخش BACKEND TYPES را در زیر ببینید). در این حالت، هر فایل ورودی ممکن است شامل یک یا چند بیت‌مپ باشد و تمامی بیت‌مپ‌های موجود در فایل‌های ورودی پردازش شده و خروجی در قالب یک فایل واحد ادغام می‌شود. می‌توان از نام فایل «-» برای نوشتن در خروجی استاندارد استفاده کرد.
.TP
.B --
پایان گزینه‌ها. تمام آرگومان‌های باقی‌مانده به عنوان نام فایل تفسیر می‌شوند. این کار حتی در صورت ارائه نشدن نام فایل، حالت فیلتر را غیرفعال می‌کند. این ویژگی برای اسکریپت‌های شل مفید است، زیرا دستور \fBpotrace -- $FILENAMES\fP حتی با یک فهرست خالی از نام فایل‌ها عملکرد صحیحی خواهد داشت. با این حال، استفاده از \fB--\fP همراه با یک فهرست خالی از نام فایل‌ها در کنار گزینهٔ \fB-o\fP مجاز نیست، زیرا این کار سندی بدون صفحه تولید می‌کند که هیچ‌یک از بک‌اندها آن را مجاز نمی‌دانند.
.PD.SS انتخاب بک‌اند (Backend selection):
برای اطلاعات عمومی، همچنین «انواع بک‌اند (BACKEND TYPES)» را در زیر ببینید.
.TP 15
.B -b \fIname\fP, --backend \fIname\fP
انتخاب بک‌اند با نام، که در آن \fIname\fP یکی از eps، postscript،
ps، pdf، pdfpage، svg، dxf، geojson، pgm، gimppath یا xfig است. نام‌های
بک‌اند را تا زمانی که بدون ابهام باشند می‌توان با یک پیشوند کوتاه کرد.
نام‌های بک‌اند به حروف بزرگ و کوچک حساس نیستند.
.TP
.B -s, --svg, -b svg, --backend svg
بک‌اند SVG. خروجی یک فایل Scalable Vector Graphics (SVG) است.
این یک بک‌اند تک‌صفحه‌ای، با اندازهٔ متغیر و مبتنی بر ابعاد است. توجه
داشته باشید که مگر در صورت تعیین گزینهٔ \fB-r\fP، تفکیک‌پذیری (رزولوشن)
بیت‌مپ ورودی 72dpi در نظر گرفته می‌شود.
.TP
.B -b pdf, --backend pdf
بک‌اند PDF. خروجی فایلی در قالب Portable Document Format است. اگر
ورودی شامل چند بیت‌مپ باشد، هر کدام در یک صفحهٔ جداگانه رندر می‌شوند.
این یک بک‌اند چندصفحه‌ای، با اندازهٔ متغیر و مبتنی بر ابعاد است.
.TP
.B -b pdfpage, --backend pdfpage
بک‌اند PDFPage مشابه بک‌اند PDF است، با این تفاوت که مانند بک‌اند
PostScript اندازهٔ ثابت دارد.
.TP
.B -e, --eps, -b eps, --backend eps
بک‌اند EPS (پیش‌فرض). خروجی یک فایل Encapsulated PostScript است.
این یک بک‌اند تک‌صفحه‌ای، با اندازهٔ متغیر و مبتنی بر ابعاد است.
.TP
.B -p, --postscript, -b ps, --backend ps
بک‌اند PostScript. خروجی یک فایل PostScript است. این یک بک‌اند
چندصفحه‌ای، با اندازهٔ ثابت و مبتنی بر ابعاد است. اگر ورودی شامل چند
بیت‌مپ باشد، هر کدام در یک صفحهٔ جداگانه رندر می‌شوند.
.TP
.B -b dxf, --backend dxf
بک‌اند DXF. خروجی فایلی در قالب Drawing Interchange Format (DXF)
است. در این بک‌اند، تمام منحنی‌های Bezier توسط کمان‌های دایره‌ای تکه‌ای
تقریب زده می‌شوند؛ این امر برای پردازش در نرم‌افزارهای CAD یا کاربردهای
ماشین‌کاری با ابزارهای CNC مناسب است. این یک بک‌اند تک‌صفحه‌ای، با
اندازهٔ متغیر و مبتنی بر پیکسل است. گزینهٔ \fB-u\fP هیچ اثری روی این
بک‌اند ندارد.
.TP
.B -b geojson, --backend geojson
بک‌اند GeoJSON. خروجی فایلی در قالبی است که توسط برخی برنامه‌های
پردازش داده‌های جغرافیایی استفاده می‌شود. در این بک‌اند، تمام منحنی‌های
Bezier توسط ۸ پاره‌خط راست تقریب زده می‌شوند. این یک بک‌اند تک‌صفحه‌ای،
با اندازهٔ متغیر و مبتنی بر پیکسل است. گزینهٔ \fB-u\fP هیچ اثری روی این
بک‌اند ندارد.
.TP
.B -g, --pgm, -b pgm, --backend pgm
بک‌اند PGM. خروجی یک فایل portable greymap (PGM) است. این
بک‌اندی مناسب برای هموارسازی (antialiasing) یک تصویر بیت‌مپ است. این یک
بک‌اند چندصفحه‌ای، با اندازهٔ متغیر و مبتنی بر پیکسل است. اگر ورودی شامل
بیش از یک تصویر باشد، تصاویر در خروجی به یکدیگر متصل می‌شوند.
.TP
.B -b gimppath, --backend gimppath
بک‌اند Gimppath. این بک‌اند خروجی مناسبی تولید می‌کند تا به عنوان یک مسیر
توسط GNU Image Manipulation Program (Gimp) وارد شود (در پنجرهٔ گفتگوی
Layers, Channels & Paths، بخش Paths را انتخاب کنید، سپس راست‌کلیک
کرده و Import Path را برگزینید). خروجی در واقع یک فایل SVG است.
تفاوت‌های آن با بک‌اند SVG عبارتند از: گزینهٔ \fB--opaque\fP هیچ تأثیری
ندارد، گزینهٔ \fB--flat\fP همیشه فعال است، و ابعاد مبتنی بر پیکسل هستند.
این یک بک‌اند تک‌صفحه‌ای، با اندازهٔ متغیر و مبتنی بر پیکسل است.
.TP
.B -b xfig, --backend xfig
بک‌اند XFig. این یک بک‌اند تک‌صفحه‌ای، با اندازهٔ ثابت و مبتنی بر ابعاد است.
خروجی فایلی در قالب XFig است. توجه داشته باشید که XFig به جای منحنی‌های
Bezier از X-splines استفاده می‌کند، بنابراین تبدیل خروجی \fBpotrace\fP به
قالب XFig با دقت مطلق ممکن نیست. این بک‌اند با استفاده از دو نقطهٔ کنترل
برای هر قطعه از منحنی Bezier تقریب معقولی ایجاد می‌کند. گزینهٔ \fB-u\fP
هیچ اثری روی این بک‌اند ندارد، زیرا در XFig نقاط کنترل همیشه به نزدیک‌ترین
1/1200 اینچ گرد می‌شوند. بهینه‌سازی منحنی غیرفعال است. متضمن
\fB--opaque\fP است.
.PD
.SS گزینه‌های الگوریتم (Algorithm options):
برای اطلاعات دقیق‌تر دربارهٔ این گزینه‌ها، «مستندات فنی (TECHNICAL
DOCUMENTATION)» را در زیر ببینید.
.TP 15
.B -z \fIpolicy\fP, --turnpolicy \fIpolicy\fP
چگونگی رفع ابهام در تجزیهٔ مسیر را مشخص می‌کند. باید یکی از موارد
black، white، right، left، minority، majority یا random باشد. پیش‌فرض
minority است. سیاست‌های گردش را می‌توان با یک پیشوند بدون ابهام کوتاه کرد؛
برای مثال می‌توان min را به جای minority مشخص نمود.
.TP
.B -t \fIn\fP, --turdsize \fIn\fP
حذف لکه‌ها و نویزهای ریز (speckles) تا حداکثر این تعداد پیکسل.
.TP
.B -a \fIn\fP, --alphamax \fIn\fP
تنظیم پارامتر آستانهٔ گوشه. مقدار پیش‌فرض 1 است. هرچه این مقدار
کوچک‌تر باشد، گوشه‌های تیز بیشتری تولید خواهد شد. اگر این پارامتر 0
باشد، هیچ هموارسازی‌ای انجام نمی‌شود و خروجی یک چندضلعی خواهد بود.
اگر این پارامتر بزرگ‌تر از 4/3 باشد، تمام گوشه‌ها حذف شده و خروجی کاملاً
هموار و صاف می‌شود.
.TP
.B -n, --longcurve
غیرفعال کردن بهینه‌سازی منحنی. در حالت عادی \fBpotrace\fP سعی
می‌کند در صورت امکان قطعات منحنی Bezier مجاور را به یکدیگر متصل کند.
این گزینه این رفتار را غیرفعال کرده و منجر به افزایش حجم فایل می‌شود.
.TP
.B -O \fIn\fP, --opttolerance \fIn\fP
تنظیم میزان تلورانس بهینه‌سازی منحنی. مقدار پیش‌فرض 0.2 است.
مقادیر بزرگ‌تر به قطعات متوالی بیشتری از منحنی‌های Bezier اجازه می‌دهند
تا به بهای کاهش دقت، به یک قطعهٔ واحد تبدیل شوند.
.TP
.B -u \fIn\fP, --unit \fIn\fP
تنظیم کوانتش (quantization) خروجی. مختصات در خروجی به 1/unit پیکسل
گرد می‌شوند. مقدار پیش‌فرض 10 معمولاً نتایج خوبی می‌دهد. برای برخی از
حالت‌های اشکال‌زدایی (debug)، مقدار 100 خروجی دقیق‌تری ارائه می‌دهد.
این گزینه برای بک‌اند XFig (که همیشه به 1/1200 اینچ تبدیل می‌کند) یا
بک‌اند DXF هیچ اثری ندارد. برای بک‌اند GeoJSON، این گزینه تنها یک پیشنهاد
است؛ گرد کردن واقعی ممکن است دقیق‌تر باشد، اما از مقدار تعیین‌شده
کم‌دقت‌تر نخواهد بود.
.TP
.B -d \fIn\fP, --debug \fIn\fP
تولید خروجی اشکال‌زدایی از نوع n. این گزینه روی بک‌اندهای مختلف اثرات
متفاوتی دارد. برای بک‌اندهای PostScript/EPS، مقادیر n=1,2,3 مراحل
میانی الگوریتم \fBpotrace\fP را نمایش می‌دهند.
.PD.SS گزینه‌های مقیاس‌بندی و جانمایی:
.TP 15
.B -P \fIformat\fP, --pagesize \fIformat\fP
برای backendهای با اندازهٔ ثابت، اندازهٔ صفحه را تنظیم می‌کند. قالب‌های زیر را می‌توان مشخص کرد: A4، A3، A5، B5، Letter، Legal، Tabloid، Statement، Executive، Folio، Quarto، 10x14. نام‌های قالب به بزرگی و کوچکی حروف حساس نیستند. همچنین آرگومانی به شکل \fIdim\fPx\fIdim\fP برای مشخص کردن ابعاد دلخواه پذیرفته می‌شود. اندازهٔ پیش‌فرض صفحه Letter است (یا A4، در صورتی که هنگام کامپایل پیکربندی شده باشد؛ بخش پیکربندی زمان کامپایل (COMPILE TIME CONFIGURATION) در زیر را ببینید). نام‌های قالب صفحه را می‌توان با یک پیشوند تا زمانی که یکتا و بدون ابهام باشد، خلاصه کرد. این گزینه برای backendهای با اندازهٔ متغیر تأثیری ندارد.
.TP
.B -W \fIdim\fP, --width \fIdim\fP
عرض تصویر خروجی را (پیش از هرگونه چرخش و حاشیه‌ها) تنظیم می‌کند. اگر فقط یکی از عرض یا ارتفاع مشخص شود، دیگری به گونه‌ای تنظیم می‌شود که نسبت ابعاد حفظ شود.
.TP
.B -H \fIdim\fP, --height \fIdim\fP
ارتفاع تصویر خروجی را تنظیم می‌کند. برای جزئیات به \fB-W\fP مراجعه کنید.
.TP
.B -r \fIn\fP[x\fIn\fP], --resolution \fIn\fP[x\fIn\fP]
برای backendهای مبتنی بر بُعد، وضوح (به dpi) را تنظیم می‌کند. یک اینچ در تصویر خروجی متناظر با این تعداد پیکسل در ورودی خواهد بود. توجه داشته باشید که مقدار بزرگ‌تر منجر به تصویر خروجی کوچک‌تر می‌شود. با دادن آرگومانی به شکل \fIn\fPx\fIn\fP امکان تعیین وضوح جداگانه در جهت‌های x و y وجود دارد. برای backendهای با اندازهٔ متغیر، وضوح پیش‌فرض 72dpi است. برای backendهای با اندازهٔ ثابت، وضوح پیش‌فرضی وجود ندارد؛ تصویر به طور پیش‌فرض برای جا شدن در صفحه مقیاس‌بندی می‌شود. این گزینه روی backendهای مبتنی بر پیکسل تأثیری ندارد. در صورت مشخص شدن \fB-W\fP یا \fB-H\fP، آنها اولویت دارند.
.TP
.B -x \fIn\fP[x\fIn\fP], --scale \fIn\fP[x\fIn\fP]
برای backendهای مبتنی بر پیکسل، ضریب مقیاس‌بندی را تنظیم می‌کند. مقداری بزرگ‌تر از 1 خروجی را بزرگ‌تر می‌کند، مقداری بین 0 و 1 خروجی را کوچک‌تر می‌کند. مقدار پیش‌فرض 1 است. با دادن آرگومانی به شکل \fIn\fPx\fIn\fP می‌توان ضرایب مقیاس‌بندی جداگانه‌ای برای جهت‌های x و y مشخص کرد. این گزینه برای backendهای مبتنی بر بُعد تأثیری ندارد. در صورت مشخص شدن \fB-W\fP یا \fB-H\fP، آنها اولویت دارند.
.TP
.B -S \fIn\fP, --stretch \fIn\fP
نسبت ابعاد را تنظیم می‌کند. مقدار بزرگ‌تر از 1 به این معنی است که تصویر در جهت y کشیده می‌شود. مقدار بین 0 و 1 به این معنی است که تصویر در جهت y فشرده می‌شود.
.TP
.B -A \fIangle\fP, --rotate \fIangle\fP
زاویهٔ چرخش را (به درجه) تنظیم می‌کند. خروجی به این اندازه در خلاف جهت عقربه‌های ساعت چرخانده می‌شود. این گزینه برای جبران تصاویری که کاملاً عمودی اسکن نشده‌اند کاربردی است.
.TP
.B -M \fIdim\fP, --margin \fIdim\fP
هر چهار حاشیه را تنظیم می‌کند. تأثیر و مقدار پیش‌فرض این گزینه به backend بستگی دارد. برای backendهای با اندازهٔ متغیر، حاشیه‌ها صرفاً در اطراف تصویر خروجی اضافه می‌شوند (یا در صورت حاشیه‌های منفی، کسر می‌شوند). حاشیهٔ پیش‌فرض برای این backendها 0 است. برای backendهای با اندازهٔ ثابت، تنظیمات حاشیه می‌تواند برای کنترل جای‌گذاری تصویر روی صفحه استفاده شود. اگر فقط یکی از حاشیه‌های چپ و راست داده شود، تصویر در این فاصله از لبهٔ مربوطه در صفحه قرار می‌گیرد؛ و به همین ترتیب برای بالا و پایین. اگر حاشیه‌ها در طرف‌های مخالف داده شوند، تصویر به گونه‌ای مقیاس‌بندی می‌شود که میان این حاشیه‌ها قرار گیرد، مگر اینکه مقیاس‌بندی قبلاً به طور صریح توسط یک یا چند مورد از گزینه‌های \fB-W\fP، \fB-H\fP، \fB-r\fP یا \fB-x\fP مشخص شده باشد. به طور پیش‌فرض، backendهای با اندازهٔ ثابت از حاشیه‌ای غیرصفر استفاده می‌کنند که پهنای آن به اندازهٔ صفحه بستگی دارد.
.TP
.B -L \fIdim\fP, --leftmargin \fIdim\fP
حاشیهٔ چپ را تنظیم می‌کند. برای جزئیات به \fB-M\fP مراجعه کنید.
.TP
.B -R \fIdim\fP, --rightmargin \fIdim\fP
حاشیهٔ راست را تنظیم می‌کند. برای جزئیات به \fB-M\fP مراجعه کنید.
.TP
.B -T \fIdim\fP, --topmargin \fIdim\fP
حاشیهٔ بالا را تنظیم می‌کند. برای جزئیات به \fB-M\fP مراجعه کنید.
.TP
.B -B \fIdim\fP, --bottommargin \fIdim\fP
حاشیهٔ پایین را تنظیم می‌کند. برای جزئیات به \fB-M\fP مراجعه کنید.
.TP
.B --tight
فضای خالی اطراف تصویر را پیش از اعمال مقیاس‌بندی و حاشیه‌ها حذف می‌کند. اگر این گزینه داده شود، محاسبات عرض، ارتفاع و حاشیه‌ها بر اساس طرح برداری واقعی انجام می‌شود، نه بر اساس ابعاد خارجی pixmap ورودی که حالت پیش‌فرض است. به ویژه، گزینهٔ \fB--tight\fP می‌تواند برای حذف هرگونه حاشیهٔ موجود از تصویر ورودی استفاده شود. برای توضیحات دقیق‌تر، فایل placement.pdf را ببینید.
.PD.SS گزینه‌های رنگ (Color options):
این گزینه‌ها تنها توسط برخی پس‌اندهای مشخص پشتیبانی می‌شوند. پس‌اندهای DXF و
GeoJSON از رنگ پشتیبانی نمی‌کنند.
.TP 15
.B -C \fI#rrggbb\fP, --color \fI#rrggbb\fP
تنظیم رنگ پیش‌زمینه تصویر خروجی. مقدار پیش‌فرض، سیاه است.
.TP
.B --fillcolor \fI#rrggbb\fP
تنظیم رنگ پرکردن تصویر خروجی، یعنی رنگ بخش‌های «سفیدی» که توسط بخش‌های «سیاه»
محصور شده‌اند. مقدار پیش‌فرض، شفاف رها کردن این بخش‌ها است. این گزینه مستلزم
\fB--opaque\fP است.
لطفاً توجه داشته باشید که این گزینه رنگ پس‌زمینه را تنظیم می‌کند؛ برای تنظیم
رنگ پیش‌زمینه، به جای آن از \fB--color\fP استفاده کنید.
.TP
.B --opaque
پر کردن بخش‌های سفید تصویر به‌صورت کدر (مات)، به جای شفاف گذاشتن آن‌ها. این گزینه
تنها بر بخش‌های سفید درونی اعمال می‌شود، یعنی بخش‌هایی که درون یک طرح کلی سیاه
محصور شده‌اند. مات بودن همواره برای پس‌اند XFig فعال است.
.PD
.SS گزینه‌های SVG:
.TP 15
.B --group
برای خروجی SVG، تلاش برای گروه‌بندی مسیرهای مرتبط با یکدیگر. هر مسیر به همراه
تمام مسیرهایی که درون آن قرار دارند در یک گروه قرار می‌گیرد، به طوری که می‌توان
آن‌ها را به عنوان یک واحد در یک ویرایشگر SVG جابه‌جا کرد. این کار رنگ‌آمیزی
اجزای جداگانه را اندکی دشوارتر می‌کند و به همین دلیل حالت پیش‌فرض نیست.
.TP
.B --flat
برای خروجی SVG، قرار دادن کل تصویر در یک مسیر واحد. این کار رنگ‌آمیزی اجزا به صورت
جداگانه را غیرممکن می‌سازد و بنابراین پیش‌فرض نیست. اما فایل SVG حاصل را می‌توان
بسیار آسان‌تر به برخی برنامه‌ها مانند Gimp وارد (import) کرد. در واقع، پس‌اند
Gimppath گونه‌ای از پس‌اند SVG است که به همراه گزینه \fB--flat\fP و مقیاس‌بندی
مبتنی بر پیکسل ارائه شده است. در صورت انتخاب گزینه \fB--opaque\fP، گزینه
\fB--flat\fP هیچ تأثیری نخواهد داشت.
.PD
.SS گزینه‌های PostScript/EPS/PDF:
.TP 15
.B -c, --cleartext
خروجی فشرده‌سازی نشود. این گزینه استفاده از فیلترهای فشرده‌سازی را در خروجی
PostScript و PDF غیرفعال می‌کند. در پس‌اند PostScript، اگر گزینه‌های \fB-c\fP و
\fB-q\fP با هم استفاده شوند، خروجی حاصل به آسانی توسط برنامه‌های دیگر یا حتی انسان
قابل خواندن خواهد بود.
.TP
.B -2, --level2
استفاده از فشرده‌سازی سطح ۲ PostScript (پیش‌فرض). حجم فایل حاصل حدود ۴۰٪ کمتر
از حالتی است که از گزینه \fB-c\fP استفاده شود.
.TP
.B -3, --level3
استفاده از فشرده‌سازی سطح ۳ PostScript، در صورت در دسترس بودن. این گزینه فایل‌هایی
اندکی کوچک‌تر از حالت استفاده از \fB-2\fP تولید می‌کند، اما ممکن است فایل‌های
حاصل روی چاپگرهای قدیمی‌تر سطح ۲ PostScript چاپ نشوند. اگر پشتیبانی از فشرده‌سازی
سطح ۳ PostScript در زمان کامپایل غیرفعال شده باشد، یک پیام هشدار چاپ شده و
به جای آن از فشرده‌سازی سطح ۲ استفاده می‌شود.
.TP
.B -q, --longcoding
غیرفعال کردن کدگذاری عددی بهینه‌شده در خروجی PostScript. در حالت عادی،
\fBpotrace\fP با بهره‌گیری از افزونگی موجود در پارامترهای منحنی، از یک قالب
عددی بسیار فشرده برای نمایش منحنی‌های Bezier در PostScript استفاده می‌کند. این گزینه
این رفتار را غیرفعال کرده و خروجی طولانی‌تر اما خواناتری تولید می‌کند (به‌ویژه
اگر از گزینه \fB-c\fP نیز استفاده شود).
.PD
.SS گزینه‌های PGM:
.TP 15
.B -G \fIn\fP, --gamma \fIn\fP
تنظیم مقدار گاما برای لبه‌زدایی (anti-aliasing) (پیش‌فرض 2.2 است). بیشتر
نمایشگرهای رایانه طیف‌های خاکستری را به صورت خطی بازنمایی نمی‌کنند، یعنی مقدار
خاکستری 0.5 دقیقاً در نیمه راه بین سیاه و سفید نمایش داده نمی‌شود. پارامتر گاما
این مورد را اصلاح کرده و بنابراین باعث ایجاد خروجی زیباتری می‌شود. مقدار پیش‌فرض
2.2 برای بیشتر نمایشگرهای عادی CRT مناسب است.
.PD
.SS گزینه‌های پیش‌اند (Frontend options):
.TP 15
.B -k \fIn\fP, --blacklevel \fIn\fP
تنظیم سطح آستانه برای تبدیل تصاویر ورودی به بیت‌مپ. الگوریتم \fBpotrace\fP
انتظار یک تصویر بیت‌مپ را دارد، بنابراین تمام پیکسل‌های تصاویر ورودی پیش از آغاز
پردازش به سیاه یا سفید تبدیل می‌شوند.
پیکسل‌هایی که روشنایی آن‌ها کمتر از \fIn\fP باشد به سیاه، و تمام پیکسل‌های دیگر
به سفید تبدیل می‌شوند. در اینجا \fIn\fP عددی بین 0 و 1 است. یک حالت به صورت
ویژه مدیریت می‌شود: اگر ورودی در قالب رنگ نمایه‌دار (indexed color) دقیقاً با
۲ رنگ باشد، مقدار blacklevel نادیده گرفته شده و رنگ تیره‌تر از میان آن دو رنگ به
سیاه نگاشت می‌شود.

نکته: روش استفاده شده توسط \fBpotrace\fP برای تبدیل greymap به بیت‌مپ بسیار
ابتدایی است؛ اگر از یک برنامه جداگانه، مانند \fBmkbitmap\fP(1) برای این منظور
استفاده شود، نتایج بسیار بهتری به دست می‌آید. به‌ویژه، برنامه \fBmkbitmap\fP(1)
که همراه با \fBpotrace\fP توزیع می‌شود، امکان مقیاس‌بندی و درونیابی تصویر را
پیش از آستانه‌گذاری فراهم می‌کند که منجر به حفظ به مراتب بهتر جزئیات می‌شود.
.TP
.B -i, --invert
وارونه کردن بیت‌مپ ورودی پیش از پردازش.
.PD.SS "گزینه‌های نوار پیشرفت:"
.TP 15
.B --progress
نمایش یک نوار پیشرفت برای هر نگاشت بیتی (bitmap) که پردازش می‌شود. این گزینه
برای استفاده تعاملی سودمند است. رفتار پیش‌فرض عدم نمایش هرگونه
اطلاعات پیشرفت است.
.TP
.B --tty \fImode\fP
تنظیم حالت ترمینال برای رندر کردن نوار پیشرفت. مقادیر ممکن عبارتند از
"vt100" که نیازمند یک ترمینال سازگار با vt100 است، و "dumb"
که تنها از نویسه‌های ASCII استفاده می‌کند. مقدار پیش‌فرض وابسته به سیستم است.
.PD
.SH "انواع بک‌اند (BACKEND TYPES)"
بک‌اندها را می‌توان به چند روش طبقه‌بندی کرد که بر
گزینه‌های دردسترس خط فرمان و رفتار آن‌ها تأثیر می‌گذارد:
.TP 5
.B اندازه ثابت یا اندازه متغیر:
برای بک‌اندهای با اندازه ثابت، اندازه صفحه همواره یکسان است (برای
نمونه Letter یا A4، همان‌طور که در زمان کامپایل یا با گزینه \fB-P\fP
مشخص می‌شود). به‌طور پیش‌فرض، تصویر در مرکز قرار می‌گیرد و متناسب با
اندازه صفحه مقیاس‌بندی می‌شود. برای بک‌اندهای با اندازه متغیر، اندازه صفحه از
اندازه تصویر پیروی می‌کند. در حال حاضر بک‌اندهای PostScript (PS)، PDFPage و
XFig اندازه ثابت هستند، و باقی بک‌اندها اندازه متغیر دارند.
.TP
.B مبتنی بر ابعاد یا مبتنی بر پیکسل:
در بک‌اندهای مبتنی بر ابعاد، فاصله‌ها با واحدهای فیزیکی
مانند اینچ یا سانتی‌متر اندازه‌گیری می‌شوند. در بک‌اندهای مبتنی بر پیکسل، فاصله‌ها
با واحد پیکسل سنجیده می‌شوند. گزینه \fB-r\fP تنها برای
بک‌اندهای مبتنی بر ابعاد کار می‌کند، و گزینه \fB-x\fP تنها برای
بک‌اندهای مبتنی بر پیکسل عمل می‌کند. در حال حاضر، بک‌اندهای DXF، PGM، Gimppath و GeoJSON
مبتنی بر پیکسل هستند، و باقی بک‌اندها
مبتنی بر ابعاد می‌باشند. هم‌اکنون، تمامی بک‌اندهای مبتنی بر پیکسل
اندازه متغیر دارند.
.TP
.B تک‌صفحه‌ای یا چندصفحه‌ای:
بک‌اندهای تک‌صفحه‌ای تنها می‌توانند یک تصویر واحد را بپذیرند. بک‌اندهای چندصفحه‌ای
می‌توانند چندین تصویر را بپذیرند، معمولاً یک تصویر در هر صفحه خروجی. در حال حاضر،
بک‌اندهای PostScript (PS)، PDF، PDFPage و PGM چندصفحه‌ای هستند، و
باقی بک‌اندها تک‌صفحه‌ای می‌باشند. توجه داشته باشید که چندین تصویر
ورودی را می‌توان به دو روش خواند: از چندین فایل ورودی (با
گزینه \fB-o\fP)، یا از یک فایل ورودی واحد که شامل چندین
تصویر پیوسته‌شده به هم است.
.PD
.SH "پیکربندی زمان کامپایل (COMPILE TIME CONFIGURATION)"

جنبه‌های خاصی از رفتار \fBpotrace\fP را می‌توان در
زمان کامپایل با ارسال گزینه‌های زیر به اسکریپت ./configure
پیکربندی کرد.
.TP 5
.B --disable-zlib
کامپایل \fBpotrace\fP بدون کتابخانه فشرده‌سازی zlib. این بدان معناست
که فشرده‌سازی PostScript سطح ۳ در دسترس نخواهد بود.
.TP
.B --enable-metric
کامپایل \fBpotrace\fP با سانتی‌متر به عنوان واحد پیش‌فرض به جای
اینچ.
.TP
.B --enable-a4
کامپایل \fBpotrace\fP با A4 به عنوان اندازه پیش‌فرض صفحه.
.PD
.SH "وضعیت خروج (EXIT STATUS)"

وضعیت خروج در صورت تکمیل موفقیت‌آمیز 0، در صورتی که خط
فرمان نامعتبر باشد 1، و در صورت بروز هر خطای دیگر 2 است.
.SH "نسخه (VERSION)"

1.16
.SH "نویسندگان (AUTHORS)"

Peter Selinger <selinger at users.sourceforge.net>

لطفاً برای فهرست کامل سایر مشارکت‌کنندگان فایل AUTHORS را ببینید.
.SH "مستندات فنی (TECHNICAL DOCUMENTATION)"

برای توضیحات فنی دقیق در مورد الگوریتم \fBpotrace\fP،
فایل potrace.pdf را ببینید که در وب‌سایت \fBpotrace\fP
در دسترس است. برای اطلاعات درباره API کتابخانه Potrace، به potracelib.pdf مراجعه کنید.
.SH "وب‌سایت و پشتیبانی (WEB SITE AND SUPPORT)"

آخرین نسخه \fBpotrace\fP از نشانی
http://potrace.sourceforge.net
در دسترس است. این سایت همچنین حاوی فهرستی از
پرسش‌های متداول و اطلاعاتی در مورد نحوه دریافت
پشتیبانی است..SH "همچنین ببینید (SEE ALSO)"

\fBmkbitmap\fP(1)
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"

کپی‌رایت (C) 2001-2019 Peter Selinger

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) که توسط بنیاد نرم‌افزار آزاد منتشر شده است، طبق نسخهٔ ۲ مجوز یا (به انتخاب خودتان) هر نسخهٔ بعدی دیگری، بازتوزیع کرده و/یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر مجوز عمومی همگانی گنو را ببینید.

شما باید به همراه این برنامه یک نسخه از GNU General Public License را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر نامه بنویسید:
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
همچنین ببینید: http://www.gnu.org