GS(1) Ghostscript GS(1) NAZWA gs - Ghostscript (interpreter/przegladarka jezyka PDF i PostScript) SKLADNIA gs [ opcje ] [ pliki ] ... (Unix, VMS) gswin32c [ opcje ] [ pliki ] ... (MS Windows) gswin32 [ opcje ] [ pliki ] ... (MS Windows 3.1) gsos2 [ opcje ] [ pliki ] ... (OS/2) OPIS Polecenie gs (gswin32c, gswin32, gsos2) wywoluje Ghostscript, interpreter jezykow Portable Document Format (PDF) i PostScript(tm) firmy Adobe Systems. gs odczytuje kolejno "pliki" i wykonuje je jako programy Ghostscripta. Po zrobieniu tego, odczytuje dalsze wejscie ze strumienia standardowego wejscia (zwykle klawiatura), interpretujac kazdy wiersz osobno i wysylajac wyjscie na urzadzenie wyjsciowe (moze byc to plik lub okno przegladarki X11, zob. nizej). Interpreter konczy dzialanie po napotkaniu polecenia "quit" (w pliku lub po wpisaniu z klawiatury), po osiagnieciu konca pliku oraz po otrzymaniu sygnalu przerwania (np. Control-C z klawiatury). Interpreter rozpoznaje wiele przelacznikow opcji, czesc z ktorych opisano ponizej. Zob. dokumentacje aby dowiedziec sie szczegolow. Przelaczniki moga pojawic sie w dowolnym miejscu wiersza polecenia i stosuja sie do wszystkich nastepujacych po nich plikach. Wywolanie Ghostscript z przelacznikiem -h lub -? wypisuje komunikat informujacy o wielu przydatnych przelacznikach, wszystkich znanych plikowi wykonywalnemu urzadzeniach oraz sciezce przeszukiwania fontow; w systemach uniksowych pokazuje rowniez polozenie pelnej dokumentacji. Ghostscript moze byc zbudowany z mozliwoscia korzystania z wielu roznych urzadzen wyjsciowych. Liste urzadzen, ktore obejmuje uzywany plik wykonywalny pokaze polecenie "gs -h". O ile nie poda sie konkretnego urzadzenia, Ghostscript zwykle otworzy pierwsze z nich i przekieruje do niego swoje wyjscie. Jesli program zbudowano z obsluga X11, czesto domyslnym urzadzeniem jest okno X11 (przegladarka), w innym przypadku ghostscript zwykle uzyje urzadzenia bbox i wypisze na standardowe wyjscie wymiary pliku postscript. Jesli zatem urzadzenie, z ktorego chce sie skorzystac jest pierwsze na liscie, wystarczy wydac polecenie gs mojplik.ps Mozna rowniez sprawdzic liste dostepnych urzadzen wewnatrz Ghostscript: nalezy wywolac Ghostscript i wpisac devicenames == lecz pierwsze urzadzenie na wynikowej liscie nie musi byc domyslnym urzadzeniem, ktore mozna ustalic poleceniem "gs -h". Aby ustawic "AbcXyz" jako pierwotne urzadzenie wyjsciowe, nalezy dolaczyc przelacznik -sDEVICE=AbcXyz Na przyklad, aby utworzyc wyjscie do drukarki Epson, mozna podac gs -sDEVICE=epson mojplik.ps "-sDEVICE=" musi poprzedzac pierwsze wystapienie pliku do wydrukowania i jedynie pierwsze wystapienie przelacznika odnosi skutek. Mozna rowniez zdefiniowac domyslne urzadzenie w zmiennej srodowiskowej GS_DEVICE. Priorytety tych sposobow, od najwyzszego do najnizszego to (Ghostscript uzywa urzadzenia zdefiniowanego najwyzej w tej liscie): setpagedevice (wiersz polecenia) GS_DEVICE (pierwsze urzadzenie na liscie wbudowanej) Niektore urzadzenia moga obslugiwac rozne rozdzielczosci (gestosci). Aby okreslic rozdzielczosc takiej drukarki, nalezy uzyc przelacznika "-r": gs -sDEVICE= -rx Np. tryb najnizszej gestosci na 9 iglowym Epsonie mozna uzyskac przez gs -sDEVICE=epson -r60x72 a tryb najwyzszej gestosci (najwyzszej jakosci druku) przez gs -sDEVICE=epson -r240x72. Jesli jako urzadzenie wyjsciowe wybierze sie drukarke, Ghostscript umozliwi wybor tego, gdzie urzadzenie wysyla swoje wyjscie -- na systemach uniksowych zwykle jest to plik tymczasowy. Aby wyslac wyjscie do pliku "foo.xyz", nalezy uzyc przelacznika -sOutputFile=foo.xyz Mozna rowniez zechciec wydrukowac kazda strone oddzielnie. Aby to zrobic, mozna wyslac wyjscie do serii plikow "foo1.xyz, foo2.xyz, ..." przelacznikiem "-sOutputFile=" oraz z "%d" w szablonie nazwy pliku: -sOutputFile=foo%d.xyz Kazdy wynikowy plik otrzymuje po jednej stronie wyjscia, a pliki sa ponumerowane. "%d" jest okresleniem formatu printf, mozna podac rowniez wariant taki jak "%02d". Na systemach uniksowych i MS Windows wyjscie mozna przeslac rowniez przez potok. Na przyklad, aby przeslac wyjscie polecenia lpr (ktore pod wieloma systemami uniksowymi jest poleceniem przesylajacym do drukarki), nalezy uzyc opcji -sOutputFile=%pipe%lpr Prosze zauwazyc, ze znak "%" nalezy podwoic w systemach MS Windows, aby uniknac znieksztalcenia przez interpreter powloki. Mozna rowniez wyslac wyjscie na standardowe wyjscie: -sOutputFile=- lub -sOutputFile=%stdout% W tym wypadku musisz tez uzyc przelacznika -q, aby uchronic Ghostscript przed drukowaniem na stdout komunikatow. Aby wybrac inny rozmiar papieru, uzyj przelacznika linii komend -sPAPERSIZE= na przyklad -sPAPERSIZE=a4 lub -sPAPERSIZE=legal Rozpoznawanych jest wiekszosc rozmiarow papieru ISO i US. Pelna liste zawiera dokumentacja oraz definicje pliki inicjalizacyjnego "gs_statd.ps". Ghostscript moze zrobic wiele innych rzeczy niz wydruk lub wyswietlenie plikow PostScript i PDF. Jesli oczekiwane jest np. poznanie wielkosci prostokata ograniczajacego z pliku PostScript (lub EPS), Ghostscript zapewnia specjalne "urzadzenie", ktorego jedynym zadaniem jest wypisanie tej informacji. Na przyklad, korzystajac z jednego z przykladowych plikow rozprowadzanych razem z Ghostscript: gs -sDEVICE=bbox golfer.ps wypisuje %%BoundingBox: 0 25 583 732 %%HiResBoundingBox: 0.808497 25.009496 582.994503 731.809445 OPCJE -- nazwapliku arg1 ... Bierze nastepny argument jako nazwe pliku, lecz pozostale argumenty pobiera i definiuje nazwe "ARGUMENTS" w "userdict" (nie w "systemdict") jako tablice tych lancuchow, przed uruchomieniem pliku. Gdy Ghostscript zakonczy wykonywanie pliku, wychodzi do powloki. -Dnazwa=token -dnazwa=token Definiuj nazwe w "systemdict" na podana definicje. Token musi byc dokladnie jeden (jak zdefiniowano operatorem `token') i nie moze zawierac bialych spacji. -Dnazwa -dnazwa Definiuj nazwe w "systemdict", ktorej wartosc wynosi null. -Snazwa=napis -snazwa=napis Definiuj nazwe w "systemdict" na podana wartosc napisowa. Jest to rozne od -d. Na przyklad, -dnazwa=35 jest rownowazne fragmentowi programu /nazwa 35 def podczas gdy -snazwa=35 jest rownowazne /nazwa (35) def -P Zmusza Ghostscript, aby najpierw sprawdzic katalog biezacy w poszukiwaniu plikow bibliotecznych. Domyslnie, Ghostscript nie sprawdza juz biezacego katalogu o ile, oczywiscie, pierwszym podanym katalogiem w -I nie jest jawne ".". Zob. tez PLIKI INICJALIZACYJNE oraz dostarczony plik Use.htm, aby dowiedziec sie wiecej o sciezkach przeszukiwania i trybie wyszukiwania plikow przez Ghostcript. -q Ciche uruchamianie: nie drukuj normalnych komunikatow startowych i rob to, co -dQUIET. -gliczba1xliczba2 Rownowazne z -dDEVICEWIDTH=liczba1 i -dDEVICEHEIGHT=liczba2. Jest to dla uzytku urzadzen (takich jak okna X11), ktore wymagaja (lub zezwalaja) na podanie wysokosci i szerokosci. -rliczba -rliczba1xliczba2 Rownowazne z -dDEVICEXRESOLUTION=liczba1 i -dDEVICEYRESOLUTION=liczba2. Jest to dla uzytku urzadzen (takich jak drukarki), ktore obsluguja wiele rozdzielczosci X i Y. Jesli podana jest tylko jedna liczba, to uzywana jest ona dla rozdzielczosci zarowno X jak i Y. -Ikatalogi Dodaje podana liste katalogow na poczatek sciezki przeszukiwania plikow bibliotecznych. - Nie jest to tak naprawde przelacznik, lecz wskazuje Ghostscriptowi, ze standardowe wejscie pochodzi z pliku lub potoku, a nie interaktywnie, z wiersza polecen. Ghostscript odczytuje to wejscie az do konca pliku, wykonujac je jak kazdy inny plik, a nastepnie kontynuuje przetwarzanie wiersza polecen. Po przetworzeniu calego wiersza polecen, Ghostscript konczy dzialanie, zamiast przechodzic do trybu interaktywnego. Prosze zauwazyc, ze zwykly plik inicjalizacji "gs_init.ps" powoduje, ze "systemdict" staje sie dostepny tylko dla odczytu, wiec wartosci nazw zdefiniowanych przez -D, d, S lub s nie moga byc zmieniane (choc oczywiscie moga byc powstrzymywane przez definicje w "userdict" lub innych slownikach). NAZWY SPECJALNE -dNOCACHE Wylacza buforowanie znakow. Przydatne tylko dla debuggowania. -dNOBIND Wylacza operator `bind'. Przydatne dla debuggowania. -dNODISPLAY Powstrzymuje normalna inicjalizacje urzadzenia wyjsciowego. Moze to byc przydatne dla debuggowania. -dNOPAUSE Wylacza znak zachety i pauzowanie na koncu kazdej strony. Moze to byc przydatne dla aplikacji, gdzie inny program kieruje Ghostscriptem. -dNOPLATFONTS Wylacza uzywanie fontow, przekazanych przez podlegajaca platforme (np. X Window System). Moze to byc potrzebne jesli fonty platformy wygladaja gorzej niz fonty skalowalne. -dSAFER Ogranicza operacje na plikach, jakie moze wykonac zadanie. Obecnie jest to domyslny tryb dzialania. -dWRITESYSTEMDICT Pozostawia "systemdict" w stanie zezwolenia na zapis. Jest to potrzebne podczas uruchamiania specjalnych programow narzedziowych, lecz jest odradzane, poniewaz obchodzi normalne zabezpieczenia PostScript. -sDEVICE=urzadzenie Wybierz alternatywne poczatkowe urzadzenie wyjsciowe. -sOutputFile=nazwapliku Wybierz alternatywny plik wyjsciowy (lub lacze) dla poczatkowego urzadzenia wyjsciowego. TRYB SAFER (BEZPIECZNIEJSZY) Opcja -dSAFER ogranicza dostep na poziomie systemu plikow do tych plikow i katalogow, ktore dozwolono odpowiednimi zmiennymi srodowiskowymi (takimi jak GS_LIB) lub parametrami wiersza polecen (wiecej szczegolow pod adresem https://ghostscript.com/doc/current/Use.htm). Tryb SAFER jest obecnie domyslnym trybem dzialania. Z tego wzgledu, uruchamiajac programy potrzebujace otwierac pliki lub zastrzezone parametry, nalezy podac opcje wiersza polecen -dNOSAFER lub jej synonim -dDELAYSAFER. Dzialanie z NOSAFER/DELAYSAFER (jak sama nazwa sugeruje) ogranicza bezpieczenstwo, dlatego tryb ten jest zalecany TYLKO do debugowania lub w BARDZO kontrolowanych warunkach i bardzo ODRADZA sie go w innych okolicznosciach. PLIKI Polozenie wielu plikow uruchomieniowych Ghostscript jest wkompilowane w plik wykonywalny w momencie budowania go. Na systemach uniksowych jest to zwykle lokalizacja zwiazana z /usr/local, lecz moze byc inna w zaleznosci od systemu. W systemie DOS zwykle bedzie to C:\GS, lecz moze to byc tez calkiem inne miejsce, szczegolnie jesli Ghostscript zainstalowano za pomoca GSview. Polecenie "gs -h" pokaze polozenie dokumentacji Ghostscript na danym systemie, co pozwoli dowiedziec sie wiecej. /usr/local/share/ghostscript/#.##/* Pliki startowe, narzedzia i podstawowe definicje fontow. /usr/local/share/ghostscript/fonts/* Dodatkowe definicje fontow /usr/local/share/ghostscript/#.##/examples/* Demonstracyjne pliki Ghostscript /usr/local/share/ghostscript/#.##/doc/* Dokumentacja PLIKI INICJALIZACYJNE Szukajac plikow inicjalizacyjnych "gs_*.ps", plikow zwiazanych z fontami, lub pliku dla operatora "run", Ghostscript najpierw probuje otworzyc plik o podanej nazwie w biezacym katalogu, jesli nie podano innego. Jesli to sie nie powiedzie, a nazwa pliku nie wskazuje jawnie katalogu lub napedu (np. nie zawiera "/" w systemach uniksowych lub "\" w MS Windows) Ghostscript probuje skorzystac z nastepujacych katalogow (odpowiednio w kolejnosci): 1. Katalogi podane przelacznikami -I w wierszu polecen (zob. nizej); 2. Katalogi podane w zmiennej srodowiskowej GS_LIB; 3. Katalogi podane w makrze GS_LIB_DEFAULT, w pliku makefile Ghostscripta, gdy budowano plik wykonywalny. Przy budowaniu gs w systemach uniksowych GS_LIB_DEFAULT wynosi zwykle "/usr/local/share/ghostscript/#.##:/usr/local/share/ghostscript/fonts" gdzie "#.##" odpowiada wersji Ghostscript Katalogi podane w ten sposob (jako GS_LIB_DEFAULT, GS_LIB i parametr -I) moga byc pojedynczymi katalogami lub listami katalogow, rozdzielonymi znakiem ":". SRODOWISKO GS_OPTIONS Lancuch opcji do przetworzenia przed opcjami wiersza polecen GS_DEVICE Sluzy do okreslenia urzadzenia wyjsciowego GS_FONTPATH Sciezki do wyszukiwania fontow GS_LIB Sciezki z plikami inicjujacymi i fontami TEMP Miejsce, gdzie tworzone sa pliki tymczasowe ZASOBY X Ghostscript, albo, scislej, urzadzenie wyswietlacza X11, szuka nastepujacych zasobow dla programu o nazwie "Ghostscript": borderWidth Szerokosc ramki w pikselach (domyslnie = 1). borderColor Nazwa koloru ramki (domyslnie = black). geometry Rozmiar okna i jego polozenie WxH+X+Y (domyslnie NULL). xResolution Liczba pikseli x na cal (domyslnie obliczana z WidthOfScreen i WidthMMOfScreen). yResolution Liczba pikseli y na cal (domyslnie obliczana z HeightOfScreen i HeightMMOfScreen). useBackingPixmap Okresla czy uzywac mechanizmu backing store do zachowywania okna wyswietlania (domyslnie = true). Dokument na temat uzycia programu opisuje pelniejsza liste zasobow. Aby ustawic te zasoby w systemach uniksowych, nalezy je wstawic do pliku, takiego jak "~/.Xresources", w nastepujacej postaci: Ghostscript*geometry: 612x792-0+0 Ghostscript*xResolution: 72 Ghostscript*yResolution: 72 Nastepnie prosze polaczyc te zasoby z baza danych zasobow serwera X: % xrdb -merge ~/.Xresources ZOBACZ TAKZE Rozne pliki dokumentacji Ghostscript (zob wyzej), szczegolnie Use.htm. USTERKI Zobacz http://bugs.ghostscript.com/ oraz grupe dyskusyjna Usenet comp.lang.postscript. WERSJA Dokument uaktualniono wedlug stanu na Ghostscript w wersji 10.04.0. AUTOR Glownym opiekunem Ghostscript jest Artifex Software, Inc. Russell J. Lang, gsview at ghostgum.com.au, jest autorem wiekszosci kodu Ghostscript w systemie MS Windows. TLUMACZENIE Tlumaczenie niniejszej strony podrecznika: Przemek Borys i Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . 10.04.0 18 wrzesnia 2024 r. GS(1)