INKSCAPE(1) Inkscape Commands Manual INKSCAPE(1)

Inkscape - برنامه‌ای برای ویرایش گرافیک برداری مقیاس‌پذیر (SVG).

"inkscape [options] [filename_1 filename_2 ...]"

گزینه‌ها:

    -?, --help
        --help-all
        --help-gapplication
        --help-gtk
    -V, --version
        --debug-info
        --system-data-directory
        --user-data-directory
    -p, --pipe
    -n, --pages=PAGE[,PAGE]
        --pdf-poppler
        --convert-dpi-method=METHOD
        --no-convert-text-baseline-spacing
    -o, --export-filename=FILENAME
        --export-overwrite
        --export-type=TYPE[,TYPE]*
        --export-extension=EXTENSION-ID
    -C, --export-area-page
    -D, --export-area-drawing
    -a, --export-area=x0:y0:x1:y1
        --export-area-snap
    -d, --export-dpi=DPI
    -w, --export-width=WIDTH
    -h, --export-height=HEIGHT
        --export-margin=MARGIN
        --export-page=all|n[,a-b]
    -i, --export-id=OBJECT-ID[;OBJECT-ID]*
    -j, --export-id-only
    -l, --export-plain-svg
        --export-png-color-mode=COLORMODE
        --export-png-compression=LEVEL
        --export-png-antialias=LEVEL
        --export-png-use-dithering=BOOLEAN
        --export-ps-level=LEVEL
        --export-pdf-version=VERSION
    -T, --export-text-to-path
        --export-latex
        --export-ignore-filters
    -t, --export-use-hints
    -b, --export-background=COLOR
    -y, --export-background-opacity=VALUE
    -I, --query-id=OBJECT-ID[,OBJECT-ID]*
    -S, --query-all
    -X, --query-x
    -Y, --query-y
    -W, --query-width
    -H, --query-height
        --vacuum-defs
        --select=OBJECT-ID[,OBJECT-ID]*
        --actions=ACTION(:ARG)[;ACTION(:ARG)]*
        --action-list
        --actions-file=FILENAME
    -g, --with-gui
    -q, --active-window
        --display=DISPLAY
        --app-id-tag=TAG
        --batch-process
        --shell
Inkscape یک ویرایشگر گرافیک برداری آزاد و متن‌باز است. این برنامه مجموعه‌ای غنی از ویژگی‌ها را ارائه می‌دهد و به طور گسترده برای تصویرسازی‌های هنری و فنی مانند کارتون‌ها، کلیپ‌آرت‌ها، نمادها، تایپوگرافی، رسم نمودارها و فلوچارت‌ها استفاده می‌شود.
این ابزار از گرافیک برداری برای ارائه چاپ‌ها و رندرهای دقیق و واضح در تفکیک‌پذیری‌های (رزولوشن) نامحدود بهره می‌برد و برخلاف گرافیک‌های شطرنجی (رستری)، محدود به تعداد ثابتی از پیکسل‌ها نیست. Inkscape از قالب استاندارد پرونده SVG به عنوان قالب اصلی خود استفاده می‌کند که توسط بسیاری از برنامه‌های دیگر از جمله مرورگرهای وب نیز پشتیبانی می‌شود.
رابط کاربری این نرم‌افزار به شکلی طراحی شده است که برای کاربران ماهر راحت و کارآمد باشد و در عین حال با استانداردهای GNOME سازگار بماند تا کاربرانی که با سایر برنامه‌های GNOME آشنا هستند بتوانند کار با رابط آن را به سرعت بیاموزند.
SVG یک قالب استاندارد W3C بر پایه XML برای ترسیم برداری دوبعدی است. این قالب امکان تعریف اشیاء در ترسیم را با استفاده از نقاط، مسیرها و اشکال اولیه فراهم می‌آورد. رنگ‌ها، قلم‌ها، پهنای خط دور (stroke) و موارد دیگر به عنوان مشخصه‌های `style' برای این اشیاء تعیین می‌شوند. هدف این است که چون SVG یک استاندارد است و پرونده‌های آن از نوع text/xml هستند، استفاده از پرونده‌های SVG در شمار زیادی از برنامه‌ها و برای طیف گسترده‌ای از کاربردها میسر باشد.
Inkscape از SVG به عنوان قالب بومی اسناد خود استفاده می‌کند و این هدف را دنبال می‌کند که به سازگارترین برنامه ترسیم برای پرونده‌های SVG در جامعه متن‌باز بدل شود.

-?, --help
نمایش یک پیام راهنما.
نمایش تمام گزینه‌های راهنما.
نمایش گزینه‌های GApplication.
نمایش گزینه‌های +GTK.
نمایش نسخه Inkscape و تاریخ ساخت آن.
چاپ اطلاعات فنی شامل نسخه Inkscape، نسخه‌های وابستگی‌ها و سیستم‌عامل. این اطلاعات هنگام اشکال‌زدایی مسائل Inkscape مفید است و باید در هنگام ارسال گزارش باگ گنجانده شود.
چاپ دایرکتوری داده‌های سیستم که پرونده‌های داده همراه Inkscape در آن ذخیره می‌شوند. این موارد شامل پرونده‌هایی است که Inkscape برای اجرا به آن‌ها نیاز دارد (مانند تعاریف واحدها، نگاشت کلیدهای توکار، پرونده‌های توصیف چیدمان رابط کاربری، تم‌های نقشک و غیره)، افزونه‌های اصلی، منابع پیش‌فرض (فیلترها، قلم‌ها، نشانگرها، پالت‌های رنگ، نمادها، الگوها) و مستندات (پرونده‌های نمونه SVG و آموزش‌ها).

مسیری را که Inkscape برای دایرکتوری داده‌های سیستم انتظار دارد می‌توان با متغیر محیطی INKSCAPE_DATADIR بازنویسی کرد.

چاپ دایرکتوری نمایه کاربر که پرونده‌های داده مخصوص کاربر و ترجیحات در آن ذخیره می‌شوند. افزونه‌ها و منابع سفارشی (فیلترها، قلم‌ها، نشانگرها، پالت‌های رنگ، نمادها، الگوها) باید در زیردایرکتوری‌های مربوط به خود در این دایرکتوری نصب شوند. علاوه بر این، قرار دادن پرونده‌ای با نام یکسان با یکی از پرونده‌های دایرکتوری داده‌های سیستم در اینجا، امکان بازنویسی اکثر پیش‌تنظیم‌های دایرکتوری داده‌های سیستم (مانند الگوهای پیش‌فرض، پرونده‌های رابط کاربری و غیره) را فراهم می‌آورد.

مسیر پیش‌فرض دایرکتوری نمایه را می‌توان با متغیر محیطی INKSCAPE_PROFILE_DIR بازنویسی کرد.

خواندن پرونده ورودی از ورودی استاندارد (stdin).
درون‌ریزی فهرست صفحه‌های مشخص‌شده با کاما از یک پرونده PDF یا یک پرونده SVG چندصفحه‌ای.

این گزینه جایگزین --pdf-page در نسخه‌های قبلی Inkscape است.

به طور پیش‌فرض Inkscape پرونده‌های PDF را از طریق یک کتابخانه داخلی (مشتق‌شده از poppler) درون‌ریزی می‌کند. متن به عنوان متن ذخیره می‌شود. مش‌ها (شبکه‌ها) به کاشی‌ها تبدیل می‌شوند. برای درون‌ریزی از طریق یک کتابخانه خارجی (poppler با بک‌اند cairo) از --pdf-poppler استفاده کنید. در این حالت متن شامل گروه‌های حاوی گلیف‌های همزادشده است که در آن هر گلیف یک مسیر است. تصاویر به صورت داخلی ذخیره می‌شوند. مش‌ها باعث می‌شوند کل سند به صورت یک تصویر شطرنجی رندر شود.
انتخاب روش مورد استفاده برای مقیاس‌بندی مجدد پرونده‌های قدیمی (پیش از ۰.۹۲) که به دلیل تغییر از 90 DPI به 96 DPI در تفسیر اندازه‌های بیان‌شده با واحد پیکسل، کمی کوچک‌تر رندر می‌شوند. مقادیر ممکن عبارتند از: "none" (بدون تغییر، سند با ۹۴٪ اندازه اصلی خود رندر می‌شود)، "scale-viewbox" (سند به صورت سراسری مقیاس‌بندی می‌شود و اندازه‌های منفرد دست‌نخورده باقی می‌مانند) و "scale-document" (هر اندازه به صورت جداگانه باز مقیاس‌بندی می‌شود).
عدم اصلاح خودکار خط مبنای متن‌ها در پرونده‌های قدیمی (پیش از ۰.۹۲) هنگام باز کردن. نگارش 0.92 از Inkscape تعریف استاندارد CSS را برای مشخصه 'line-height' در پیش می‌گیرد که با نگارش‌های پیشین متفاوت است. به طور پیش‌فرض، مقادیر ارتفاع خط در پرونده‌های ایجاد شده قبل از Inkscape 0.92 در هنگام بارگذاری تنظیم می‌شوند تا چیدمان مورد نظر متن حفظ شود. این گزینه خط فرمان از آن تنظیم چشم‌پوشی می‌کند.
تنظیم نام پرونده خروجی. مقدار پیش‌فرض استفاده دوباره از نام پرونده ورودی است. اگر --export-type نیز استفاده شده باشد، پسوند پرونده به شکل مناسب اصلاح (یا افزوده) خواهد شد. در غیر این صورت، نوع پرونده برای برون‌بری از پسوند نام پرونده مشخص‌شده استنباط می‌شود.

استفاده از نام پرونده خاص "-" باعث می‌شود Inkscape داده‌های تصویر را در خروجی استاندارد (stdout) بنویسد.

رونویسی روی پرونده ورودی.
تعیین نوع پرونده برای برون‌بری. مقادیر ممکن: svg، png، ps، eps، pdf، emf، wmf و هر نوع پرونده‌ای که برای آن یک افزونه برون‌بری وجود داشته باشد. امکان برون‌بری بیش از یک نوع پرونده در یک زمان وجود دارد.

توجه داشته باشید که PostScript از شفافیت پشتیبانی نمی‌کند، بنابراین هر شیء شفاف در SVG اصلی به صورت خودکار شطرنجی‌سازی (رستریزه) می‌شود. قلم‌های استفاده‌شده زیرمجموعه‌گیری شده و جاسازی می‌شوند. محدوده پیش‌فرض برون‌بری، صفحه است؛ می‌توانید آن را با --export-area-drawing به ترسیم تغییر دهید.

توجه داشته باشید که قالب PDF شفافیت موجود در SVG اصلی را حفظ می‌کند.

امکان تعیین یک افزونه خروجی را که برای برون‌بری استفاده خواهد شد فراهم می‌کند؛ این موضوع به ویژه زمانی اهمیت دارد که بیش از یک گزینه برون‌بری برای یک نوع پرونده مشخص وجود داشته باشد. در صورت تنظیم، پسوند پرونده در --export-filename و --export-type می‌تواند نادیده گرفته شود. علاوه بر این، در صورت تنظیم، تنها یک نوع پرونده می‌تواند در --export-type مشخص شود.
در برون‌بری SVG، PNG، PDF و PS، ناحیه برون‌بری‌شده برابر با صفحه است. این حالت پیش‌فرض برای SVG، PNG، PDF و PS است، بنابراین نیازی به مشخص کردن آن ندارید مگر اینکه از --export-id برای برون‌بری یک شیء خاص استفاده کنید. این گزینه برای EPS در حال حاضر پشتیبانی نمی‌شود.
در برون‌بری SVG، PNG، PDF، PS و EPS، ناحیه برون‌بری‌شده کل ترسیم است (نه صفحه)، یعنی کادر مرزی (bounding box) تمام اشیاء سند (یا شیء برون‌بری‌شده در صورت استفاده از --export-id). با این گزینه، تصویر برون‌بری‌شده تمامی اشیاء قابل مشاهده سند را بدون حاشیه‌ها یا برش نمایش می‌دهد. این محدوده پیش‌فرض برای EPS است. برای PNG، می‌توان آن را همراه با --export-use-hints به کار برد.
در برون‌بری PNG، ناحیه برون‌بری‌شده از سند را تنظیم می‌کند که بر حسب پیکسل (1/96 اینچ) مشخص می‌شود. پیش‌فرض، برون‌بری کل صفحه سند است. نقطه (0,0) گوشه پایین سمت چپ است.
برای برون‌بری PNG، ناحیه خروجی را به سمت بیرون به نزدیک‌ترین مقادیر عدد صحیح px می‌چسباند (snap). اگر از تفکیک‌پذیری پیش‌فرض برون‌بری 96 dpi استفاده می‌کنید و طرح‌های گرافیکی شما برای به حداقل رساندن شکستگی خطوط (antialiasing) با پیکسل‌ها تراز شده‌اند، این گزینه اجازه می‌دهد این تراز را حفظ کنید، حتی اگر در حال برون‌بری کادر مرزی شیئی باشید (با --export-id یا --export-area-drawing) که خودش تراز پیکسلی ندارد.
تفکیک‌پذیری مورد استفاده برای برون‌بری PNG. همچنین برای شطرنجی‌سازی جایگزین اشیاء دارای فیلتر هنگام برون‌بری به PS، EPS یا PDF استفاده می‌شود (مگر اینکه از --export-ignore-filters برای جلوگیری از شطرنجی‌سازی استفاده کنید). مقدار پیش‌فرض 96 dpi است که با برون‌بری ۱ واحد کاربر SVG (px، که «user unit» نیز نامیده می‌شود) به ۱ پیکسل نقشه بیتی (bitmap) مطابقت دارد. این مقدار در صورت استفاده با --export-use-hints، اشاره‌گر DPI را لغو می‌کند.
عرض نقشه بیتی تولیدشده بر حسب پیکسل. این مقدار تنظیم --export-dpi (یا اشاره‌گر DPI در صورت استفاده هم‌زمان با --export-use-hints) را لغو می‌کند.
ارتفاع نقشه بیتی تولیدشده بر حسب پیکسل. این مقدار تنظیم --export-dpi (یا اشاره‌گر DPI در صورت استفاده هم‌زمان با --export-use-hints) را لغو می‌کند.
یک حاشیه در اطراف ناحیه برون‌بری‌شده اضافه می‌کند. اندازه حاشیه بر حسب واحدهای اندازه صفحه (برای SVG) یا میلی‌متر (برای PS/PDF) تعیین می‌شود. این گزینه در حال حاضر روی سایر قالب‌های برون‌بری تأثیری ندارد.
فقط صفحه‌های انتخاب‌شده را برون‌بری می‌کند. در صورتی که بیش از یک صفحه تعیین شده باشد و قالب خروجی نیز از آن پشتیبانی کند، سند حاصل ممکن است حاوی چندین صفحه باشد.

مقدار می‌تواند فهرستی از شماره‌های صفحه جدا شده با کاما، یا بازه‌هایی از صفحات شامل دو عدد جدا شده با خط پیوند باشد. می‌توان از کلیدواژه 'all' برای اشاره به برون‌بری همه صفحات استفاده کرد..IP "-i ID, --export-id=OBJECT-ID[;OBJECT-ID]*" 8 برای برون‌بری PNG، PS، EPS، PDF و SVG ساده، مقدار ویژگی id شیء (یا اشیایی) است که می‌خواهید از سند برون‌بری شوند؛ سایر اشیاء برون‌بری نمی‌شوند. به‌طور پیش‌فرض، ناحیه برون‌بری‌شده کادر احاطه‌کننده (bounding box) شیء است؛ می‌توانید این را با استفاده از --export-area (تنها برای PNG) یا --export-area-page بازنویسی کنید.

اگر مقادیر متعددی را در فهرستی از اشیاء که با نقطه-ویرگول (semicolon) جدا شده‌اند مشخص کنید، هر یک به‌طور جداگانه برون‌بری خواهند شد. در این حالت پرونده‌های برون‌بری‌شده بدین شکل نام‌گذاری می‌شوند: [input_filename]_[ID].[export_type]

برای برون‌بری PNG، PS، EPS، PDF و SVG ساده، تنها شیئی را برون‌بری می‌کند که شناسه (id) آن در --export-id مشخص شده است. تمام اشیاء دیگر پنهان شده و حتی در صورت هم‌پوشانی با شیء برون‌بری‌شده، در خروجی نمایش داده نخواهند شد. بدون --export-id، این گزینه نادیده گرفته می‌شود.
برون‌بری سند(ها) به قالب SVG ساده، بدون فضانام‌های sodipodi: یا inkscape: و بدون فراداده‌های RDF. از گزینه --export-filename برای مشخص کردن نام پرونده استفاده کنید.
تنظیم حالت رنگ (عمق بیتی و نوع رنگ) برای بیت‌مپ‌های برون‌بری‌شده (Gray_1/Gray_2/Gray_4/Gray_8/Gray_16/RGB_8/RGB_16/GrayAlpha_8/GrayAlpha_16/RGBA_8/RGBA_16).
تنظیم سطح فشرده‌سازی برای برون‌بری PNG (بین ۰ تا ۹)؛ مقدار پیش‌فرض ۶ است.
تنظیم سطح ضدپله‌ای‌شدن (antialiasing) برای برون‌بری PNG (بین ۰ تا ۳)؛ مقدار پیش‌فرض ۲ است.
اجبار به ایجاد ترام (dithering) یا غیرفعال کردن آن (برای این کار، ساختار کامپایل‌شدهٔ Inkscape باید از ترام پشتیبانی کند).
تنظیم نسخه زبان برای برون‌بری PS و EPS. سطح ۲ یا ۳ PostScript پشتیبانی می‌شود. پیش‌فرض ۳ است.
انتخاب نسخه PDF برای پرونده PDF برون‌بری‌شده. این گزینه اساساً همان انتخاب‌گر نسخه PDF موجود در پنجره گفتگوی برون‌بری PDF در واسط گرافیکی (GUI) را در دسترس قرار می‌دهد. باید یکی از نسخه‌های موجود در آن جعبه کشویی را مشخص کنید، مثلاً “1.4”. نسخه پیش‌فرض برون‌بری PDF مقدار “1.4” است.
تبدیل اشیاء متنی به مسیر (path) هنگام برون‌بری، در صورت امکان (برای برون‌بری PS، EPS، PDF و SVG).
(برای برون‌بری PS، EPS، و PDF) جهت ایجاد تصاویر برای اسناد LaTeX استفاده می‌شود، به‌گونه‌ای که متن تصویر توسط LaTeX حروف‌چینی شود. هنگام برون‌بری به قالب PDF/PS/EPS، این گزینه خروجی را به یک پرونده PDF/PS/EPS (مثلاً طبق آنچه توسط --export-type مشخص شده) و یک پرونده LaTeX تقسیم می‌کند. متن در پرونده PDF/PS/EPS درج نمی‌شود، بلکه در پرونده LaTeX ظاهر خواهد شد. این پرونده LaTeX پرونده PDF/PS/EPS را در بر می‌گیرد. با فراخوانی (\input{image.tex}) پرونده LaTeX در سند LaTeX خود، تصویر نمایش داده شده و تمام متن‌ها توسط LaTeX حروف‌چینی می‌شوند. برای اطلاعات بیشتر پرونده نهایی LaTeX را بررسی کنید. همچنین ترمینال خروجی `epslatex' در GNUPlot را ببینید.
برون‌بری اشیاء دارای فیلتر (مانند اشیاء دارای تاری یا blur) به‌صورت برداری، با نادیده گرفتن فیلترها (برای برون‌بری PS، EPS، و PDF). به‌طور پیش‌فرض، تمام اشیاء دارای فیلتر در میزان --export-dpi (پیش‌فرض ۹۶ dpi) به تصویر شطرنجی (رستریزه) تبدیل می‌شوند تا ظاهر آن‌ها حفظ شود.
هنگام برون‌بری به PNG، از راهنماهای (hints) نام پرونده و DPI ذخیره‌شده در شیء برون‌بری‌شده استفاده می‌کند (تنها همراه با --export-id). این راهنماها هنگام برون‌بری بخش انتخاب‌شده از درون Inkscape به‌طور خودکار تنظیم می‌شوند. بنابراین برای مثال، اگر شکلی با "id="path231 را به‌عنوان /home/me/shape.png با وضوح 300 dpi از سند document.svg با استفاده از واسط گرافیکی Inkscape برون‌بری کرده و سند را ذخیره کنید، بعداً می‌توانید آن شکل را به‌سادگی با همان پرونده و همان وضوح مجدداً برون‌بری کنید: 
inkscape -i path231 -t document.svg

اگر همراه با این گزینه از --export-dpi، --export-width، یا --export-height استفاده کنید، راهنمای DPI نادیده گرفته شده و مقدار ارائه‌شده در خط فرمان اعمال می‌شود. اگر همراه با این گزینه از --export-filename استفاده کنید، راهنمای نام پرونده نادیده گرفته شده و نام پرونده خط فرمان اعمال خواهد شد.

رنگ پس‌زمینه PNG برون‌بری‌شده. این مقدار می‌تواند هر رشته رنگ معتبر و پشتیبانی‌شده در SVG باشد، مانند "#ff007f" یا "rgb(255, 0, 128)". در صورت عدم تنظیم، رنگ صفحه تعیین‌شده در پنجره خصوصیات سند (Document Properties) در Inkscape به کار خواهد رفت (ذخیره‌شده در ویژگی =pagecolor از sodipodi:namedview).
کدری (شفافیت معکوس یا Opacity) پس‌زمینه PNG برون‌بری‌شده. این مقدار می‌تواند بین 0.0 و 1.0 (0.0 به معنای شفافیت کامل و 1.0 کدر بودن کامل) یا عددی بزرگ‌تر از ۱ تا ۲۵۵ باشد (۲۵۵ به معنای کدر بودن کامل). اگر تنظیم نشود و گزینه -b نیز استفاده نشده باشد، کدری صفحه تعیین‌شده در پنجره Document Properties در Inkscape استفاده خواهد شد (ذخیره‌شده در ویژگی =inkscape:pageopacity از sodipodi:namedview). اگر تنظیم نشود اما گزینه -b استفاده شده باشد، مقدار ۲۵۵ (کدری کامل) اعمال خواهد شد.
تنظیم شناسه(های) شیء یا اشیایی که ابعاد آن‌ها مورد پرس‌وجو قرار می‌گیرد در یک فهرست جداشده با کاما. اگر تنظیم نشود، گزینه‌های پرس‌وجو ابعاد کل طرح (یعنی تمام اشیاء سند) را بازمی‌گردانند، نه صفحه یا viewbox را.

اگر مقادیر متعددی را در فهرستی جداشده با کاما از اشیاء مشخص کنید، هر پرس‌وجوی هندسی (مانند --query-x) فهرستی از مقادیر جداشده با کاما متناظر با فهرست اشیاء در --query-id را بازمی‌گرداند.

فهرستی جداشده با کاما از تمام اشیاء دارای شناسه (ID) تعریف‌شده در سند SVG را همراه با مقادیر x، y، پهنا (width) و بلندی (height) آن‌ها چاپ می‌کند.
پرس‌وجوی مختصات X کل طرح، یا شیء مشخص‌شده با --query-id. مقدار بازگشتی بر حسب px (واحدهای کاربر SVG) است.
پرس‌وجوی مختصات Y کل طرح، یا شیء مشخص‌شده با --query-id. مقدار بازگشتی بر حسب px (واحدهای کاربر SVG) است.
پرس‌وجوی پهنای طرح، یا شیء مشخص‌شده با --query-id. مقدار بازگشتی بر حسب px (واحدهای کاربر SVG) است.
پرس‌وجوی بلندی (ارتفاع) طرح، یا شیء مشخص‌شده با --query-id. مقدار بازگشتی بر حسب px (واحدهای کاربر SVG) است.
حذف تمام موارد استفاده‌نشده از بخش "<defs>" پرونده SVG. اگر این گزینه به همراه --export-plain-svg فراخوانی شود، تنها پرونده برون‌بری‌شده تغییر خواهد کرد. در صورت استفاده به‌تنهایی، پرونده مشخص‌شده به‌صورت درجا ویرایش می‌شود.
دستور --select باعث انتخاب اشیایی می‌شود که شناسه آن‌ها مشخص شده است. می‌توانید چندین شیء را با یک فهرست جداشده با کاما انتخاب کنید. این کار امکان اعمال فعل‌های (verbs) گوناگون بر روی آن‌ها را فراهم می‌کند. برای لغو تمامی انتخاب‌ها از "--verb=EditDeselect" استفاده کنید. شناسه‌های اشیاء موجود وابسته به سندی هستند که برای بارگیری مشخص شده است.
کنش‌ها (Actions) روش جدیدی برای فراخوانی توابع با یک پارامتر اختیاری یکتا هستند. برای دریافت فهرستی از شناسه‌های کنش‌های موجود، از گزینه خط فرمان --action-list استفاده کنید. در آینده تمامی فعل‌ها (verbs) با کنش‌ها جایگزین خواهند شد. موقتاً هر فعلی می‌تواند به‌عنوان یک کنش (بدون پارامتر) استفاده شود. توجه داشته باشید که اکثر فعل‌ها به یک رابط گرافیکی کاربر (GUI) نیاز دارند (حتی اگر عملاً از آن استفاده نکنند). برای بستن خودکار GUI در پایان پردازش، از --batch-process استفاده کنید. علاوه بر این، تمامی گزینه‌های برون‌بری دارای کنش‌های متناظر هستند (با حذف '--' از ابتدای گزینه و جایگزینی '=' با ':').

اگر فقط از کنش‌ها استفاده شود، گزینه --batch-process باید حتماً به کار برده شود.

برون‌بری را می‌توان در هر لحظه با کنش export-do اجبار کرد. این ویژگی امکان برون‌بری‌های متعدد روی یک پرونده منفرد را ممکن می‌سازد.

فهرستی از تمام کنش‌های موجود را چاپ می‌کند.
اجرای تمامی کنش‌های فهرست‌شده در پرونده. محتوای پرونده باید مطابق با نحو دستور --actions قالب‌بندی شده باشد. این گزینه در صورت وجود هم‌زمان، بر آرگومان --actions اولویت دارد.
تلاش برای استفاده از واسط گرافیکی کاربر (در یونیکس، استفاده از سرور X حتی اگر متغیر محیطی $DISPLAY تنظیم نشده باشد).
به‌جای راه‌اندازی یک فرایند جدید برای Inkscape، دستور را در سندی از Inkscape اجرا می‌کند که اخیراً دارای فوکوس بوده است.
نمایشگر X مورد استفاده برای پنجره Inkscape را تنظیم می‌کند.
یک نمونه یکتا از Inkscape با شناسه برنامه 'org.inkscape.Inkscape.TAG' ایجاد می‌کند. این گزینه برای جداسازی نمونه‌های مختلف Inkscape در زمان اجرای هم‌زمان نسخه‌های متفاوت یا استفاده از پرونده‌های ترجیحات گوناگون مفید است.
بستن واسط گرافیکی کاربر (GUI) پس از اجرای تمامی کنش‌ها یا فعل‌ها..IP --shell 8 با این پارامتر، Inkscape وارد حالت پوستهٔ تعاملی خط فرمان خواهد شد. در این حالت، دستورها را در اعلان (prompt) وارد می‌کنید و Inkscape بدون نیاز به اجرای یک نسخهٔ جدید از برنامه برای هر دستور، آن‌ها را اجرا می‌کند. این ویژگی بیش از همه برای اسکریپت‌نویسی و کاربردهای سرور مفید است: قابلیت جدیدی اضافه نمی‌کند، اما به شما امکان می‌دهد سرعت و نیازمندی‌های حافظهٔ هر اسکریپتی را که مکرراً Inkscape را برای انجام کارهای خط فرمان (مانند برون‌بری یا تبدیل‌ها) فراخوانی می‌کند، بهبود ببخشید.

در حالت پوسته، Inkscape دنباله‌ای از کنش‌ها (یا verbها) را به عنوان ورودی انتظار دارد. آن‌ها سطر به سطر پردازش می‌شوند، که معمولاً به معنای پردازش هنگام فشردن کلید Enter است. امکان قرار دادن تمام کنش‌ها در یک سطر واحد وجود دارد (اما ضروری نیست).

این گزینه را می‌توان با پارامتر --active-window ترکیب کرد تا دستورهای پوسته در سندی از Inkscape که از پیش باز شده است، اجرا شوند.

مثال زیر یک فایل را باز کرده و آن را به دو قالب مختلف برون‌بری می‌کند، سپس فایل دیگری را باز کرده و یک شیء واحد را برون‌بری می‌نماید:

file-open:file1.svg; export-type:pdf; export-do; export-type:png; export-do
file-open:file2.svg; export-id:rect2; export-id-only; export-filename:rect_only.svg; export-do

فایل پیکربندی اصلی در ~/.config/inkscape/preferences.xml واقع شده است؛ این فایل انواع تنظیمات سفارشی‌سازی را که می‌توانید در Inkscape تغییر دهید (عمدتاً در پنجرهٔ گفتگوی Preferences در Inkscape) ذخیره می‌کند. همچنین در زیردایرکتوری‌های آنجا، می‌توانید موارد اختصاصی خود را قرار دهید:

$HOME/.config/inkscape/extensions/ - افزونه‌ها.

$HOME/.config/inkscape/fonts/ - قلم‌ها.

$HOME/.config/inkscape/icons/ - مجموعه‌های آیکون.

$HOME/.config/inkscape/keys/ - نگاشت‌های کلید صفحه‌کلید.

$HOME/.config/inkscape/paint/ - الگوها و هاشورها.

$HOME/.config/inkscape/palettes/ - پالت‌ها.

$HOME/.config/inkscape/symbols/ - فایل‌های نماد.

$HOME/.config/inkscape/templates/ - الگوهای فایل جدید.

$HOME/.config/inkscape/ui/ - فایل‌های واسط کاربری.

برنامه در صورت موفقیت صفر و در صورت شکست مقداری غیر صفر برمی‌گرداند.

پیام‌های خطای متنوع و هشدارهایی ممکن است در STDERR یا STDOUT چاپ شوند. اگر برنامه با یک فایل SVG خاص رفتار غیرعادی داشت یا دچار فروپاشی (crash) شد، بررسی این خروجی برای یافتن سرنخ‌ها مفید خواهد بود.

گرچه بدیهی است که Inkscape در وهلهٔ اول به عنوان یک برنامهٔ گرافیکی (GUI) طراحی شده است، اما برای انجام پردازش‌های SVG در خط فرمان نیز قابل استفاده است.

باز کردن یک فایل SVG در واسط گرافیکی:

inkscape filename.svg

برون‌بری یک فایل SVG به PNG با وضوح پیش‌فرض 96 dpi (هر واحد کاربری SVG به یک پیکسل بیت‌مپ تبدیل می‌شود):

inkscape --export-filename=filename.png filename.svg

مشابه بالا، اما با اجبار فایل PNG به ابعاد 600x400 پیکسل:

inkscape --export-filename=filename.png -w 600 -h 400 filename.svg

مشابه بالا، اما برون‌بری طراحی (کادر احاطه‌کنندهٔ تمام اشیاء)، نه صفحه:

inkscape --export-filename=filename.png --export-area-drawing filename.svg

برون‌بری دو فایل مختلف، هر کدام به چهار قالب مجزای فایل:

inkscape --export-type=png,ps,eps,pdf filename1.svg filename2.svg

برون‌بری شیء با شناسهٔ id="text1555" به PNG، با استفاده از نام فایل خروجی و وضوحی که آخرین بار هنگام برون‌بری آن از طریق واسط گرافیکی استفاده شده بود:

inkscape --export-id=text1555 --export-use-hints filename.svg

مشابه بالا، اما با استفاده از وضوح پیش‌فرض 96 dpi، تعیین نام فایل خروجی و چسباندن (snap) محدودهٔ برون‌بری‌شده رو به بیرون به نزدیک‌ترین مقادیر کامل واحد کاربری SVG (برای حفظ تراز پیکسلی اشیاء و در نتیجه به حداقل رساندن شکستگی خطوط/aliasing):

inkscape --export-id=text1555 --export-filename=text.png --export-area-snap filename.svg

تبدیل یک سند Inkscape SVG به یک SVG ساده:

inkscape --export-plain-svg --export-filename=filename2.svg filename1.svg

تبدیل یک سند SVG به EPS و تبدیل همهٔ متن‌ها به مسیر (path):

inkscape --export-filename=filename.eps --export-text-to-path filename.svg

پرس‌وجوی پهنای شیء با شناسهٔ id="text1555":

inkscape --query-width --query-id=text1555 filename.svg

تکثیر اشیاء با شناسه‌های id="path1555" و id="rect835"، چرخاندن نسخه‌های تکثیرشده به اندازهٔ ۹۰ درجه در جهت عقربه‌های ساعت، ذخیرهٔ SVG و خروج:

inkscape --select=path1555,rect835 --actions="duplicate;object-rotate-90-cw" --export-overwrite filename.svg

انتخاب تمام اشیاء با برچسب ellipse، چرخاندن آن‌ها به اندازهٔ ۳۰ درجه، ذخیرهٔ فایل و خروج:

inkscape --actions="select-by-element:ellipse;transform-rotate:30" --export-overwrite filename.svg

برون‌بری شیء با شناسهٔ MyTriangle با پس‌زمینهٔ ارغوانی نیمه‌شفاف به فایل triangle_purple.png و با پس‌زمینهٔ قرمز به فایل triangle_red.png:

inkscape --actions="export-id:MyTriangle; export-id-only; export-background:purple; export-background-opacity:0.5;export-filename:triangle_purple.png; export-do; export-background:red; export-background-opacity:1; export-filename:triangle_red.png; export-do" filename.svg

خواندن یک SVG از ورودی استاندارد (stdin) و برون‌بری آن به قالب PDF:

cat filename.svg | inkscape --pipe --export-filename=filename.pdf

برون‌بری یک SVG به قالب PNG و نوشتن آن در خروجی استاندارد (stdout)، سپس تبدیل آن به قالب JPG با برنامهٔ convert نرم‌افزار ImageMagick:

inkscape --export-type=png --export-filename=- filename.svg | convert - filename.jpg

مشابه بالا، اما با خواندن هم‌زمان از یک لوله (pipe) (در این حالت می‌توان --export-filename را نادیده گرفت):

cat filename.svg | inkscape --pipe --export-type=png | convert - filename.jpg
تنظیم یک مسیر سفارشی برای دایرکتوری نمایه کاربر.
تنظیم یک مسیر سفارشی برای دایرکتوری داده‌های Inkscape (مثلاً $PREFIX/share
اگر فایل‌های اشتراکی Inkscape در $PREFIX/share/inkscape قرار دارند).
تنظیم یک مسیر سفارشی برای کاتالوگ ترجمه‌ها.
برای جزئیات بیشتر همچنین ببینید:
<http://wiki.inkscape.org/wiki/index.php/Environment_variables>

مکان اصلی و مرجع برای یافتن اطلاعات Inkscape در https://www.inkscape.org است. این وب‌سایت شامل اخبار، مستندات، آموزش‌ها، مثال‌ها، آرشیو فهرست‌های پستی، جدیدترین نگارش منتشرشده از برنامه، پایگاه‌های داده باگ‌ها و درخواست‌های قابلیت‌های جدید، انجمن‌ها و موارد بیشتر است.

potrace, cairo, rsvg, batik, ghostscript, pstoedit.

مجموعه آزمون سازگاری SVG: https://www.w3.org/Graphics/SVG/WG/wiki/Test_Suite_Overview

اعتبارسنج SVG: https://validator.w3.org

Scalable Vector Graphics (SVG) 1.1 Specification W3C Recommendation 16 August 2011 https://www.w3.org/TR/SVG11

Scalable Vector Graphics (SVG) 1.2 Specification W3C Working Draft 13 April 2005 https://www.w3.org/TR/SVG12

Scalable Vector Graphics (SVG) 2 Specification W3C Candidate Recommendation 15 September 2016 https://www.w3.org/TR/SVG2

Document Object Model (DOM): Level 2 Core W3C Recommendation 13 November 2000 https://www.w3.org/TR/DOM-Level-2-Core

برای یادگیری کار با رابط گرافیکی Inkscape، راهنما را در Help > Inkscape manual و آموزش‌ها را در Help > Tutorials مطالعه کنید.

به‌جز SVG، برنامه Inkscape می‌تواند بیشتر قالب‌های بیتی (PNG، BMP، JPG، XPM، GIF و غیره)، متن ساده (نیازمند Perl)، PS و EPS (نیازمند Ghostscript) و قالب‌های PDF و AI (نگارش 9.0 یا جدیدتر AI) را وارد (File > Import) کند.

برنامه Inkscape تصاویر 32-بیتی PNG (از طریق File > Export PNG Image) و همچنین AI، PS، EPS، PDF، DXF و چندین قالب دیگر را از طریق File > Save as صادر می‌کند.

برنامه Inkscape می‌تواند از فشار و زاویه قلم تبلت گرافیکی برای پهنا، زاویه و شدت اثرگذاری چندین ابزار از جمله قلم خوش‌نویسی (Calligraphic pen) استفاده کند.

برنامه Inkscape شامل یک رابط گرافیکی برای موتور ردگیری تصویر بیتی Potrace (http://potrace.sf.net) است که در داخل Inkscape تعبیه شده است.

برنامه Inkscape می‌تواند از اسکریپت‌های خارجی (پالایه‌های stdin-to-stdout) که با دستورهایی در منوی Extensions مشخص می‌شوند استفاده کند. یک اسکریپت می‌تواند برای تنظیم پارامترهای گوناگون دارای یک پنجره گفتگوی گرافیکی باشد و شناسه‌های شیءهای انتخاب‌شده را از طریق خط فرمان برای اعمال عملیات دریافت کند. برنامه Inkscape همراه با مجموعه‌ای از جلوه‌های نوشته‌شده با Python ارائه می‌شود.

برای مشاهده فهرست کامل میانبرهای صفحه‌کلید و موشواره، فایل doc/keys.html را بررسی کرده یا از دستور Keys and Mouse در منوی Help استفاده کنید.

باگ‌های متعددی شناخته شده‌اند؛ لطفاً برای بررسی موارد گزارش‌شده و گزارش مشکلات تازه یافت‌شده به وب‌سایت (https://www.inkscape.org) مراجعه کنید. همچنین بخش Known Issues را در یادداشت‌های انتشار (Release Notes) نگارش خود (فایل `NEWS') ببینید..SH "تاریخچه (HISTORY)" پایه‌کدی که بعدها به Inkscape تبدیل شد، حیات خود را در سال ۱۹۹۹ با برنامهٔ Gill، نرم‌افزار تصویرسازی GNOME ایجادشده توسط Raph Levien آغاز کرد. هدف اعلام‌شده برای Gill، پشتیبانی نهایی از تمامی ویژگی‌های استاندارد SVG بود. Raph مدل تصویرسازی منحنی‌های بزیه (bezier) در PostScript، شامل خط‌کشی (stroking) و پر کردن (filling)، سبک انتهای خطوط (line cap)، سبک اتصالات خطوط (line join)، متن و غیره را پیاده‌سازی کرد. صفحهٔ مربوط به Gill از Raph در نشانی http://www.levien.com/svg در دسترس است. به نظر می‌رسد کار بر روی Gill در سال ۲۰۰۰ کند یا متوقف شده باشد.

تجسد بعدی این پایه‌کد، تبدیل شدن به برنامهٔ بسیار محبوب Sodipodi به رهبری Lauris Kaplinski بود. این پایه‌کد طی چندین سال تلاش، با افزودن قابلیت‌های جدید متعددی، پشتیبانی از چندزبانگی، پورت شدن به Windows و سایر سیستم‌عامل‌ها، و حذف وابستگی‌ها، به یک برنامهٔ قدرتمند تصویرسازی بدل گشت.

پروژهٔ Inkscape در سال ۲۰۰۳ توسط چهار توسعه‌دهندهٔ فعال Sodipodi یعنی Bryce Harrington، MenTaLguY، Nathan Hurst و Ted Gould پایه‌گذاری شد؛ چرا که آن‌ها قصد داشتند مسیر متفاوتی را در توسعهٔ پایه‌کد با تمرکز بر سازگاری با SVG، ظاهر و حس رابط کاربری (look-and-feel) و تمایل به گشودن فرصت‌های مشارکت برای افراد بیشتر در پیش بگیرند. این پروژه به سرعت پیشرفت کرد و مشارکت‌کنندگان فعال و قابلیت‌های فراوانی را جذب نمود.

بخش عمده‌ای از کارها در روزهای نخست پروژه، بر پایدارسازی کد و بین‌المللی‌سازی متمرکز بود. موتور رندر اولیه که از Sodipodi به ارث رسیده بود، دچار موارد مرزی (corner cases) ریاضی متعددی بود که در صورت استفاده‌های فراتر از معمول، منجر به فروپاشی‌ها و کرش‌های غیرمنتظره می‌شد؛ این رندرکننده با Livarot جایگزین شد که هرچند آن نیز بی‌نقص نبود، اما خطای به مراتب کمتری داشت. پروژه همچنین رویهٔ ثبت مداوم کدها (commit) و تشویق کاربران به اجرای نسخه‌های آزمایشی توسعه (developmental snapshots) را در پیش گرفت؛ این امر به شناسایی سریع باگ‌های جدید کمک کرد و اطمینان داد که بررسی و اعتبارسنجی اصلاحات توسط کاربران آسان است. در نتیجه، نسخه‌های منتشرشدهٔ Inkscape عموماً به پایدار بودن و قابلیت اطمینان بالا شهرت یافته‌اند.

به همین ترتیب، تلاش‌هایی برای بین‌المللی‌سازی و بومی‌سازی رابط کاربری صورت گرفت که به جذب مشارکت‌کنندگان از سراسر جهان برای این برنامه کمک شایانی کرد.

به‌طور کلی، Inkscape با فراهم آوردن ابزاری جهت ایجاد و به‌اشتراک‌گذاری آیکون‌ها، صفحه‌های شروع (splash screens)، طرح‌های گرافیکی وب‌سایت و غیره، تأثیر بسزایی بر جذابیت بصری دنیای Open Source داشته است. به نوعی، با وجود این‌که Inkscape «تنها یک برنامهٔ طراحی» است، نقش مهمی در ترغیب بصری دنیای متن‌باز برای مخاطبان گسترده‌تر ایفا کرده است.

این پایه‌کد وجود خود را در دوره‌های گوناگون حیاتش، مدیون مشارکت‌کنندگان پرشماری است. فهرست زیر بدون شک ناقص است، اما به منظور قدردانی از شانه‌های بسیاری آورده شده است که این برنامه بر آن‌ها استوار است:

Maximilian Albert, Joshua A. Andler, Tavmjong Bah, Pierre Barbry-Blot, Jean-François Barraud, Campbell Barton, Bill Baxter, John Beard, John Bintz, Arpad Biro, Nicholas Bishop, Joshua L. Blocher, Hanno Böck, Tomasz Boczkowski, Adrian Boguszewski, Henrik Bohre, Boldewyn, Daniel Boles, Daniel Borgmann, Bastien Bouclet, Hans Breuer, Gustav Broberg, Christopher Brown, Marcus Brubaker, Luca Bruno, Brynn, Nicu Buculei, Bulia Byak, Pierre Caclin, Ian Caldwell, Gail Carmichael, Ed Catmur, Chema Celorio, Jabiertxo Arraiza Cenoz, Johan Ceuppens, Zbigniew Chyla, Alexander Clausen, John Cliff, Kees Cook, Ben Cromwell, Jon Cruz, Aurélie De-Cooman, Kris De Gussem, Milosz Derezynski, Daniel Díaz, Bruno Dilly, Larry Doolittle, Nicolas Dufour, Tim Dwyer, Maxim V. Dziumanenko, Moritz Eberl, Johan Engelen, Miklos Erdelyi, Ulf Erikson, Noé Falzon, Sebastian Faubel, Frank Felfe, Andrew Fitzsimon, Edward Flick, Marcin Floryan, Fred, Ben Fowler, Cedric Gemy, Steren Giannini, Olivier Gondouin, Ted Gould, Toine de Greef, Michael Grosberg, Bryce Harrington, Dale Harvey, Aurélio Adnauer Heckert, René de Hesselle, Carl Hetherington, Jos Hirth, Hannes Hochreiner, Thomas Holder, Joel Holdsworth, Christoffer Holmstedt, Alan Horkan, Karl Ove Hufthammer, Richard Hughes, Nathan Hurst, inductiveload, Thomas Ingham, Jean-Olivier Irisson, Bob Jamison, Ted Janeczko, Marc Jeanmougin, jEsuSdA, Lauris Kaplinski, Lynn Kerby, Niko Kiirala, James Kilfiger, Nikita Kitaev, Jason Kivlighn, Adrian Knoth, Krzysztof Kosiński, Petr Kovar, Michael Kowalski, Benoît Lavorata, Alex Leone, Julien Leray, Raph Levien, Diederik van Lierop, Nicklas Lindgren, Vitaly Lipatov, Ivan Louette, Fernando Lucchesi Bastos Jurema, Pierre-Antoine Marc, Aurel-Aimé Marmion, Colin Marquardt, Craig Marshall, Ivan Masár, Dmitry G. Mastrukov, David Mathog, Matiphas, Patrick McDermott, Michael Meeks, Federico Mena, MenTaLguY, Aubanel Monnier, Vincent Montagne, Tim Mooney, Derek P. Moore, Chris Morgan, Peter Moulder, Jörg Müller, Yukihiro Nakai, Victor Navez, Jonathan Neuhauser, Christian Neumair, Nick, Andreas Nilsson, Mitsuru Oka, Vinícius dos Santos Oliveira, Martin Owens, PBS, Alvin Penner, Matthew Petroff, Jon Phillips, Zdenko Podobny, Alexandre Prokoudine, Jean-René Reinhard, Alexey Remizov, Frederic Rodrigo, Hugo Rodrigues, Jean Franco Amoni Rodríguez, Juarez Rudsatz, Xavier Conde Rueda, Felipe Corrêa da Silva Sanches, Christian Schaller, Marco Scholten, Tom von Schwerdtner, Markus Schwienbacher, Danilo Šegan, Abhishek Sharma, Tim Sheridan, Shivaken, Rafał Siejakowski, Michael Sloan, John Smith, Sandra Snan, Boštjan Špetič, Aaron Spike, Kaushik Sridharan, Ralf Stephan, Dariusz Stojek, Patrick Storz, Martin Sucha, Sushant A.A., ~suv, Pat Suwalski, Adib Taraben, Parcly Taxel, Hugh Tebby, Jonas Termeau, David Turner, Andre Twupack, Aleksandar Urošević, Alex Valavanis, Joakim Verona, Lucas Vieites, Daniel Wagenaar, Liam P. White, Sebastian Wüst, Michael Wybrow, Gellule Xg, Daniel Yacob, Masatake Yamato, David Yip, Wen-Wei Kao.SH "کپی‌رایت و پروانه (COPYRIGHT AND LICENSE)" حق نشر (C) 1999-2023 متعلق به نویسندگان.

Inkscape یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط پروانه GPL نسخه ۲ یا جدیدتر بازتوزیع کرده و/یا تغییر دهید.

2026-08-21 1.4.4