'\" t .\" Title: dvisvgm .\" Author: Martin Gieseking .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2026-08-03 .\" Manual: dvisvgm Manual .\" Source: dvisvgm 3.6.1 .\" Language: English .\" .TH "DVISVGM" "1" "2026\-08\-03" "dvisvgm 3\&.6\&.1" "dvisvgm Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" dvisvgm \- تبدیل فایل‌های DVI، EPS و PDF به قالب برداری SVG مبتنی بر XML .SH "خلاصه دستور (SYNOPSIS)" .sp \fBdvisvgm\fR [\fIoptions\fR] \fIfile\fR[\&.dvi] .sp \fBdvisvgm\fR \-\-eps [\fIoptions\fR] \fIfile1\fR[\&.eps] \fIfile2\fR[\&.eps] \&... .sp \fBdvisvgm\fR \-\-pdf [\fIoptions\fR] \fIfile\fR[\&.pdf] .SH "توضیحات (DESCRIPTION)" .sp ابزار خط فرمانی \fBdvisvgm\fR فایل‌های DVI تولیدشده توسط TeX/LaTeX را به قالب گرافیک برداری مقیاس‌پذیر مبتنی بر XML به نام SVG تبدیل می‌کند\&. این ابزار از نسخهٔ کلاسیک DVI ۲ و همچنین نسخهٔ ۳ (تولیدشده توسط pTeX در حالت عمودی) و نسخه‌های ۵ تا ۷ XeTeX که با عنوان XDV نیز شناخته می‌شوند، پشتیبانی می‌کند\&. افزون بر دستورات پایه‌ای DVI، برنامهٔ dvisvgm بسیاری از به‌اصطلاح \fIspecials\fR را نیز ارزیابی و پردازش می‌کند که قابلیت‌های قالب پایهٔ DVI را به میزان چشمگیری گسترش می‌دهند\&. برای بررسی دقیق‌تر، بخش \fBSupported Specials\fR در ادامه را ببینید\&. .sp از آنجا که استاندارد فعلی SVG 1\&.1 گرافیک‌های چندصفحه‌ای را تعریف نمی‌کند، dvisvgm برای هر صفحهٔ DVI یک فایل SVG جداگانه ایجاد می‌کند\&. به دلایل سازگاری، به‌طور پیش‌فرض تنها صفحهٔ اول تبدیل می‌شود\&. برای انتخاب یک صفحهٔ دیگر یا توالی دلخواهی از صفحات، از گزینهٔ \fB\-p\fR که در ادامه شرح داده شده است استفاده کنید\&. .sp قالب SVG یک قالب گرافیکی برداری است و از این رو dvisvgm تلاش می‌کند تا خطوط پیرامونی نشانه‌ها (glyphها) را برای تمامی قلم‌های ارجاع‌شده در یک بخش صفحهٔ DVI به توصیف‌های مسیر مقیاس‌پذیر تبدیل کند\&. سریع‌ترین راه برای دستیابی به این هدف، استخراج اطلاعات مسیر از فایل‌های قلم برداری موجود در قالب‌های PFB، TTF یا OTF است\&. اگر dvisvgm بتواند چنین فایلی را بیابد، تمامی اطلاعات پیرامونی لازم دربارهٔ نشانه‌ها را از آن استخراج می‌کند\&. .sp با این حال، منبع اصلی پیشین TeX برای توصیف قلم‌ها Metafont است که خروجی نقشه‌بیتی (بیت‌مپ) در قالب فایل‌های GF تولید می‌کند\&. به همین دلیل همهٔ قلم‌های قابل دسترسی TeX در قالب‌های مقیاس‌پذیر موجود نیستند\&. در این موارد، dvisvgm تلاش می‌کند با ردگیری (tracing) بیت‌مپ نشانه‌ها، خروجی Metafont را برداری‌سازی کند\&. نتایج به اندازهٔ همتایان PFB یا OTF (که به‌صورت دستی بهینه‌سازی شده‌اند) بی‌نقص نیستند، اما با این وجود در بیشتر موارد بسیار رضایت‌بخش هستند\&. .sp هنگام اجرای dvisvgm بدون گزینهٔ \fB\-\-no\-fonts\fR، این ابزار عنصرهای \fIfont\fR (\fB\fR\&...\fB\fR) ایجاد می‌کند تا داده‌های قلم را درون فایل‌های SVG جاسازی (embed) کند\&. متأسفانه، تنها تعداد اندکی از رندرکننده‌های SVG از این عنصرها پشتیبانی می‌کنند\&. بیشتر مرورگرهای وب و برنامه‌های گرافیک برداری آن‌ها را به‌درستی ارزیابی نمی‌کنند، به‌طوری که بخش‌های متنی گرافیک حاصل ممکن است ناهماهنگ به نظر برسند\&. برای ایجاد فایل‌های SVG سازگارتر، می‌توان گزینهٔ خط فرمانی \fB\-\-no\-fonts\fR را مشخص کرد تا عنصرهای قلم با مسیرهای گرافیکی ساده جایگزین شوند\&. بیشتر مرورگرهای وب (اما تنها تعداد کمی از رندرکننده‌های مستقل SVG) از قلم‌های WOFF و WOFF2 نیز پشتیبانی می‌کنند که می‌توانند به جای قلم‌های پیش‌فرض SVG به کار روند\&. گزینهٔ \fB\-\-font\-format\fR قابلیت تغییر قالبی که به قلم‌های جاسازی‌شده اعمال می‌شود را فراهم می‌کند\&. با این حال، این ویژگی تنها برای فایل‌های DVI یا فایل‌های PDF تبدیل‌شده از طریق پردازشگر جدید PDF مبتنی بر mutool کار می‌کند (پایین‌تر را ببینید)\&. متن موجود در فایل‌های PostScript همواره به عنصرهای مسیر (path) تبدیل می‌شود\&. .SH "گزینه‌ها (OPTIONS)" .sp برنامهٔ dvisvgm یک رابط خط فرمانی سازگار با POSIX با نام‌های گزینهٔ کوتاه و بلند ارائه می‌دهد\&. آن‌ها را می‌توان پیش و/یا پس از نام فایل مورد نظر برای تبدیل وارد کرد\&. همچنین، ترتیب مشخص کردن گزینه‌ها اهمیتی ندارد، به این معنی که می‌توانید آن‌ها را به هر ترتیبی بدون تغییر در رفتار dvisvgm اضافه کنید\&. برخی گزینه‌ها پارامترهای اضافی می‌پذیرند یا به آن‌ها نیاز دارند که مستقیماً به گزینهٔ کوتاه چسبانده می‌شوند یا با فاصله از آن جدا می‌شوند (مانند \fB\-v0\fR یا \fB\-v 0\fR)\&. گزینه‌های بلند به یک علامت مساوی اضافی (\fB=\fR) بین نام گزینه و آرگومان نیاز دارند، اما بدون هیچ فاصلهٔ خالی در اطراف آن (مانند \fB\-\-verbosity=0\fR)\&. چندین گزینهٔ کوتاه که انتظار پارامترهای بیشتری ندارند را می‌توان پس از یک خط فاصله با هم ترکیب کرد (مانند \fB\-ejs\fR به جای \fB\-e \-j \-s\fR)\&. .sp نام‌های بلند گزینه‌ها را می‌توان با حذف نویسه‌های انتهایی نیز کوتاه کرد، تا زمانی که نام کوتاه‌شده همچنان بدون ابهام باشد\&. برای نمونه، گزینهٔ \fB\-\-exact\-bbox\fR می‌تواند به \fB\-\-exact\fR، \fB\-\-exa\fR یا \fB\-\-ex\fR کوتاه شود\&. در صورت وجود اختصارهای مبهم، dvisvgm یک پیام خطا همراه با تمام نام‌های گزینهٔ مطابقت‌یافته چاپ می‌کند\&. .PP \fB\-b, \-\-bbox\fR=\fIfmt\fR .RS 4 جعبهٔ محصورکننده (bounding box) گرافیک SVG تولیدشده را روی قالب مشخص‌شده تنظیم می‌کند\&. این گزینه تنها بر تبدیل فایل‌های DVI اثر می‌گذارد\&. اسناد SVG تولیدشده از PDF و PostScript همواره جعبه‌های محصورکنندهٔ فایل‌های ورودی را به ارث می‌برند\&. .sp پارامتر \fIfmt\fR یا یکی از مشخص‌کننده‌های قالب فهرست‌شده در زیر را می‌پذیرد، یا توالی‌ای از چهار مقدار طول جداشده با کاما یا فاصله شامل \fIx1\fR، \fIy1\fR، \fIx2\fR و \fIy2\fR\&. مورد دوم، مختصات مطلق دو گوشهٔ قطری جعبهٔ محصورکننده را مشخص می‌کند\&. هر مقدار طول شامل یک عدد ممیز شناور و یک یکای طول اختیاری است (pt، bp، cm، mm، in، pc، dd، cc یا sp)\&. در صورت حذف یکا، واحدهای پوینت TeX (pt) در نظر گرفته می‌شوند\&. .sp همچنین امکان ارائهٔ تنها یک مقدار طول \fIl\fR وجود دارد\&. در این حالت، کمینهٔ جعبهٔ محصورکننده محاسبه شده و با افزودن (\-\fIl\fR,\-\fIl\fR) به گوشهٔ بالا\-چپ و (\fIl\fR,\fIl\fR) به گوشهٔ پایین\-راست گسترش می‌یابد\&. .sp علاوه بر این، dvisvgm مشخص‌کننده‌های قالب زیر را نیز پشتیبانی می‌کند: .PP \fBاندازه‌های کاغذ بین‌المللی DIN/ISO\fR .RS 4 A\fIn\fR، B\fIn\fR، C\fIn\fR، D\fIn\fR، که در آن \fIn\fR یک عدد صحیح غیرمنفی است، مانند A4 یا a4 برای قالب DIN/ISO A4 (۲۱۰ میلی‌متر \(mu ۲۹۷ میلی‌متر)\&. .RE .PP \fBاندازه‌های کاغذ آمریکای شمالی\fR .RS 4 invoice، executive، legal، letter، ledger .RE .PP \fBاندازه‌های ویژهٔ جعبهٔ محصورکننده\fR .RS 4 .TS tab(:); lt ltx lt ltx lt ltx lt ltx lt ltx. T{ \fBdvi\fR T}:T{ اندازهٔ صفحه ذخیره‌شده در فایل DVI T} T{ \fBmin\fR T}:T{ کمینه‌ترین/فشرده‌ترین جعبهٔ محصورکننده را محاسبه می‌کند T} T{ \fBnone\fR T}:T{ هیچ جعبهٔ محصورکننده‌ای اختصاص داده نمی‌شود T} T{ \fBpapersize\fR T}:T{ اندازه‌های جعبه مشخص‌شده توسط \fIpapersize\fR specials موجود در فایل DVI T} T{ \fBpreview\fR T}:T{ داده‌های جعبهٔ محصورکننده محاسبه‌شده توسط بستهٔ preview (اگر در فایل DVI موجود باشد) T} .TE .sp 1 .RE .PP \fBجهت‌گیری صفحه (Page orientation)\fR .RS 4 جهت‌گیری پیش‌فرض صفحه برای اندازه‌های کاغذ DIN/ISO و آمریکایی \fIportrait\fR (عمودی) است، یعنی \fIwidth\fR < \fIheight\fR\&. افزودن \fB\-landscape\fR یا صرفاً \fB\-l\fR به رشتهٔ قالب، حالت را به \fIlandscape\fR (افقی) تغییر می‌دهد (\fIwidth\fR > \fIheight\fR)\&. به دلایل تقارن، می‌توانید به‌طور صریح \fB\-portrait\fR یا \fB\-p\fR را نیز برای اشاره به قالب پیش‌فرض عمودی اضافه کنید\&. توجه داشته باشید که این پسوندها بخشی از رشتهٔ اندازه هستند و نه گزینه‌های جداگانه؛ بنابراین باید مستقیماً پس از مشخص‌کنندهٔ اندازه و بدون فاصلهٔ خالی اضافی بیایند\&. علاوه بر این، پسوندهای جهت‌گیری را نمی‌توان همراه با \fBdvi\fR، \fBmin\fR و \fBnone\fR به کار برد\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBنکته\fR .ps -1 .br گزینهٔ \fB\-b, \-\-bbox\fR تنها بر جعبهٔ محصورکننده تأثیر می‌گذارد و محتوای صفحه را تغییرشکل نمی‌دهد\&. از این رو، در صورت انتخاب یک قالب افقی، صفحه چرخانده نخواهد شد\&. .sp .5v .RE .RE .RE .PP \fB\-B, \-\-bitmap\-format\fR=\fIfmt\fR .RS 4 این گزینه قالب تصویری مورد استفاده برای جاسازی بیت‌مپ‌های استخراج‌شده از داده‌های PostScript یا PDF را تعیین می‌کند\&. به‌طور پیش‌فرض، dvisvgm تمام بیت‌مپ‌ها را به صورت تصاویر JPEG جاسازی می‌کند زیرا فشرده‌ترین قالب از میان دو قالب پشتیبانی‌شده توسط SVG است\&. برای انتخاب قالب جایگزینِ بدون‌اتلاف PNG، می‌توان از \fB\-\-bitmap\-format=png\fR استفاده کرد\&. انواع قالب‌های دیگری نیز وجود دارند که dvisvgm در حال حاضر از آن‌ها پشتیبانی می‌کند، هرچند که \fBjpeg\fR و \fBpng\fR باید در بیشتر موارد کافی باشند\&. فهرست زیر نمایی کلی از نام‌های قالب شناخته‌شده ارائه می‌دهد که متناظر با نام‌های دستگاه‌های خروجی Ghostscript هستند\&. .TS tab(:); lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx. T{ \fBnone\fR T}:T{ غیرفعال کردن پردازش تصاویر بیت‌مپ T} T{ \fBjpeg\fR T}:T{ قالب JPEG رنگی T} T{ \fBjpeggray\fR T}:T{ قالب JPEG در مقیاس خاکستری T} T{ \fBpng\fR T}:T{ قالب PNG در مقیاس خاکستری یا رنگی ۲۴ بیتی، بسته به فضای رنگ فعلی T} T{ \fBpnggray\fR T}:T{ قالب PNG در مقیاس خاکستری T} T{ \fBpngmono\fR T}:T{ قالب PNG سیاه‌وسفید T} T{ \fBpngmonod\fR T}:T{ قالب PNG سیاه‌وسفید با ترام‌ریزی (dithered) T} T{ \fBpng16\fR T}:T{ قالب PNG با رنگ ۴ بیتی T} T{ \fBpng256\fR T}:T{ قالب PNG با رنگ ۸ بیتی T} T{ \fBpng16m\fR T}:T{ قالب PNG با رنگ ۲۴ بیتی T} .TE .sp 1 از آنجا که مجموعهٔ دستگاه‌های خروجی پشتیبانی‌شده می‌تواند میان نصبیات محلی مختلف Ghostscript متغیر باشد، ممکن است همهٔ قالب‌ها در برخی محیط‌ها در دسترس نباشند\&. اگر قالب خروجی انتخاب‌شده نیازمند یک دستگاه خروجی باشد که به صورت محلی پشتیبانی نمی‌شود، dvisvgm با یک پیام خطای PostScript خارج می‌شود\&. .sp دو مشخص‌کنندهٔ قالب JPEG یک پارامتر اختیاری برای تنظیم سطح کیفیت IJG می‌پذیرند که باید مستقیماً پس از مشخص‌کنندهٔ قالب و جداشده با دونقطه بیاید، مانند \fB\-\-bitmap\-format=jpeg:50\fR\&. مقدار کیفیت یک عدد صحیح بین 0 و 100 است\&. مقادیر بالاتر منجر به کیفیت تصویر بهتر اما ضریب فشرده‌سازی کمتر و در نتیجه فایل‌های بزرگ‌تر می‌شوند\&. سطح کیفیت پیش‌فرض 75 است که در صورت تعیین نشدن پارامتر کیفیت یا تنظیم آن روی 0 اعمال می‌شود\&. .RE.PP \fB\-C, \-\-cache\fR[=\fIdir\fR] .RS 4 برای افزایش سرعت فرایند تبدیل قلم‌های بیت‌مپ، dvisvgm اطلاعات میانی تبدیل را در فایل‌های کَش ذخیره می‌کند\&. به‌طور پیش‌فرض، این فایل‌ها در \fB$XDG_CACHE_HOME/dvisvgm/\fR یا چنانچه \fBXDG_CACHE_HOME\fR تنظیم نشده باشد، در \fB$HOME/\&.cache/dvisvgm\fR ذخیره می‌شوند\&. اگر مکان دیگری را ترجیح می‌دهید، از گزینه \fB\-\-cache\fR برای بازنویسی مقدار پیش‌فرض استفاده کنید\&. علاوه بر این، غیرفعال کردن کامل سازوکار کش قلم با گزینه \fB\-\-cache=none\fR نیز امکان‌پذیر است\&. اگر آرگومان \fIdir\fR حذف شود، dvisvgm مسیر دایرکتوری پیش‌فرض کش را همراه با اطلاعات بیشتر درباره قلم‌های ذخیره‌شده چاپ می‌کند\&. همچنین، فایل‌های کش قدیمی و آسیب‌دیده حذف می‌شوند\&. .RE .PP \fB\-j, \-\-clipjoin\fR .RS 4 این گزینه به dvisvgm می‌گوید که تمام تقاطع‌های مسیرهای برش (clipping paths) را خودش محاسبه کند، به‌جای اینکه این وظیفه را به رندرکننده SVG واگذار نماید\&. فایل‌های SVG حاصل سازگاری و قابلیت‌حمل بیشتری دارند، زیرا برخی از نمایش‌دهنده‌های SVG از تقاطع مسیرهای برشی که توسط عناصر \fIclipPath\fR حاوی صفت \fIclip\-path\fR تعریف شده‌اند پشتیبانی نمی‌کنند\&. .RE .PP \fB\-\-color\fR .RS 4 رنگی‌سازی پیام‌های چاپ‌شده در حین فرایند تبدیل را فعال می‌کند\&. رنگ‌ها را می‌توان از طریق متغیر محیطی \fBDVISVGM_COLORS\fR سفارشی‌سازی کرد\&. برای اطلاعات بیشتر، بخش محیط (ENVIRONMENT) در ادامه را ببینید\&. .RE .PP \fB\-\-colornames\fR .RS 4 به‌طور پیش‌فرض، dvisvgm منحصراً از مقادیر RGB به شکل \fI#RRGGBB\fR یا \fI#RGB\fR برای نمایش رنگ‌ها در فایل SVG استفاده می‌کند\&. مورد دوم شکل کوتاه‌شده‌ای برای رنگ‌هایی است که مؤلفه‌های RGB آن‌ها هر یک از دو رقم هگزادسیمال یکسان تشکیل شده است؛ برای مثال، \fB#123\fR برابر است با \fB#112233\fR\&. طبق استاندارد SVG، استفاده از نام‌های رنگ (مانند \fBblack\fR و \fBdarkblue\fR) نیز برای تعداد محدودی از رنگ‌های از پیش تعریف‌شده (\m[blue]https://www.w3.org/TR/SVG11/types.html#ColorKeywords\m[]) امکان‌پذیر است\&. به‌منظور اعمال این نام‌های رنگ به‌جای مقادیر RGB آن‌ها، dvisvgm را با گزینه \fB\-\-colornames\fR فراخوانی کنید\&. تمامی رنگ‌های فاقد نام رنگ در SVG، همچنان با مقادیر RGB نمایش داده خواهند شد\&. .RE .PP \fB\-\-comments\fR .RS 4 توضیحاتی (کامنت‌هایی) را با اطلاعات تکمیلی درباره داده‌های منتخب به فایل SVG می‌افزاید\&. در حال حاضر، تنها عناصر قلم و قواعد CSS قلمِ مرتبط با قلم‌های بومی (native) حاشیه‌نویسی می‌شوند\&. .RE .PP \fB\-\-currentcolor\fR[=\fIcolor\fR] .RS 4 این گزینه به dvisvgm می‌گوید تا رنگ مشخص‌شده را با متغیر CSS با نام \fBcurrentColor\fR جایگزین کند که مقدار رنگ پیش‌زمینه جاری تعیین‌شده توسط ویژگی CSS با نام \fBcolor\fR را در بر دارد\&. بدین ترتیب یک برنامه کاربردی یا وب‌سایت می‌تواند رنگ را از طریق CSS تغییر دهد، بدون آنکه نیازی به تغییر کد SVG باشد\&. .sp آرگومان اختیاری \fB\-\-currentcolor\fR مقدار رنگ RGB مورد نظر برای جایگزینی را مشخص می‌کند و باید یا به صورت یک مقدار رنگ هگزادسیمال شش یا سه رقمی (\m[blue]https://www.w3.org/TR/css-color/#typedef-hex-color\m[]) که قبل از آن نویسه \fB#\fR قرار دارد مشخص شود؛ مانند \fB#0000ff\fR یا \fB#00f\fR برای آبی\&. در صورت حذف آرگومان اختیاری، رنگ سیاه به عنوان پیش‌فرض در نظر گرفته می‌شود\&. .RE .PP \fB\-\-embed\-bitmaps\fR .RS 4 محتوای فایل‌های بیت‌مپ را به‌جای افزودن ارجاع‌های فایلی، در درون فایل‌های SVG تولیدشده جاسازی می‌کند\&. به دلیل داده‌های با کدگذاری base64، فایل‌های SVG معمولاً بسیار بزرگ‌تر می‌شوند، اما هم‌زمان قابلیت‌حمل بیشتری دارند زیرا به فایل‌های بیت‌مپ خارجی وابسته نیستند\&. .sp این گزینه تنها بر بیت‌مپ‌های ارجاع‌داده‌شده در فایل‌های DVI/XDV تأثیر می‌گذارد، مثلاً از طریق \fB\eincludegraphics\fR یا دستور ویژه \fBdvisvgm:img\fR (پایین را ببینید)\&. بیت‌مپ‌های موجود در فایل‌های PostScript یا PDF همواره جاسازی می‌شوند\&. همچنین گزینه \fBbitmap\-format\fR را ببینید\&. .RE .PP \fB\-E, \-\-eps\fR .RS 4 در صورت ارائه این گزینه، dvisvgm به‌جای DVI انتظار یک یا چند فایل ورودی EPS را دارد و سعی می‌کند آن‌ها را به SVG تبدیل کند\&. برای انجام این کار، یک دستور ویژه \fIpsfile\fR ایجاد شده و به گرداننده ویژه PostScript ارجاع داده می‌شود\&. این گزینه تنها در صورتی در دسترس است که dvisvgm با پشتیبانی فعال از PostScript ساخته شده باشد، و نیازمند در دسترس بودن Ghostscript است\&. برای اطلاعات بیشتر، گزینه \fB\-\-libgs\fR را ببینید\&. .RE .PP \fB\-e, \-\-exact\-bbox\fR .RS 4 این گزینه به dvisvgm دستور می‌دهد تا جعبه احاطه‌کننده (bounding box) دقیق هر نویسه را محاسبه کند\&. به‌طور پیش‌فرض، مقادیر ذخیره‌شده در فایل TFM یک قلم برای تعیین حدود یک گلیف مورد استفاده قرار می‌گیرند\&. از آنجا که این مقادیر با هدف جای‌گذاری بهینه نویسه‌ها در نظر گرفته شده‌اند و نه برای نمایش ابعاد دقیق، لزوماً با مرزهای بصری گلیف‌ها مطابقت ندارند\&. در نتیجه، پهنا و/یا ارتفاع برخی گلیف‌ها ممکن است از مقادیر متناظر در TFM بزرگ‌تر (یا کوچک‌تر) باشد\&. این امر می‌تواند به بریده شدن نویسه‌ها در مرزهای گرافیک SVG منجر شود\&. با ارائه گزینه \fB\-\-exact\-bbox\fR، برنامه dvisvgm شکل واقعی هر نویسه را تحلیل کرده و جعبه احاطه‌کننده‌ای معمولاً کاملاً منطبق و بسته به دست می‌آورد\&. .sp این گزینه تنها بر پردازش فایل‌های DVI تأثیر می‌گذارد\&. هنگام تبدیل فایل‌های EPS یا PDF، از اطلاعات جعبه احاطه‌کننده ذخیره‌شده در همان فایل‌ها برای تعیین جعبه احاطه‌کننده SVG استفاده می‌شود\&. .RE .PP \fB\-f, \-\-font\-format\fR=\fIformat\fR .RS 4 قالب فایلی را مشخص می‌کند که برای جاسازی داده‌های قلم در خروجی SVG تولیدشده هنگام تبدیل فایل‌های DVI یا PDF به کار می‌رود\&. مورد دوم نیازمند گرداننده جدید PDF مبتنی بر mutool است که در dvisvgm نگارش 3\&.0 معرفی شده است (همچنین گزینه \fB\-\-pdf\fR را ببینید)\&. گزینه \fB\-\-font\-format\fR هنگام تبدیل فایل‌های PDF یا PostScript با استفاده از Ghostscript هیچ تأثیری ندارد\&. در این حالت، قطعه‌های متنی موجود در این فایل‌ها همواره به عناصر مسیر (path) تبدیل می‌شوند\&. .sp قالب‌های زیر پشتیبانی می‌شوند: \fBSVG\fR (پیش‌فرض)، \fBTTF\fR (TrueType)، \fBWOFF\fR، و \fBWOFF2\fR (Web Open Font Format نگارش ۱ و ۲)\&. به‌طور پیش‌فرض، dvisvgm قلم‌های بدون بهینه‌سازی نمایشی (unhinted) ایجاد می‌کند که ممکن است در دستگاه‌هایی با وضوح تصویر پایین جلوه نامناسبی داشته باشند\&. به‌منظور بهبود کیفیت نمایش، می‌توان قلم‌های TrueType، WOFF یا WOFF2 تولیدشده را به‌طور خودکار بهینه‌سازی نمایشی (autohint) کرد\&. این بهینه‌ساز خودکار با افزودن \fB,autohint\fR یا \fB,ah\fR به قالب قلم فعال می‌شود؛ مثلاً \fB\-\-font\-format=woff,autohint\fR یا \fB\-\-fwoff,ah\fR\&. این قابلیت نیازمند کتابخانه ttfautohint (\m[blue]https://freetype.org/ttfautohint\m[]) است\&. اگر این کتابخانه موجود نباشد یا یافت نشود، dvisvgm پیام هشدار مربوطه‌ای صادر می‌کند\&. .sp گزینه \fB\-\-font\-format\fR تنها در صورتی در دسترس است که dvisvgm با پشتیبانی فعال از WOFF ساخته شده باشد\&. .RE .PP \fB\-m, \-\-fontmap\fR=\fIfilenames\fR .RS 4 یک فایل نگاشت قلم یا توالی‌ای از فایل‌های نگاشت قلم را بارگذاری و ارزیابی می‌کند\&. این فایل‌ها برای حل نام فایل‌های قلم و رمزگذاری‌ها (encodings) مورد نیاز هستند\&. برنامه dvisvgm فایل‌های نگاشت اختصاصی خود را ارائه نمی‌دهد، بلکه تلاش می‌کند فایل‌های موجود همراه با dvips یا dvipdfm را بخواند\&. اگر گزینه \fB\-\-fontmap\fR حذف شود، dvisvgm فایل‌های نگاشت پیش‌فرض \fIdvisvgm\&.map\fR، \fIps2pk\&.map\fR، \fIpdftex\&.map\fR، \fIdvipdfm\&.map\fR، و \fIpsfonts\&.map\fR را (به همین ترتیب) جستجو می‌کند\&. در غیر این صورت، فایل‌های ارائه‌شده به عنوان آرگومان‌های گزینه به ترتیب مشخص‌شده ارزیابی می‌شوند\&. نام‌های متعدد فایل‌ها باید با کاما و بدون فاصله‌های خالی ابتدا و/یا انتها از یکدیگر جدا شوند\&. .sp به‌طور پیش‌فرض، نگاشت‌های بازتعریف‌شده جایگزین موارد قبلی نمی‌شوند\&. با این حال، می‌توان در ابتدای هر نام فایل یک مشخص‌کننده حالت اختیاری (\fB+\fR، \fB\-\fR، یا \fB=\fR) قرار داد تا این رفتار تغییر کند: .PP +mapfile .RS 4 تنها آن دسته از مدخل‌های فایل نگاشت ارائه‌شده اعمال می‌شوند که یک نگاشت قلم را بازتعریف نکنند؛ یعنی قلم‌هایی که از قبل نگاشت شده‌اند دست‌نخورده باقی می‌مانند\&. این حالت همچنین در صورت تعیین نشدن هیچ مشخص‌کننده‌ای، حالت پیش‌فرض است\&. .RE .PP \-mapfile .RS 4 تضمین می‌کند که هیچ‌یک از نگاشت‌های قلم تعریف‌شده در فایل نگاشت داده‌شده استفاده نشوند؛ یعنی نگاشت‌های پیش‌تر تعریف‌شده برای قلم‌های مشخص‌شده حذف می‌شوند\&. .RE .PP =mapfile .RS 4 تمامی نگاشت‌های تعریف‌شده در فایل نگاشت اعمال می‌شوند\&. تنظیمات پیش‌تر تعریف‌شده برای همان قلم‌ها جایگزین می‌گردند\&. .sp اگر پیش از نخستین نام فایل در توالی نام‌ها یک مشخص‌کننده حالت قرار گیرد، dvisvgm نگاشت قلم پیش‌فرض را بارگذاری کرده (بالا را ببینید) و سپس سایر فایل‌های نگاشت را اعمال می‌نماید\&. در غیر این صورت، هیچ‌یک از فایل‌های نگاشت پیش‌فرض به‌طور خودکار بارگذاری نخواهند شد\&. .sp مثال‌ها: \fB\-\-fontmap=myfile1\&.map,+myfile2\&.map\fR فایل \fImyfile1\&.map\fR و به دنبال آن \fImyfile2\&.map\fR را بارگذاری می‌کند که در آن تمام بازتعریف‌های \fBmyfile2\&.map\fR نادیده گرفته می‌شوند\&. \fB\-\-fontmap==myfile1\&.map,\-myfile2\&.map\fR فایل نگاشت پیش‌فرض و به دنبال آن \fImyfile1\&.map\fR و \fImyfile2\&.map\fR را بارگذاری می‌کند که در آن تمام بازتعریف‌های \fImyfile1\&.map\fR جایگزین مدخل‌های پیشین می‌شوند\&. پس از آن، تمامی تعاریف قلم‌های مشخص‌شده در \fImyfile2\&.map\fR از درخت نگاشت قلم حذف می‌گردند\&. .sp برای کسب اطلاعات بیشتر پیرامون قالب‌های فایل نگاشت و مشخص‌کننده‌های حالت، کتابچه‌های راهنمای dvips (\m[blue]https://tug.org/texinfohtml/dvips.html\m[]) و dvipdfm (\m[blue]https://ctan.org/tex-archive/dviware/dvipdfm\m[]) را مشاهده کنید\&. .sp برنامه dvisvgm از هر دو قالب فایل نگاشت \fIdvips\fR و \fIdvipdfm\fR پشتیبانی می‌کند\&. این برنامه هر دو حالت را با دو دستور include گسترش می‌دهد که امکان بارگذاری سایر فایل‌های نگاشت را درون یک فایل نگاشت فراهم می‌سازند\&. نحو به صورت زیر است: .sp .if n \{\ .RS 4 .\} .nf #include [] #includefirst [] .fi .if n \{\ .RE .\} .sp آن‌ها باید در یک خط جداگانه قرار گیرند و از ستون اول آن خط آغاز شوند؛ در غیر این صورت، نادیده گرفته می‌شوند\&. در حالی که حالت اول همواره تلاش می‌کند فایل مشخص‌شده را بگنجاند، \fB#includefirst\fR تنها یک بار اجرا می‌شود؛ بدین معنی که به محض اینکه یک فایل با موفقیت توسط این دستور گنجانده شد، تمامی خطوط بعدی \fB#includefirst\fR نادیده گرفته می‌شوند\&. این سازوکار می‌تواند برای گنجاندن یکی از چندین فایل جایگزین به کار رود، به‌گونه‌ای که نخستین فایل یافت‌شده بارگذاری می‌شود و بقیه نادیده گرفته می‌شوند\&. .sp پارامتر اختیاری \fI\fR (که می‌تواند \fB+\fR، \fB\-\fR، یا \fB=\fR باشد) چگونگی ادغام داده‌های خوانده‌شده از فایل گنجانده‌شده را با داده‌های نگاشت موجود تعیین می‌کند\&. عملکرد آن‌ها همانند مشخص‌کننده‌های حالت شرح‌داده‌شده در بالا است\&. اگر پارامتر \fI\fR حذف شود، مقدار پیش‌فرض آن \fB+\fR خواهد بود\&. .sp نام فایل یا مسیر فایل در ادامه، فایل مورد نظر برای گنجاندن را مشخص می‌کند\&. در مورد نام‌های فایل ساده (بدون مشخص‌کننده‌های مسیر)، فایل‌ها با استفاده از قابلیت جستجوی فایل TeX پیدا می‌شوند؛ بدین معنی که فایل‌های موجود در ساختار درختی دایرکتوری TeX را می‌توان به‌آسانی اضافه کرد\&. مسیرهای نسبی نسبت به مکان فایل حاوی دستور \fB#include\fR محاسبه می‌شوند\&. مؤلفه‌های مسیر حتی در سیستم‌های Windows نیز باید با اسلش رو به جلو (\fB/\fR) از هم جدا شوند\&. .sp مثال‌ها: \fB#include pdftex\&.map\fR به دنبال \fIpdftex\&.map\fR در دایرکتوری کاری جاری و در ساختار درختی دایرکتوری TeX می‌گردد\&. از سوی دیگر، دستور \fB#include \&./pdftex\&.map\fR تنها در همان دایرکتوری که فایل دربرگیرنده در آن قرار دارد، به دنبال \fIpdftex\&.map\fR می‌گردد\&. .RE .RE.PP \fB\-\-grad\-overlap\fR .RS 4 به dvisvgm می‌گوید که هنگام تقریب‌زدن پر کردن گرادیان رنگی، بخش‌های شبکه‌ای هم‌پوشان ایجاد کند (همچنین گزینهٔ \fB\-\-grad\-segments\fR را در زیر ببینید)\&. به‌طور پیش‌فرض، بخش‌های مجاور هم‌پوشانی ندارند و تنها مانند کاشی‌های جداگانه مماس با یکدیگرند\&. با این حال، اگر رندرکنندهٔ SVG برای ایجاد خطوط مرزیِ صاف از anti\-aliasing استفاده کند، این چینش می‌تواند منجر به ایجاد شکاف‌های قابل مشاهده میان بخش‌ها شود، چرا که رنگ پس‌زمینه معمولاً روی رنگ مرز بخش‌ها تأثیر می‌گذارد\&. یک راه برای جلوگیری از این موضوع و ایجاد نواحی رنگی کاملاً پیوسته، بزرگ‌تر کردن بخش‌ها به گونه‌ای است که به درون ناحیهٔ همسایگان راست و پایین خود امتداد یابند\&. از آنجا که بخش‌های مجاور روی قسمت‌های هم‌پوشان رسم می‌شوند، اندازهٔ قابل مشاهدهٔ تمام بخش‌ها بدون تغییر باقی می‌ماند\&. تنها شکاف‌های قبلی ناپدید می‌شوند، چرا که پس‌زمینه اکنون کاملاً با رنگ‌های درست پوشانده شده است\&. در حال حاضر، dvisvgm بخش‌های هم‌پوشان را به‌طور جداگانه برای هر وصله (patch) از مش محاسبه می‌کند (یک patch mesh ممکن است شامل چندین وصله از یک نوع باشد)\&. بنابراین، ممکن است همچنان شکاف‌های قابل مشاهده‌ای در محل اتصال دو وصلهٔ مجاور وجود داشته باشد\&. .RE .PP \fB\-\-grad\-segments\fR=\fInumber\fR .RS 4 حداکثر تعداد بخش‌ها در هر ستون و سطر را که برای تقریب‌زدن پر کردن گرادیان رنگی استفاده می‌شود، مشخص می‌کند\&. از آنجا که SVG 1\&.1 تنها از زیرمجموعهٔ کوچکی از الگوریتم‌های سایه‌زنی (shading) موجود در PostScript پشتیبانی می‌کند، dvisvgm برخی از آن‌ها را با تقسیم ناحیهٔ مورد نظر به بخش‌های کوچک‌تر و تک‌رنگ (monochromatic) تقریب می‌زند\&. به هر یک از این بخش‌ها میانگین رنگ ناحیه‌ای که پوشش می‌دهد اختصاص می‌یابد\&. بنابراین، افزایش تعداد بخش‌ها منجر به ایجاد نواحی تک‌رنگ کوچک‌تر و در نتیجه تقریب بهتری از گرادیان رنگی واقعی می‌شود\&. با این حال، افزایش بخش‌ها عیب ایجاد فایل‌های SVG بزرگ‌تر را در پی دارد، زیرا هر بخش با یک عنصر path جداگانه نمایش داده می‌شود\&. .sp در حال حاضر، dvisvgm از مش‌های وصلهٔ مثلثی با فرم آزاد (free\-form) و شبکه‌ای (lattice\-form) و نیز مش‌های وصلهٔ Coons و tensor\-product پشتیبانی می‌کند\&. این موارد با تقسیم مساحت هر وصله به یک شبکهٔ \fIn\fR\(mu\fIn\fR از بخش‌های کوچک‌تر تقریب زده می‌شوند\&. حداکثر تعداد بخش‌ها در هر سطر و ستون را می‌توان با گزینهٔ \fB\-\-grad\-segments\fR تغییر داد\&. .RE .PP \fB\-\-grad\-simplify\fR=\fIdelta\fR .RS 4 اگر اندازهٔ بخش‌های ایجادشده برای تقریب گرادیان رنگی از مقدار دلتای مشخص‌شده کمتر شود، dvisvgm سطح جزئیات آن‌ها را کاهش می‌دهد\&. برای نمونه، منحنی‌های بزیه (B\('ezier) با خطوط مستقیم جایگزین می‌شوند و بخش‌های مثلثی به چهارضلعی‌ها تبدیل می‌گردند\&. برای یک \fIdelta\fR کوچک، این ساده‌سازی‌ها معمولاً قابل توجه نیستند اما اندازهٔ فایل‌های SVG تولیدشده را به‌طور چشمگیری کاهش می‌دهند\&. .RE .PP \fB\-h, \-\-help\fR[=\fImode\fR] .RS 4 خلاصه‌ای کوتاه از تمام گزینه‌های در دسترس خط فرمان را چاپ می‌کند\&. پارامتر اختیاری \fImode\fR یک مقدار عددی صحیح بین 0 و 2 است\&. این پارامتر نحوهٔ نمایش متن راهنما را مشخص می‌کند\&. حالت 0 همهٔ گزینه‌ها را به همراه سربرگ هر بخش، در دسته‌بندی‌های جداگانه فهرست می‌کند\&. این حالت همچنین رفتار پیش‌فرض در صورت فراخوانی dvisvgm بدون پارامتر است\&. حالت 1 همهٔ گزینه‌ها را بر پایهٔ نام‌های کوتاه مرتب می‌کند، در حالی که حالت 2 خطوط را بر اساس نام‌های بلند گزینه‌ها مرتب می‌سازد\&. .sp مقادیر داخل کروشه پس از متن توضیحات، پارامتر پیش‌فرض گزینه را نشان می‌دهند\&. این مقادیر در صورتی اعمال می‌شوند که گزینه‌ای با یک پارامتر اجباری استفاده نشود یا اگر یک پارامتر اختیاری حذف گردد\&. برای نمونه، گزینهٔ \fB\-\-bbox\fR به یک پارامتر اندازه نیاز دارد که در صورت استفاده نشدن از \fB\-\-bbox\fR مقدار پیش‌فرض آن \fBmin\fR است\&. گزینهٔ \fB\-\-zip\fR که به‌طور پیش‌فرض اعمال نمی‌شود، یک پارامتر اختیاری برای سطح فشرده‌سازی می‌پذیرد\&. در صورت حذف آن، مقدار پیش‌فرض ذکرشده یعنی 9 استفاده می‌شود\&. .RE .PP \fB\-\-keep\fR .RS 4 حذف فایل‌های موقت ایجادشده توسط Metafont (معمولاً فایل‌های \&.gf، \&.tfm و \&.log) یا ماژول TrueType/WOFF را غیرفعال می‌کند\&. .RE .PP \fB\-\-libgs\fR=\fIpath\fR .RS 4 این گزینه تنها زمانی در دسترس است که کتابخانهٔ Ghostscript به‌طور مستقیم به dvisvgm پیوند (link) داده نشده باشد و پشتیبانی از PostScript در طول کامپایل کاملاً غیرفعال نشده باشد\&. در این حالت، dvisvgm تلاش می‌کند کتابخانهٔ اشتراکی GS را به‌طور پویا در زمان اجرا بارگذاری کند\&. به‌طور پیش‌فرض، انتظار دارد نام کتابخانه \fBlibgs\&.so\&.X\fR (در سیستم‌های شبه‌یونیکس، که در آن \fBX\fR نسخهٔ ABI کتابخانه است) یا \fBgsdll32\&.dll\fR/\fBgsdll64\&.dll\fR (در Windows) باشد\&. اگر dvisvgm کتابخانه را پیدا نکند، می‌توان از گزینهٔ \fB\-\-libgs\fR برای تعیین مسیر و نام فایل صحیح استفاده کرد، برای مثال \fB\-\-libgs=/usr/local/lib/libgs\&.so\&.9\fR یا \fB\-\-libgs=\egs\egs9\&.25\ebin\egsdll64\&.dll\fR\&. .sp به عنوان جایگزین، همچنین می‌توان مسیر را به متغیر محیطی \fBLIBGS\fR اختصاص داد، مثلاً \fBexport LIBGS=/usr/local/lib/libgs\&.so\&.9\fR یا \fBset LIBGS=\egs\egs9\&.25\ebin\egsdll63\&.dll\fR\&. اولویت \fBLIBGS\fR از گزینهٔ خط فرمان کمتر است، یعنی اگر \fB\-\-libgs\fR داده شده باشد، dvisvgm متغیر \fBLIBGS\fR را نادیده می‌گیرد\&. .RE .PP \fB\-L, \-\-linkmark\fR=\fIstyle\fR .RS 4 روش نشانه‌گذاری نواحی دارای پیوند (hyperlink) را انتخاب می‌کند\&. آرگومان \fIstyle\fR می‌تواند یکی از مقادیر \fInone\fR، \fIbox\fR و \fIline\fR را بگیرد، که \fIbox\fR حالت پیش‌فرض است؛ یعنی در صورت حذف گزینهٔ \fB\-\-linkmark\fR، یک مستطیل دور ناحیهٔ پیوند داده‌شده رسم می‌شود\&. آرگومان سبک \fIline\fR تنها لبهٔ پایینی مستطیل محاطی را رسم می‌کند، و \fInone\fR به dvisvgm می‌گوید هیچ شیء مرئی‌ای به پیوندها اضافه نکند\&. خط‌ها و جعبه‌ها رنگ متن فعلی را به خود می‌گیرند\&. برای اعمال یک رنگ ثابت و متفاوت، می‌توان یک دونقطه به همراه شناسهٔ رنگ را به رشتهٔ سبک اضافه کرد\&. یک \fIشناسهٔ رنگ\fR یا یک مقدار هگزادسیمال RGB به شکل \fI#RRGGBB\fR است، یا یک نام رنگ dvips (\m[blue]https://en.wikibooks.org/wiki/LaTeX/Colors#The_68_standard_colors_known_to_dvips\m[])\&. .sp علاوه بر این، آرگومان \fIstyle\fR می‌تواند یک شناسهٔ رنگ منفرد را برای برجسته‌سازی ناحیهٔ پیوند داده‌شده با یک جعبهٔ بدون کادر پرشده با آن رنگ بپذیرد\&. یک شناسهٔ رنگ دوم اختیاری که با دونقطه جدا می‌شود، رنگ کادر را تعیین می‌کند\&. .sp مثال‌ها: \fBbox:red\fR یا \fBbox:#ff0000\fR جعبه‌های قرمزرنگی را دور نواحی پیوند داده‌شده رسم می‌کنند\&. \fByellow:blue\fR مستطیل‌های پرشده با رنگ زرد و با کادرهای آبی ایجاد می‌کند\&. .RE .PP \fB\-l, \-\-list\-specials\fR .RS 4 فهرستی از گرداننده‌های ویژه‌دستورِ (special handlers) ثبت‌شده را چاپ کرده و خارج می‌شود\&. هر گرداننده مجموعه‌ای از دستورهای ویژه متعلق به یک دسته‌بندی مشخص را پردازش می‌کند\&. در بیشتر موارد، این دسته‌بندی‌ها با پیشوند دستورهای ویژه مشخص می‌شوند که معمولاً یک رشته در ابتدا همراه با یک دونقطه یا فاصله است، مانند \fIcolor\fR یا \fIps\fR\&. با این حال، نام‌های فهرست‌شده برای گرداننده‌ها نیازی نیست که با این پیشوندها مطابقت داشته باشند؛ مثلاً در حالتی که پیشوند مشترکی وجود ندارد یا قابلیت‌ها به چند گردانندهٔ مجزا تقسیم شده‌اند تا بتوان آن‌ها را به‌طور جداگانه با استفاده از گزینهٔ \fB\-\-no\-specials\fR غیرفعال کرد\&. تمام دستورهای ویژه‌ای که توسط یکی از گرداننده‌ها پوشش داده نشوند، در سکوت نادیده گرفته می‌شوند\&. .RE .PP \fB\-M, \-\-mag\fR=\fIfactor\fR .RS 4 ضریب بزرگ‌نمایی اعمال‌شده همراه با فراخوانی‌های Metafont پیش از ردگیری (tracing) نشانه‌ها (glyphs) را تنظیم می‌کند\&. هر چه این مقدار بزرگ‌تر باشد، نتایج ردگیری بهتر خواهد بود\&. با این حال، مقادیر بزرگ‌نمایی زیاد می‌توانند به دلیل سرریز عددی، باعث خطاهای محاسباتی در Metafont شوند\&. بنابراین، از این گزینه با احتیاط استفاده کنید\&. تنظیمات پیش‌فرض معمولاً نتایج مطلوبی تولید می‌کند\&. .RE .PP \fB\-\-message\fR=\fItext\fR .RS 4 پس از نوشته شدن یک فایل SVG، پیام مشخص‌شده را در کنسول چاپ می‌کند\&. آرگومان \fItext\fR می‌تواند شامل متن ایستا و همچنین ماکروهای فهرست‌شده در بخش توضیحات دستور ویژهٔ \fBdvisvgm:raw\fR در زیر باشد\&. برای نمونه، \fB\-\-message="page {?pageno} written to {?svgfile}"\fR پس از تبدیل هر صفحه از یک فایل DVI یا PDF، یا پس از پردازش یک فایل EPS، این پیام را با ماکروهای بسط‌یافته چاپ می‌کند\&. .sp خروجی گزینهٔ \fB\-\-message\fR تحت تأثیر سطح پرگویی (verbosity level) مشخص‌شده قرار نمی‌گیرد، یعنی dvisvgm این متن را حتی با \fB\-\-verbosity=0\fR نیز چاپ می‌کند\&. .RE .PP \fB\-\-no\-merge\fR .RS 4 هر نویسه را در یک عنصر \fItext\fR مجزا به همراه ویژگی‌های متناظر \fIx\fR و \fIy\fR قرار می‌دهد\&. به‌طور پیش‌فرض، عناصر جدید \fItext\fR یا \fItspan\fR تنها زمانی ایجاد می‌شوند که یک رشته در مکانی شروع شود که با موقعیت معمول تعریف‌شده توسط مقادیر پیشروی (advance values) نویسه‌ها تفاوت داشته باشد\&. .RE .PP \fB\-\-no\-mktexmf\fR .RS 4 از تولید فایل‌های فونت ناموجود جلوگیری می‌کند\&. اگر dvisvgm نتواند از طریق سازوکار جستجوی kpathsea یک فایل فونت را بیابد، ابزارهای خارجی \fImktextfm\fR یا \fImktexmf\fR را فراخوانی می‌کند\&. این گزینه این فراخوانی‌ها را غیرفعال می‌سازد\&. .RE .PP \fB\-n, \-\-no\-fonts\fR[=\fIvariant\fR] .RS 4 اگر این گزینه مشخص شود، dvisvgm عناصر \fIfont\fR در SVG ایجاد نمی‌کند و در عوض از مسیرها ( \fIpaths\fR ) استفاده می‌کند\&. فایل‌های SVG حاصل معمولاً حجم بیشتری دارند، اما هم‌زمان با بیشتر برنامه‌هایی که از فونت‌های SVG پشتیبانی نمی‌کنند سازگارتر هستند\&. آرگومان اختیاری \fIvariant\fR روش جایگزینی فونت‌ها با مسیرها را انتخاب می‌کند\&. گونهٔ 0 برای جلوگیری از موارد تکراریِ طولانی، عناصر \fIpath\fR و \fIuse\fR ایجاد می‌کند\&. گونهٔ 1 تنها عناصر \fIpath\fR می‌سازد\&. گزینهٔ \fB\-\-no\-fonts\fR گزینهٔ \fB\-\-no\-styles\fR را نیز در بر دارد\&. .RE .PP \fB\-c, \-\-scale\fR=\fIsx\fR[,\fIsy\fR] .RS 4 محتوای صفحه را به‌صورت افقی با \fIsx\fR و به‌صورت عمودی با \fIsy\fR مقیاس‌بندی می‌کند\&. این گزینه معادل \fB\-TS\fR\fIsx\fR,\fIsy\fR است\&. .RE .PP \fB\-S, \-\-no\-specials\fR[=\fInames\fR] .RS 4 پردازش دستورهای ویژهٔ جاسازی‌شده در فایل DVI را غیرفعال می‌کند\&. اگر پارامتر دیگری داده نشود، تمام ویژه‌دستورها نادیده گرفته می‌شوند\&. برای غیرفعال کردن دسته‌ای مشخص از ویژه‌دستورها، می‌توان فهرستی اختیاری از نام‌ها که با کاما از هم جدا شده‌اند را به این گزینه اضافه کرد\&. یک \fIname\fR شناسهٔ یکتایی است که به گردانندهٔ ویژه‌دستور مورد نظر، همان‌گونه که توسط گزینهٔ \fB\-\-list\-specials\fR فهرست شده است، ارجاع می‌دهد\&. .RE .PP \fB\-\-no\-styles\fR .RS 4 به‌طور پیش‌فرض، dvisvgm برای ارجاع به فونت‌ها، سبک‌های CSS و ویژگی‌های class ایجاد می‌کند\&. این روش فشرده‌تر از اضافه کردن مکرر اطلاعات کامل فونت به تک‌تک عناصر متنی است\&. با این حال، اگر ارجاع مستقیم به فونت‌ها را ترجیح می‌دهید، رفتار پیش‌فرض را می‌توان با گزینهٔ \fB\-\-no\-styles\fR غیرفعال کرد\&. .RE.PP \fB\-O, \-\-optimize\fR[=\fImodules\fR] .RS 4 چندین بهینه‌سازی را روی درخت SVG تولیدشده اعمال می‌کند تا اندازه فایل کاهش یابد\&. این بهینه‌سازی‌ها با اجرای پودمان‌های بهینه‌ساز جداگانه‌ای که توسط آرگومان اختیاری \fImodules\fR مشخص می‌شوند، انجام می‌پذیرند\&. این آرگومان می‌تواند شامل نام یک پودمان منفرد یا فهرستی از چندین نام پودمان جداشده با کاما باشد\&. پودمان‌های مربوطه یکی پس از دیگری به ترتیبِ داده‌شده اجرا می‌شوند و بدین ترتیب درخت XML را به تدریج تبدیل می‌کنند\&. یک خط تیره در ابتدا (\fB\-\fR) می‌تواند برای مستثنی کردن یک پودمان از پردازش به کار رود\&. برای نمونه \fB\-Oall,\-collapse\-groups\fR تمام بهینه‌سازی‌ها را به جز \fBcollapse\-groups\fR انجام می‌دهد\&. اگر نام نخستین پودمان در فهرست با خط تیره آغاز شود، dvisvgm به صورت خودکار \fBall\fR را در ابتدا درج می‌کند؛ یعنی \fB\-O\-collapse\-groups\fR همانند \fB\-Oall,\-collapse\-groups\fR است\&. .sp فهرست زیر پودمان‌های بهینه‌ساز موجود در حال حاضر را شرح می‌دهد\&. .PP \fBlist\fR .RS 4 تمام پودمان‌های بهینه‌ساز موجود را فهرست کرده و خارج می‌شود\&. .RE .PP \fBnone\fR .RS 4 اگر این آرگومان داده شود، dvisvgm هیچ بهینه‌سازی‌ای اعمال نمی‌کند\&. \fBnone\fR نمی‌تواند با سایر نام‌های پودمان ترکیب شود\&. .RE .PP \fBall\fR .RS 4 تمام بهینه‌سازی‌های فهرست‌شده در زیر را انجام می‌دهد\&. این حالت همچنین پیش‌فرض است اگر گزینه \fB\-\-optimize\fR بدون هیچ آرگومانی استفاده شود\&. پودمان‌ها با ترتیبی از پیش تعریف‌شده اجرا می‌شوند که معمولاً به بهترین نتایج منجر می‌شود\&. \fBall\fR باید تنها ورودی یا نخستین ورودی در فهرست نام‌های پودمان باشد\&. .RE .PP \fBcollapse\-groups\fR .RS 4 عناصر گروه تودرتو (\fB\fR\&...\fB\fR) را که هر کدام تنها شامل یک صفت منفرد هستند، ادغام می‌کند\&. در صورت امکان، صفت‌های گروه به بیرونی‌ترین عنصر زیردرختِ پردازش‌شده منتقل می‌شوند\&. این پودمان همچنین عناصر گروهی را که اصلاً هیچ صفتی ندارند باز (unwrap) می‌کند\&. .RE .PP \fBgroup\-attributes\fR .RS 4 برای صفت‌های مشترک، گروه‌هایی (\fB\fR\&...\fB\fR) در اطراف عناصر مجاور ایجاد می‌کند\&. هر صفت به یک گروه جداگانه منتقل می‌شود تا صفت‌های مشترکِ چندگانه به گروه‌های تودرتو منجر شوند\&. این گروه‌ها را می‌توان پس از آن با اعمال پودمان بهینه‌ساز \fIcollapse\-groups\fR ادغام کرد\&. الگوریتم تنها ویژگی‌های ارث‌برنده، مانند \fBfill\fR یا \fBstroke\-width\fR را در نظر می‌گیرد و تنها در صورتی آنها را از یک عنصر حذف می‌کند که هیچ‌یک از صفت‌های دیگر، مانند \fBid\fR، مانع این کار نشوند\&. .RE .PP \fBreassign\-clippaths\fR .RS 4 تمام عناصر \fBclipPath\fR را که تنها در شناسه (ID) خود تفاوت دارند جمع‌آوری می‌کند\&. پس از آن، موارد تکراری حذف می‌شوند به‌گونه‌ای که تنها یکی باقی بماند\&. تمام صفت‌های \fBclip\-path\fR که به یکی از موارد تکراری ارجاع می‌دهند، مطابق با آن به‌روزرسانی می‌شوند\&. .RE .PP \fBremove\-clippaths\fR .RS 4 تمام عناصر زاید \fIclipPath\fR را حذف می‌کند\&. این بهینه‌سازی در نگارش‌های پیشین dvisvgm نیز وجود داشت و همواره به‌طور پیش‌فرض اعمال می‌شد\&. این رفتار حفظ شده است، یعنی dvisvgm این پودمان را حتی اگر گزینه \fB\-\-optimize\fR داده نشده باشد، اجرا می‌کند\&. می‌توانید از آرگومان \fInone\fR برای جلوگیری از آن استفاده کنید\&. .RE .PP \fBsimplify\-text\fR .RS 4 اگر یک عنصر \fBtext\fR تنها شامل گره‌های فاصله‌ساز و عناصر \fBtspan\fR باشد، تمام صفت‌های ارث‌برنده مشترکِ عناصر اخیر به عنصر متنی دربرگیرنده منتقل می‌شوند\&. تمام عناصر \fBtspan\fR بدون صفت‌های بیشتر، باز (unwrap) می‌شوند؛ یعنی برچسب‌های \fBtspan\fR حذف می‌گردند\&. .RE .PP \fBsimplify\-transform\fR .RS 4 تلاش می‌کند تمام صفت‌های \fItransform\fR را کوتاه کند\&. این پودمان دستورهای تبدیل هر صفت را ترکیب کرده و ماتریس تبدیل به‌دست‌آمده را به دنباله‌ای از تبدیلات پایه‌ای، یعنی انتقال (translation)، مقیاس‌گذاری (scaling)، چرخش (rotation) و اریب‌کردن (skewing) تجزیه می‌کند\&. اگر این دنباله کوتاه‌تر از عبارت معادل \fImatrix\fR باشد، به صفت اختصاص می‌یابد\&. در غیر این صورت، عبارت ماتریسی استفاده می‌شود\&. .RE .RE .PP \fB\-o, \-\-output\fR=\fIpattern\fR .RS 4 الگویی را تنظیم می‌کند که نام فایل‌های SVG تولیدشده را تعیین می‌نماید و می‌تواند به صورت اختیاری شامل مسیر فایل نیز باشد\&. پارامتر الزامی \fIpattern\fR می‌تواند شامل دنباله‌ای دلخواه از نویسه‌ها باشد که نام فایل‌ها یا مسیرهای فایل را به صورت نسبی نسبت به دایرکتوری کاری جاری تشکیل می‌دهند\&. به استثنای متغیرها و عبارات ذکرشده در زیر، تمام نویسه‌ها به عنوان بخش‌های ایستا از نام فایل‌ها/پوشه‌ها در نظر گرفته می‌شوند و بنابراین برای همه صفحاتی که طی یک اجرای dvisvgm پردازش می‌شوند یکسان هستند\&. رشته‌های \fB%f\fR، \fB%p\fR، \fB%P\fR، \fB%n\fR، \fB%N\fR، \fB%hd\fR، \fB%ho\fR و \fB%hc\fR متغیرهایی هستند که می‌توانند به عنوان بخشی از الگو استفاده شوند\&. \fB%f\fR به نام پایه فایل DVI، یعنی نام فایل بدون پسوند باز می‌شود؛ \fB%p\fR شماره صفحه جاری است و \fB%P\fR تعداد کل صفحات در فایل DVI است\&. متغیرهای \fB%n\fR و \fB%N\fR به ترتیب به شماره فایلی که در حال حاضر تبدیل می‌شود (با شروع از ۱) و تعداد کل فایل‌های داده‌شده باز می‌شوند\&. .sp یک عدد اختیاری (۰\-۹) که مستقیماً پس از علامت درصدِ یک متغیر عددی مشخص می‌شود، حداقل تعداد رقم‌های ایجادشده را نشان می‌دهد\&. اگر مقداری از ارقام کمتری تشکیل شده باشد، آن عدد با صفر در ابتدا پر می‌شود\&. مثال: \fB%3p\fR ۳ رقم را برای شماره صفحه جاری اجبار می‌کند (۰۰۱، ۰۰۲ و غیره)\&. بدون یک مشخص‌کننده صریح پهنا، \fB%p\fR به همان تعداد رقم‌های \fB%P\fR رقم دریافت می‌کند\&. .sp اگر به کنترل بیشتری روی شماره‌گذاری نیاز دارید، می‌توانید از عبارات حسابی به عنوان بخشی از الگو استفاده کنید\&. نحو آن به صورت \fB%(\fR\fIexpr\fR\fB)\fR است که در آن \fIexpr\fR می‌تواند شامل جمع، تفریق، ضرب و تقسیم اعداد صحیح با اولویت‌های عملگری متداول باشد\&. متغیرهای \fBp\fR و \fBP\fR به ترتیب شامل شماره صفحه جاری و تعداد کل صفحات هستند\&. برای نمونه، \fB\-\-output="%f\-%(p\-1)"\fR نام فایل‌هایی ایجاد می‌کند که شماره‌گذاری آن‌ها به جای ۱ از ۰ آغاز می‌شود\&. .sp متغیرهای \fB%hX\fR شامل مقادیر درهم‌سازی (هش) متفاوتی هستند که از داده‌های صفحه DVI و گزینه‌های ارائه‌شده در خط فرمان محاسبه شده‌اند\&. \fB%hd\fR و \fB%hc\fR تنها در صورتی مقداردهی می‌شوند که گزینه \fB\-\-page\-hashes\fR وجود داشته باشد\&. در غیر این صورت، خالی خواهند بود\&. برای اطلاعات بیشتر، توضیحات گزینه \fB\-\-page\-hashes\fR را در زیر ببینید\&. .sp الگوی پیش‌فرض \fB%f\-%p\&.svg\fR است اگر فایل DVI بیش از یک صفحه داشته باشد، و در غیر این صورت \fB%f\&.svg\fR است\&. بدین معنا که یک فایل DVI با نام \fIfoo\&.dvi\fR در صورتی که سندی تک‌صفحه‌ای باشد به \fIfoo\&.svg\fR تبدیل می‌شود\&. در غیر این صورت، چندین فایل SVG مانند \fIfoo\-01\&.svg\fR، \fIfoo\-02\&.svg\fR و غیره تولید می‌شوند\&. در محیط‌های Windows، علامت درصد نشان‌دهنده متغیرهای محیطی ارجاع‌زدایی‌شده است، و از این رو باید با یک علامت درصد دوم محافظت شود، برای مثال \fB\-\-output=%%f\-%%p\fR\&. .RE .PP \fB\-p, \-\-page\fR=\fIranges\fR .RS 4 این گزینه صفحاتی را که باید پردازش شوند انتخاب می‌کند\&. پارامتر \fIranges\fR شامل فهرستی جداشده با کاما از شماره صفحات منفرد و/یا بازه‌های صفحه است\&. یک بازه صفحه، جفتی از اعداد است که با خط تیره از هم جدا شده‌اند، مانند 5\-12\&. بنابراین، یک توالی صفحه ممکن است به این شکل باشد: 2\-4,6,9\-12,15\&. مهم نیست که یک صفحه بیش از یک بار مشخص شود یا بازه‌های صفحه هم‌پوشانی داشته باشند\&. dvisvgm همیشه شماره صفحات را به ترتیب صعودی استخراج می‌کند و آنها را فقط یک بار تبدیل می‌نماید\&. .sp به منظور حفظ سازگاری با نگارش‌های پیشین، توالی پیش‌فرض صفحات \fB1\fR است\&. از این رو، اگر گزینه \fB\-\-page\fR ذکر نشود، dvisvgm فقط صفحه نخست را تبدیل می‌کند و نه کل سند را\&. معمولاً، بازه‌های صفحه شامل دو عدد هستند که نخستین و آخرین صفحه برای تبدیل را مشخص می‌کنند\&. اگر تبدیل باید از صفحه ۱ آغاز شود، یا تا آخرین صفحه DVI ادامه یابد، عدد اول یا دوم بازه می‌تواند به ترتیب حذف شود\&. مثال: \fB\-\-page=\-10\fR تمام صفحات تا صفحه ۱۰ را تبدیل می‌کند، \fB\-\-page=10\-\fR تمام صفحات با شروع از صفحه ۱۰ را تبدیل می‌کند\&. لطفاً توجه داشته باشید که مقادیر صفحه به شماره صفحات چاپ‌شده روی صفحه مربوطه اشاره ندارند\&. در عوض، شمارش فیزیکی صفحات مد نظر است که در آن صفحه اول همواره شماره ۱ را دریافت می‌کند\&. .sp برای انتخاب آخرین صفحه، می‌توان از عبارت \fB%P\fR به جای شماره صفحه صریح استفاده کرد\&. این عبارت با شماره آخرین صفحه جایگزین می‌شود\&. برای نمونه، \fB\-\-page=1,%P\fR صفحه اول و آخر سند را تبدیل می‌کند\&. .sp افزون بر این، عبارات حسابی به صورت \fB%(\fR\fIexpr\fR\fB)\fR به جای اعداد نیز معتبر هستند\&. مقادیر حاصل همواره به نزدیک‌ترین عدد صحیح به سمت پایین گرد می‌شوند\&. برای اطلاعات بیشتر در مورد نحو و عملگرهای حسابی پشتیبانی‌شده، گزینه \fB\-\-output\fR را ببینید\&. مثال: \fB\-\-page=%(P\-2)\-\fR سه صفحه آخر را تبدیل می‌کند\&. .sp در انتهای توالی بازه، یک مشخص‌کننده پالایه اختیاری می‌تواند افزوده شود تا شماره صفحات خاصی را از توالی حذف کند\&. در حال حاضر، دو پالایه \fB:even\fR و \fB:odd\fR پشتیبانی می‌شوند که مقادیر پیشین را به ترتیب به اعداد زوج و فرد محدود می‌کنند\&. برای نمونه، \fB\-\-page=1\-11,20:even\fR معادل \fB\-\-page=2,4,6,8,10,20\fR است\&. .RE.PP \fB\-H, \-\-page\-hashes\fR[=\fIparams\fR] .RS 4 اگر این گزینه داده شود، dvisvgm مقادیر درهم‌سازی (هش) تمام صفحاتی را که باید پردازش شوند محاسبه می‌کند\&. تا زمانی که محتوای صفحه تغییر نکند، مقدار هش آن صفحه ثابت می‌ماند\&. از این ویژگی می‌توان برای تعیین این‌که آیا یک صفحه DVI باید دوباره تبدیل شود یا می‌توان در اجراهای متوالی dvisvgm از آن صرف‌نظر کرد، استفاده نمود\&. این کار با انتقال مقدار هش به متغیر \fB%hd\fR انجام می‌شود که در الگوی خروجی قابل دسترسی است (گزینه \fB\-\-output\fR را ببینید)\&. به‌طور پیش‌فرض، در صورت داده شدن گزینه \fB\-\-page\-hashes\fR، برنامه dvisvgm الگوی خروجی را به \fB%f\-%hd\fR تغییر می‌دهد\&. در نتیجه، تمام نام‌های فایل SVG به جای شماره صفحه، حاوی مقدار هش خواهند بود\&. هنگام فراخوانی مجدد dvisvgm با گزینه \fB\-\-page\-hashes\fR و همان الگوی خروجی، این برنامه وجود فایل SVG را که قرار است ایجاد شود بررسی می‌کند و در صورت موجود بودن، از تبدیل آن صرف‌نظر می‌نماید\&. این مورد همچنین برای فراخوانی‌های متوالی dvisvgm با پارامترهای خط فرمان مختلف نیز صدق می‌کند\&. اگر می‌خواهید تبدیل مجدد یک فایل DVI را که تغییر نکرده است تحمیل کنید، باید فایل‌های SVG مربوطه را از قبل حذف کنید یا پارامتر \fBreplace\fR را اضافه نمایید (پایین را ببینید)\&. اگر الگوی خروجی را دستی طوری تنظیم کنید که حاوی مقدار هش نباشد، از تبدیل صرف‌نظر نخواهد شد\&. .sp به‌عنوان جایگزین، الگوی خروجی می‌تواند حاوی متغیرهای \fB%ho\fR و \fB%hc\fR باشد\&. \fB%ho\fR به یک هش ۳۲ بیتی گسترش می‌یابد که نشان‌دهنده گزینه‌های خط فرمان داده‌شده‌ای است که بر خروجی SVG تولیدشده تأثیر می‌گذارند، مانند \fB\-\-no\-fonts\fR و \fB\-\-precision\fR\&. ترکیب‌های متفاوتی از گزینه‌ها و پارامترها منجر به هش‌های متفاوتی می‌شوند\&. بدین ترتیب الگوی \fB%f\-%hd\-%ho\fR نام‌فایل‌هایی ایجاد می‌کند که بسته به داده‌های DVI و گزینه‌های خط فرمان ارائه‌شده تغییر می‌کنند\&. متغیر \fB%hc\fR یک هش ترکیبی را ارائه می‌دهد که از داده‌های DVI و گزینه‌های خط فرمان محاسبه شده است\&. طول آن با \fB%hd\fR یکسان است\&. .sp از آنجا که شماره صفحه به‌طور پیش‌فرض بخشی از نام فایل نیست، صفحات مختلف DVI با محتوای یکسان، نام فایل یکسانی دریافت می‌کنند\&. از این رو، تنها صفحه نخست تبدیل شده و از بقیه صرف‌نظر می‌شود\&. برای ایجاد فایل‌های جداگانه برای هر صفحه، می‌توانید شماره صفحه را به الگوی خروجی اضافه کنید، مانند \fB\-\-output="%f\-%p\-%hc"\fR\&. .sp به‌طور پیش‌فرض، dvisvgm از الگوریتم هش سریع XXH64 برای محاسبه مقادیر ارائه‌شده از طریق \fB%hd\fR و \fB%hc\fR استفاده می‌کند\&. هش‌های ۶۴ بیتی باید برای اکثر اسناد با تعداد میانگین صفحات کافی باشند\&. به‌علاوه، می‌توان از XXH32 و MD5 نیز استفاده کرد\&. الگوریتم مورد نظر توسط آرگومان \fIparams\fR از گزینه \fB\-\-page\-hashes\fR مشخص می‌شود\&. این آرگومان یکی از رشته‌های \fBMD5\fR، \fBXXH32\fR و \fBXXH64\fR را می‌پذیرد، که نام‌ها می‌توانند با حروف کوچک نیز داده شوند، مانند \fB\-\-page\-hashes=md5\fR\&. از نسخه 0\&.7\&.1، xxHash یک تابع هش ۱۲۸ بیتی آزمایشی ارائه می‌دهد که الگوریتم آن از نسخه 0\&.8 پایدار شده است\&. هنگام استفاده از نسخه‌های قبل از 0\&.8، مقادیر هش ۱۲۸ بیتی ممکن است بسته به نسخه xxHash استفاده‌شده تفاوت داشته باشند\&. در صورت در دسترس بودن API مربوطه، dvisvgm از تابع هش جدید پشتیبانی می‌کند و گزینه \fB\-\-page\-hashes\fR علاوه بر این مشخص‌کننده الگوریتم \fBXXH128\fR را می‌پذیرد\&. .sp در نهایت، گزینه \fB\-\-page\-hashes\fR می‌تواند آرگومان دومی را بپذیرد که باید با یک کاما جدا شود\&. در حال حاضر، تنها دو پارامتر \fIlist\fR و \fIreplace\fR ارزیابی می‌شوند، مانند \fB\-\-page\-hashes=md5,list\fR یا \fB\-\-page\-hashes=replace\fR\&. هنگامی که \fIlist\fR حضور دارد، dvisvgm هیچ تبدیلی انجام نمی‌دهد بلکه صرفاً مقادیر هش \fB%hd\fR و \fB%hc\fR صفحاتی را که با گزینه \fB\-\-page\fR مشخص شده‌اند، فهرست می‌کند\&. پارامتر \fIreplace\fR برنامه dvisvgm را وادار می‌کند تا یک صفحه DVI را حتی در صورتی که فایلی با نام مقصد از قبل موجود باشد، تبدیل کند\&. .RE .PP \fB\-P, \-\-pdf\fR .RS 4 اگر این گزینه داده شود، dvisvgm به جای DVI انتظار یک فایل ورودی PDF را دارد و تلاش می‌کند آن را به SVG تبدیل کند\&. مشابه تبدیل فایل‌های DVI، به‌طور پیش‌فرض تنها صفحه نخست پردازش می‌شود\&. گزینه \fB\-\-page\fR می‌تواند برای انتخاب صفحات مختلف، محدوده‌های صفحه و/یا توالی‌های صفحه استفاده شود\&. .sp اگر نسخه‌ای از Ghostscript کمتر از 10\&.01\&.0 یافت شود، dvisvgm از Ghostscript برای پردازش فایل PDF استفاده می‌کند\&. در این حالت، تبدیل با ایجاد یک دستور ویژه (special) منفرد \fIpdffile\fR تحقق می‌یابد که به گرداننده ویژه PostScript در dvisvgm فرستاده می‌شود\&. بنابراین، این گزینه تنها در صورتی در دسترس است که dvisvgm با پشتیبانی فعال از PostScript ساخته شده باشد، و نیازمند در دسترس بودن Ghostscript است\&. برای اطلاعات بیشتر گزینه \fB\-\-libgs\fR را ببینید\&. .sp از نسخه 10\&.01\&.0 برنامه Ghostscript به بعد، به دلیل معرفی یک مفسر جدید PDF، این روش دیگر کار نخواهد کرد\&. از این رو، یک ماژول تبدیل جایگزین بر پایه \fImutool\fR، ابزاری که بخشی از بسته MuPDF (\m[blue]https://mupdf.com\m[]) است، معرفی شده است\&. این ماژول به‌طور خودکار فراخوانی می‌شود در صورتی که نتوان از Ghostscript استفاده کرد و یک فایل اجرایی فعال \fBmutool\fR در دایرکتوری‌ای که بخشی از مسیر جستجوی سیستم است، موجود باشد\&. .sp به‌عنوان جایگزین، می‌توان از متغیر محیطی \fBDVISVGM_PDF_PROC\fR برای انتخاب پردازنده PDF استفاده کرد\&. مقادیر پشتیبانی‌شده فعلی \fBgs\fR و \fBmutool\fR هستند\&. .RE .PP \fB\-d, \-\-precision\fR=\fIdigits\fR .RS 4 حداکثر تعداد ارقام اعشار اعمال‌شده بر مقادیر مشخصه‌های ممیز شناور را تعیین می‌کند\&. تمام مقادیر مشخصه‌های نوشته‌شده در فایل(های) SVG تولیدشده بر همین اساس گرد می‌شوند\&. پارامتر \fIdigits\fR مقادیر صحیح از 0 تا 6 را می‌پذیرد، که در آن 0 انتخاب خودکار ارقام اعشار بااهمیت را فعال می‌کند\&. این همچنین مقدار پیش‌فرض در صورت فراخوانی dvisvgm بدون گزینه \fB\-\-precision\fR است\&. .RE .PP \fB\-\-progress\fR[=\fIdelay\fR] .RS 4 یک نشانگر پیشرفت ساده را فعال می‌کند که هنگام پردازش عملیات زمان‌بر مانند دستورات ویژه PostScript نمایش داده می‌شود\&. این نشانگر پیش از سپری شدن تاخیر داده‌شده (به ثانیه) ظاهر نمی‌شود\&. مقدار تاخیر پیش‌فرض 0\&.5 ثانیه است\&. .RE .PP \fB\-r, \-\-rotate\fR=\fIangle\fR .RS 4 محتوای صفحه را به اندازه \fIangle\fR درجه در جهت عقربه‌های ساعت به دور مرکز صفحه می‌چرخاند\&. این گزینه معادل \fB\-TR\fR\fIangle\fR است\&. .RE .PP \fB\-R, \-\-relative\fR .RS 4 فرمت SVG به شما امکان می‌دهد تا مسیرهای گرافیکی را با توالی‌ای از دستورات مسیر مطلق و/یا نسبی تعریف کنید، یعنی هر دستور یا مختصات مطلق و یا مختصات نسبی به موقعیت رسم فعلی را انتظار دارد\&. به‌طور پیش‌فرض، dvisvgm مسیرهای متشکل از دستورات مطلق ایجاد می‌کند\&. اگر گزینه \fB\-\-relative\fR داده شود، به جای آن دستورات نسبی ایجاد می‌شوند\&. این کار در اکثر موارد اندازه فایل‌های SVG را اندکی کاهش می‌دهد\&. .RE .PP \fB\-\-stdin\fR .RS 4 به dvisvgm دستور می‌دهد تا داده‌های ورودی DVI یا EPS را به جای فایل از \fBstdin\fR بخواند\&. به‌عنوان جایگزینی برای گزینه \fB\-\-stdin\fR، یک خط تیره منفرد (\-) می‌تواند داده شود\&. نام پیش‌فرض فایل SVG تولیدشده \fIstdin\&.svg\fR است که می‌تواند با گزینه \fB\-\-output\fR تغییر یابد\&. .RE .PP \fB\-s, \-\-stdout\fR .RS 4 خروجی SVG را در یک فایل نمی‌نویسد، بلکه آن را به \fBstdout\fR هدایت می‌کند\&. .RE .PP \fB\-\-tmpdir\fR[=\fIpath\fR] .RS 4 در برخی موارد، dvisvgm برای عملکرد صحیح نیاز به ایجاد فایل‌های موقت دارد\&. این فایل‌ها به‌طور پیش‌فرض به پوشه موقت سیستم، مانند \fB/tmp\fR در سیستم‌های لینوکس، می‌روند\&. گزینه \fB\-\-tmpdir\fR می‌تواند برای تعیین مکانی متفاوت استفاده شود\&. لطفاً توجه داشته باشید که dvisvgm در صورت عدم وجود این پوشه، آن را ایجاد نمی‌کند\&. بنابراین، باید پیش از اجرای dvisvgm اطمینان حاصل کنید که این پوشه واقعاً وجود دارد\&. .sp به منظور جلوگیری از تداخل فایل‌های ناشی از فراخوانی‌های موازی dvisvgm، این برنامه فایل‌ها را مستقیماً در دایرکتوری مشخص‌شده نمی‌نویسد، بلکه علاوه بر آن زیرپوشه‌ای با نام یکتا در آنجا ایجاد می‌کند که فایل‌های موقت در آن قرار خواهند گرفت\&. این رفتار را می‌توان با الحاق \fB//\fR یا \fB\e\e\fR (در ویندوز) به انتهای نام دایرکتوری مشخص‌شده لغو کرد\&. برای مثال، \fB\-\-tmpdir=\&.//\fR فایل‌های موقت را مستقیماً در دایرکتوری کاری فعلی ایجاد می‌کند، در حالی که \fB\-\-tmpdir=\&.\fR آن‌ها را در یک زیرپوشه اختصاصی از دایرکتوری کاری فعلی قرار می‌دهد\&. .sp اگر پارامتر اختیاری \fIpath\fR از گزینه \fB\-\-tmpdir\fR حذف شود، dvisvgm مکان پوشه موقت سیستم را چاپ کرده و خارج می‌شود\&. .RE .PP \fB\-a, \-\-trace\-all\fR=[\fIretrace\fR] .RS 4 این گزینه dvisvgm را وادار می‌کند تا نه تنها گلیف‌هایی را که واقعاً برای رندر صحیح فایل SVG مورد نیاز هستند \(en که حالت پیش‌فرض است \(en برداری کند، بلکه تمام گلیف‌های تمام قلم‌های ارجاع داده‌شده در فایل DVI را پردازش نماید\&. از آنجا که dvisvgm نتایج ردیابی برداری را در حافظه موقت (کَش) قلم ذخیره می‌کند، تمام تبدیل‌های بعدی این قلم‌ها به میزان چشمگیری تسریع خواهند شد\&. گزینه بولی \fIretrace\fR تعیین می‌کند با گلیف‌هایی که قبلاً در کَش ذخیره شده‌اند چگونه رفتار شود\&. به‌طور پیش‌فرض، از این گلیف‌ها صرف‌نظر می‌شود\&. تنظیم آرگومان \fIretrace\fR روی \fIyes\fR یا \fItrue\fR برنامه dvisvgm را وادار می‌کند تا دوباره بیت‌مپ‌های مربوطه را ردیابی برداری کند\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBنکته\fR .ps -1 .br این گزینه تنها زمانی تأثیر دارد که کَش قلم فعال باشد\&. بنابراین، \fB\-\-trace\-all\fR نمی‌تواند با گزینه \fB\-\-cache=none\fR ترکیب شود\&. .sp .5v .RE .RE .PP \fB\-T, \-\-transform\fR=\fIcommands\fR .RS 4 توالی‌ای از تبدیل‌های هندسی را بر محتوای SVG اعمال می‌کند\&. هر تبدیل توسط یک \fIcommand\fR که با یک حرف بزرگ آغاز می‌شود و پس از آن فهرستی از پارامترهای جداشده با کاما می‌آید، توصیف می‌شود\&. دستورات تبدیل زیر پشتیبانی می‌شوند:.PP \fBT\fR \fItx\fR[,\fIty\fR] .RS 4 صفحه را در جهت بردار (\fItx\fR,\fIty\fR) انتقال می‌دهد (جابه‌جا می‌کند)\&. اگر \fIty\fR حذف شود، \fIty\fR=0 فرض می‌شود\&. واحد طول مورد انتظار برای \fItx\fR و \fIty\fR پوینت‌های TeX است (1pt = 1/72\&.27in)\&. با این حال، چندین ثابت برای ساده‌سازی تبدیل واحدها تعریف شده است (پایین را ببینید)\&. .RE .PP \fBS\fR \fIsx\fR[,\fIsy\fR] .RS 4 صفحه را به‌صورت افقی به اندازهٔ \fIsx\fR و به‌صورت عمودی به اندازهٔ \fIsy\fR مقیاس‌بندی می‌کند\&. اگر \fIsy\fR حذف شود، \fIsy\fR=\fIsx\fR فرض می‌شود\&. .RE .PP \fBR\fR \fIangle\fR[,\fIx\fR,\fIy\fR] .RS 4 صفحه را در جهت عقربه‌های ساعت به اندازهٔ \fIangle\fR درجه حول نقطهٔ (\fIx\fR,\fIy\fR) می‌چرخاند\&. اگر آرگومان‌های اختیاری \fIx\fR و \fIy\fR حذف شوند، صفحه بسته به قالب صفحهٔ انتخاب‌شده حول مرکز خود چرخانده می‌شود\&. هنگامی که گزینهٔ \fB\-bnone\fR داده شود، مرکز چرخش مبدا مختصات (0,0) است\&. .RE .PP \fBKX\fR \fIangle\fR .RS 4 صفحه را در امتداد محور \fIx\fR به اندازهٔ \fIangle\fR درجه کج (مورب) می‌کند\&. آرگومان \fIangle\fR می‌تواند هر مقداری به‌جز 90+180\fIk\fR داشته باشد، که در آن \fIk\fR یک عدد صحیح است\&. .RE .PP \fBKY\fR \fIangle\fR .RS 4 صفحه را در امتداد محور \fIy\fR به اندازهٔ \fIangle\fR درجه کج (مورب) می‌کند\&. آرگومان \fIangle\fR می‌تواند هر مقداری به‌جز 90+180\fIk\fR داشته باشد، که در آن \fIk\fR یک عدد صحیح است\&. .RE .PP \fBFH\fR [\fIy\fR] .RS 4 صفحه را نسبت به خط افقی گذرنده از نقطهٔ (0,\fIy\fR) بازتاب (آینه) می‌کند\&. حذف آرگومان اختیاری منجر به \fIy\fR=\fIh\fR/2 می‌شود، که در آن \fIh\fR نشان‌دهندهٔ ارتفاع صفحه است (بخش \fIثابت‌های از پیش تعریف‌شده\fR در زیر را ببینید)\&. .RE .PP \fBFV\fR [\fIx\fR] .RS 4 صفحه را نسبت به خط عمودی گذرنده از نقطهٔ (\fIx\fR,0) بازتاب (آینه) می‌کند\&. حذف آرگومان اختیاری منجر به \fIx\fR=\fIw\fR/2 می‌شود، که در آن \fIw\fR نشان‌دهندهٔ عرض صفحه است (بخش \fIثابت‌های از پیش تعریف‌شده\fR در زیر را ببینید)\&. .RE .PP \fBM\fR \fIm1\fR,\&...,\fIm6\fR .RS 4 تبدیلی را که توسط ماتریس 3\(mu3 به‌صورت ((\fIm1\fR,\fIm2\fR,\fIm3\fR),(\fIm4\fR,\fIm5\fR,\fIm6\fR),(0,0,1)) توصیف شده است اعمال می‌کند، که در آن سه‌تایی‌های درونی بیانگر سطرها هستند\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBنکته\fR .ps -1 .br تمام دستورات تبدیل گزینهٔ \fB\-T, \-\-transform\fR به ترتیبی که نوشته شده‌اند اعمال می‌شوند\&. دستورات چندگانه را می‌توان اختیاری با فاصله از هم جدا کرد\&. در این حالت کل رشتهٔ تبدیل باید درون نقل‌قول دوتایی (double quotes) قرار گیرد تا یکپارچه بماند\&. همهٔ پارامترها عبارت‌هایی از نوع ممیز شناور هستند\&. می‌توانید اعداد ساده یا عبارت‌های حسابی ترکیب‌شده با عملگرهای \fB+\fR (جمع)، \fB\-\fR (تفریق)، \fB*\fR (ضرب)، \fB/\fR (تقسیم) یا \fB%\fR (باقی‌مانده) را با قواعد معمول تقدم و شرکت‌پذیری ارائه دهید\&. پرانتزها نیز قابل استفاده هستند\&. .sp علاوه بر این، برخی از ثابت‌های از پیش تعریف‌شده فراهم شده‌اند: .TS tab(:); lt ltx lt ltx lt ltx lt ltx. T{ \fBux\fR T}:T{ موقعیت افقی گوشهٔ بالا-چپ صفحه در واحد پوینت TeX T} T{ \fBuy\fR T}:T{ موقعیت عمودی گوشهٔ بالا-چپ صفحه در واحد پوینت TeX T} T{ \fBh\fR T}:T{ ارتفاع صفحه در واحد پوینت TeX (مقدار 0 در صورت استفاده از \fB\-bnone\fR) T} T{ \fBw\fR T}:T{ عرض صفحه در واحد پوینت TeX (مقدار 0 در صورت استفاده از \fB\-bnone\fR) T} .TE .sp 1 افزون بر این، می‌توانید از ۹ ثابت طول \fBpt\fR، \fBbp\fR، \fBcm\fR، \fBmm\fR، \fBin\fR، \fBpc\fR، \fBdd\fR، \fBcc\fR و \fBsp\fR استفاده کنید، مانند \fB2cm\fR یا \fB1\&.6in\fR\&. بنابراین، گزینهٔ \fB\-TT1in,0R45\fR محتوای صفحه را ۱ اینچ به راست جابه‌جا کرده و پس از آن ۴۵ درجه حول مرکز صفحه می‌چرخاند\&. .sp برای تبدیلات منفرد، گزینه‌های کوتاه‌نویسی \fB\-c\fR، \fB\-t\fR و \fB\-r\fR نیز در دسترس هستند\&. برخلاف دستورات \fB\-\-transform\fR، ترتیب این گزینه‌ها اهمیتی ندارد، به همین دلیل نمی‌توان توالی‌های تبدیل را با آن‌ها مشخص کرد\&. .sp .5v .RE .RE .RE .PP \fB\-t, \-\-translate\fR=\fItx\fR[,\fIty\fR] .RS 4 محتوای صفحه را در جهت بردار (\fItx\fR,\fIty\fR) جابه‌جا (انتقال) می‌دهد\&. این گزینه معادل \fB\-TT\fR\fItx\fR,\fIty\fR است\&. .RE .PP \fB\-v, \-\-verbosity\fR=\fIlevel\fR .RS 4 نوع پیام‌های چاپ‌شده در حین اجرای dvisvgm را کنترل می‌کند: .TS tab(:); lt ltx lt ltx lt ltx lt ltx lt ltx. T{ \fB0\fR T}:T{ هیچ پیامی در خروجی چاپ نمی‌شود T} T{ \fB1\fR T}:T{ فقط پیام‌های خطا T} T{ \fB2\fR T}:T{ فقط پیام‌های هشدار T} T{ \fB4\fR T}:T{ فقط پیام‌های اطلاع‌رسانی T} T{ \fB8\fR T}:T{ فقط پیام‌های کاربر (مثلاً ایجادشده توسط دستور ویژهٔ \fBdvisvgm:message\fR) T} .TE .sp 1 .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBنکته\fR .ps -1 .br با جمع کردن این مقادیر می‌توانید دسته‌بندی‌ها را با هم ترکیب کنید\&. سطح پیش‌فرض ۱۵ است، یعنی تمام پیام‌ها چاپ می‌شوند\&. .sp .5v .RE .RE.PP \fB\-V, \-\-version\fR[=\fIextended\fR] .RS 4 نسخه dvisvgm را چاپ کرده و خارج می‌شود\&. اگر آرگومان اختیاری روی \fIyes\fR تنظیم شده باشد، شماره نسخه کتابخانه‌های پیوند‌یافته نیز چاپ می‌شود\&. .RE .PP \fB\-z, \-\-zip\fR[=\fIlevel\fR] .RS 4 یک فایل SVG فشرده با پسوند \&.svgz ایجاد می‌کند\&. آرگومان اختیاری سطح فشرده‌سازی را مشخص می‌کند\&. مقادیر معتبر در محدوده ۱ تا ۹ هستند (مقدار پیش‌فرض ۹ است)\&. مقادیر بزرگ‌تر باعث فشرده‌سازی بهتری می‌شوند اما ممکن است زمان پردازش کمی بیشتری نیاز داشته باشند\&. .RE .PP \fB\-Z, \-\-zoom\fR=\fIfactor\fR .RS 4 مقادیر مشخصه‌های \fIwidth\fR و \fIheight\fR عنصر ریشه SVG را در آرگومان \fIfactor\fR ضرب می‌کند در حالی که دستگاه مختصات محتوای گرافیکی حفظ می‌شود\&. در نتیجه، بیشتر نمایشگرهای SVG گرافیک را متناسب با آن بزرگ‌نمایی یا کوچک‌نمایی می‌کنند\&. اگر یک ضریب منفی داده شود، مشخصه‌های \fIwidth\fR و \fIheight\fR حذف می‌شوند\&. .RE .SH "دستورهای ویژه پشتیبانی‌شده (SUPPORTED SPECIALS)" .sp نرم‌افزار dvisvgm از چندین \fIspecial command\fR (دستور ویژه) پشتیبانی می‌کند که مجموعه دستورهای DVI را با دستورالعمل‌های اضافی برای ویژگی‌هایی چون رنگ، گرافیک و پیوندها غنی می‌سازد\&. اصطلاح \fIspecial command\fR، یا صرفاً \fIspecial\fR، از دستور \fB\especial{\&...}\fR در TeX سرچشمه می‌گیرد که تقریباً هیچ کاری انجام نمی‌دهد\&. نرم‌افزار TeX فقط آرگومان این دستور را با استفاده از آپ‌کد متناظر \fIxxx\fR به فایل DVI منتقل می‌کند، و بدین ترتیب اجرای آن را به درایور DVI واگذار می‌نماید\&. درایور سپس می‌تواند بسته به عبارت‌های پشتیبانی‌شده، تصمیم به پردازش یا نادیده گرفتن آن بگیرد\&. پارامتر دستور \fB\especial\fR در TeX درون آکولاد قرار می‌گیرد و می‌تواند شامل یک دنباله نویسه دلخواه باشد که دستورالعمل واقعی را نشان می‌دهد، برای مثال \fBcolor Red\fR\&. .sp شایان ذکر است که دستورهای ویژه تنها هنگام پردازش فایل‌های DVI ارزیابی می‌شوند\&. فرمت‌های PS/EPS و PDF چیزی از مفهوم دستورهای ویژه نمی‌دانند و بنابراین سازوکاری برای نمایش آن‌ها ارائه نمی‌دهند\&. .sp به منظور ارزیابی دستورهای ویژه، dvisvgm چندین گرداننده (handler) اختصاصی را پیاده‌سازی می‌کند\&. هر گرداننده مسئول تمامی عبارت‌های ویژه متعلق به یک مجموعه دستور یکسان است؛ یعنی دستورهایی که معمولاً \(en اما نه لزوماً \(en با یک پیشوند مشترک آغاز می‌شوند\&. برای نمونه، تمام دستورهای ویژه PDF با پیشوند \fBpdf:\fR آغاز می‌شوند، در حالی که مجموعه دستورهای ویژه TPIC شامل ۱۳ دستور مختلف بدون شناسه مشترک است\&. دستورهای ویژه PDF توسط گرداننده \fIpdf\fR در dvisvgm پردازش می‌شوند و دستورهای TPIC توسط گرداننده \fItpic\fR\&. برای دریافت فهرستی از گرداننده‌های ویژه ارائه‌شده، از گزینه \fB\-\-list\-specials\fR استفاده کنید (به بالا مراجعه شود)\&. فهرست زیر نمای کلی از مجموعه‌های ویژه در حال حاضر پشتیبانی‌شده را ارائه می‌دهد\&. از نام گرداننده‌ها همچنین می‌توان برای غیرفعال کردن پردازش مجموعه‌های خاصی از دستورهای ویژه استفاده کرد\&. برای اطلاعات بیشتر در این مورد، گزینه \fB\-\-no\-specials\fR را ببینید\&. .PP \fBbgcolor\fR .RS 4 عبارت‌های ویژه برای تغییر رنگ پس‌زمینه/صفحه\&. در حال حاضر، dvisvgm تنها از عبارت \fBbackground\fR همان‌گونه که در راهنمای dvips مشخص شده است (\m[blue]https://tug.org/texinfohtml/dvips.html#Color-specifications\m[]) پشتیبانی می‌کند\&. از آنجا که SVG 1\&.1 از رنگ‌های پس‌زمینه پشتیبانی نمی‌کند، dvisvgm مستطیلی با رنگ انتخاب‌شده را درون سند SVG تولیدشده قرار می‌دهد\&. این مستطیل همواره هم‌اندازه جعبه محصورکننده (bounding box) انتخاب‌شده یا محاسبه‌شده خواهد بود\&. این دستور رنگ پس‌زمینه بخشی از مجموعه ویژه رنگ است اما به طور جداگانه مدیریت می‌شود تا کاربر بتواند آن را خاموش کند\&. .RE .PP \fBcolor\fR .RS 4 عبارت‌های این مجموعه دستورالعمل‌هایی برای تغییر رنگ متن/نقاشی ارائه می‌دهند\&. برای مرور ساختار دقیق، برای مثال به مستندات dvips مراجعه کنید\&. .sp نرم‌افزار dvisvgm نحو رنگ‌های ویژه dvips را با دو اصلاح‌کننده اختیاری گسترش می‌دهد تا امکان تفکیک بین رنگ‌های پرکردن (fill) و خط دور (stroke) را فراهم سازد، یعنی رنگ‌هایی که به ترتیب برای پر کردن نواحی محصور و رسم خطوط استفاده می‌شوند\&. اگر قبل از یکی از مشخص‌کننده‌های رنگ، مانند نام رنگ یا مدل رنگی که پس از آن دنباله‌ای از مؤلفه‌های رنگ می‌آید، \fBfill\fR یا \fBstroke\fR قرار گیرد، تنها رنگ متناظر تغییر می‌یابد\&. بدون این اصلاح‌کننده‌ها هر دو رنگ تغییر می‌کنند\&. مثال: \fBcolor push fill rgb 1 0 1\fR یک جفت رنگ جدید را در پشته رنگ قرار می‌دهد که در آن رنگ پرکردن روی magenta تنظیم شده و رنگ خط دور مقدار فعلی خود را حفظ می‌کند\&. \fBcolor push rgb 1 0 1\fR یک جفت رنگ را در پشته قرار می‌دهد که هر دو رنگ آن روی magenta تنظیم شده‌اند\&. .sp علاوه بر این، دستور ویژه جدید \fBcolor set\fR معرفی شده است\&. نحو آن مشابه با \fBcolor push\fR به همراه اصلاح‌کننده‌های اختیاری \fBfill\fR و \fBstroke\fR است\&. این دستور به جای قرار دادن یک جفت رنگ جدید در پشته، بالاترین مورد روی پشته را اصلاح می‌کند\&. اگر پشته رنگ خالی باشد، رنگ پیش‌فرض (سیاه) fill/stroke تغییر می‌یابد\&. .RE .PP \fBdvisvgm\fR .RS 4 فهرست زیر مرور کوتاهی بر مجموعه اختصاصی دستورهای ویژه dvisvgm که در حال حاضر پشتیبانی می‌شوند ارائه می‌دهد\&. .PP \fBdvisvgm:raw\fR \fItext\fR .RS 4 یک دنباله دلخواه از گره‌های XML را به بخش صفحه سند SVG اضافه می‌کند\&. نرم‌افزار dvisvgm نحو و تو در تویی صحیح عنصرهای درج‌شده را بررسی می‌کند اما هیچ اعتبارسنجی انجام نمی‌دهد؛ بنابراین کاربر باید اطمینان حاصل کند که SVG حاصل همچنان معتبر است\&. تگ‌های باز و بسته می‌توانند بین دستورهای ویژه \fIraw\fR مختلف توزیع شوند\&. خود تگ‌ها نیز می‌توانند شکسته شوند اما باید بلافاصله با دستور ویژه \fIraw\fR بعدی ادامه یابند\&. هر دو مورد تگ‌های از نظر نحوی نادرست و تگ‌های با تو در تویی اشتباه منجر به پیام‌های خطا می‌شوند\&. .sp پارامتر \fItext\fR همچنین می‌تواند حاوی عبارت‌های \fB{?x}\fR، \fB{?y}\fR، \fB{?color}\fR، \fB{?fillcolor}\fR، \fB{?strokecolor}\fR، \fB{?matrix}\fR، \fB{?pageno}\fR، \fB{?svgfile}\fR و \fB{?svgpath}\fR باشد که به ترتیب به مختصات فعلی \fIx\fR و \fIy\fR، یک رشته هگز RGB از رنگ فعال فعلی fill و stroke، ماتریس تبدیل فعلی، شماره صفحه فعلی، و مسیر نسبی و مطلق فایل SVG در حال ایجاد گسترش می‌یابند\&. \fB{?color}\fR به همان رشته \fB{?fillcolor}\fR گسترش می‌یابد و همچنان برای سازگاری با نسخه‌های قدیمی‌تر dvisvgm که بین رنگ‌های fill و stroke تفاوتی قائل نبودند در دسترس است (اطلاعات مربوط به دستورهای ویژه رنگ را در زیر ببینید)\&. .sp از آنجا که SVG از رنگ‌های CMYK پشتیبانی نمی‌کند، برای نمونه در مشخصه‌های \fBfill\fR و \fBstroke\fR، نرم‌افزار dvisvgm ماکروی \fB{?cmyk(\fR\fB\fIc\fR\fR\fB,\fR\fB\fIm\fR\fR\fB,\fR\fB\fIy\fR\fR\fB,\fR\fB\fIk\fR\fR\fB)}\fR را برای ایجاد یک رشته هگز RGB از یک رنگ CMYK ارائه می‌دهد\&. این ماکرو می‌تواند به جای ترکیبی از دستورهای ویژه color/PostScript و ماکروهای رنگ، برای درج مستقیم یک مقدار رنگی CMYK استفاده شود\&. .sp دنباله نویسه \fB{?nl}\fR به یک نویسه خط جدید گسترش می‌یابد\&. در نهایت، ساختارهایی به شکل \fB{?(\fR\fB\fIexpr\fR\fR\fB)}\fR ارزیابی عبارت‌های ریاضی را ممکن می‌سازند که می‌توانند شامل عملیات پایه‌ای حسابی از جمله باقی‌مانده تقسیم (modulo) باشند\&. همانند بالا، متغیرهای \fIx\fR و \fIy\fR نشان‌دهنده مختصات فعلی هستند\&. عملیات نامعتبر، مانند تقسیم بر صفر، منجر به پیام خطا در کنسول می‌شود\&. مثال: \fB{?(\-10*(x+2y)\-5)}\fR یک عبارت معتبر است و به رشته عددی متناظر گسترش می‌یابد\&. .RE .PP \fBdvisvgm:rawdef\fR \fItext\fR .RS 4 این دستور مشابه \fBdvisvgm:raw\fR است، اما گره‌های XML را در بخش از سند SVG که در حال حاضر تولید می‌شود قرار می‌دهد\&. .RE .PP \fBdvisvgm:rawset\fR \fIname\fR \&... \fBdvisvgm:endrawset\fR .RS 4 این جفت دستور ویژه، آغاز و پایان تعریف یک قطعه خام نام‌گذاری‌شده SVG را مشخص می‌کند\&. تمام دستورهای ویژه \fBdvisvgm:raw\fR و \fBdvisvgm:rawdef\fR که بین \fBdvisvgm:rawset\fR و \fBdvisvgm:endrawset\fR محصور شده‌اند، بلافاصله ارزیابی نمی‌شوند بلکه برای استفاده بعدی تحت \fIname\fR مشخص‌شده با هم ذخیره می‌گردند\&. پس از تعریف، می‌توان در سراسر فایل DVI با استفاده از \fBdvisvgm:rawput\fR به این قطعه نام‌گذاری‌شده ارجاع داد (به زیر مراجعه کنید)\&. دو دستور \fBdvisvgm:rawset\fR و \fBdvisvgm:endrawset\fR نباید تو در تو باشند؛ یعنی پیش از فراخوانی یک \fBdvisvgm:rawset\fR دیگر، هر فراخوانی \fBdvisvgm:rawset\fR باید با فراخوانی متناظر \fBdvisvgm:endrawset\fR دنبال شود\&. همچنین شناسه \fIname\fR باید در سراسر فایل DVI یکتا باشد\&. استفاده چندباره از \fBdvisvgm:rawset\fR با یک \fIname\fR یکسان منجر به پیام‌های هشدار می‌شود\&. .RE .PP \fBdvisvgm:rawput\fR \fIname\fR .RS 4 قطعات خام SVG که پیش‌تر تحت \fIname\fR مشخص‌شده ذخیره شده بودند را درج می‌کند\&. نرم‌افزار dvisvgm بین قطعاتی که با \fBdvisvgm:raw\fR یا \fBdvisvgm:rawdef\fR مشخص شده‌اند تفاوت قائل می‌شود و با آن‌ها به شکل متفاوتی رفتار می‌کند: هر بار که \fBdvisvgm:rawput\fR فراخوانی شود، تمام بخش‌های \fBdvisvgm:raw\fR را درج می‌کند، در حالی که بخش‌های \fBdvisvgm:rawdef\fR تنها یک بار به بخش از سند SVG فعلی منتقل می‌شوند\&. .RE .PP \fBdvisvgm:img\fR \fIwidth\fR \fIheight\fR \fIfile\fR .RS 4 با استفاده از موقعیت گرافیکی فعلی، ماتریس تبدیل، ابعاد مشخص‌شده و نام فایل ارائه‌شده، یک عنصر \fBimage\fR ایجاد می‌کند\&. این دستور ویژه همچنین جعبه محصورکننده SVG حاصل را به‌روزرسانی می‌کند تا تصویر تبدیل‌یافته را به‌طور کامل در بر بگیرد\&. خود تصویر به گونه‌ای قرار می‌گیرد که گوشه پایین سمت چپ تصویر تبدیل‌نشده در موقعیت گرافیکی فعلی قرار گیرد\&. طول‌های \fIwidth\fR و \fIheight\fR ابعاد تصویر تبدیل‌نشده را مشخص می‌کنند\&. برای فهرستی از واحدهای طول پشتیبانی‌شده به گزینه \fB\-\-bbox\fR مراجعه کنید\&. اعداد ساده بدون مشخص‌کننده واحد، به معنای پوینت‌های TeX هستند (1in = 72\&.27pt)\&. .sp پارامتر \fIfile\fR می‌تواند یک نام فایل ساده یا یک مسیر نسبی یا مطلق از یک فایل باشد\&. به‌طور پیش‌فرض، dvisvgm صرفاً پیوندهایی ایجاد می‌کند که به فایل تصویر ارجاع می‌دهند، به طوری که رندرکننده SVG نام فایل یا مسیر را نسبت به مکان فایل SVG تولیدشده ارزیابی می‌کند\&. اگر گزینه \fB\-\-embed\-bitmaps\fR داده شود، تصاویر JPEG و PNG درون سند SVG جاسازی می‌شوند\&. از آنجا که این امر نیازمند کدگذاری base64 داده‌های تصویر است، فایل‌های SVG حاصل می‌توانند بسیار حجیم شوند\&. .RE .PP \fBdvisvgm:bbox\fR lock .RS 4 جعبه محصورکننده صفحه فعلی را قفل کرده و از به‌روزرسانی بیشتر آن جلوگیری می‌کند؛ یعنی عناصر گرافیکی که پس از فراخوانی این دستور ویژه اضافه می‌شوند، در تعیین وسعت جعبه محصورکننده در نظر گرفته نمی‌شوند\&. .RE .PP \fBdvisvgm:bbox\fR unlock .RS 4 جعبه محصورکننده قبلاً قفل‌شده صفحه فعلی را باز می‌کند تا با افزودن عناصر گرافیکی به صفحه، دوباره به‌روزرسانی شود\&. .RE.PP \fBdvisvgm:bbox\fR n[ew] \fIname\fR .RS 4 یک کادر احاطه‌کننده محلی به نام \fIname\fR\& را تعریف یا بازنشانی می‌کند. این نام می‌تواند شامل حروف و ارقام باشد\&. هنگام پردازش یک صفحه DVI،‏ dvisvgm به‌طور مداوم کادر احاطه‌کننده (سراسری) صفحه جاری را به‌روزرسانی می‌کند تا کوچک‌ترین مستطیل شامل تمام اجزای مرئی صفحه (نویسه‌ها، تصاویر، عناصر ترسیمی و غیره) را تعیین کند\&. علاوه بر کادر احاطه‌کننده سراسری، کاربر می‌تواند تعداد دلخواهی از کادرهای احاطه‌کننده محلی نام‌گذاری‌شده را درخواست کند\&. پس از تعریف، این کادرها همراه با کادر احاطه‌کننده سراسری، با شروع از نخستین نویسه پس از تعریف، به‌روزرسانی می‌شوند\&. بنابراین، می‌توان از کادرهای محلی برای محاسبه وسعت بخش‌هایی از صفحه استفاده کرد\&. این قابلیت برای سناریوهایی که فایل SVG تولیدشده پس‌پردازش می‌شود، مفید است\&. .sp در ترکیب با دستور ویژه \fBdvisvgm:raw\fR، ماکروی \fB{?bbox \fR\fB\fIname\fR\fR\fB}\fR به چهار مقدار \fIx\fR، \fIy\fR، \fIw\fR و \fIh\fR (جداشده با فاصله) بسط می‌یابد که مختصات گوشه بالا سمت چپ، عرض و ارتفاع کادر محلی \fIname\fR\& را مشخص می‌کنند. اگر کادر \fIname\fR قبلاً تعریف نشده باشد، هر چهار مقدار برابر با صفر خواهند بود\&. .RE .PP \fBdvisvgm:bbox\fR \fIwidth\fR \fIheight\fR [\fIdepth\fR] [\fBtransform\fR] .RS 4 کادر احاطه‌کننده صفحه جاری را با تعبیه یک مستطیل مجازی (\fIx\fR، \fIy\fR، \fIwidth\fR، \fIheight\fR) که گوشه پایین سمت چپ آن در موقعیت رسم جاری DVI (\fIx\fR,\fIy\fR)\& قرار دارد، به‌روزرسانی می‌کند. اگر پارامتر اختیاری \fIdepth\fR مشخص شده باشد، dvisvgm یک مستطیل دوم (\fIx\fR، \fIy\fR، \fIwidth\fR، \-\fIdepth\fR)\& را تعبیه می‌کند. طول‌های \fIwidth\fR، \fIheight\fR و \fIdepth\fR می‌توانند همراه با یک مشخص‌کننده واحد (گزینه \fB\-\-bbox\fR را ببینید) یا به صورت اعداد ممیز شناور ساده مشخص شوند\&. در حالت دوم، واحدهای پوینت تک فرض می‌شوند (1in = 72\&.27pt)\&. بسته به اندازه و موقعیت مستطیل مجازی، این دستور کادر احاطه‌کننده کلی را گسترش می‌دهد یا آن را همان‌گونه که هست رها می‌کند\&. بنابراین، کاهش وسعت آن امکان‌پذیر نیست\&. .sp این دستور ویژه قرار است همراه با \fBdvisvgm:raw\fR استفاده شود تا درگاه دید (viewport) صفحه را به‌درستی به‌روزرسانی کند\&. به‌طور پیش‌فرض، ابعاد کادر بدون تغییر تخصیص داده می‌شوند و به‌ویژه با دستورات تبدیل تغییر نمی‌کنند\&. برای اعمال ماتریس تبدیل جاری، اصلاح‌کننده اختیاری \fBtransform\fR می‌تواند در انتهای عبارت دستور ویژه افزوده شود\&. .RE .PP \fBdvisvgm:bbox\fR a[bs] \fIx1\fR \fIy1\fR \fIx2\fR \fIy2\fR [\fBtransform\fR] .RS 4 این نوع از دستور ویژه bbox، کادر احاطه‌کننده را با تعبیه یک مستطیل مجازی (\fIx1\fR,\fIy1\fR,\fIx2\fR,\fIy2\fR)\& به‌روزرسانی می‌کند. نقاط (\fIx1\fR,\fIy1\fR) و (\fIx2\fR,\fIy2\fR) نشان‌دهنده مختصات مطلق دو گوشه قطری مستطیل هستند\&. همانند گونه نسبی دستور ویژه شرح داده شده در بالا، اصلاح‌کننده اختیاری \fBtransform\fR امکان اعمال ماتریس تبدیل جاری روی کادر احاطه‌کننده را فراهم می‌آورد\&. .RE .PP \fBdvisvgm:bbox\fR f[ix] \fIx1\fR \fIy1\fR \fIx2\fR \fIy2\fR [\fBtransform\fR] .RS 4 این نوع از دستور ویژه bbox یک کادر احاطه‌کننده مطلق (نهایی) را به SVG حاصل اختصاص می‌دهد\&. پس از اجرای این دستور، dvisvgm دیگر مختصات کادر احاطه‌کننده را تغییر نمی‌دهد، مگر اینکه این دستور ویژه بعداً مجدداً فراخوانی شود\&. نقاط (\fIx1\fR,\fIy1\fR) و (\fIx2\fR,\fIy2\fR) نشان‌دهنده مختصات مطلق دو گوشه قطری مستطیل هستند\&. همانند گونه نسبی دستور ویژه شرح داده شده در بالا، اصلاح‌کننده اختیاری \fBtransform\fR امکان اعمال ماتریس تبدیل جاری روی کادر احاطه‌کننده را فراهم می‌آورد\&. .sp قطعه‌کد TeX زیر دو عنصر خام SVG را به خروجی اضافه کرده و کادر احاطه‌کننده را متناسب با آن به‌روزرسانی می‌کند: .sp .if n \{\ .RS 4 .\} .nf \especial{dvisvgm:raw }% \especial{dvisvgm:bbox 10bp 10bp 10bp transform}% \especial{dvisvgm:bbox \-10bp 10bp 10bp transform} \especial{dvisvgm:raw }% \especial{dvisvgm:bbox abs 10bp 200bp 100bp 250bp transform} .fi .if n \{\ .RE .\} .RE .PP \fBdvisvgm:currentcolor\fR [on|off] .RS 4 این دستور ویژه عملکردی مشابه با گزینه \fB\-\-currentcolor\fR دارد اما نیازی به آرگومان صریح رنگ ندارد\&. در عوض، رنگ فعال کنونی را دریافت کرده و آن را با \fBcurrentColor\fR جایگزین می‌کند\&. بنابراین، نتیجه نهایی هم به محل قرارگیری این دستور ویژه و هم به تغییرات رنگ پیش از آن وابسته است\&. آرگومان \fBon\fR \(en که قابلیت \fIcurrentColor\fR را فعال می‌کند \(en می‌تواند حذف شود\&. هنگامی که با آرگومان \fBoff\fR فراخوانی شود، این قابلیت دوباره غیرفعال می‌گردد\&. .RE .PP \fBdvisvgm:message\fR \fImsg\fR .RS 4 متن ارائه‌شده \fImsg\fR را در کنسول چاپ می‌کند\&. علاوه بر متن ایستا، می‌تواند شامل ماکروهای \fB{?\&...}\fR ذکرشده در توضیحات \fBdvisvgm:raw\fR نیز باشد\&. پیام‌های ایجادشده توسط این دستور ویژه را می‌توان با گزینه \fB\-\-verbosity\fR (به بالا مراجعه کنید) فرونشاند\&. .RE .RE .PP \fBem\fR .RS 4 این دستورات ویژه همراه با توزیع \fIemTeX\fR توسط Eberhard Mattes معرفی شدند\&. آن‌ها دستورات رسم خط، دستورالعمل‌هایی برای تعبیه فایل‌های تصویری PCX ،MSP و BMP و همچنین دو دستور PCL را فراهم می‌کنند\&. dvisvgm فقط از دستورات رسم خط پشتیبانی می‌کند و تمام دیگر دستورات ویژه em را بدون اخطار نادیده می‌گیرد\&. شرح نحو این دستورات را می‌توان در مستندات درایور DVI همراه با emTeX (\m[blue]https://ctan.org/pkg/emtex\m[]) یافت\&. .RE .PP \fBhtml\fR .RS 4 مشخصات hyperref چندین شیوه گوناگون را برای چگونگی علامت‌گذاری نواحی پیونددار در یک فایل DVI تعریف می‌کند\&. dvisvgm از ساختارهای دستور ویژه استاندارد HyperTeX به همان شکلی که توسط گزینه \fIhypertex\fR بسته hyperref ایجاد می‌شوند، پشتیبانی می‌کند\&. به‌طور پیش‌فرض، تمام نواحی پیونددار سند با یک مستطیل علامت‌گذاری می‌شوند\&. گزینه \fB\-\-linkmark\fR به شما امکان می‌دهد این رفتار را تغییر دهید\&. برای جزئیات بیشتر به بخش‌های بالاتر مراجعه کنید\&. اطلاعات مربوط به نحو و معناشناسی دستورات ویژه HyperTeX را می‌توان در راهنمای hyperref (\m[blue]https://ctan.org/pkg/hyperref\m[]) یافت\&. .RE .PP \fBpapersize\fR .RS 4 دستور ویژه \fIpapersize\fR، که افزونه‌ای معرفی‌شده توسط dvips است، می‌تواند برای تعیین عرض و ارتفاع صفحات در فایل DVI استفاده شود\&. این دستور بر صفحه‌ای که در آن ظاهر می‌شود و همچنین بر تمامی صفحات پس از آن تا زمانی که دستور ویژه papersize دیگری یافت شود، تأثیر می‌گذارد\&. اگر بیش از یک دستور ویژه papersize در یک صفحه وجود داشته باشد، dvisvgm آخرین مورد را اعمال می‌کند\&. با این حال، به منظور حفظ سازگاری با نسخه‌های قبلی dvisvgm که این دستورات ویژه را ارزیابی نمی‌کردند، پردازش آن‌ها باید صریحاً با افزودن گزینه \fB\-\-bbox=papersize\fR در خط فرمان فعال شود\&. در غیر این صورت، dvisvgm آن‌ها را نادیده گرفته و کادرهای احاطه‌کننده فشرده را محاسبه می‌کند\&. .RE .PP \fBpdf\fR .RS 4 برنامه‌های pdfTeX و dvipdfmx چندین دستور ویژه مرتبط با تولید فایل‌های PDF را معرفی کردند\&. در حال حاضر، تنها دستورات ویژه \fIpdf:mapfile\fR، \fIpdf:mapline\fR، \fIpdf:pagesize\fR و پیوندهای PDF توسط dvisvgm پشتیبانی می‌شوند\&. موارد اخیر، معادل‌های PDF برای دستورات ویژه HyperTeX در HTML هستند\&. برای نمونه، این دستورات توسط بسته hyperref در حالت PDF تولید می‌شوند\&. اگر یک صفحه DVI حاوی دستورات ویژه پشتیبانی‌نشده PDF باشد، dvisvgm یک پیام هشدار شامل تعداد دستورات ویژه نادیده‌گرفته‌شده چاپ می‌کند\&. .sp دستور \fIpdf:pagesize\fR مشابه دستور ویژه \fIpapersize\fR است (بالا را ببینید) که اندازه صفحه کنونی و تمام صفحات بعدی را تعیین می‌کند\&. به منظور اعمال واقعی این ابعاد بر فایل‌های SVG تولیدشده، گزینه \fB\-\-bbox=papersize\fR باید ارائه شود\&. .sp دستورات \fIpdf:mapfile\fR و \fIpdf:mapline\fR امکان تغییر درخت نگاشت فونت را در طول پردازش فایل DVI فراهم می‌کنند\&. این دستورات برای نمونه توسط CTeX استفاده می‌شوند\&. dvisvgm از هر دو قالب نگاشت قلم dvips و dvipdfm پشتیبانی می‌کند\&. برای کسب اطلاعات بیشتر درباره نحو و مفاهیم این دستور، مستندات \fB\epdfmapfile\fR را در راهنمای کاربر pdfTeX (\m[blue]https://ctan.org/pkg/pdftex\m[]) ببینید\&. .RE .PP \fBps\fR .RS 4 درایور سرشناس DVI به نام \fIdvips\fR (\m[blue]https://www.tug.org/texinfohtml/dvips.html\m[]) مجموعه دستورات ویژه اختصاصی خود را برای گنجاندن کدهای PostScript در فایل‌های DVI معرفی کرد، که توانایی‌های اسناد DVI را به شدت افزایش می‌دهد\&. یکی از اهداف dvisvgm ارزیابی کامل تمام قطعه‌کدهای PostScript و تبدیل هر چه بیشتر آن‌ها به فرمت SVG است\&. بر خلاف dvips، برنامه dvisvgm برای محاسبه موقعیت دقیق هر عنصر گرافیکی از محاسبات ممیز شناور استفاده می‌کند، یعنی مختصات را گرد نمی‌کند\&. از این رو، ممکن است موقعیت نسبی عناصر گرافیکی اندکی با مقادیر محاسبه‌شده توسط dvips متفاوت باشد\&. .sp از آنجا که PostScript زبانی نسبتاً پیچیده است، dvisvgm مفسر اختصاصی خود را برای PostScript پیاده‌سازی نکرده و به جای آن به Ghostscript (\m[blue]https://ghostscript.com\m[]) متکی است\&. اگر کتابخانه Ghostscript به باینری dvisvgm پیوند داده نشده باشد، در زمان اجرا به شکل پویا جستجو و بارگذاری می‌شود\&. در این حالت، dvisvgm در سیستم‌های شبه‌یونیکس به دنبال \fIlibgs\&.so\&.X\fR (نسخه‌های ABI پشتیبانی‌شده: 7، 8، 9)، در macOS به دنبال \fIlibgs\&.X\&.dylib\fR و در ویندوز به دنبال \fIgsdll32\&.dll\fR یا \fIgsdll64\&.dll\fR می‌گردد\&. شما می‌توانید با استفاده از متغیر محیطی \fBLIBGS\fR یا گزینه خط فرمان \fB\-\-libgs\fR نام‌های پیش‌فرض فایل را لغو و بازنویسی کنید\&. کتابخانه باید از طریق مسیر جستجوی ld (در شبه‌یونیکس) یا متغیر محیطی PATH (در ویندوز) در دسترس باشد\&. همچنین می‌توان مسیر مطلق فایل را مشخص کرد\&. اگر کتابخانه یافت نشود، dvisvgm پردازش دستورات ویژه PostScript را غیرفعال کرده و یک پیام هشدار چاپ می‌کند\&. با استفاده از گزینه \fB\-\-list\-specials\fR بررسی کنید که آیا پشتیبانی از PostScript در دسترس است یا خیر، یعنی ورودی \fIps\fR وجود دارد یا نه\&. .sp پردازشگر PostScript همچنین داده‌های کادر احاطه‌کننده تولیدشده توسط بسته preview (\m[blue]https://ctan.org/pkg/preview\m[]) با گزینه \fItightpage\fR را شناسایی و ارزیابی می‌کند\&. اگر چنین داده‌ای در فایل DVI وجود داشته باشد و dvisvgm با گزینه \fB\-\-bbox=preview\fR فراخوانی شود، dvisvgm پهنا و ارتفاع کل فایل SVG را بر اساس مقادیر استخراج‌شده از داده‌های پیش‌نمایش تنظیم می‌کند\&. علاوه بر این، پیامی حاوی پهنا، ارتفاع و عمق کادر بر حسب واحدهای پوینت تک به کنسول چاپ می‌کند\&. به‌ویژه، مقدار عمق (depth) می‌تواند توسط پس‌پردازشگرها خوانده شود تا برای نمونه، گرافیک‌های SVG را با خط مبنای (baseline) متن پیرامون در اسناد HTML یا XSL\-FO هم‌تراز سازد\&. لطفاً توجه داشته باشید که کادرهای احاطه‌کننده SVG بر اساس یک پهنا و یک ارتفاع (کل) تعریف می‌شوند\&. بر خلاف TeX، فرمت SVG هیچ سازوکاری برای تفکیک ارتفاع و عمق، یعنی به ترتیب ابعاد عمودی بالاتر و پایین‌تر از خط مبنا، ارائه نمی‌دهد\&. از این رو، به‌طور کلی امکان استخراج مقدار عمق از خود فایل SVG وجود ندارد\&. .sp اگر dvisvgm را با گزینه \fB\-\-bbox=min\fR (پیش‌فرض) اجرا کنید و داده‌های پیش‌نمایش در فایل DVI وجود داشته باشند، dvisvgm ابعاد پیش‌نمایش را اعمال نمی‌کند، بلکه کادر احاطه‌کننده‌ای را محاسبه می‌کند که محتویات صفحه را به صورت فشرده احاطه کند\&. مقادیر ارتفاع، عمق و پهنا که در کنسول نوشته می‌شوند، بر این اساس تطبیق خواهند یافت\&. .RE .PP \fBtpic\fR .RS 4 مجموعه دستورات ویژه TPIC دستورالعمل‌هایی را برای رسم اشکال هندسی ساده تعریف می‌کند\&. برخی بسته‌های LaTeX، نظیر eepic و tplot، از این دستورات ویژه برای توصیف نگاره‌ها استفاده می‌کنند\&. .RE.SH "مثال‌ها (EXAMPLES)" .PP \fBdvisvgm file\fR .RS 4 صفحه نخست \fIfile\&.dvi\fR را به \fIfile\&.svg\fR تبدیل می‌کند\&. .RE .PP \fBdvisvgm \-p1\-5 file\fR .RS 4 پنج صفحه نخست \fIfile\&.dvi\fR را به \fIfile\-1\&.svg\fR،\&...،\fIfile\-5\&.svg\fR تبدیل می‌کند\&. .RE .PP \fBdvisvgm \-p1\- file\fR .RS 4 تمامی صفحات \fIfile\&.dvi\fR را به فایل‌های SVG جداگانه تبدیل می‌کند\&. .RE .PP \fBdvisvgm \-p1,3 \-O file\fR .RS 4 صفحات اول و سوم \fIfile\&.dvi\fR را به فایل‌های بهینه‌شده SVG تبدیل می‌کند\&. .RE .PP \fBdvisvgm \- < file\&.dvi\fR .RS 4 صفحه نخست \fIfile\&.dvi\fR را به \fIstdin\&.svg\fR تبدیل می‌کند، به‌طوری که محتوای \fIfile\&.dvi\fR از \fBstdin\fR خوانده می‌شود\&. .RE .PP \fBdvisvgm \-z file\fR .RS 4 صفحه نخست \fIfile\&.dvi\fR را با سطح فشرده‌سازی پیش‌فرض 9 به \fIfile\&.svgz\fR تبدیل می‌کند\&. .RE .PP \fBdvisvgm \-p5 \-z3 \-ba4\-l \-o newfile file\fR .RS 4 صفحه پنجم \fIfile\&.dvi\fR را با سطح فشرده‌سازی 3 به \fInewfile\&.svgz\fR تبدیل می‌کند\&. کادر احاطه‌کننده (bounding box) روی DIN/ISO A4 در قالب افقی (landscape) تنظیم شده است\&. .RE .PP \fBdvisvgm \-\-transform="R20,w/3,2h/5 T1cm,1cm S2,3" file\fR .RS 4 صفحه نخست \fIfile\&.dvi\fR را به \fIfile\&.svg\fR تبدیل می‌کند که در آن سه تبدیل (transformation) اعمال می‌شود\&. .RE .SH "محیط (ENVIRONMENT)" .sp برنامه dvisvgm از کتابخانه \fBkpathsea\fR برای یافتن فایل‌هایی که باز می‌کند استفاده می‌کند\&. از این رو، متغیرهای محیطی شرح‌داده‌شده در مستندات این کتابخانه بر مبدل تأثیر می‌گذارند\&. .sp اگر dvisvgm بدون کتابخانه Ghostscript پیوند داده شده باشد و پشتیبانی از PostScript غیرفعال نشده باشد، کتابخانه مشترک Ghostscript هنگام اجرا از طریق dlopen() جستجو می‌شود\&. متغیر محیطی \fBLIBGS\fR می‌تواند برای تعیین مسیر و نام فایل کتابخانه استفاده شود\&. .sp نسخه‌های از پیش کامپایل‌شده ویندوز dvisvgm به یک نصب فعال از MiKTeX 2\&.9 یا بالاتر نیاز دارند\&. dvisvgm همراه با نسخه قابل‌حمل (portable) MiKTeX کار نمی‌کند زیرا به رابط COM مربوط به MiKTeX متکی است که تنها در یک نصب محلی در دسترس است\&. برای فعال‌سازی ارزیابی دستورات ویژه PostScript، باید فایل DLL اصلی Ghostscript یعنی \fIgsdll32\&.dll\fR موجود و از طریق مسیر جستجو قابل‌دستیابی باشد\&. ساخت‌های ۶۴بیتی ویندوز نیازمند فایل DLL شصت و چهار بیتی Ghostscript یعنی \fIgsdll64\&.dll\fR هستند\&. هر دو فایل DLL همراه با نصب‌کننده‌های متناظر Ghostscript ارائه می‌شوند که از طریق \m[blue]\fBhttps://ghostscript\&.com\fR\m[] در دسترس هستند\&. .sp متغیر محیطی \fBDVISVGM_COLORS\fR رنگ‌های به‌کاررفته برای برجسته‌سازی بخش‌های مختلف خروجی پیام‌های dvisvgm را مشخص می‌کند\&. این متغیر تنها زمانی ارزیابی می‌شود که گزینه \fB\-\-color\fR داده شده باشد\&. مقدار \fBDVISVGM_COLORS\fR فهرستی از مدخل‌های جداشده با دونقطه به صورت \fIgg\fR=\fIBF\fR است، که در آن \fIgg\fR نشان‌دهنده یکی از شاخص‌های گروه رنگ فهرست‌شده در زیر است، و \fIBF\fR دو رقم هگزادسیمال هستند که رنگ پس‌زمینه (رقم اول) و رنگ متن/پیش‌زمینه (رقم دوم) را مشخص می‌کنند\&. مقادیر رنگ به صورت زیر تعریف شده‌اند: 0=مشکی، 1=قرمز، 2=سبز، 3=زرد، 4=آبی، 5=سرخابی، 6=فیروزه‌ای، 7=خاکستری، 8=قرمز روشن، 9=سبز روشن، A=زرد روشن، B=آبی روشن، C=سرخابی روشن، D=فیروزه‌ای روشن، E=خاکستری روشن، F=سفید\&. بسته به ترمینال، ممکن است رنگ‌ها متفاوت باشند\&. به جای تغییر هر دو رنگ متن و پس‌زمینه، تغییر تنها یکی از آن‌ها نیز ممکن است: علامت ستاره (*) به جای رقم هگزادسیمال نشان‌دهنده رنگ پیش‌فرض متن یا پس‌زمینه ترمینال است\&. .sp تمامی مدخل‌های با ساختار نامعتبر در این فهرست بدون نمایش پیام نادیده گرفته می‌شوند\&. .TS tab(:); lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx. T{ .sp \fBer\fR T}:T{ .sp پیام‌های خطا T} T{ .sp \fBwn\fR T}:T{ .sp پیام‌های هشدار T} T{ .sp \fBpn\fR T}:T{ .sp پیام‌های مربوط به شماره صفحه T} T{ .sp \fBps\fR T}:T{ .sp پیام‌های اندازه صفحه T} T{ .sp \fBfw\fR T}:T{ .sp اطلاعات مربوط به فایل‌های نوشته‌شده T} T{ .sp \fBsm\fR T}:T{ .sp پیام‌های وضعیت T} T{ .sp \fBtr\fR T}:T{ .sp پیام‌های ردیاب گلیف (glyph tracer) T} T{ .sp \fBpi\fR T}:T{ .sp نشانگر پیشرفت T} .TE .sp 1 .sp \fBمثال:\fR \fBer=01:pi=*5\fR رنگ پیام‌های خطا (\fBer\fR) را به قرمز (\fB1\fR) روی مشکی (\fB0\fR)، و رنگ نشانگرهای پیشرفت (\fBpi\fR) را به فیروزه‌ای (\fB5\fR) روی پس‌زمینه پیش‌فرض (\fB*\fR) تنظیم می‌کند\&. .sp متغیر \fBDVISVGM_PDF_PROC\fR امکان انتخاب پردازشگر PDF دلخواه را فراهم می‌کند\&. برای پردازش فایل‌های PDF، dvisvgm به Ghostscript (نسخه < 10\&.01\&.0) یا mutool نیاز دارد\&. اگر \fBDVISVGM_PDF_PROC\fR تنظیم نشده باشد، dvisvgm تلاش می‌کند پردازشگرهای موجود را شناسایی کند\&. برای اطلاعات بیشتر گزینه \fB\-\-pdf\fR را ببینید\&. جهت انتخاب یک پردازشگر PDF خاص، می‌توانید \fBDVISVGM_PDF_PROC\fR را روی \fBgs\fR یا \fBmutool\fR تنظیم کنید که به ترتیب استفاده از Ghostscript و mutool را تحمیل می‌کند\&..SH "فایل‌ها (FILES)" .sp مکان فایل‌های زیر توسط کتابخانه kpathsea تعیین می‌شود\&. برای بررسی پیکربندی واقعی kpathsea می‌توانید از ابزار \fBkpsewhich\fR استفاده کنید\&. .TS tab(:); lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx lt ltx. T{ .sp \fB*\&.enc\fR T}:T{ .sp فایل‌های کدگذاری قلم T} T{ .sp \fB*\&.fgd\fR T}:T{ .sp فایل‌های داده‌های گلیف قلم (فایل‌های کش ایجادشده توسط dvisvgm) T} T{ .sp \fB*\&.map\fR T}:T{ .sp فایل‌های نگاشت قلم T} T{ .sp \fB*\&.mf\fR T}:T{ .sp فایل‌های ورودی Metafont T} T{ .sp \fB*\&.pfb\fR T}:T{ .sp فایل‌های قلم PostScript Type 1 T} T{ .sp \fB*\&.pro\fR T}:T{ .sp فایل‌های سرآیند/پیش‌درآمد PostScript T} T{ .sp \fB*\&.tfm\fR T}:T{ .sp فایل‌های متریک قلم TeX T} T{ .sp \fB*\&.ttf\fR T}:T{ .sp فایل‌های قلم TrueType T} T{ .sp \fB*\&.vf\fR T}:T{ .sp فایل‌های قلم مجازی T} .TE .sp 1 .SH "همچنین ببینید (SEE ALSO)" .sp \fBtex(1), mf(1), mktexmf(1), grodvi(1), potrace(1)\fR و مستندات info مربوط به \fBkpathsea library\fR\&. .SH "منابع (RESOURCES)" .PP صفحه اصلی پروژه .RS 4 \m[blue]\fBhttps://dvisvgm\&.de\fR\m[] .RE .PP مخزن کد .RS 4 \m[blue]\fBhttps://github\&.com/mgieseki/dvisvgm\fR\m[] .RE .SH "گزارش باگ‌ها (BUGS)" .sp لطفاً گزارش باگ‌ها را با استفاده از سامانه ردیابی باگ در GitHub (\m[blue]https://github.com/mgieseki/dvisvgm/issues\m[]) ارسال کنید\&. .SH "نویسندگان (AUTHORS)" .sp نوشته‌شده توسط Martin Gieseking <\m[blue]\fBmartin\&.gieseking@uos\&.de\fR\m[]> .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .sp حق نشر \(co 2005\-2026 متعلق به Martin Gieseking است\&. استفاده آزاد از این نرم‌افزار تحت شرایط «مجوز عمومی همگانی گنو» (GPL) نسخه ۳ یا (به انتخاب شما) هر نسخه بالاتر مجاز است\&.