.\" -*- coding: UTF-8 -*-
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH "Podręcznik użytkownika xwdtopnm" 1 "8 stycznia 2010" "dokumentacja netpbm" 

.SH NAZWA
xwdtopnm \- konwertuje plik zrzutu ekranu X11 lub X10 na obraz PNM

.UN synopsis
.SH SKŁADNIA

\fBxwdtopnm\fP [\fB\-verbose\fP] [\fB\-headerdump\fP] [\fIplik_xwd\fP]

.UN description
.SH OPIS
.PP
Program jest częścią \fBNetpbm\fP(1).
.PP
\fBxwdtopnm\fP odczytuje plik zrzutu ekranu X11 lub X10 na wejściu i tworzy
obraz PNM na wyjściu. Rodzaj obrazu wyjściowego zależy od typu pliku
wejściowego. Jeżeli plik wejściowy jest czarno\-biały, tworzony jest plik
PBM. Jeżeli plik wejściowy jest w skali szarości, tworzony jest plik PGM. W
pozostałych przypadkach tworzony jest plik PPM. Program informuje
użytkownika, jaki rodzaj pliku jest tworzony.
.PP
Używając tego programu można utworzyć obraz PNM ze wszystkiego, co da się
wyświetlić na ekranie stacji roboczej. Wystarczy wyświetlić cokolwiek,
uruchomić program \fBxwd\fP aby przechwycić zawartość okna, dokonać konwersji
za pomocą \fBxwdtopnm\fP, a następnie użyć programu \fBpamcut\fP, by wybrać
interesujący fragment obrazu.
.PP
Proszę zauważyć, że pseudokolorowy obraz XWD (zwykle jest to to, co
otrzymuje się przy zrzuceniu pseudokolorowego okna X) ma wartość maksymalną
(maxval) 65535 co oznacza, że plik PNM utworzony przez \fBxwdtopnm\fP będzie
miał maxval równą 65535. Wiele starszych programów przetwarzających obrazy
(które nie są częścią pakietu Netpbm i nie używają biblioteki
programistycznej Netpbm) nie potrafią przetwarzać obrazów PNM z maxval
większą nić 255 (ponieważ są to dwa bajty zamiast jednego, dla każdej próbki
w obrazie). Przed przekazaniem wejścia do jednego z takich starszych
programów, można zatem przesłać wyjście \fBxwdtopnm\fP przez \fBpamdepth\fP.
.PP
\fBxwdtopnm\fP nie potrafi przekształcić każdego rodzaju obrazu XWD (co
zasadniczo oznacza, że nie potrafi przekształcić XWD utworzonego dla każdej
konfiguracji ekranu X). W szczególności, nie radzi sobie gdy występuje
więcej niż 24 bitów na piksel.


.UN options
.SH OPCJE
.PP
Oprócz opcji wspólnych wszystkim programom korzystającym z libnetpbm (przede wszystkim \fB\-quiet\fP) \fBxwdtopnm\fP rozpozna następujące opcje wiersza poleceń:


.TP 
\fB\-verbose\fP
Opcja powoduje wyświetlenie przez \fBxwdtopnm\fP przydatnych informacji o
obrazie wejściowym i procesie konwersji.

.TP 
\fB\-headerdump\fP
Opcja powoduje wyświetlenie przez \fBxwdtopnm\fP zawartość nagłówka X11. Nie ma
znaczenia, gdy wejściem jest X10. Jest to nowość w Netpbm 10.26 (z grudnia
2004 r.).



.UN notes
.SH UWAGI

.UN twobytesamples
.SS "Próbki dwubajtowe"
.PP
\fBxwdtopnm\fP niekiedy tworzy wyjście z maxval większą niż 255 co oznacza, że
maksymalna wartość próbki (wartość jednej intensywności np. czerwonej
składowej piksela) jest większa niż 255 i dlatego każda próbka potrzebuje 2
bajtów. Może stanowić to problem, ponieważ niektóre programy oczekują tych
bajtów w odmiennej kolejności, niż przewiduje to norma formatu Netpbm
(której przestrzega \fBxwdtopnm\fP), co oznacza, że zinterpretują one inne
kolory, niż powinny. Jednym z takich programów jest \fBxv\fP.
.PP
Jeśli stanowi to problem (np. chce się obejrzeć wynik działania \fBxwdtopnm\fP
za pomocą \fBxv\fP), są dwa sposoby na naprawienie tego:


.IP \(bu
Przekazanie wyjścia za pomocą \fBpamendian\fP, aby utworzyć format, jakiego
oczekuje program.
.IP \(bu
Przekazanie wyjścia za pomocą \fBpamdepth\fP, aby zredukować maxval poniżej
wartości 256, dzięki czemu każda próbka zajmie jedynie jeden bajt.

.PP
Często nie ma dobrego powodu, aby maxval miała więcej niż 255. Może się to
zdarzyć, ponieważ w XWD, lecz nie w PNM, każda składowa koloru piksela może
mieć różną rozdzielczość np. 5 bitów dla niebieskiego (maxval 31), 5 bitów
dla czerwonego (maxval 31) i 6 bitów dla zielonego (maxval 63), co w sumie
daje 16 bitów na piksel. Aby dokonać najlepszej możliwej reprodukcji
kolorów, \fBxwdtopnm\fP musi użyć większej maxval. W tym przykładzie,
skorzystałby z 31 * 63 = 1953 i użyłby 48 bitów na piksel.
.PP
Jest to na tyle częsty i frustrujący problem przy korzystaniu z \fBxwdtopnm\fP,
że program wypisuje ostrzeżenie za każdym razem, gdy na wyjściu powstają
próbki dwubajtowe. Można wyciszyć to ostrzeganie za pomocą opcji \fB\-quiet\fP
stanowiącej jedną z opcji ogólnych. Ostrzeganie pojawiło się w Netpbm 10.46
(z marca 2009 r.).


.UN seealso
.SH "ZOBACZ TAKŻE"
\fBpnmtoxwd\fP(1), \fBpamendian\fP(1), \fBpamdepth\fP(1), \fBpnm\fP(1), \fBxwd\fP(1)

.UN author
.SH AUTOR

Copyright (C) 1989, 1991 Jef Poskanzer.
.SH "ŹRÓDŁO DOKUMENTU"
Niniejszą stronę podręcznika wygenerowano za pomocą narzędzia Netpbm
\[Bq]makeman\[rq] ze źródeł HTML. Główna dokumentacja jest dostępna pod
adresem
.IP
\fBhttp://netpbm.sourceforge.net/doc/xwdtopnm.html\fP
.PP
.PP
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
Łukasz Kowalczyk <lukow@tempac.okwf.fuw.edu.pl>,
Robert Luberda <robert@debian.org>
i
Michał Kułach <michal.kulach@gmail.com>
.
.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 .
