~inkscape.dev/inkscape/trunk

=head1 NAME

Inkscape - editor SVG (Scalable Vector Graphics).

=head1 SYNOPSIS

C<inkscape [voľby] [názov súboru ...]>

voľby:

    -?, --help        

        --usage       

    -V, --version

    -f, --file=NÁZOVSÚBORU               

    -e, --export-png=NÁZOVSÚBORU         

    -a, --export-area=x0:y0:x1:y1     

    -C, --export-area-canvas

    -D, --export-area-drawing

        --export-area-snap

    -i, --export-id=ID     

    -j, --export-id-only     

    -t, --export-use-hints

    -b, --export-background=FARBA     

    -y, --export-background-opacity=HODNOTA     

    -d, --export-dpi=DPI              

    -w, --export-width=ŠÍRKA          

    -h, --export-height=VÝŠKA        

    -P, --export-ps=NÁZOVSÚBORU

    -E, --export-eps=NÁZOVSÚBORU

    -A, --export-pdf=NÁZOVSÚBORU

    -T, --export-text-to-path

        --export-bbox-page 

    -l, --export-plain-svg=NÁZOVSÚBORU             

    -p, --print=PRINTER

    -I, --query-id=ID     

    -X, --query-x

    -Y, --query-y

    -W, --query-width

    -H, --query-height

    -S, --query-all

    -x, --extension-directory

        --verb-list

        --verb=VERB-ID

        --select=OBJECT-ID

        --shell

    -g, --with-gui                    

    -z, --without-gui                 

        --vacuum-defs

        --g-fatal-warnings

=head1 OPIS

B<Inkscape> je editor súborov vektorovej grafiky vo formáte

B<Scalable Vector Graphics (SVG)> s grafickým rozhraním, ktorého

schopnosti sú podobné B<Adobe Illustrator>, B<CorelDraw>, B<Xara Xtreme>,

atď. Medzi vlastnosti Inkscape patria všestranné tvary, bézierove krivky,

kreslenie voľbou rukou, viacriadkový text, text na ceste, alpha blending,

ľubovoľné afínne transformácie, farebné prechody a výplň vzorkou,

úprava uzlov, mnohé formáty na export a import vrátane PNG a PDF,

zoskupovanie, vrstvy, živé klony a veľa iného. Rozhranie je navrhnuté pre

komfortné a efektívne ovládanie pre skúseného používateľa, pričom dodržiava

štandardy B<GNOME>, takže používateľ oboznámený s inými aplikáciami GNOME

si môže ovládanie rozhrania rýchlo osvojiť.

B<SVG> je štandardný W3C XML formát pre dvojrozmernú vektorovú grafiku.

Umožňuje definíciu objektov kresby pomocou bodov, ciest a primitívnych

tvarov. Farby, písma, šírka ťahu atď sa pri týchto objektoch uvádzajú ako

atribúty „štýlu“. Zámer je taký, že keďže SVG je štandard a jeho súbory sú

text/xml, bude možné použiť SVG súbory vo veľkom počte programov v širokom

spektre aplikácií.

B<Inkscape> používa SVG ako svoj natívny formát dokumentu a jeho cieľom je

stať sa kresliacim programom plne konformným SVG súborom, dostupným open

source komunite.

=head1 VOĽBY

=over 8

=item B<-?>, B<--help>

Zobrazí správu s pomocou

=item B<-V>, B<--version>

Zobrazí verziu a dátum zostavenia Inkscape.

=item B<-a> I<x0:y0:x1:y1>, B<--export-area>=I<x0:y0:x1:y1>

Pri exporte PNG, nastaví exportovanú oblasť v používateľských jednotkách

SVG (anonymné jednotky dĺžky bežne používané v Inkscape SVG). Štandardne sa

exportuje celé kresliace plátno dokumentu. Bod (0,0) je spodný dolný roh.

=item B<-C>, B<--export-area-canvas>

Pri exporte NG, PDF, PS a EPS je exportovaná oblasť celé kresliace plátno dokumentu

(stránka). Toto je štandardné nastavenie pre PNG, PDF a PS, takže ju nemusíte uvádzať

ak nepoužívate --export-id na exportovanie konkrétneho objektu. Pri exporte EPS to

však nie je štandardné nastavenie. Naviac pri EPS neumožňuje špecifikácia formátu aby

bolo ohraničenie väčšie ako obsah dokumentu. To znamená, že ak pri exporte EPS použijete

--export-area-canvas, ohraničenie plátna sa oreže dnu na ohraničenie objektu ak je menšie.

=item B<-D>, B<--export-area-drawing>

Pri exporte PNG, PDF, PS a EPS je exportovaná oblasť celá kresba (nie plátno), t.j. ohraničenie

všetkých objektov dokumentu (alebo exportovaného objektu ak je použité --export-id). 

S touto voľbou budú na exportovanom obrázku iba viditeľné objekty dokumentu bez

okrajov alebo orezania. Toto je štandardná exportná oblasť pre EPS. Pri PNG

je možné použiť túto voľbu v kombinácii s --export-use-hints.

=item B<--export-area-snap>

Pri exporte png prichytí oblasť exportu smerom von na najbližšiu celočíselnú používateľskú jednotku SVG (px).

Ak používate štandardné rozlíšenie na export 90 dpi a vaša grafika je zarovnaná na pixle aby sa minimalizoval

antialiasing, tento prepínač vám umožní zachovať toto zarovnanie aj ak exportujete ohraničenie nejakého

objektu (pmocou --export-id alebo --export-area-drawing), ktoré samotné nie je zarovnané na pixle.

=item B<-b> I<FARBA>, B<--export-background>=I<FARBA>

Farba pozadia exportovaného PNG.

Toto môže byť akýkoľvek reťazec špecifikujúci farbu, ktorý SVG podporuje, napr.

„#ff007f“ alebo „rgb(255, 0, 128)“.

Ak nie je nastavená, použije sa farba nastavená v Inkscape v dialógu Možnosti dokumentu (uložená v atribúte pagecolor= v sodipodi:namedview).

=item B<-d> I<DPI>, B<--export-dpi>=I<DPI>

Použité rozlíšenie na export PNG.

Tiež sa používa pri rasterizácii filtrovaných objektov pri exporte do PS, EPS a PDF (ak neuvediete

--export-ignore-filters na potlačenie rasterizácie).

Štandardne 90, čo zodpovedá 1 používateľskej jednotke SVG.

(px, tiež nazývaná „používateľská jednotka“) exportovanej na 1 pixel bitmapy.

Táto hodnota má precedenciu pred odporúčaným DPI pri použití s prepínačom --export-use-hints.

=item B<-e> I<NÁZOVSÚBORU>, B<--export-png>=I<NÁZOVSÚBORU>

Názov súboru pre export PNG.

Ak už existuje, bude prepísaní bez pýtania sa.

=item B<-f> I<NÁZOVSÚBORU>, B<--file>=I<NÁZOVSÚBORU>

Otvorí zadané dokumenty.

Je možné vynechať reťazec voľby, t.j. môžete uviesť zoznam súborov bez -f.

=item B<-g>, B<--with-gui>

Pokúsiť sa použiť GUI (na unixových systémoch, použiť X server aj keď nie je nastavená premenná $DISPLAY).

=item B<-h> I<VÝŠKA>, B<--export-height>=I<VÝŠKA>

Výška generovaných bitmáp v pixloch. Táto hodnota má precedenciu pred

nastavením --export-dpi (alebo odporúčaním DPI pri použití s prepínačom --export-use-hints). 

=item B<-i> I<ID>, B<--export-id>=I<ID>

Pri exporte PNG, PS, EPS a PDF hodnota atribútu id objektu, ktorý chcete

exportovať z dokumentu. Žiadne iné objekty sa neexportujú. Štandardne sa

exportuje ohraničenie objektu. To môžete zmeniť použitím voľby

--export-area (iba pri PNG) alebo --export-area-canvas.

=item B<-j>, B<--export-id-only>

Exportovať do PNG iba objekt s id zadaným v --export-id. Všetky ostatné objekty sa skryjú a

nezobrazia sa v exporte ani keď prekrývajú exportovaný objekt. Ak nie je uvedené --export-id,

táto voľba sa ignoruje. Pri exporte PDF je toto štandardná voľba, takže jej uvedenie nemá žiadny vplyv.

=item B<-l>, B<--export-plain-svg>=I<NÁZOVSÚBORU>

Exportovať dokumenty do formátu čisté SVG, bez menných priestorov sodipodi: alebo inkscape: namespaces a bez metadát RDF.

=item B<-x>, B<--extension-directory>

Vypíše aktuálny adresár rozšírení, ktorý bol nastavený pre Inkscape a potom

skončí. Využívajú to externé rozšírenia aby použili rovnakú konfiguráciu ako

pôvodná inštalácia Inkscape.

=item B<--verb-list>

Vypíše všetky slovesá dostupné v Inkscape podľa ID. Tieto ID možno použiť

pri definovaní klávesových máp alebo menu. Tiež ich možno použiť na

príkazovom riadku s voľbou --verb.

=item B<--verb>=I<VERB-ID>, B<--select>=I<OBJECT-ID>

Tieto dve voľby spolu poskytujú základné možnosti skriptovania v Inkscape

z príkazového riadka. Obe sa môžu na príkazovom riadku vyskytovať

ľubovoľný počet krát a vykonajú sa v tomto poradí na každom určenom

dokumente.

Príkaz --verb vykoná uvedené sloveso ako keby bolo zavolané z menu alebo

klávesovou skratkou. Dialógy sa objavia ak sú súčasťou slovesa. Ak chcete

vypísať zoznam dostupných ID, použite voľby príkazového riadka

--verb-list.

Príkaz --select spôsobí výber objektov s uvedeným ID.

To umožňuje vykonávanie slovies na nich.

Ak chcete zrušiť všetky výbery, použite --verb=EditDeselect. ID objektov

sú dostupné v závislosti na dokumente, ktorý sa má načítať.

=item B<-p> I<TLAČIAREŇ>, B<--print>=I<TLAČIAREŇ>

Vytlačí dokumenty na určenej tlačiarni pomocou „lpr -P TLAČIAREŇ“.

Ak chcete výstup poslať rúrou inému príkazu, môžete použiť „| PRÍKAZ“

alebo „> NÁZOVSÚBORU“ ak chcete namiesto tlačenia zapísať výstup v PostScripte do súboru.

Pamätajte na to, že musíte použiť vhodné úvodzovky pre váš shell, napr.

inkscape --print='| ps2pdf - mydoc.pdf' mydoc.svg

=item B<-t>, B<--export-use-hints>

Použiť názov exportovaného súboru a atribút DPI uložené v exportovanom objekte (iba s voľbou --export-id).

Tieto údaje sa nastavujú automaticky keď exportujete výber z grafického rozhrania Inkscape.

Takže napr. ak exportujete útvar s id="path231" ako /home/me/shape.png pri 300 dpi z dokument.svg z grafického rozhrania Inkscape a uložíte dokument, neskôr budete môcť exportovať útvar

do rovnakého súboru s rovnakým rozlíšením jednoducho spustením

inkscape -i path231 -t document.svg

Ak spolu s touto voľbou použijete --export-dpi, --export-width alebo --export-height

bude sa atribút DPI ignorovať a použije sa hodnota zadaná na príkazovom riadku.

Ak spolu s touto voľbou použijete --export-png, 

bude sa atribút názvov súboru ignorovať a použije sa hodnota zadaná na príkazovom riadku.

=item B<-w> I<ŠÍRKA>, B<--export-width>=I<ŠÍRKA>

Výška generovaných bitmáp v pixeloch. Táto hodnota má precedenciu pred nastavením --export-dpi

(alebo odporúčaním DPI pri použití s prepínačom --export-use-hints). 

=item B<-y> I<HODNOTA>, B<--export-background-opacity>=I<HODNOTA>

Krytie pozadia exportovaných súborov PNG.

Toto môže byť hodnota buď medzi 0.0 a 1.0 (kde 0.0 znamená celkom priehľadné a 1.0 plné krytie)

alebo väčšia ako 1 do 255 (kde 255 znamená plné krytie).

Ak nie je hodnota nastavená a nepoužije sa voľba -b,

použije sa krytie stránky nastavené v Inkscape v dialógu Vlastnosti dokumentu (uložené v atribúte inkscape:pageopacity=  sodipodi:namedview).

Ak nie je hodnota nastavená a použije sa voľba -b

použije sa hodnota 255 (plné krytie).

=item B<-P> I<NÁZOVSÚBORU>, B<--export-ps>=I<NÁZOVSÚBORU>

Exportovať dokumenty do formátu PostScript. Pamätajte, že PostScript nepodporuje priesvitnosť, takže akékoľvek priesvitné objekty v pôvodnom SVG sa automaticky rasterizujú. Priložia sa použité písma alebo podmnožina použitých znakov. Štandardná oblasť exportu je plátno a môžete ju nastaviť na kresbu pomocou --export-area-drawing.

Ak chcete exportovať jediný objekt, môžete použiť --export-id (všetky ostatné sa skryjú); v tom prípade

bude oblasťou exportu ohraničenie uvedeného objektu, ale možno ho nastaviť na plátno voľbou --export-area-canvas.

=item B<-E> I<NÁZOVSÚBORU>, B<--export-eps>=I<NÁZOVSÚBORU>

Exportovať dokumenty do formátu Encapsulated PostScript. Pamätajte, že PostScript nepodporuje priesvitnosť, takže akékoľvek priesvitné objekty v pôvodnom SVG sa automaticky rasterizujú. Priložia sa použité písma alebo podmnožina použitých znakov. Štandardná oblasť exportu je kresba a môžete ju však nastaviť na plátno, pozrite si však obmedzenia v popise voľby --export-area-drawing. Ak chcete exportovať jediný objekt, môžete použiť --export-id (všetky ostatné sa skryjú).

=item B<-A> I<NÁZOVSÚBORU>, B<--export-pdf>=I<NÁZOVSÚBORU>

Exportovať dokumenty do formátu PDF format. Tento formát zachováva priesvitnosť z pôvodného SVG.

Priložia sa použité písma alebo podmnožina použitých znakov.

Štandardná oblasť exportu je plátno a môžete ju nastaviť na kresbu pomocou --export-area-drawing.

Ak chcete exportovať jediný objekt, môžete použiť --export-id (všetky ostatné sa skryjú); v tom prípade

bude oblasťou exportu ohraničenie uvedeného objektu, ale možno ho nastaviť na plátno voľbou --export-area-canvas.

=item B<-T>, B<--export-text-to-path>

Konvertovať pri exporte textové objekty na cesty kde sa dá (pri exporte PS, EPS a PDF).

=item B<--export-ignore-filters>

Exportovať objekty s filtrami (napr. s rozostrením) ako vektorovú grafiku a ignorovať filtre (pri exporte PS, EPS a PDF). 

Štandardne sa všetky objekty s filtrami rasterizujú s rozlíšením --export-dpi (štandardne 90 dpi) čím sa zachová ich vzhľad.

=item B<-I>, B<--query-id>

Nastaviť ID objektu, ktoré rozmery zisťujeme. Ak nie je nastavené, voľby požiadavky

vrátia rozmer kresby (t.j. všetkých objektov dokumentu), nie stránky či zobrazenia.

=item B<-X>, B<--query-x>

Zistiť súradnicu X kresby alebo, ak je určený, objektu s --query-id. Vrátená hodnota je v px (používateľské jednotky SVG). 

=item B<-Y>, B<--query-y>

Zistiť súradnicu Y kresby alebo, ak je určený, objektu s --query-id. Vrátená hodnota je v px (používateľské jednotky SVG). 

=item B<-W>, B<--query-width>

Zistiť šírku kresby alebo, ak je určený, objektu s --query-id. Vrátená hodnota je v px (používateľské jednotky SVG). 

=item B<-H>, B<--query-height>

Zistiť výšku kresby alebo, ak je určený, objektu s --query-id. Vrátená hodnota je v px (používateľské jednotky SVG). 

=item B<-S>, B<--query-all>

Vypíše zoznam všetkých objektov v dokumente SVG s definovaným id spolu s ich

súradnicou x,y, šírkou a výškou vo formáte s hodnotami oddelenom čiarkami.

=item B<--shell>

Ak je zadaný tento parameter, Inkscape vstúpi do interaktívneho režimu príkazového riadka.

V tomto režime píšete príkazy na príkazovom riadku a Inkscape ich vykonáva bez toho aby

ste museli pri každom príkaze spúšťať novú inštanciu Inkscape. Táto vlastnosť je

najužitočnejšia v skriptoch a pri použití na serveri: nepridáva nové schopnosti, ale umožňuje

vám zlepšovať nároky na rýchlosť a pamäť akéhokoľvek skriptu, ktorý opakovane volá Inkscape

aby vykonal úlohy z príkazového riadka (ako export alebo konverzie). Každý príkaz v režime shellu

musí byť úplný platný príkaz Inkscape ale bez názvu programu Inkscape, napr.

„subor.svg --export-pdf=subor.pdf“.

=item B<--vacuum-defs>

Odstráni všetky nepoužité položky zo sekcie <lt>defs<gt> SVG súboru. Ak túto voľbu

zadáte spolu s --export-plain-svg, bude mať vplyv iba na exportovaný súbor.

Ak ju použijete samostatne, zmení sa existujúci súbor.

=item B<-z>, B<--without-gui>

Neotvírať grafické rozhranie (na unixových systémoch nepoužívať X server), iba spracovať súbory z konzoly.

Táto voľba sa predpokladá pri voľbách -p, -e, -l a --vacuum-defs.

=item B<--g-fatal-warnings>

Táto štandardná voľba GTK vynucuje, že akékoľvek upozornenia, ktoré sú zvyčajne

neškodné, spôsobia ukončenie Inkscape (čo je užitočné pri ladení).

=item B<--usage>

Zobrazí stručnú správu o tom ako používať Inkscape.

=back

=head1 KONFIGURÁCIA

Hlavný konfiguračný súboor je ~/.config/Inkscape/preferences.xml. Ukladá rozličné

nastavenia, ktoré môžete zmeniť v Inkscape (prevažne v dialógu Nastavenia Inkscape).

Do podadresárov tohto adresára tiež môžete umiestniť vlastné:

B<$HOME>/.config/Inkscape/extensions/ - rozširujúce efekty.

B<$HOME>/.config/Inkscape/icons/ - ikony.

B<$HOME>/.config/Inkscape/keys/ - mapy kláves.

B<$HOME>/.config/Inkscape/templates/ - šablóny nových súborov.

=head1 DIAGNOSTIKA

Program vráti nulovú hodnotu pri úspešnom a nenulovú pri neúspešnom ukončení.

Na štandardný chybový výstup alebo štandardný výstup môže vypísať rozličné chybové

hlásenia alebo upozornenia. Ak sa program správa chybne alebo havaruje v súvislosti

s konkrétnym SVG súborom, prehliadnutie tohto výstupu pomôže zistiť dôvod zlyhania.

=head1 PRÍKLADY

Hoci je B<Inkscape> zjavne v prvom rade aplikácia s grafickým používateľským

rozhraním, tiež ho možno použiť na spracovanie SVG z príkazového riadka.

Otvorenie SVG súboru v grafickom rozhraní: