GS(1)

JMÉNO
gs - Ghostscript (interpreter a prohlížeč jazyka PostScript a PDF)

POUŽITÍ
gs [ volby ] [ soubory ] ... (Unix, VMS)
gswin32 [ volby ] [ soubory ] ... (MS Windows)
gswin32c [ volby ] [ soubory ] ... (MS Windows)
gs386 [ volby ] [ soubory ] ... (DOS for PC)
gsos2 [ volby ] [ soubory ] ... (OS/2)

POPIS
Příkaz gs (gswin32, gswin32c, gs386, gsos2) vyvolá Ghostscript, interpreter jazyka Adobe Systems' PostScript(tm) a Portable Document Format (PDF). gs čte "soubory" jeden podruhém a spouští je jako Ghostscript programy. Po přečtení souborů, čte ještě navíc ze standartního vstupu (obvykle klávesnice) a každý řádek interpretuje samostatně. Interpreter se ukončí pokud narazí na příkaz "quit" (ať už v některém ze souborů nebo ze standartního vstupu), na konci souboru, nebo přijme-li signál přerušení (jako například při stisknutí Control-C na klávesnici).

Interpreter rozlišuje několik přepínačů popsaných níže, které se mohou objevit kdekoli na příkazové řádce a ovlivní všechny soubory, které jsou jmenovány za nimi. Vyvoláním programu Ghostscript s přepínačem -h nebo -? je možné získat výpis několika užitečných přepínačů, všech zařízení, která ovládá daná verze programu a nastavení cest, na kterých jsou hledány fonty. V systému Unix také zobrazí umístění podrobné dokumentace.

Ghostscript může být zkompilován tak, aby spolupracoval s množstvím výstupních zařízení. Pro zobrazení všech výstupních zařízení podporovaných aktuálním sestavením programu, spusťte "gs -h". Pokud není zadáno jméno konkrétního zařízení, Ghostscript otevře první z nich a směruje na něj výstup, takže pokud je na první pozici to zařízení, které chcete použít, zadejte příkaz

	gs soubor.ps

Dostupná zařízení je také možné zjistit přímo z programu Ghostscript: spuštěním Ghostscriptu a zadáním

	devicenames ==

ale první zařízení z takto získaného seznamu nemusí být defaultní zařízení, které zjistíte pomocí "gs -h". Zadání určitého zařízení "AbcXyz" jako výstupního zařízení se provede přidáním přepínače

	-sDEVICE=AbcXyz

Například pro výstup na tiskárnu Epson je možné použít příkazu

	gs -sDEVICE=epson soubor.ps

Přepínač "-sDEVICE=" musí předcházet prvnímu výskytu jména zpracovávaného souboru a jedině jeho první použití má nějaký účinek. Jiným způsobem je možné vybrat zařízení přímo v Ghostscriptu zápisem:

	(epson) selectdevice
	(soubor.ps) run

Veškerý výstup je pak směrován na tiskárnu, dokud není vybráno jiné zařízení pomocí procedury "selectdevice" v PostScriptovém programu, například:

	(vga) selectdevice
nebo
	(x11) selectdevice

Je možné také specifikovat dafaultní zařízení pomocí proměnné prostředí GS_DEVICE. Pořadí priorit těchto alternativ je od nejvyšší do nejnížší takovéto (Ghostscript používá zařízení s nejvyšší prioritou podle seznamu):

	selectdevice
	(příkazová řádka)
	GS_DEVICE
	(první zařízení v zakompilovaném seznamu)

Některé tiskárny umí tisknout v různých rozlišeních (hustotách tisku). K výběru rozlišení takové tiskárny se používá přepínač "-r":

	gs -sDEVICE=<zařízení> -r<xres>x<yres>

Například na devítijehličkové Epson kompatibilní tiskárně je možné získat mód s nejnižší hustotou (nejrychlejší mód) pomocí

	gs -sDEVICE=epson -r60x72

a mód s nejvyšší hustotou (nejlepší výstupní kvalita) za použití

	gs -sDEVICE=epson -r240x72.

Pokud je jako výstupní zařízení vybrána tiskárna, Ghostscript také umožnuje zvolit, kam se má poslat výstup -- v systémech na bázi Unixu, obvykle do dočasného souboru. K přesměrování výstupu do souboru "něco.xyz", se použije přepínač

	-sOutputFile=něco.xyz

Někdy je potřeba tisknout jedotlivé strany odděleně. To je možné udělat pomocí přesměrování výstupu do řady souborů "něco1.xyz, něco2.xyz, ..." pomocí přepínače "-sOutputFile=" s parametrem "%d" v šabloně pro jméno souboru:

	-sOutputFile=něco%d.xyz

Každý výsledný soubor bude obsahovat jednu stranu výstupu a soubory budou očíslovány popořadě. "%d" je zde standartní formátovací značka funkce printf. Je možné také použít jiné její varianty jako např. "%02d".

V Unixových systémech je také možné přesměrovat výstup do roury. Například lze výstup přes rouru směrovat do programu "lpr" (který jej na mnoha Unixových systémech předá tiskárně), pomocí přepínače

	-sOutputFile=\|lpr

Také je možné výstup směrovat na standartní výstup přepínačem

	-sOutputFile=-

V takovém případě je nutné použít zároveň přepínač -q, aby Ghostscript nevypisoval zprávy na standartní výstup.

K volbě určité velikosti papíru se z příkazové řádky používá přepínač

	-sPAPERSIZE=známá_velikost_papíru

například

	-sPAPERSIZE=a4
nebo
	-sPAPERSIZE=legal

V této chvíli jsou známé rozměry papíru definované v inicializačním souboru "gs_statd.ps" takovéto:
PAPERSIZE    X inches   Y inches   X cm       Y cm
a0           33.0556    46.7778    83.9611    118.816
a1           23.3889    33.0556    59.4078    83.9611
a2           16.5278    23.3889    41.9806    59.4078
a3           11.6944    16.5278    29.7039    41.9806
a4           8.26389    11.6944    20.9903    29.7039
a5           5.84722    8.26389    14.8519    20.9903
a6           4.125      5.84722    10.4775    14.8519
a7           2.91667    4.125      7.40833    10.4775
a8           2.05556    2.91667    5.22111    7.40833
a9           1.45833    2.05556    3.70417    5.22111
a10          1.02778    1.45833    2.61056    3.70417
b0           39.3889    55.6667    100.048    141.393
b1           27.8333    39.3889    70.6967    100.048
b2           19.6944    27.8333    50.0239    70.6967
b3           13.9167    19.6944    35.3483    50.0239
b4           9.84722    13.9167    25.0119    35.3483
b5           6.95833    9.84722    17.6742    25.0119
archA        9          12         22.86      30.48
archB        12         18         30.48      45.72
archC        18         24         45.72      60.96
archD        24         36         60.96      91.44
archE        36         48         91.44      121.92
flsa         8.5        13         21.59      33.02
flse         8.5        13         21.59      33.02
halfletter   5.5        8.5        13.97      21.59
note         7.5        10         19.05      25.4
letter       8.5        11         21.59      27.94
legal        8.5        14         21.59      35.56
11x17        11         17         27.94      43.18
ledger       17         11         43.18      27.94

Rozměry papíru v řadě B jsou standartní podle normy ISO: informace o používání JIS B rozměrů papíru je možné nalézt v souboru Use.htm.

Ghostscript umí mnoho dalších věcí než jen tisk nebo prohlížení souborů formátu PostScript nebo PDF. Například, pokud je potřeba zjistit velikost ohraničujícího obdélníku nějakého souboru formátu PostScript (nebo EPS) , nabízí program Ghostscript speciální "zařízení", které nedělá nic jiného, než že vypíše tuto informaci:

	gs -sDEVICE=bbox soubor.ps

Například použití s jedním vzorovým souborem dodávaným v balíku Ghostscript,

	gs -sDEVICE=bbox golfer.ps

vypíše toto:

	%%BoundingBox: 0 25 583 732
	%%HiResBoundingBox: 0.808497 25.009496 582.994503 731.809445

INICIALIZAČNÍ SOUBORY
Když jsou požadovány inicializační soubory "gs_*.ps", soubory vztahující se k fontům nebo soubor pro operátor "run", Ghostscript se nejprve pokusí otvřít tyto soubory pod zadaným jménem v aktuálním pracovním adresáři (pokud nebyl zadán jiný adresář). Při neuspěchu a pokud soubor neudává určitý adresář nebo disk (tzn. v Unixových systémech neobsahuje "/", neobsahuje "\" v systémech na bázi DOS), zkouší Ghostscript adresáře v tomto pořadí:

1.  adresáře udané přepínači -I z příkazové řádky (pokud byly nějaké zadány)

2.  adresáře udané v proměnné prostředí GS_LIB (pokud je nastavena)

3.  adresáře udané makrem GS_LIB_DEFAULT v souboru makefile v době kompilace programu GhostScript. Když byl gs kompilován pro systém Unix, makro GS_LIB_DEFAULT má obvykle hodnotu "/usr/local/share/ghostscript/#.##:/usr/local/share/ghostscript/fonts" kde "#.##" představuje číslo verze programu Ghostscript.

Každý z těchto parametrů (GS_LIB_DEFAULT, GS_LIB i parametr -I) může být buď jeden adresář, anebo seznam adresářů oddělených znakem ":".

X RESOURCES
Ghostscript používá následující resources pod jménem "Ghostscript":

borderWidth
    Šířka okraje udaná v bodech (default = 1).

borderColor
    Jméno barvy okraje (default = black).

geometry
    Velikost okna a jeho umístění, WxH+X+Y (default je NULL).

xResolution
    Počet bodů v ose x na jeden palec (default je vypočítán z WidthOfScreen a WidthMMOfScreen).

yResolution
    Počet bodů v ose x na jeden palec (default je výpočítán z HeightOfScreen a HeightMMOfScreen).

useBackingPixmap
    Rozhodne jestli je použit backing store na uložení původního obsahu okna (default = true).

Kompletní seznam resources je obsažen v dokumentu usage. Nastavení těchto parametrů na Unixu se přidá do souboru jako je např. "~/.Xresources" v následujícím tvaru:

	Ghostscript*geometry:	 612x792-0+0
	Ghostscript*xResolution: 72
	Ghostscript*yResolution: 72

Poté je potřeba vmísit tato nastavení do X server's resource database:

	% xrdb -merge ~/.Xresources

PŘEPÍNAČE

-- soubor arg1 ...
    Použije další argument jako jméno souboru obvyklým způsobem, ale všechny následující argumenty (i když mají syntaxi přepínačů) vezme a definuje jméno "ARGUMENTS" v "userdict" (nikoli v "systemdict") jako pole řetězců s jednotlivými argumenty. To provede ještě před spuštěním daného souboru. Po zpracování souboru se Ghostscript ukončí.

-Djméno=token
-djméno=token
    Definuje "jméno" v "systemdict" podle dané definice. Token musí být právě jeden token (jak je definováno operátorem "token") a nesmí obsahovat žádné prázdné znaky (mezery, tabelátory ...).

-Djméno
-djméno
    Definuje "jméno" v "systemdict" s hodnotou=null.

-Sjméno=řetězec
-sjméno=řetězec
    Definuje "jméno" v "systemdict" s daným řetězcem jako hodnotou. Toto se liši od -d. Například -djméno=35 je stejné jako takováto část programu
        /jméno 35 def
    zatímco -sname=35 představuje
        /jméno (35) def

-q  Tichý start: potlačí obvyklé počáteční zprávy. Je stejné jako -dQUIET.

-gčíslo1xčíslo2
    Stejné jako -dDEVICEWIDTH=číslo1 a -dDEVICEHEIGHT=číslo2. Slouží jako podpora zařízení (jako např. X11 windows), která požadují (nebo povolují) nastavení šírky a výšky.

-rčíslo
-rčíslo1xčíslo2
    Stejné jako -dDEVICEXRESOLUTION=číslo1 a -dDEVICEYRESOLUTION=číslo2. Slouží jako podpora takových zařízení jako např. tiskárny, které podporují vícero rozlišení v ose X a Y. Pokud je zadáno jen jedno číslo, bude použito pro nastavení rozlišení v obou směrech, X i Y.

-Iadresáře
    Přídá dvojtečkou oddělený seznam adresářů na začátek seznamu cest pro soubory knihoven.

-   Toto není skutečný přepínač, ale značí pro GhostScript, že standartní vstup přichází ze souboru nebo roury a není tedy interaktivně zadáván z příkazové řádky. Ghostscript čte standartní vstup dokud nedosáhne konce souboru a zpracovává jej jako každý jiný soubor. Poté pokračuje se zpracováním ostatních parametrů zadaných z příkzové řádky. Když jsou všechny parametry zpracovány, Ghostscript se ukončí a nepřepíná se už do svého interaktivního módu.

Standartní inicializační soubor "gs_init.ps" nastaví "systemdict" pouze pro čtení, takže hodnoty klíčů definovaných pomocí -D, -d, -S nebo -s nemohou být změněny (přestože mohou být samozřejmě nahrazeny definicemi v "userdict" nebo jiných slovnících)

SPECIÁLNÍ JMÉNA

-dDISKFONTS
    Způsobí, že definice jednotlivých znaků se budou nahrávat z disku a to teprve tehdy, kdy bude zaznamenán první takový znak. (Normálně Ghostscript nahraje tvaru všech znaků, když nahrává font.) To může dovolit nahrát více fontů do operační paměti za cenu pomalejšího renderingu.

-dNOCACHE
    Zakáže používání vyrovnávací paměťi pro znaky. Užitečné pouze pro ladění a odstraňování chyb.

-dNOBIND
    Zakáže operátor "bind". Užitečné pouze pro ladění a odstraňování chyb.

-dNODISPLAY
    Potlačí normální inicializaci výstupního zařízení. Užitečné pouze pro ladění a odstraňování chyb.

-dNOPAUSE
    Zakáže čekání na konci každé strany. To může být žádoucí v aplikacích kde jiný program řídí Ghostscript.

-dNOPLATFONTS
    Zakáže použití fontů nabízených danou platformou (například X Windows). To může být vhodné, pokud fonty dané platformy vypadají příliš odlišně než fonty s nastavitelnou velikostí.

-dSAFER
    Zakáže operátory "deletefile" a "renamefile" a schopnost otevírat soubory v jakémkoli jiném módu než jen pro čtení. To může být žádoucí citlivá přostředí a úlohy, kde musí být zamezeno špatně napsaným nebo poškozeným PostScriptovým programům měnit nebo mazat důležité soubory.

-dWRITESYSTEMDICT
    Nechá práva na zápis do "systemdict". To je nezbytné když se spouští zvláštní programy jako například font2c a pcharstr, které musí překonat normální ochranu přístupových práv PostScriptu.

-sDEVICE=zařízení
    Vybere jiné počáteční výstupní zařízení, jak bylo popsáno výše.

-sOutputFile=soubor
    Vybere výstupní soubor (resp. rouru) pro počáteční výstupní zařízení, jak bylo výše popsáno.

SOUBORY

Umístění mnoha souborů potřebných pro správný běh programu Ghostscript bylo zakompilováno přímo do kódu programu. V systému Unix se nacházejí zpravidla v /usr/local, ale ve vašem systému tomu může být jinak. V systému DOS jsou obvykle umístěny v C:\GS, ale mohou být i jinde, zvláště jestli byl Ghostscript instalován s programem GSview. Spuštěním "gs -h" je možné zjistit umístění dokumentace programu Ghostscript ve vašem systému, která obsahuje více podrobností.

/usr/local/share/ghostscript/#.##/*
    Inicializační soubory, pomůcky a základní definice fontů

/usr/local/share/ghostscript/fonts/*
    Další definice fontů

/usr/local/share/ghostscript/#.##/examples/*
    Ukázkové soubory používající Ghostscript

/usr/local/share/ghostscript/#.##/doc/*
    Rozličné soubory dokumentací

PROSTŘEDÍ

GS_OPTIONS
    Řetězec voleb, které se mají zpracovat před volbami z příkazové řádky.

GS_DEVICE
    Používá se k zadání výstupního zařízení.

GS_FONTPATH
    Cesty na kterých se mají hledat fonty.

GS_LIB
    Cesty, na kterých se mají hledat inicializační soubory a fonty.

TEMP
    Kam se mají ukládat dočasné soubory.

DALŠÍ INFORMACE
Různé soubory dokumentace programu Ghostscript (viz výše), zvlášte soubor Use.htm.

CHYBY
Sledujte Usenet news group comp.lang.postscript.

VERZE
Tento dokument byl naposledy revidován pro Ghostscript verze 6.0.

AUTOR
L. Peter Deutsch <ghost@aladdin.com> je autorem vlastního programu Ghostscript.
Russell J. Lang <rjl@aladdin.com> je autorem většiny MS Windows kódu Ghostscriptu.
Tuto manuálovou stránku přeložil Michal Ambrož (^_^) <Michal.Ambroz@post.cz>.