.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "DVIPNG 1" .TH DVIPNG 1 2025-02-02 "dvipng 1.18" "User commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" dvipng \- مبدل پرونده‌های DVI به تصاویر PNG .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" dvipng [options] filename .PP dvipng [options] [filename] \- .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" این برنامه از پرونده‌های DVI به‌دست‌آمده از TeX و نرم‌افزارهای مرتبط با آن، پرونده‌های گرافیکی PNG و/یا GIF تولید می‌کند. .PP در صورت فعال بودن پشتیبانی از GIF، خروجی GIF با استفاده از باینری \&\fBdvigif\fR یا با گزینهٔ \fB\-\-gif\fR انتخاب می‌شود. .PP مزایای \fBdvipng\fR/\fBdvigif\fR عبارتند از: .IP * 4 سرعت. این برنامه دارای کدی بسیار سریع برای رندر بیت‌مپ (bitmap) از پرونده‌های DVI است، که آن را برای تولید درلحظهٔ (on-the-fly) حجم زیادی از تصاویر، آن‌گونه که در preview-latex، WeBWorK و غیره نیاز است، مناسب می‌سازد. .IP * 4 این برنامه بخش مؤخره (postamble) را نمی‌خواند، بنابراین می‌تواند حتی پیش از پایان کار TeX شروع به پردازش کند. یک گزینهٔ \fB\-\-follow\fR وجود دارد که باعث می‌شود dvipng در انتهای پرونده برای دریافت خروجی‌های بیشتر منتظر بماند، مگر اینکه به نشانگر POST که نشان‌دهندهٔ پایان پروندهٔ DVI است، برسد. .IP * 4 پرس‌وجوی تعاملی گزینه‌ها. dvipng می‌تواند گزینه‌ها را به‌صورت تعاملی از طریق stdin بخواند و تمام گزینه‌ها در این حالت قابل استفاده هستند. حتی تغییر دادن پروندهٔ ورودی از طریق این رابط کاربری امکان‌پذیر است. .IP * 4 پشتیبانی از قلم‌های PK، VF، PostScript Type1 و TrueType، زیرقلم‌ها (یعنی آنچه در CJK-LaTeX استفاده می‌شود)، دستورهای ویژهٔ رنگ (color specials)، و درج تصاویر PostScript، PNG، JPEG یا GIF. .IP * 4 و موارد دیگر....SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" بسیاری از گزینه‌های بدون آرگومان فهرست‌شده در اینجا را می‌توان با افزودن یک صفر (\fB0\fR) به انتهای گزینه غیرفعال کرد؛ برای مثال، برای غیرفعال کردن معکوس‌سازی صفحات، از \fB\-r0\fR استفاده کنید. این گزینه‌ها با یک \&\fB*\fR در انتها مشخص شده‌اند. .IP \fB\-\fR 4 .IX Item "-" خواندن گزینه‌های اضافی از ورودی استاندارد پس از پردازش خط فرمان. .IP \fB\-\-help\fR 4 .IX Item "--help" نمایش یک پیام راهنمای نحوهٔ استفاده و خروج. .IP \fB\-\-version\fR 4 .IX Item "--version" نمایش شمارهٔ نسخه و خروج. .IP "\fB\-bd\fR \fInum\fR" 4 .IX Item "-bd num" .PD 0 .IP "\fB\-bd\fR \fIcolor_spec\fR" 4 .IX Item "-bd color_spec" .IP "\fB\-bd '\fR\fInum\fR\fB \fR\fIcolor_spec\fR\fB'\fR" 4 .IX Item "-bd 'num color_spec'" .PD تنظیم پهنای پیکسل حاشیهٔ شفاف (پیش‌فرض 0 است). استفاده از این گزینه لبه‌های تصویر را شفاف می‌کند، اما تنها بر پیکسل‌های دارای رنگ پس‌زمینه اثر می‌گذارد. تعیین یک \fIcolor_spec\fR رنگ جایگزین را برای نمایشگرهایی که از شفافیت پشتیبانی نمی‌کنند تعیین می‌کند (پیش‌فرض همان رنگ پس‌زمینه است). مشخصات رنگ باید در نحو \especial رنگ TeX باشد، مانند 'rgb 1.0 0.0 0.0'. تنظیم رنگ جایگزین، پهنای پیش‌فرض حاشیه را به 1 پیکسل تبدیل می‌کند. .IP "\fB\-\-bdpi\fR \fInum\fR" 4 .IX Item "--bdpi num" این گزینه تنها هنگام استفاده از فونت‌های بیت‌مپ (PK) اثر دارد. این گزینه تفکیک‌پذیری پایه (Metafont) را، هم به‌صورت افقی و هم عمودی، روی \fInum\fR نقطه در اینچ (dpi) تنظیم می‌کند. این گزینه زمانی که حالت Metafont به‌صورت دستی با گزینهٔ \-\-mode انتخاب شود ضروری است (به زیر مراجعه کنید). .IP "\fB\-bg\fR \fIcolor_spec\fR" 4 .IX Item "-bg color_spec" انتخاب رنگ پس‌زمینه برای تصاویر. اگر یک \especial رنگ پس‌زمینه در DVI وجود داشته باشد، این گزینه نادیده گرفته خواهد شد. مشخصات رنگ باید در نحو \especial رنگ TeX باشد، مانند 'rgb 1.0 0.0 0.0'. همچنین می‌توانید 'Transparent' یا 'transparent' را مشخص کنید که یک پس‌زمینهٔ شفاف با پس‌زمینهٔ معمولی به عنوان رنگ جایگزین به شما ارائه می‌دهد. عبارت 'Transparent' با حرف نخست بزرگ شفافیت کامل آلفا (full-alpha) را ارائه می‌دهد، در حالی که 'transparent' با حروف تماماً کوچک یک پس‌زمینهٔ ساده کاملاً شفاف با پیکسل‌های ناصافی‌زدایی‌شدهٔ (antialiased) غیرشفاف ارائه می‌کند. دومی برای نمایشگرهایی مناسب است که نمی‌توانند کانال آلفای واقعی را پردازش کنند. تصاویر GIF از شفافیت کامل آلفا پشتیبانی نمی‌کنند، بنابراین در صورت خروجی GIF، هر دو حالت رفتار دوم را به کار خواهند گرفت. .IP "\fB\-d\fR \fInum\fR" 4 .IX Item "-d num" تنظیم پرچم‌های اشکال‌زدایی (debug) که نشان می‌دهد dvipng (فکر می‌کند) در حال انجام چه کاری است. این قابلیت کار خواهد کرد مگر اینکه dvipng بدون گزینهٔ \f(CW\*(C`DEBUG\*(C'\fR کامپایل شده باشد (توصیه نمی‌شود). پرچم‌ها را بر اساس نیاز خود تنظیم کنید؛ از \fB\-d \-1\fR به عنوان نخستین گزینه برای بیشترین مقدار خروجی استفاده کنید. .IP "\fB\-D\fR \fInum\fR" 4 .IX Item "-D num" تنظیم تفکیک‌پذیری خروجی، هم به‌صورت افقی و هم عمودی، روی \fInum\fR نقطه در اینچ (dpi). .Sp ممکن است شخصی بخواهد این مقدار را برای تطابق با اندازهٔ قلم یک متن خاص (برای مثال، در یک صفحهٔ وب) تنظیم کند؛ برای ارتفاع قلم متن به اندازهٔ \fIfont_px\fR پیکسل (در Mozilla) فرمول صحیح عبارت است از: .Sp .Vb 1 \& = * 72.27 / 10 [px * TeXpt/in / TeXpt] .Ve .Sp تقسیم نهایی بر ده به دلیل ارتفاع استاندارد قلم 10pt در سند شما است؛ اگر از 12pt استفاده می‌کنید، بر 12 تقسیم کنید. متأسفانه، برخی از مرورگرهای تجاری ارتفاع قلم را بر حسب pt (نقطه) در نظر می‌گیرند، نه پیکسل. شما باید با استفاده از تفکیک‌پذیری صفحه نمایش (که معمولاً به‌طور پیش‌فرض 96 dpi است) آن را به پیکسل تبدیل کنید که فرمول آن به این صورت خواهد بود: .Sp .Vb 1 \& = * 96 / 72 [pt * px/in / (pt/in)] .Ve .Sp در برخی از نمایشگرهای با تفکیک‌پذیری بالا، این مقدار در عوض 120 dpi است. موفق باشید! .IP \fB\-\-depth*\fR 4 .IX Item "--depth*" گزارش عمق تصویر. این گزینه تنها زمانی به طور قابل اعتماد کار می‌کند که استایل LaTeX با نام \fIpreview.sty\fR از بستهٔ preview-latex همراه با گزینهٔ \fBactive\fR استفاده شده باشد. این مقدار، تعداد پیکسل‌ها از پایین تصویر تا خط کرسی (baseline) تصویر را گزارش می‌دهد. این را می‌توان برای موقعیت‌دهی عمودی تصویر، مثلاً در اسناد وب استفاده کرد، جایی که شخص می‌تواند بنویسد (Cascading StyleSheets 1): .Sp .Vb 1 \& .Ve .Sp عمق در این حالت یک آفست منفی است، بنابراین علامت منفی لازم است، و واحد آن بر حسب پیکسل (px) می‌باشد. .IP \fB\-\-dvinum*\fR 4 .IX Item "--dvinum*" این گزینه را تنظیم کنید تا شمارهٔ صفحهٔ خروجی به جای شمارهٔ فیزیکی صفحه، شماره‌های صفحهٔ TeX باشد. سوئیچ \fB\-o\fR را ببینید. .IP "\fB\-fg\fR \fIcolor_spec\fR" 4 .IX Item "-fg color_spec" انتخاب رنگ پیش‌زمینه برای تصاویر. اگر یک \especial رنگ پیش‌زمینه در DVI وجود داشته باشد، این گزینه نادیده گرفته خواهد شد. مشخصات رنگ باید در نحو \especial رنگ TeX باشد، مانند 'rgb 1.0 0.0 0.0'. .IP \fB\-\-follow*\fR 4 .IX Item "--follow*" انتظار برای دریافت داده‌ها در پایان فایل (end-of-file). یکی از مزایای dvipng این است که postamble را نمی‌خواند، بنابراین می‌تواند پیش از پایان یافتن کار TeX شروع به پردازش کند. این سوئیچ باعث می‌شود dvipng در انتهای فایل منتظر خروجی‌های بعدی بماند، مگر اینکه نشانگر POST را که بیانگر پایان DVI است پیدا کند. این رفتار مشابه دستور \fBtail \-f\fR است، اما برای تبدیل DVI به PNG. .IP \fB\-\-freetype*\fR 4 .IX Item "--freetype*" فعال/غیرفعال کردن رندر قلم با FreeType (به‌طور پیش‌فرض فعال است). این گزینه در صورتی در دسترس است که کتابخانهٔ قلم FreeType2 در زمان کامپایل موجود بوده باشد. در این صورت، dvipng به جای استفاده از \fBgsftopk\fR برای رندر قلم‌ها، از قلم‌های PostScript Type1 و TrueType به‌طور مستقیم در ساختار داخلی خود پشتیبانی خواهد کرد. اگر نسخه‌های PostScript قلم Computer Modern را نصب داشته باشید، نیازی به تولید نسخه‌های بیت‌مپ (PK) آن‌ها روی دیسک نخواهد بود. سپس می‌توانید تصاویر را در تفکیک‌پذیری‌های مختلف (و غیرمعمول) بدون اشغال فضای دیسک با انبوهی از فونت‌های بیت‌مپ رندر کنید. یک دلیل برای غیرفعال کردن رندر قلم با FreeType، تولید خروجی یکسان در پلتفرم‌های مختلف است، زیرا FreeType از رندرکنندهٔ بومی سیستم‌عامل استفاده می‌کند و بنابراین ممکن است در هر پلتفرم خروجی کمی متفاوت ارائه دهد. .IP "\fB\-\-gamma\fR \fInum\fR" 4 .IX Item "--gamma num" کنترل درون‌یابی رنگ‌ها در پالت رنگی ناصافی‌زدایی (anti-aliasing) مقیاس خاکستری (greyscale). مقدار پیش‌فرض 1.0 است. به ازای 0 < \fInum\fR < 1، قلم‌ها روشن‌تر خواهند بود (بیشتر شبیه به رنگ پس‌زمینه)، و به ازای \fInum\fR > 1، قلم‌ها تیره‌تر خواهند بود (بیشتر شبیه به رنگ پیش‌زمینه). .IP \fB\-\-gif*\fR 4 .IX Item "--gif*" در صورتی که پشتیبانی از GIF فعال باشد، تصاویر در قالب GIF خروجی داده می‌شوند. این حالت پیش‌فرض برای باینری \fBdvigif\fR است که تنها در صورت فعال بودن پشتیبانی از GIF در دسترس خواهد بود. تصاویر GIF تصاویری مبتنی بر پالت هستند (گزینهٔ \fB\-\-palette\fR را ببینید) و از کانال‌های آلفای واقعی پشتیبانی نمی‌کنند (گزینهٔ \fB\-\-bg\fR را ببینید). همچنین گزینهٔ \fB\-\-png\fR را ببینید. .IP \fB\-\-height*\fR 4 .IX Item "--height*" گزارش ارتفاع تصویر. این گزینه تنها زمانی به طور قابل اعتماد کار می‌کند که استایل LaTeX با نام \fIpreview.sty\fR از بستهٔ preview-latex همراه با گزینهٔ \fBactive\fR استفاده شده باشد. این مقدار، تعداد پیکسل‌ها از بالای تصویر تا خط کرسی تصویر را گزارش می‌دهد. ارتفاع کل تصویر از مجموع مقادیر گزارش‌شده از \&\fB\-\-height\fR و \fB\-\-depth\fR به دست می‌آید. .IP "\fB\-l [=]\fR\fInum\fR" 4 .IX Item "-l [=]num" آخرین صفحهٔ چاپ‌شده نخستین صفحه‌ای خواهد بود که شمارهٔ آن \fInum\fR باشد. پیش‌فرض، آخرین صفحه در سند است. اگر در ابتدای \fInum\fR علامت مساوی قرار داده شود، آنگاه این مقدار (و آرگومان گزینهٔ \fB\-p\fR، در صورت تعیین شدن) به جای مقایسه با مقادیر \fB\ecount0\fR ذخیره‌شده در فایل DVI، به عنوان شماره صفحهٔ فیزیکی (مطلق) در نظر گرفته می‌شود. بنابراین، استفاده از \fB\-l =9\fR بدون توجه به شماره‌گذاری واقعی صفحات، به صفحهٔ نهم سند ختم خواهد شد. .IP "\fB\-\-mode\fR \fImode\fR" 4 .IX Item "--mode mode" این گزینه تنها هنگام استفاده از فونت‌های بیت‌مپ (PK) اثر دارد. استفاده از \&\fImode\fR به عنوان نام دستگاه Metafont برای فونت‌های PK (هم برای جستجوی مسیر و هم تولید فونت). این مقدار باید با تفکیک‌پذیری پایهٔ دستگاه که با گزینهٔ \fB\-\-bdpi\fR مشخص می‌شود تکمیل شود. برای دیدن فهرستی از تفکیک‌پذیری‌ها و نام‌های حالت برای بیشتر دستگاه‌ها، فایل <\fBftp://ftp.tug.org/tex/modes.mf\fR> را ببینید. .IP \fB\-M*\fR 4 .IX Item "-M*" این گزینه تنها هنگام استفاده از فونت‌های بیت‌مپ (PK) اثر دارد. این گزینه تولید خودکار فونت PK (\fImktexpk\fR) را غیرفعال می‌کند. .IP \fB\-\-nogs*\fR 4 .IX Item "--nogs*" این سوئیچ فراخوانی داخلی GhostScript را برای نمایش دستورات ویژهٔ (specials) PostScript ممنوع می‌کند. گزینهٔ \fB\-\-nogs0\fR این فراخوانی را مجدداً فعال می‌کند. .IP \fB\-\-nogssafer*\fR 4 .IX Item "--nogssafer*" به‌طور معمول، اگر از GhostScript برای رندر دستورات ویژهٔ PostScript استفاده شود، مفسر GhostScript با گزینهٔ \fB\-dSAFER\fR اجرا می‌شود. گزینهٔ \&\fB\-\-nogssafer\fR نرم‌افزار GhostScript را بدون \fB\-dSAFER\fR اجرا می‌کند. گزینهٔ \&\fB\-dSAFER\fR در Ghostscript عملگرهای PostScript نظیر deletefile را غیرفعال می‌کند تا از ایجاد هرگونه اثر نامطلوب توسط برنامه‌های بالقوه مخرب PostScript جلوگیری کند..IP \fB\-\-norawps*\fR 4 .IX Item "--norawps*" برخی بسته‌ها دستورهای ویژهٔ (specials) خام PostScript تولید می‌کنند، حتی دستورهای ویژه‌ای از این دست که رسم نمی‌شوند. این سوییچ فراخوانی درونی به GhostScript را که برای نمایش این دستورهای ویژهٔ خام PostScript در نظر گرفته شده است غیرفعال می‌کند. \fB\-\-norawps0\fR این فراخوانی را دوباره فعال می‌کند. .IP "\fB\-o\fR \fIname\fR" 4 .IX Item "-o name" ارسال خروجی به فایل \fIname\fR. یک بار رخداد \fR\f(CB%d\fR\fB\fR یا \&\fB\fR\f(CB%01d\fR\fB\fR، ...، \fB\fR\f(CB%09d\fR\fB\fR با شماره صفحهٔ فیزیکی جایگزین خواهد شد (این رفتار قابل تغییر است، سوییچ \fB\-\-dvinum\fR را ببینید). نام فایل خروجی پیش‌فرض \fIfile\fR\fB\fR\f(CB%d\fR\fB.png\fR است که در آن فایل DVI ورودی \fIfile\fR\fB.dvi\fR بوده است. .IP "\fB\-O\fR \fIx\-offset\fR\fB,\fR\fIy\-offset\fR" 4 .IX Item "-O x-offset,y-offset" مبدأ را به اندازهٔ \fIx\-offset\fR,\fIy\-offset\fR جابه‌جا می‌کند، که یک جفت بُعد جداشده با کاما مانند \fB.1in,\-.3cm\fR است. مبدأ صفحه به این اندازه از موقعیت پیش‌فرض (یک اینچ به سمت پایین، یک اینچ به سمت راست از گوشهٔ بالا-چپ کاغذ) جابه‌جا می‌شود. .IP "\fB\-p [=]\fR\fInum\fR" 4 .IX Item "-p [=]num" نخستین صفحهٔ چاپ‌شده، اولین صفحه‌ای خواهد بود که شمارهٔ آن \fInum\fR باشد. پیش‌فرض، نخستین صفحهٔ سند است. اگر پیشوندِ \fInum\fR یک علامت مساوی باشد، با آن (و در صورت تعیین، با آرگومان گزینهٔ \fB\-l\fR) به عنوان یک شماره صفحهٔ فیزیکی (مطلق) رفتار می‌شود، نه مقداری برای مقایسه با مقادیر \fB\ecount0\fR مربوط به TeX که در فایل DVI ذخیره شده است. بنابراین، استفاده از \fB\-p =3\fR، بدون توجه به این که شمارهٔ واقعی صفحات چیست، از سومین صفحهٔ سند آغاز خواهد کرد. .IP \fB\-\-palette*\fR 4 .IX Item "--palette*" هنگامی که یک تصویر خارجی اضافه می‌شود، \fBdvipng\fR به طور خودکار به حالت رنگ واقعی (truecolor) می‌رود تا از تأخیر غیرضروری و کاهش کیفیت جلوگیری کند، و به مترجم EPS امکان دهد روی پس‌زمینهٔ شفاف و خارج از کادر محصورکننده (boundingbox) نقاشی کند. این سوییچ خروجی را به حالت پالت (۲۵۶ رنگ) وامی‌دارد و باعث می‌شود \fBdvipng\fR به حالت گنجاندن تصویر ماتِ برش‌خورده بازگردد. همچنین این سوییچ در صورت وجود، سوییچ \fB\-\-truecolor\fR را لغو (override) می‌کند. .IP \fB\-\-picky*\fR 4 .IX Item "--picky*" هنگام وقوع هشدار، هیچ تصویری خروجی داده نمی‌شود. در حالت عادی، dvipng با وجود هشدار، تصویر را خروجی می‌دهد، اما ممکن است نقصی در این تصویر وجود داشته باشد. یک دلیل برای استفاده از این گزینه زمانی است که یک مبدل پشتیبانِ (fallback) کامل‌تر اما کندتر در اختیار داشته باشید. این گزینه عمدتاً برای گنجاندن‌های ناموفق تصاویر و رخدادهای ناشناختهٔ \especial کاربرد دارد، اما هشدارها برای مشخصات رنگیِ ناموجود یا ناشناخته و فونت‌های PK مفقود نیز رخ خواهند داد. .IP \fB\-\-png*\fR 4 .IX Item "--png*" تصاویر در قالب PNG خروجی داده می‌شوند. این حالت پیش‌فرض برای باینری \&\fBdvipng\fR است. همچنین گزینهٔ \fB\-\-gif\fR را ببینید. .IP "\fB\-pp\fR \fIfirstpage\fR\fB\-\fR\fIlastpage\fR" 4 .IX Item "-pp firstpage-lastpage" صفحات \fIfirstpage\fR تا \fIlastpage\fR را چاپ می‌کند؛ اما نه کاملاً معادل با \fB\-p\fR \fIfirstpage\fR \fB\-l\fR \fIlastpage\fR. برای نمونه، هنگام رندر کردن یک کتاب، ممکن است چندین مورد از یک شماره صفحه در فایل DVI وجود داشته باشد (یکی در \f(CW\*(C`\efrontmatter\*(C'\fR، یکی در \f(CW\*(C`\emainmatter\*(C'\fR و یکی در \f(CW\*(C`\ebackmatter\*(C'\fR). در صورت تطابق چند صفحه، \fB\-pp\fR \&\fIfirstpage\fR\fB\-\fR\fIlastpage\fR \fIهمهٔ\fR صفحاتی را که با محدودهٔ مشخص‌شده مطابقت دارند رندر می‌کند، در حالی که \fB\-p\fR \fIfirstpage\fR \fB\-l\fR \&\fIlastpage\fR صفحات را از \fIنخستین\fR رخدادِ \fIfirstpage\fR تا \fIنخستین\fR رخدادِ \fIlastpage\fR رندر خواهد کرد. این رفتار (مستندنشدهٔ) dvips است. در dvipng می‌توانید هر دو نوع گزینه را مشخص کنید، که در این حالت همهٔ صفحاتی را دریافت خواهید کرد که با محدودهٔ درون \fB\-pp\fR بین صفحاتِ \fB\-p\fR تا \fB\-l\fR مطابقت دارند. همچنین برخلاف \fB\-p\fR و \fB\-l\fR، چند گزینهٔ \fB\-pp\fR با یکدیگر تجمیع می‌شوند. جداکنندهٔ \fB\-\fR می‌تواند \fB:\fR نیز باشد. توجه داشته باشید که \fB\-pp \-1\fR به عنوان «همهٔ صفحات تا و خودِ ۱» تفسیر می‌شود؛ اگر صفحه‌ای با شمارهٔ \-1 را می‌خواهید (مثلاً تنها فهرست مطالب)، \fB\-pp \-1\-\-1\fR یا برای خوانایی بهتر، \fB\-pp \-1:\-1\fR را قرار دهید. .IP \fB\-q*\fR 4 .IX Item "-q*" اجرا در حالت ساکت. اطلاعاتی دربارهٔ صفحات تبدیل‌شده و غیره به خروجی استاندارد ارسال نمی‌کند؛ هیچ هشداری (فقط خطاها) را به خطای استاندارد گزارش نمی‌دهد. .IP "\fB\-Q\fR \fInum\fR" 4 .IX Item "-Q num" کیفیت را روی \fInum\fR تنظیم می‌کند. بدین معنا که تعداد سطوح هموارسازی (antialiasing) برای فونت‌های نقشه‌بیتی (PK) را به میزان \&\fInum\fR*\fInum\fR+1 انتخاب می‌کند. مقدار پیش‌فرض 4 است که 17 سطح هموارسازی برای فونت‌های هموارشده ارائه می‌دهد. در صورت در دسترس بودن FreeType، رندر آن تحت تأثیر این گزینه قرار نمی‌گیرد. .IP \fB\-r*\fR 4 .IX Item "-r*" تغییر وضعیت خروجی صفحات به ترتیب معکوس/مستقیم. به طور پیش‌فرض، نخستین صفحه در DVI ابتدا خروجی داده می‌شود. .IP \fB\-\-strict*\fR 4 .IX Item "--strict*" برنامه هنگام وقوع یک هشدار خارج می‌شود. در حالت عادی، dvipng با وجود هشدار تصویری خروجی می‌دهد، اما ممکن است نقصی در این تصویر وجود داشته باشد. یک دلیل برای استفاده از این گزینه زمانی است که یک تبدیل‌کنندهٔ پشتیبانِ کامل‌تر اما کندتر در اختیار داشته باشید. برای فهرستی از مواردی که هشدار رخ می‌دهد، گزینهٔ \fB\-\-picky\fR در بالا را ببینید. .IP "\fB\-T\fR \fIimage_size\fR" 4 .IX Item "-T image_size" اندازهٔ تصویر را روی \fIimage_size\fR تنظیم می‌کند که می‌تواند یکی از مقادیر \&\fBbbox\fR، \fBtight\fR، یا یک جفت بُعدِ جداشده با کاما به صورت \&\fIhsize\fR,\fIvsize\fR مانند \fB.1in,.3cm\fR باشد. مقدار پیش‌فرض \&\fBbbox\fR است که یک تصویر PNG تولید می‌کند شامل تمام جوهر درج‌شده روی صفحه و علاوه بر آن مبدأ DVI، واقع در 1 اینچی از بالا و 1 اینچی از لبهٔ چپ کاغذ. این حالت معمولاً در تصویر تولیدشده فضای خالی در بالا و سمت چپ ایجاد می‌کند. مقدار \fBtight\fR سبب می‌شود dvipng تنها جوهر درج‌شده روی صفحه را در بر گیرد و تصاویری جمع‌وجور و مرتب تولید کند. .IP \fB\-\-truecolor*\fR 4 .IX Item "--truecolor*" این سوییچ باعث می‌شود \fBdvipng\fR خروجی رنگ واقعی (truecolor) تولید کند. توجه داشته باشید که اگر یک تصویر خارجی را در DVI خود بگنجانید، مثلاً از طریق دستور ویژهٔ PostScript (یعنی بستهٔ \fBgraphics\fR یا \&\fBgraphicx\fR)، خروجیِ رنگ واقعی خودکار خواهد بود. این سوییچ توسط سوییچ \&\fB\-\-palette\fR لغو و نادیده گرفته می‌شود. .IP \fB\-v*\fR 4 .IX Item "-v*" فعال‌سازی عملیات پرگو (verbose). این گزینه در حال حاضر علاوه بر خروجی همیشگی، فونت‌های استفاده‌شده را نیز مشخص می‌کند. .IP \fB\-\-width*\fR 4 .IX Item "--width*" عرض تصویر را گزارش می‌کند. همچنین \fB\-\-height\fR و \&\fB\-\-depth\fR را ببینید. .IP "\fB\-x\fR \fInum\fR" 4 .IX Item "-x num" این گزینه منسوخ شده است و نباید استفاده شود. انتخاب مستقیم تفکیک‌پذیری خروجی با استفاده از گزینهٔ \fB\-D\fR بسیار بهتر است. این گزینه نسبت بزرگ‌نمایی را روی \fInum\fR/1000 تنظیم کرده و بزرگ‌نمایی مشخص‌شده در فایل DVI را لغو می‌کند. مقدار باید بین 10 و 100000 باشد. پیشنهاد می‌شود از مقادیر استاندارد magstep (مانند 1095، 1200، 1440، 1728، 2074، 2488، 2986 و غیره) استفاده کنید تا به کاهش تعداد کل فایل‌های PK تولیدشده کمک شود. برای افزایش دقت، \fInum\fR می‌تواند به جای عدد صحیح، یک عدد حقیقی باشد. .IP "\fB\-z\fR \fInum\fR" 4 .IX Item "-z num" سطح فشرده‌سازی PNG را روی \fInum\fR تنظیم می‌کند. اگر کتابخانهٔ \fBlibgd\fR شما به اندازهٔ کافی جدید باشد، این گزینه فعال است. سطح فشرده‌سازی پیش‌فرض 1 است، که بیشترین سرعت را به بهای ایجاد فایل‌های PNG کمی بزرگ‌تر انتخاب می‌کند. برای نسخه‌های قدیمی‌تر \fBlibgd\fR، مقدار ثابت 5 استفاده می‌شود. فایل سرآیند \&\fBpng.h\fR بیان می‌کند: «در حال حاضر مقادیر معتبر بین 0 تا 9 هستند، که مستقیماً متناظر با سطوح فشرده‌سازی 0 تا 9 در zlib می‌باشند (0 برای بدون فشرده‌سازی، 9 برای فشرده‌سازی «حداکثری»). توجه داشته باشید که آزمایش‌ها نشان داده‌اند سطوح فشرده‌سازی 3 تا 6 در zlib معمولاً برای تصاویر PNG به خوبی سطح 9 عمل می‌کنند و محاسبات بسیار کمتری انجام می‌دهند. در آینده ممکن است این مقادیر مستقیماً متناظر با سطوح فشرده‌سازی zlib نباشند.».SH "نکات (NOTES)" .IX Header "NOTES" راهنمای کامل در قالب info و در بیشتر سامانه‌ها با وارد کردن دستور زیر در دسترس است: .PP .Vb 1 \& info dvipng .Ve .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" این برنامه تحت مجوز GNU Lesser General Public License نگارش ۳ منتشر شده است؛ فایل COPYING در توزیع dvipng یا <\fBhttp://www.gnu.org/licenses/gpl.html\fR> را ببینید. .PP کپی‌رایت (c) 2002\-2015, 2019 متعلق به Jan-AAke Larsson