'\" t .\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "rsvg-convert" "1" "" "" "User Commands" .SH "نام (NAME)" rsvg-convert \- رندر کردن اسناد SVG به تصاویر PNG یا تبدیل آن‌ها به PDF یا PS .\" rsvg-convert(1): . .SH "خلاصه دستور (SYNOPSIS)" .sp تبدیل یک فایل SVG به PNG با «اندازه طبیعی» آن و نوشتن در خروجی استاندارد: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP .UNINDENT .UNINDENT .sp مشخص کردن نام فایل خروجی؛ نام فایل ورودی باید آخرین آرگومان باشد: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-output=\fP\fIoutput.png\fP \fIinput.svg\fP .UNINDENT .UNINDENT .sp تنظیم نقطه در اینچ (DPI) برای فایل‌های SVG دارای واحدهای فیزیکی، مانند \fB\fP \- پیش‌فرض 96 DPI است: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-dpi\-x=\fP\fI300\fP \fB\-\-dpi\-y=\fP\fI300\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP .UNINDENT .UNINDENT .sp رندر کردن SVG با اندازه پیکسلی مشخص، با حفظ تناسب تصویر: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-width=\fP\fI1024\fP \fB\-\-height=\fP\fI768\fP \fB\-\-keep\-aspect\-ratio\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBrsvg\-convert\fP اسناد SVG را به تصاویر شطرنجی (رستر) PNG رندر می‌کند یا آن‌ها را به عنوان اشیای برداری به PDF یا PS تبدیل می‌نماید. به صورت پیش‌فرض، \fBrsvg\-convert\fP سند SVG را به یک تصویر رستر PNG رندر کرده و در خروجی استاندارد می‌نویسد: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP .UNINDENT .UNINDENT .sp برای انتخاب قالبی دیگر، از گزینه \fB\-\-format\fP استفاده کنید: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert \-\-format=pdf\fP \fIinput.svg\fP \fB>\fP \fIoutput.pdf\fP .UNINDENT .UNINDENT .sp می‌توانید از \fBrsvg\-convert\fP به عنوان بخشی از یک خط لوله (پایپ‌لاین) استفاده کنید؛ بدون تعیین آرگومانی برای نام فایل ورودی، سند از ورودی استاندارد خوانده خواهد شد: .INDENT 0.0 .INDENT 3.5 \fBcat\fP \fIinput.svg\fP \fB|\fP \fBrsvg\-convert\fP \fB>\fP \fIoutput.png\fP .UNINDENT .UNINDENT .SS تعیین اندازه رندرشده .sp می‌توانید از گزینه‌های \fB\-\-width\fP و \fB\-\-height\fP برای مشخص کردن اندازه تصویر خروجی استفاده کنید. در بیشتر موارد باید گزینه \fB\-\-keep\-aspect\-ratio\fP را مشخص کنید تا مقیاس تصویر به صورت متناسب تغییر کند؛ جهت سازگاری با نگارش‌های قدیمی‌تر، این حالت پیش‌فرض نیست. .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-width=\fP\fI100\fP \fB\-\-height=\fP\fI200\fP \fB\-\-keep\-aspect\-ratio\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP .UNINDENT .UNINDENT .sp همچنین می‌توانید ابعاد را بر حسب طول‌های CSS مانند \fB10px\fP یا \fB8.5in\fP مشخص کنید. شناسه‌های یکای پشتیبانی‌شده عبارتند از: .INDENT 0.0 .INDENT 3.5 .TS box center; l|l. T{ px T} T{ پیکسل (شناسه یکا می‌تواند حذف شود) T} _ T{ in T} T{ اینچ T} _ T{ cm T} T{ سانتی‌متر T} _ T{ mm T} T{ میلی‌متر T} _ T{ pt T} T{ پوینت، 1/72 اینچ T} _ T{ pc T} T{ پایکا، 1/6 اینچ T} .TE .UNINDENT .UNINDENT .sp دستور زیر یک تصویر PNG به اندازه 600*900 پیکسل یا 2*3 اینچ با تراکم ۳۰۰ نقطه در اینچ تولید می‌کند: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-width=\fP\fI2in\fP \fB\-\-height=\fP\fI3in\fP \fB\-\-keep\-aspect\-ratio\fP \fB\-\-dpi\-x=\fP\fI300\fP \fB\-\-dpi\-y=\fP\fI300\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP .UNINDENT .UNINDENT .sp دستور زیر مقیاس سند SVG را برای گنجاندن در یک صفحه A4 تنظیم کرده و آن را به PDF تبدیل می‌کند: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-format=\fP\fIpdf\fP \fB\-\-width=\fP\fI210mm\fP \fB\-\-height=\fP\fI297mm\fP \fB\-\-keep\-aspect\-ratio\fP \fIinput.svg\fP \fB>\fP \fIoutput.pdf\fP .UNINDENT .UNINDENT .SS تعیین اندازه صفحه .sp به صورت پیش‌فرض، اندازه خروجی از روی اندازه رندرشده تعیین می‌شود که می‌توان آن را با گزینه‌های \fB\-\-width\fP و \fB\-\-height\fP مشخص کرد؛ اما شما می‌توانید اندازه صفحه را مستقل از اندازه رندرشده با استفاده از گزینه‌های \fB\-\-page\-width\fP و \fB\-\-page\-height\fP، به همراه \fB\-\-top\fP و \fB\-\-left\fP برای کنترل موقعیت تصویر رندرشده در صفحه مشخص کنید. به طور خلاصه: .INDENT 0.0 .IP \(bu 2 \fB\-\-page\-width\fP و \fB\-\-page\-height\fP با یکدیگر \- اندازه صفحه را تعیین می‌کنند. .IP \(bu 2 \fB\-\-top\fP و \fB\-\-left\fP \- حاشیه‌ها را تعیین می‌کنند. .IP \(bu 2 \fB\-\-width\fP و \fB\-\-height\fP \- اندازه رندرشده را تعیین می‌کنند. .UNINDENT .sp دستور زیر یک PDF در حالت افقی (landscape) با اندازه A4 می‌سازد، با تغییر مقیاس سند SVG به 10*10 سانتی‌متر و قرار دادن آن به طوری که گوشه بالا-چپ آن ۵ سانتی‌متر از بالای صفحه و ۸ سانتی‌متر از سمت چپ صفحه فاصله داشته باشد: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-format=\fP\fIpdf\fP \fB\-\-page\-width=\fP\fI297mm\fP \fB\-\-page\-height=\fP\fI210mm\fP \fB\-\-width=\fP\fI10cm\fP \fB\-\-height=\fP\fI10cm\fP \fB\-\-keep\-aspect\-ratio\fP \fB\-\-top=\fP\fI5cm\fP \fB\-\-left=\fP\fI8cm\fP \fIinput.svg\fP \fB>\fP \fIoutput.pdf\fP .UNINDENT .UNINDENT .SS تعیین ضریب مقیاس به جای اندازه رندرشده .sp گزینه \fB\-\-zoom\fP به شما امکان می‌دهد اندازه طبیعی یک سند SVG را تغییر مقیاس دهید. به عنوان مثال، اگر \fIinput.svg\fP سندی با اندازه اعلان‌شده 100*200 پیکسل باشد، دستور زیر آن را با ابعاد 250*500 پیکسل (بزرگ‌نمایی 2.5) رندر می‌کند: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-zoom=2.5\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP .UNINDENT .UNINDENT .sp می‌توانید حداکثر اندازه مقیاس‌شده را با تعیین گزینه‌های \fB\-\-width\fP و \fB\-\-height\fP همراه با \fB\-\-zoom\fP محدود کنید. در اینجا، مقیاس تصویر ۱۰ برابر می‌شود، اما حداکثر به ابعاد 1000*1000 پیکسل محدود خواهد شد: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-zoom=10\fP \fB\-\-width=1000\fP \fB\-\-height=1000\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP .UNINDENT .UNINDENT .sp اگر به ضرایب مقیاس متفاوتی برای ابعاد افقی و عمودی نیاز دارید، به جای \fB\-\-zoom\fP از گزینه‌های \fB\-\-x\-zoom\fP و \fB\-\-y\-zoom\fP استفاده کنید. .SS ایجاد سند چندصفحه‌ای .sp قالب‌های خروجی \(dqpdf\(dq، \(dqps\(dq و \(dqeps\(dq از چندین صفحه پشتیبانی می‌کنند. این اسناد می‌توانند با ترکیب چندین فایل ورودی SVG ایجاد شوند. به عنوان مثال، این فایل PDF سه صفحه خواهد داشت: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-format=\fP\fIpdf\fP \fIpage1.svg\fP \fIpage2.svg\fP \fIpage3.svg\fP \fB>\fP \fIout.pdf\fP .UNINDENT .UNINDENT .sp اندازه هر صفحه به صورت جداگانه، همان‌طور که در بخش \fBاندازه پیش‌فرض خروجی\fP شرح داده شده است، محاسبه می‌شود. این موضوع ممکن است منجر به تولید یک فایل PDF با صفحاتی با اندازه‌های متفاوت گردد. اگر لازم است فایلی PDF ایجاد کنید که تمام صفحات آن دقیقاً یک اندازه باشند، از گزینه‌های \fB\-\-page\-width\fP و \fB\-\-page\-height\fP استفاده کنید. .sp برای نمونه، دستور زیر یک فایل PDF سه‌صفحه‌ای از سه سند SVG تولید می‌کند. همه صفحات به صورت عمودی (portrait) در اندازه US Letter هستند و مقیاس هر SVG طوری تنظیم شده است که ۱ اینچ حاشیه در اطراف هر صفحه وجود داشته باشد (از این رو عرض 6.5 اینچ و ارتفاع 9 اینچ برای اندازه رندرشده در نظر گرفته شده است). .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-format=\fP\fIpdf\fP \fB\-\-page\-width=\fP\fI8.5in\fP \fB\-\-page\-height=\fP\fI11in\fP \fB\-\-width=\fP\fI6.5in\fP \fB\-\-height=\fP\fI9in\fP \fB\-\-keep\-aspect\-ratio\fP \fB\-\-top=\fP\fI1in\fP \fB\-\-left=\fP\fI1in\fP \fIpg1.svg\fP \fIpg2.svg\fP \fIpg3.svg\fP \fB>\fP \fIout.pdf\fP .UNINDENT .UNINDENT .SS تبدیل پیکسل‌ها بر اساس نقطه در اینچ (DPI) .sp دستور \fBrsvg\-convert\fP از گزینه‌های \fB\-\-dpi\-x\fP و \fB\-\-dpi\-y\fP برای پیکربندی نقطه در اینچ (DPI) استفاده می‌کند که بر اساس آن پیکسل‌ها به/از واحدهای فیزیکی مانند اینچ یا سانتی‌متر تبدیل می‌شوند. مقدار پیش‌فرض برای هر دو گزینه 96 DPI است. .sp این نمونه SVG را در نظر بگیرید که ابعاد اسمی آن 2*3 اینچ تعریف شده است: .INDENT 0.0 .INDENT 3.5 .sp .EX .EE .UNINDENT .UNINDENT .sp دستورات زیر برای نمونه SVG بالا تصاویر PNG با اندازه‌های مختلف تولید می‌کنند: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fItwo\-by\-three.svg\fP \fB>\fP \fIoutput.png\fP #### یک تصویر PNG با ابعاد 192*288 پیکسل می‌سازد .sp \fBrsvg\-convert\fP \fB\-\-dpi\-x=\fP\fI300\fP \fB\-\-dpi\-y=\fP\fI300\fP \fItwo\-by\-three.svg\fP \fB>\fP \fIoutput.png\fP #### یک تصویر PNG با ابعاد 600*900 پیکسل می‌سازد .UNINDENT .UNINDENT .sp توجه داشته باشید که ابعاد نهایی پیکسلی به نزدیک‌ترین پیکسل به سمت بالا گرد می‌شوند تا از بریده شدن لبه‌های راست و پایین جلوگیری شود. در مثال زیر، \fBrsvg\-convert\fP یک تصویر PNG با ابعاد 300x300 پیکسل تولید خواهد کرد: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-width=\fP\fI299.5\fP \fB\-\-height=\fP\fI299.4\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP #### خروجی تصویری ۳۰۰ در ۳۰۰ پیکسلی با مقیاس‌بندی کسری است .UNINDENT .UNINDENT .sp اگر ابعاد را با واحدهای فیزیکی مشخص کنید، در مقدار نقطه در اینچ (DPI) ضرب می‌شوند تا ابعاد بر حسب پیکسل به دست آیند. به عنوان مثال، دستور زیر یک PNG با ابعاد 96x96 پیکسل تولید می‌کند، زیرا ابعاد آن 1x1 اینچ با پیش‌فرض 96 DPI است: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-width=\fP\fI1in\fP \fB\-\-height=\fP\fI1in\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP #### خروجی تصویری ۹۶ در ۹۶ پیکسلی تولید می‌کند .UNINDENT .UNINDENT .sp به همین ترتیب، دستور زیر یک PNG با ابعاد 300x300 پیکسل ایجاد می‌کند، زیرا ابعاد آن 1x1 اینچ در تراکم 300 DPI است: .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-width=\fP\fI1in\fP \fB\-\-height=\fP\fI1in\fP \fB\-\-dpi\-x=\fP\fI300\fP \fB\-\-dpi\-y=\fP\fI300\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP #### خروجی تصویری ۳۰۰ در ۳۰۰ پیکسلی تولید می‌کند .UNINDENT .UNINDENT .SS اندازه پیش‌فرض خروجی .sp اگر گزینه‌های \fB\-\-width\fP یا \fB\-\-height\fP را برای اندازه خروجی مشخص نکنید، \fBrsvg\-convert\fP یک «اندازه طبیعی» برای SVG به صورت زیر تعیین می‌کند: .INDENT 0.0 .IP \(bu 2 \fBSVG با عرض و ارتفاع بر حسب پیکسل (px):\fP \fB\fP برای خروجی PNG، از همان ابعاد پیکسلی استفاده می‌شود. برای خروجی PDF/PS/EPS، این اندازه پیکسلی بر اساس مقدار DPI به واحدهای فیزیکی تبدیل می‌شود (گزینه‌های \fB\-\-dpi\-x\fP و \fB\-\-dpi\-y\fP را ببینید). .IP \(bu 2 \fBSVG با عرض و ارتفاع بر حسب واحدهای فیزیکی:\fP \fB\fP برای خروجی PNG، ویژگی‌های \fBwidth\fP و \fBheight\fP بر اساس مقدار DPI به پیکسل تبدیل می‌شوند (گزینه‌های \fB\-\-dpi\-x\fP و \fB\-\-dpi\-y\fP را ببینید). برای خروجی PDF/PS/EPS، عرض/ارتفاع در واحدهای فیزیکی، اندازه PDF را تعیین می‌کنند مگر اینکه گزینه‌هایی برای اندازه صفحه مشخص کنید؛ بخش \fBتعیین اندازه صفحه\fP در بالا را ببینید. .IP \(bu 2 \fBSVG فقط با viewBox:\fP \fB\fP اندازه ویژگی \fBviewBox\fP برای اندازه پیکسلی تصویر مشابه مورد اول در بالا استفاده می‌شود. .IP \(bu 2 \fBSVG با عرض و ارتفاع درصدی:\fP \fB\fP درصدها بی‌معنی هستند مگر اینکه اندازه درگاه دید (viewport) را با گزینه‌های \fB\-\-width\fP و \fB\-\-height\fP مشخص کنید. در غیاب آن‌ها، \fBrsvg\-convert\fP صرفاً از اندازه \fBviewBox\fP برای اندازه پیکسلی، مطابق توضیحات بالا استفاده خواهد کرد. .IP \(bu 2 \fBSVG بدون عرض، ارتفاع، یا viewBox:\fP دستور \fBrsvg\-convert\fP ابعاد تمام اشیای گرافیکی موجود در سند SVG را اندازه‌گیری کرده و آن‌ها را در مقیاس 1:1 رندر می‌کند (۱ پیکسل برای هر واحد CSS px). اکیداً توصیه می‌شود که با ویژگی‌های \fBwidth\fP، \fBheight\fP یا \fBviewBox\fP اندازه مشخصی به اسناد SVG اختصاص دهید. .UNINDENT .SS رنگ پس‌زمینه .sp می‌توانید از گزینه \fB\-\-background\-color\fP (به اختصار \fB\-b\fP) برای مشخص کردن رنگ پس‌زمینه‌ای که در بخش‌های شفاف تصویر ظاهر می‌شود استفاده کنید. این گزینه از همان قواعد نحوی ویژگی \fBcolor\fP در CSS پشتیبانی می‌کند؛ بنابراین می‌توانید از قالب‌های \fB#rrggbb\fP، نام‌های رنگی در CSS مانند \fBwhite\fP یا \fBrgba()\fP استفاده کنید. .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-background\-color=\fP\fIwhite\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP #### سفید مات .UNINDENT .UNINDENT .\" . .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-b\fP \fI\(aq#ff000080\(aq\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP #### قرمز نیمه‌شفاف \- استفاده از کوتیشن‌های شل تا کاراکتر # به عنوان کامنت تفسیر نشود .UNINDENT .UNINDENT .SS انتخاب زبان برای SVGهای چندزبانه .sp یک سند SVG می‌تواند از عنصر \fB\fP و فرزندان آن با ویژگی \fBsystemLanguage\fP برای ارائه محتوای مختلف بر اساس زبان کاربر استفاده کند. به عنوان مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX Español Deutsch Français English fallback .EE .UNINDENT .UNINDENT .sp می‌توانید از گزینه \fB\-\-accept\-language\fP برای انتخاب زبانی که هنگام رندر استفاده می‌شود بهره ببرید. این گزینه رشته‌هایی قالب‌بندی‌شده مشابه هدر HTTP Accept-Language را می‌پذیرد که فهرستی جداشده با کاما از تگ‌های زبان BCP47 است: \% .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-accept\-language=\fP\fIes\-MX\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP #### زبان اسپانیایی مکزیک را انتخاب کرده و عبارت \(dqEspañol\(dq را رندر می‌کند. .UNINDENT .UNINDENT .SS شیوه‌نامه کاربر (User Stylesheet) .sp می‌توانید یک شیوه‌نامه (استایل‌شیت) CSS اضافی را با گزینه \fB\-\-stylesheet\fP برای استفاده هنگام رندر کردن یک سند SVG ضمیمه کنید. این استایل‌شیت دارای منشأ کاربری در CSS (\fBuser origin\fP) خواهد بود، در حالی که استایل‌های تعریف‌شده در سند SVG دارای منشأ پدیدآورنده (\fBauthor origin\fP) خواهند بود. .INDENT 0.0 .INDENT 3.5 \fBrsvg\-convert\fP \fB\-\-stylesheet=\fP\fIextra\-styles.css\fP \fIinput.svg\fP \fB>\fP \fIoutput.png\fP .UNINDENT .UNINDENT .sp لطفاً توجه داشته باشید که طبق قوانین آبشاری CSS، یک استایل‌شیت کاربر لزوماً بر استایل‌های تعریف‌شده در یک سند SVG غلبه نمی‌کند. برای بازنویسی قطعی آن‌ها، باید استایل‌های اضافی خود را با \fB!important\fP تنظیم کنید. .sp مطابق با مشخصات آبشاری CSS (\fI\fP)، اعلان‌های استایل اولویت‌های زیر را دارند. اعلان‌ها از مبداهایی که دیرتر در فهرست آمده‌اند بر اعلان‌های مبداهای پیشین اولویت دارند: .INDENT 0.0 .IP \(bu 2 اعلان‌های عادی عامل کاربر (استایل‌شیت‌های خود librsvg). .IP \(bu 2 اعلان‌های عادی کاربر (از استایل‌شیت کاربری شما). .IP \(bu 2 اعلان‌های عادی پدیدآورنده (از سند SVG). .IP \(bu 2 اعلان‌های \fB!important\fP پدیدآورنده (از سند SVG). .IP \(bu 2 اعلان‌های \fB!important\fP کاربر (از استایل‌شیت کاربری شما). .IP \(bu 2 اعلان‌های \fB!important\fP عامل کاربر (استایل‌شیت‌های خود librsvg). .UNINDENT .sp پس از آن، ویژگی اختصاصی بودن (specificity) در CSS و ترتیب ظهور اعلان‌ها در نظر گرفته می‌شوند. .sp فایل \fIinput.svg\fP زیر را در نظر بگیرید؛ توجه کنید که مستطیل دارای صفت نمایشی \fBfill=\(dqred\(dq\fP و کلاس \fBrecolorable\fP است: .INDENT 0.0 .INDENT 3.5 .sp .EX Hello .EE .UNINDENT .UNINDENT .sp و این محتوای \fIextra\-styles.css\fP است: .INDENT 0.0 .INDENT 3.5 .sp .EX \&.recolorable { fill: blue !important; } text { fill: green !important; } .EE .UNINDENT .UNINDENT .sp در این حالت، تصویر PNG ایجاد شده توسط دستور فوق دارای این ویژگی‌ها خواهد بود: .INDENT 0.0 .IP \(bu 2 یک مربع آبی به جای قرمز، به دلیل انتخاب‌گر کلاس \fBrecolorable\fP. اعلان \fBfill: blue !important;\fP بر صفت نمایشی \fBfill=\(dqred\(dq\fP اولویت دارد. .IP \(bu 2 متن به رنگ سبز، زیرا صفت \fBfill=\(dqred\(dq\fP با \fIfill: green !important\fP بازنویسی می‌شود. .UNINDENT .SH "گزینه‌ها (OPTIONS)" .\" ## ATTENTION ## .\" .\" Below is the format for documenting an option: .\" .\" [``-``, ]``--``[ **] .\" .\" [] .\" [] .\" [] ... .\" .\" where: .\" .\" - *short-name* is the short option name, if it has one. .\" - *long-name* is the long option name (which is required). .\" - *value-name* is the name of the option's value, if it takes one. .\" If present, it must be a sequence of alphabetic characters, optionally .\" containing `-`, `.` or `_` (one at a time) **in-between** the letters. .\" - *main-description* is a (preferably brief) description of the option. .\" - *value-description* is a description of the option's value, if it takes .\" one. For an option with a fixed set of possible values, this segment is .\" required and **all** the values must be listed out (backquoted and .\" separated by ", ") as in "Possible values are ``foo``, ``bar``, ``baz``.". .\" - *default-description* is a description of the option's default value .\" (if it takes a value) or behaviour when not specified. This segment is .\" typically not neccesary for boolean/flag options. .\" - *extra-description* can be anything else such as further description, .\" "See ..." or description of interaction with another option. .\" This segment may be repeated as many times as neccessary. .\" - for ease of updating and parsing, each description segment must: .\" .\" - be a **single sentence** (ending with a `.`), with the exception of .\" *extra-description*. .\" - start on a new line, with the exception of subsequent .\" *extra-description*. .\" .\" - `<`, `>`, `[` and `]` in this format specification are not literal .\" i.e should not appear in an actual instance. .\" - any part of this format specification within `[ ]` is optional except .\" when stated otherwise. .\" .\" If any change is made to this format, please see to it that the .\" `ci/check-rsvg-convert-options` crate is updated accordingly, if neccesary. . .\" If any change is made to the options in this document, please run: .\" .\" $ cargo run -p ci --bin check-rsvg-convert-options .\" .\" and make the neccesary corrections, if there are any errors. . .\" The comment below is used as a marker by `ci/check-rsvg-convert-options`. .\" If the comment is modfied, please ensure the crate is updated accordingly. . .\" START OF OPTIONS . .SS گزینه‌های عمومی .INDENT 0.0 .TP .B \fB\-f\fP, \fB\-\-format\fP \fIformat\fP قالب خروجی سند رندرشده. مقادیر مجاز عبارتند از: \fBpng\fP, \fBpdf\fP, \fBpdf1.4\fP, \fBpdf1.5\fP, \fBpdf1.6\fP, \fBpdf1.7\fP, \fBps\fP, \fBeps\fP, \fBsvg\fP\&. پیش‌فرض \fBpng\fP است. برای جزئیات بیشتر درباره قابلیت‌های هر نگارش، بخش «نگارش‌های پی‌دی‌اف» را ببینید. .TP .B \fB\-o\fP, \fB\-\-output\fP \fIfilename\fP مشخص کردن نام فایل خروجی. در صورت عدم تعیین، در خروجی استاندارد نوشته می‌شود. .TP .B \fB\-v\fP, \fB\-\-version\fP نمایش نگارش فعال rsvg\-convert. .TP .B \fB\-?\fP, \fB\-\-help\fP نمایش خلاصه‌ای از نحوه استفاده و گزینه‌ها. .UNINDENT .SS اندازه و موقعیت .sp در موارد زیر، مقادیر \fIlength\fP باید با قواعد نحوی در CSS مشخص شوند: \%\&. برای نمونه، \fB640px\fP یا \fB25cm\fP\&. .INDENT 0.0 .TP .B \fB\-\-page\-width\fP \fIlength\fP عرض صفحه سند خروجی. پیش‌فرض استفاده از عرض تصویر است که توسط گزینه‌های زیر تغییر می‌کند. باید همراه با \fB\-\-page\-height\fP استفاده شود. .TP .B \fB\-\-page\-height\fP \fIlength\fP ارتفاع صفحه سند خروجی. پیش‌فرض استفاده از ارتفاع تصویر است که توسط گزینه‌های زیر تغییر می‌کند. باید همراه با \fB\-\-page\-width\fP استفاده شود. .TP .B \fB\-\-top\fP \fIlength\fP فاصله میان لبه بالایی صفحه و تصویر رندرشده. پیش‌فرض 0 است. .TP .B \fB\-\-left\fP \fIlength\fP فاصله میان لبه چپ صفحه و تصویر رندرشده. پیش‌فرض 0 است. .TP .B \fB\-w\fP, \fB\-\-width\fP \fIlength\fP عرض تصویر رندرشده. در صورت عدم تعیین، از عرض طبیعی تصویر استفاده می‌شود. برای جزئیات، بخش «تعیین اندازه رندرشده» در بالا را ببینید. .TP .B \fB\-h\fP, \fB\-\-height\fP \fIlength\fP ارتفاع تصویر رندرشده. در صورت عدم تعیین، از ارتفاع طبیعی تصویر استفاده می‌شود. برای جزئیات، بخش «تعیین اندازه رندرشده» در بالا را ببینید. .TP .B \fB\-a\fP, \fB\-\-keep\-aspect\-ratio\fP مشخص کردن حفظ نسبت ابعاد تصویر. در صورت عدم تعیین، نسبت ابعاد حفظ نخواهد شد. تصویر به صورت متناسب برای جای‌گیری در \fB\-\-width\fP و \fB\-\-height\fP مقیاس‌بندی می‌شود. .TP .B \fB\-d\fP, \fB\-\-dpi\-x\fP \fInumber\fP تنظیم وضوح افقی (X) تصویر بر حسب نقطه در اینچ (DPI). پیش‌فرض 96 DPI است. .TP .B \fB\-p\fP, \fB\-\-dpi\-y\fP \fInumber\fP تنظیم وضوح عمودی (Y) تصویر بر حسب نقطه در اینچ (DPI). پیش‌فرض 96 DPI است. .TP .B \fB\-x\fP, \fB\-\-x\-zoom\fP \fInumber\fP ضریب مقیاس‌بندی افقی. پیش‌فرض 1.0 است. .TP .B \fB\-y\fP, \fB\-\-y\-zoom\fP \fInumber\fP ضریب مقیاس‌بندی عمودی. پیش‌فرض 1.0 است. .TP .B \fB\-z\fP, \fB\-\-zoom\fP \fInumber\fP ضریب مقیاس‌بندی افقی و عمودی هم‌زمان. پیش‌فرض 1.0 است. .UNINDENT .SS کنترل ظاهر رندرشده .INDENT 0.0 .TP .B \fB\-b\fP, \fB\-\-background\-color\fP \fIcolor\fP مشخص کردن رنگ پس‌زمینه. مقدار \fIcolor\fP باید با قواعد نحوی در CSS مشخص شود: \%؛ به عنوان نمونه، \fBblack\fP، \fB#ff0000\fP، \fBrgba(0.0, 1.0, 0.0, 1.0)\fP\&. پیش‌فرض \fBnone\fP است؛ این حالت تصاویر PNG شفاف یا PDF/PS/EPS بدون پس‌زمینه خاص ایجاد می‌کند. .TP .B \fB\-s\fP, \fB\-\-stylesheet\fP \fIfilename.css\fP نام فایل یک شیوه‌نامه (استایل‌شیت) سفارشی CSS. .TP .B \fB\-l\fP, \fB\-\-accept\-language\fP \fIlanguage\-tags\fP مشخص کردن زبان‌های مورد استفاده برای اسناد SVG چندزبانه. این مقدار مانند هدر HTTP Accept\-Language قالب‌بندی می‌شود که فهرستی از تگ‌های زبان BCP47 با جداکننده کاما است: \% برای نمونه \fBes\-MX,fr,en\fP\&. پیش‌فرض استفاده از زبان مشخص‌شده توسط متغیرهای محیطی است؛ بخش «متغیرهای محیطی» را در زیر ببینید. .UNINDENT .SS گزینه‌های ویژه خروجی PDF/PS/EPS .INDENT 0.0 .TP .B \fB\-\-keep\-image\-data\fP برای اسناد SVG که به تصاویر PNG یا JPEG ارجاع می‌دهند، تصاویر فشرده اصلی در خروجی نهایی قرار می‌گیرند، نه داده‌های فشرده‌نشده RGB. این رفتار پیش‌فرض برای خروجی‌های PDF و (E)PS است. .TP .B \fB\-\-no\-keep\-image\-data\fP عدم گنجاندن تصاویر فشرده اصلی و در عوض جاسازی داده‌های فشرده‌نشده RGB در خروجی PDF یا (E)PS. این کار به احتمال زیاد منجر به اسناد بزرگ‌تری می‌شود که بارگذاری و خواندن آن‌ها کندتر است. .UNINDENT .SS متفرقه .INDENT 0.0 .TP .B \fB\-i\fP, \fB\-\-export\-id\fP \fIobject\-id\fP امکان مشخص کردن یک شیء SVG برای برون‌بری بر اساس صفت \fBid\fP در XML آن شیء. در صورت عدم تعیین، تمامی اشیا برون‌بری می‌شوند. .TP .B \fB\-u\fP, \fB\-\-unlimited\fP غیرفعال کردن محافظ‌های تجزیه‌گر XML. تجزیه‌گر XML دارای سازوکارهای حفاظتی برای مهار مصرف بیش از حد پردازنده یا حافظه در برابر اسناد مخرب است. همچنین ممکن است از تجزیه URIهای \fBdata:\fP که برای جاسازی داده‌های تصویری در اسناد SVG استفاده می‌شوند خودداری کند. در صورت برخورد با چنین مواردی هنگام تبدیل SVG، این گزینه امکان غیرفعال‌سازی این محافظ‌ها را می‌دهد. .TP .B \fB\-\-testing\fP صرفاً ویژه توسعه‌دهندگان: رندر کردن تصاویر برای آزمون‌های خودکار librsvg. .TP .B \fB\-\-completion\fP \fIshell\-name\fP تولید اسکریپت تکمیل خودکار تب (Tab completion) برای پوسته مشخص‌شده. مقادیر مجاز عبارتند از: \fBbash\fP, \fBelvish\fP, \fBfish\fP, \fBpowershell\fP, \fBzsh\fP\&. سپس Rsvg\-convert اسکریپت مناسب را در خروجی استاندارد می‌نویسد. .UNINDENT .\" END OF OPTIONS . .\" The comment above is used as a marker by `ci/check-rsvg-convert-options`. .\" If the comment is modfied, please ensure the crate is updated accordingly. . .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" .INDENT 0.0 .TP .B \fBSOURCE_DATE_EPOCH\fP اگر قالب خروجی انتخابی PDF باشد، می‌توان از این متغیر برای کنترل فیلد CreationDate در فایل PDF استفاده کرد. این قابلیت برای تولید خروجی‌های تکرارپذیر (reproducible) مفید است. این متغیر محیطی باید روی یک عدد ده‌دهی متناظر با برچسب زمانی یونیکس (تعداد ثانیه‌های سپری‌شده از 01 Jan 1970 00:00:00 UTC بدون احتساب ثانیه‌های کبیسه) تنظیم شود. مشخصات این استاندارد در نشانی زیر در دسترس است: \% .TP .B \fBSystem language\fP مگر در صورتی که گزینه \fB\-\-accept\-language\fP مشخص شده باشد، حالت پیش‌فرض استفاده از محیط سیستم برای تشخیص زبان ترجیحی کاربر است. این سازوکار متغیرهای محیطی \fBLANGUAGE\fP، \fBLC_ALL\fP، \fBLC_MESSAGES\fP و \fBLANG\fP را بررسی می‌کند. .UNINDENT .SH "نگارش‌های پی‌دی‌اف (PDF VERSIONS)" .sp گزینه \fB\-\-format=pdf\fP باعث می‌شود rsvg\-convert خروجی را با جدیدترین نگارش PDF پشتیبانی‌شده تولید کند. به طور معمول این روش استاندارد است، مگر اینکه از ابزارهایی استفاده کنید که فایل‌های PDF حاصل را مصرف می‌کنند اما فقط از نگارش‌های خاصی پشتیبانی می‌نمایند. .sp برای نمونه، ابزارهای LaTeX مانند pdflatex در صورتی که تصویری PDF با نگارشی جدیدتر از سند اصلی درج کنید، ممکن است هشداری مشابه زیر صادر نمایند: .INDENT 0.0 .INDENT 3.5 \fIPDF inclusion: found PDF version <1.7> but at most version <1.5> allowed\fP .UNINDENT .UNINDENT .sp در این حالت، ممکن است نیاز داشته باشید نگارش PDF تولیدی rsvg\-convert را محدود کنید. به جای \fB\-\-format=pdf\fP، می‌توانید از موارد زیر استفاده کنید: .INDENT 0.0 .TP .B \fB\-\-format=pdf1.4\fP از جریان‌های شیء PDF (object streams) استفاده نمی‌کند؛ فایل‌ها ممکن است بزرگ‌تر باشند زیرا فشرده‌سازی کمتری دارند. .TP .B \fB\-\-format=pdf1.5\fP امکان ایجاد فایل‌های PDF با قابلیت انتخاب و جستجوی متن را فراهم می‌کند. .TP .B \fB\-\-format=pdf1.6\fP بدون رفتار ویژه. .TP .B \fB\-\-format=pdf1.7\fP امکان گنجاندن مطمئن نام‌فایل‌های دارای نویسه‌های UTF\-8 در اشیای پیوند را فراهم می‌سازد. .UNINDENT .sp اگر از ابزارهای LaTeX استفاده می‌کنید، ممکن است بخواهید گزینه‌هایی مانند \fB\epdfminorversion=6\fP را بررسی نمایید. .SH "اطلاعات بیشتر (MORE INFORMATION)" .sp مخزن کد مبدأ و ردیاب اشکالات Librsvg: \% .sp صفحه پروژه در ویکی: \% .sp مشخصات SVG1.1: \% .sp مشخصات SVG2: \% .sp صفحه پروژه گنوم (GNOME): \% .\" End of generated man page.