.\" -*- coding: UTF-8 -*- .\" -*- nroff -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH GS 1 "21 września 2022 r." 10.00.0 Ghostscript .SH NAZWA gs \- Ghostscript (interpreter/przeglądarka języka PDF i PostScript) .SH SKŁADNIA \fBgs\fP [ \fIopcje\fP ] [ \fIpliki\fP ] ... .de TQ .br .ns .TP \\$1 .. .SH OPIS Polecenie \fBgs\fP wywołuje \fBGhostscript\fP, interpreter języków \fBPortable Document Format\fP (PDF) i \fBPostScript\fP(tm) firmy Adobe Systems. \fBgs\fP odczytuje kolejno "pliki" i wykonuje je jako programy Ghostscripta. Po zrobieniu tego, odczytuje dalsze wejście ze strumienia standardowego wejścia (zwykle klawiatura), interpretując każdy wiersz osobno i wysyłając wyjście na urządzenie wyjściowe (może być to plik lub okno przeglądarki X11, zob. niżej). Interpreter kończy działanie po napotkaniu polecenia "quit" (w pliku lub po wpisaniu z klawiatury), po osiągnięciu końca pliku oraz po otrzymaniu sygnału przerwania (np. Control\-C z klawiatury). .PP Interpreter rozpoznaje wiele przełączników opcji, część z których opisano poniżej. Zob. dokumentację aby dowiedzieć się szczegółów. Przełączniki mogą pojawić się w dowolnym miejscu wiersza polecenia i stosują się do wszystkich następujących po nich plikach. Wywołanie Ghostscript z przełącznikiem \fB\-h\fP lub \fB\-?\fP wypisuje komunikat informujący o wielu przydatnych przełącznikach, wszystkich znanych plikowi wykonywalnemu urządzeniach oraz ścieżce przeszukiwania fontów; w systemach uniksowych pokazuje również położenie pełnej dokumentacji. .PP Ghostscript może być zbudowany z możliwością korzystania z wielu różnych urządzeń wyjściowych. Listę urządzeń, które obejmuje używany plik wykonywalny pokaże polecenie "\fBgs \-h\fP". .PP O ile nie poda się konkretnego urządzenia, Ghostscript zwykle otworzy pierwsze z nich i przekieruje do niego swoje wyjście. .PP Jeśli zainstalowano pakiet Debiana ghostscript\-x i działa się pod X, domyślnym urządzeniem jest okno X11 (przeglądarka), w innym przypadku ghostscript zwykle użyje urządzenia bbox i wypisze na standardowe wyjście wymiary pliku postscript. .PP Jeśli zatem urządzenie, z którego chce się skorzystać jest pierwsze na liście, wystarczy wydać polecenie .PP .nf gs mojplik.ps .fi .PP Można również sprawdzić listę dostępnych urządzeń wewnątrz Ghostscript: należy wywołać Ghostscript i wpisać .PP .nf devicenames == .fi .PP lecz pierwsze urządzenie na wynikowej liście nie musi być domyślnym urządzeniem, które można ustalić poleceniem "\fBgs \-h\fP". Aby ustawić "AbcXyz" jako pierwotne urządzenie wyjściowe, należy dołączyć przełącznik .PP .nf \-sDEVICE=AbcXyz .fi .PP Na przykład, aby utworzyć wyjście do drukarki Epson, można podać .PP .nf gs \-sDEVICE=epson mojplik.ps .fi .PP "\-sDEVICE=" musi poprzedzać pierwsze wystąpienie pliku do wydrukowania i jedynie pierwsze wystąpienie przełącznika odnosi skutek. .PP Można również zdefiniować domyślne urządzenie w zmiennej środowiskowej \fBGS_DEVICE\fP. Priorytety tych sposobów, od najwyższego do najniższego to (Ghostscript używa urządzenia zdefiniowanego najwyżej w tej liście): .PP Niektóre urządzenia mogą obsługiwać różne rozdzielczości (gęstości). Aby określić rozdzielczość takiej drukarki, należy użyć przełącznika "\-r": .PP .nf gs \-sDEVICE= \-rx .fi .PP Np. tryb najniższej gęstości na 9 igłowym Epsonie można uzyskać przez .PP .nf gs \-sDEVICE=epson \-r60x72 .fi .PP a tryb najwyższej gęstości (najwyższej jakości druku) przez .PP .nf gs \-sDEVICE=epson \-r240x72. .fi .PP Jeśli jako urządzenie wyjściowe wybierze się drukarkę, Ghostscript umożliwi wybór tego, gdzie urządzenie wysyła swoje wyjście \-\- na systemach uniksowych zwykle jest to plik tymczasowy. Aby wysłać wyjście do pliku "foo.xyz", należy użyć przełącznika .PP .nf \-sOutputFile=foo.xyz .fi .PP Można również zechcieć wydrukować każdą stronę oddzielnie. Aby to zrobić, można wysłać wyjście do serii plików "foo1.xyz, foo2.xyz, ..." przełącznikiem "\-sOutputFile=" oraz z "%d" w szablonie nazwy pliku: .PP .nf \-sOutputFile=foo%d.xyz .fi .PP Każdy wynikowy plik otrzymuje po jednej stronie wyjścia, a pliki są ponumerowane. "%d" jest określeniem formatu printf, można podać również wariant taki jak "%02d". .PP Wyjście można przesłać również przez potok. Na przykład, aby przesłać wyjście polecenia \fBlpr\fP (które pod wieloma systemami uniksowymi jest poleceniem przesyłającym do drukarki), należy użyć opcji .PP .nf \-sOutputFile=%pipe%lpr .fi .PP Można również wysłać wyjście na standardowe wyjście: .PP .nf \-sOutputFile=\- .fi lub .nf \-sOutputFile=%stdout% .fi .PP W tym wypadku musisz też użyć przełącznika \fB\-q\fP, aby uchronić Ghostscript przed drukowaniem na stdout komunikatów. .PP Aby wybrać inny rozmiar papieru, użyj przełącznika linii komend .PP .nf \-sPAPERSIZE= .fi .PP na przykład .PP .nf \-sPAPERSIZE=a4 .fi lub .nf \-sPAPERSIZE=legal .fi .PP Rozpoznawanych jest większość rozmiarów papieru ISO i US. Pełną listę zawiera dokumentacja oraz definicje pliki inicjalizacyjnego "gs_statd.ps". .PP Ghostscript może zrobić wiele innych rzeczy niż wydruk lub wyświetlenie plików PostScript i PDF. Jeśli oczekiwane jest np. poznanie wielkości prostokąta ograniczającego z pliku PostScript (lub EPS), Ghostscript zapewnia specjalne "urządzenie", którego jedynym zadaniem jest wypisanie tej informacji. .PP Na przykład, korzystając z jednego z przykładowych plików rozprowadzanych razem z Ghostscript: .PP .nf gs \-sDEVICE=bbox golfer.ps .fi .PP wypisuje .PP .nf %%BoundingBox: 0 25 583 732 %%HiResBoundingBox: 0.808497 25.009496 582.994503 731.809445 .fi .SH OPCJE .TP \fB\-\-\fP\fI nazwapliku arg1 ...\fP Bierze następny argument jako nazwę pliku, lecz pozostałe argumenty pobiera i definiuje nazwę "ARGUMENTS" w "userdict" (nie w "systemdict") jako tablicę tych łańcuchów, \fBprzed\fP uruchomieniem pliku. Gdy Ghostscript zakończy wykonywanie pliku, wychodzi do powłoki. .TP \fB\-D\fP\fInazwa\fP\fB=\fP\fItoken\fP .TQ \fB\-d\fP\fInazwa\fP\fB=\fP\fItoken\fP Definiuj nazwę w "systemdict" na podaną definicję. Token musi być dokładnie jeden (jak zdefiniowano operatorem `token') i nie może zawierać białych spacji. .TP \fB\-D\fP\fInazwa\fP .TQ \fB\-d\fP\fInazwa\fP Definiuj nazwę w "systemdict", której wartość wynosi null. .TP \fB\-S\fP\fInazwa\fP\fB=\fP\fInapis\fP .TQ \fB\-s\fP\fInazwa\fP\fB=\fP\fInapis\fP Definiuj nazwę w "systemdict" na podaną wartość napisową. Jest to różne od \fB\-d\fP. Na przykład, \fB\-dnazwa=35\fP jest równoważne fragmentowi programu .br /nazwa 35 def .br podczas gdy \fB\-snazwa=35\fP jest równoważne .br /nazwa (35) def .TP \fB\-P\fP Zmusza Ghostscript, aby najpierw sprawdzić katalog bieżący w poszukiwaniu plików bibliotecznych. Domyślnie, Ghostscript nie sprawdza już bieżącego katalogu o ile, oczywiście, pierwszym podanym katalogiem w \fB\-I\fP nie jest jawne ".". Zob. też \fBPLIKI INICJALIZACYJNE\fP oraz dostarczony plik \fBUse.htm\fP, aby dowiedzieć się więcej o ścieżkach przeszukiwania i trybie wyszukiwania plików przez Ghostcript. .TP \fB\-q\fP Ciche uruchamianie: nie drukuj normalnych komunikatów startowych i rób to, co \fB\-dQUIET\fP. .TP \fB\-g\fP\fIliczba1\fP\fBx\fP\fIliczba2\fP Równoważne z \fB\-dDEVICEWIDTH=\fP\fIliczba1\fP i \fB\-dDEVICEHEIGHT=\fP\fIliczba2\fP. Jest to dla użytku urządzeń (takich jak okna X11), które wymagają (lub zezwalają) na podanie wysokości i szerokości. .TP \fB\-r\fP\fIliczba\fP .TQ \fB\-r\fP\fIliczba1\fP\fBx\fP\fIliczba2\fP Równoważne z \fB\-dDEVICEXRESOLUTION=\fP\fIliczba1\fP i \fB\-dDEVICEYRESOLUTION=\fP\fIliczba2\fP. Jest to dla użytku urządzeń (takich jak drukarki), które obsługują wiele rozdzielczości X i Y. Jeśli podana jest tylko jedna liczba, to używana jest ona dla rozdzielczości zarówno X jak i Y. .TP \fB\-I\fP\fIkatalogi\fP Dodaje podaną listę katalogów na początek ścieżki przeszukiwania plików bibliotecznych. .TP \fB\-\fP Nie jest to tak naprawdę przełącznik, lecz wskazuje Ghostscriptowi, że standardowe wejście pochodzi z pliku lub potoku, a nie interaktywnie, z wiersza poleceń. Ghostscript odczytuje to wejście aż do końca pliku, wykonując je jak każdy inny plik, a następnie kontynuuje przetwarzanie wiersza poleceń. Po przetworzeniu całego wiersza poleceń, Ghostscript kończy działanie, zamiast przechodzić do trybu interaktywnego. .PP Proszę zauważyć, że zwykły plik inicjalizacji "gs_init.ps" powoduje, że "systemdict" staje się dostępny tylko dla odczytu, więc wartości nazw zdefiniowanych przez \fB\-D\fP, \fBd\fP, \fBS\fP lub \fBs\fP nie mogą być zmieniane (choć oczywiście mogą być powstrzymywane przez definicje w "userdict" lub innych słownikach). .SH "NAZWY SPECJALNE" .TP \fB\-dNOCACHE\fP Wyłącza buforowanie znaków. Przydatne tylko dla debuggowania. .TP \fB\-dNOBIND\fP Wyłącza operator `bind'. Przydatne dla debuggowania. .TP \fB\-dNODISPLAY\fP Powstrzymuje normalną inicjalizację urządzenia wyjściowego. Może to być przydatne dla debuggowania. .TP \fB\-dNOPAUSE\fP Wyłącza znak zachęty i pauzowanie na końcu każdej strony. Może to być przydatne dla aplikacji, gdzie inny program kieruje Ghostscriptem. .TP \fB\-dNOPLATFONTS\fP Wyłącza używanie fontów, przekazanych przez podlegającą platformę (np. X Window System). Może to być potrzebne jeśli fonty platformy wyglądają gorzej niż fonty skalowalne. .TP \fB\-dSAFER\fP Ogranicza operacje na plikach, jakie może wykonać zadanie. Obecnie jest to domyślny tryb działania. .TP \fB\-dWRITESYSTEMDICT\fP Pozostawia "systemdict" w stanie zezwolenia na zapis. Jest to potrzebne podczas uruchamiania specjalnych programów narzędziowych, lecz jest odradzane, ponieważ obchodzi normalne zabezpieczenia PostScript. .TP \fB\-sDEVICE=\fP\fIurządzenie\fP Wybierz alternatywne początkowe urządzenie wyjściowe. .TP \fB\-sOutputFile=\fP\fInazwapliku\fP Wybierz alternatywny plik wyjściowy (lub łącze) dla początkowego urządzenia wyjściowego. .SH "TRYB SAFER (BEZPIECZNIEJSZY)" .PP Opcja \fB\-dSAFER\fP ogranicza dostęp na poziomie systemu plików do tych plików i katalogów, które dozwolono odpowiednimi zmiennymi środowiskowymi (takimi jak GS_LIB) lub parametrami wiersza poleceń (więcej szczegółów pod adresem https://ghostscript.com/doc/current/Use.htm). .PP Tryb SAFER jest obecnie domyślnym trybem działania. Z tego względu, uruchamiając programy potrzebujące otwierać pliki lub zastrzeżone parametry, należy podać opcję wiersza poleceń \fB\-dNOSAFER\fP lub jej synonim \fB\-dDELAYSAFER\fP. .PP Działanie z NOSAFER/DELAYSAFER (jak sama nazwa sugeruje) ogranicza bezpieczeństwo, dlatego tryb ten jest zalecany TYLKO do debugowania lub w BARDZO kontrolowanych warunkach i bardzo ODRADZA się go w innych okolicznościach. .SH PLIKI .PP Położenie wielu plików uruchomieniowych Ghostscript jest wkompilowane w plik wykonywalny w momencie budowania go. Polecenie "\fBgs \-h\fP" pokaże położenie dokumentacji Ghostscript na danym systemie, co pozwoli dowiedzieć się więcej. W dystrybucji Debian pliki znajdują się w katalogu \fB/usr\fP. .TP \fB/usr/share/ghostscript/[0\-9]*.[0.9]*/*\fP Pliki startowe, narzędzia i podstawowe definicje fontów (gdzie [0\-9]*.[0.9]* jest wersją ghostscript) .TP \fB/usr/share/fonts/type1/gsfonts/*\fP Więcej definicji fontów z pakietu gsfonts .TP \fB/usr/share/doc/ghostscript/examples/*\fP Pliki demonstracyjne Ghostscript (jeśli zainstalowano pakiet ghostscript\-doc) .TP \fB/usr/share/doc/ghostscript/*\fP Różnorodne pliki z dokumentacją (mogą wymagać instalacji pakietu ghostscript\-doc) .SH "PLIKI INICJALIZACYJNE" Szukając plików inicjalizacyjnych "gs_*.ps", plików związanych z fontami, lub pliku dla operatora "run", Ghostscript najpierw próbuje otworzyć plik o podanej nazwie w bieżącym katalogu, jeśli nie podano innego. Jeśli to się nie powiedzie, a nazwa pliku nie wskazuje jawnie katalogu lub napędu (np. nie zawiera "/" w systemach uniksowych) Ghostscript próbuje skorzystać z następujących katalogów (odpowiednio w kolejności): .TP 4 1. Katalogi podane przełącznikami \fB\-I\fP w wierszu poleceń (zob. niżej); .TP 2. Katalogi podane w zmiennej środowiskowej \fBGS_LIB\fP; .TP 3. katalogi określone przez makro \fBGS_LIB_DEFAULT\fP w pliku makefile Ghostscript, z momentu budowania pliku wykonywalnego. \fBGS_LIB_DEFAULT\fP wynosi w systemie Debian "/usr/share/ghostscript/[0\-9]*.[0\-9]*/lib", gdzie "[0\-9]*.[0\-9]*" jest numerem wersji Ghostscript .PP Katalogi podane w ten sposób (jako \fBGS_LIB_DEFAULT\fP, \fBGS_LIB\fP i parametr \fB\-I\fP) mogą być pojedynczymi katalogami lub listami katalogów, rozdzielonymi znakiem ":". .SH ŚRODOWISKO .TP \fBGS_OPTIONS\fP Łańcuch opcji do przetworzenia przed opcjami wiersza poleceń .TP \fBGS_DEVICE\fP Służy do określenia urządzenia wyjściowego .TP \fBGS_FONTPATH\fP Ścieżki do wyszukiwania fontów .TP \fBGS_LIB\fP Ścieżki z plikami inicjującymi i fontami .TP \fBTEMP\fP Miejsce, gdzie tworzone są pliki tymczasowe .SH "ZASOBY X" Ghostscript, albo, ściślej, urządzenie wyświetlacza X11, szuka następujących zasobów dla programu o nazwie "Ghostscript": .TP \fBborderWidth\fP Szerokość ramki w pikselach (domyślnie = 1). .TP \fBborderColor\fP Nazwa koloru ramki (domyślnie = black). .TP \fBgeometry\fP Rozmiar okna i jego położenie WxH+X+Y (domyślnie NULL). .TP \fBxResolution\fP Liczba pikseli x na cal (domyślnie obliczana z \fBWidthOfScreen\fP i \fBWidthMMOfScreen\fP). .TP \fByResolution\fP Liczba pikseli y na cal (domyślnie obliczana z \fBHeightOfScreen\fP i \fBHeightMMOfScreen\fP). .TP \fBuseBackingPixmap\fP Określa czy używać mechanizmu backing store do zachowywania okna wyświetlania (domyślnie = true). .PP Dokument na temat użycia programu opisuje pełniejszą listę zasobów. Aby ustawić te zasoby w systemach uniksowych, należy je wstawić do pliku, takiego jak "~/.Xresources", w następującej postaci: .PP .nf Ghostscript*geometry: 612x792\-0+0 Ghostscript*xResolution: 72 Ghostscript*yResolution: 72 .fi .PP Następnie proszę połączyć te zasoby z bazą danych zasobów serwera X: .PP .nf % xrdb \-merge ~/.Xresources .fi .SH "ZOBACZ TAKŻE" Różne pliki dokumentacji Ghostscript (zob wyżej), szczególnie \fBUse.htm\fP. W dystrybucji Debian może być konieczne uprzednie zainstalowanie pakietu ghostscript\-doc. .SH USTERKI Zobacz http://bugs.ghostscript.com/ oraz grupę dyskusyjną Usenet comp.lang.postscript. .SH WERSJA Dokument uaktualniono według stanu na Ghostscript w wersji 10.00.0. .SH AUTOR Głównym opiekunem Ghostscript jest Artifex Software, Inc. Russell J. Lang, gsview at ghostgum.com.au, jest autorem większości kodu Ghostscript w systemie MS Windows. .PP .SH TŁUMACZENIE Tłumaczenie niniejszej strony podręcznika: Przemek Borys i Michał Kułach . .PP Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License w wersji 3 .UE lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. .PP Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej .MT manpages-pl-list@lists.sourceforge.net .ME .