File: ppm.5

package info (click to toggle)
manpages-pl 1%3A0.7-1
  • links: PTS, VCS
  • area: main
  • in suites: buster, stretch
  • size: 22,276 kB
  • ctags: 7
  • sloc: sh: 112; makefile: 59; perl: 32
file content (162 lines) | stat: -rw-r--r-- 7,381 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\" This file is distributed under the same license as original manpage
.\" Copyright of the original manpage:
.\" Copyright © 1989,1991 Jef Poskanzer (MIT)
.\" Copyright © of Polish translation:
.\" Przemek Borys (PTM) <pborys@dione.ids.pl>, 2000.
.\" Robert Luberda <robert@debian.org>, 2014, 2017.
.TH ppm 5 "8 kwietnia 2000"  
.SH NAZWA
ppm \- przenośny format pixmap
.SH OPIS
Jest to prosty format pixmapowy przeznaczony do obrazów kolorowych.
.IX "Format pliku PPM"

Należy zauważyć, że ten format jest strasznie niewydajny. Jest bardzo
rozwlekły i zawiera wiele informacji, których ludzkie oko nie jest w stanie
dostrzec. Co więcej, oprócz podstawowych kolorów format nie dostarcza więcej
innych informacji, co oznacza, że oprócz pliku w tym formacie trzeba w innym
miejscu przechowywać pozostałe informacje, tak żeby można było z tego
sensownie korzystać. Jednakże w bardzo łatwy sposób można napisać i
analizować programy przetwarzające ten format \- i to jest główna zaleta.

Należy także zauważyć, że często pliki są zgodne z tym formatem pod każdym
względem, z wyjątkiem precyzyjnego znaczenia wartości próbek. Pliki te są
użyteczne z powodu sposobu, w jakim PPM jest używany jako format
pośredni. Nieformalnie są nazywane plikami PPM, ale żeby być absolutnie
precyzyjnym należałoby je nazywać wariantami prawdziwego PPM. Na przykład
"PPM używający takich kolorów czerwonego, zielonego i niebieskiego, których
używa dany skaner".

Definicja formatu jest następująca:
.PP
Plik PPM składa się\ z sekwencji jednego lub więcej obrazów PPM. Nie
występują\ żadne inne dane, separatory i wyrównania przed obrazami, po nich
ani między nimi.
.PP
W skład każdego obrazu PPM wchodzą:
.IP \- 2
"Numer magiczny", określający rodzaj pliku. Numerem magicznym ppm są dwa
znaki: "P6".
.IX "Numery magiczne"
.IP \- 2
Biała spacja (spacje, tabulacje, CR, LF).
.IP \- 2
Szerokość, sformatowana jako dziesiętne znaki ASCII.
.IP \- 2
Biała spacja.
.IP \- 2
Wysokość, sformatowana jako dziesiętne znaki ASCII.
.IP \- 2
Biała spacja.
.IP \- 2
Maksymalna wartość komponentu kolorowego (maxval), znów jako dziesiętne
ASCII. Musi być mniejsza od 65536.
.IP \- 2
Znak nowej linii lub inny znak białej spacji.
.IP \- 2
Raster o rozmiarze szerokość * wysokość pikseli, przetwarzany w normalnym
porządku czytania tekstu. Każdy piksel jest trójką kolorów czerwonego,
zielonego i niebieskiego, w tej właśnie kolejności.Każda próbka jest
reprezentowana binarnie albo na jednym bajcie albo na dwóch bajtach. Jeśli
wartość maksymalna jest mniejsza niż 256, będzie to jeden bajt. W przeciwnym
wypadku są używane dwa bajty. Najbardziej znaczący bajt jest podawany
pierwszy.
.IP \- 2
W rastrze wartości próbek są "nieliniowe". Są proporcjonalne do natężenia
CIE Rec. 709  kolorów czerwonego, zielonego i niebieskiego w pikselu,
wyrównanego przez funkcję transferu gamma CIE Rec. 709. (Ta funkcja
transferu określa numer gamma jako 2.2 i ma liniową sekcję dla niskich
intensywności). Maksymalna wartość tych trzech próbek reprezentuje kolor
biały CIE D65 i najbardziej intensywny kolor w uniwersum kolorów, którego
częścią jest ten obraz (uniwersum kolorów oznacza wszystkie możliwe kolory
we wszystkich obrazach, z którymi można by porównać bieżący obraz).
.IP \- 2
Proszę zauważyć, że zwyczajową wariacją formatu PPM jest "liniowe"
wymienianie wartości próbek, tj. tak jak podano powyżej, z wyjątkiem braku
wyrównania gamma. \fBpnmgamma\fP potrafi przyjąć plik PPM w takim wariancie na
wejściu i wyprodukować prawdziwy plik PPM na wyjściu.

.IP \- 2
Znaki od "#" do znaku końca linii, przed linią maxval są ignorowane jako
komentarze.
.PP
Proszę zauważyć, że można użyć \fBpnmdepth\fP do konwersji pomiędzy formatami
używającymi 1 bajtu na próbkę i 2 bajtów na próbkę.
.PP
Istnieje także jeszcze jedna, dość rzadko spotykana, wersja formatu PPM:
"czysty" format PPM. Format opisany powyżej, który generalnie uważa się za
zwykły format, jest znany jako format "surowy". \fBpbm\fP(5) zawiera komentarze
na temat relacji pomiędzy formatem czystym a surowym.
.PP
Różnice w prostym formacie są następujące:
.IP \- 2
Plik zawiera dokładnie jeden obraz.
.IP \- 2
"Magiczny numer" to "P3" zamiast "P6".
.IP \- 2
Każda próbka w rastrze jest reprezentowana jako numer dziesiętny ASCII
(dowolnego rozmiaru).
.IP \- 2
Każda próbka w rastrze ma biały znak przed i po. Pomiędzy dwoma dowolnymi
próbkami musi występować przynajmniej jeden biały znak, ale nie ma górnego
ograniczenia na liczbę białych znaków. Piksele nie są od siebie rozdzielane
w jakiś szczególny sposób \-\- wystarczy obowiązkowa separacja pomiędzy próbką
białą jednego piksela a próbką czerwoną kolejnego piksela.
.IP \- 2
Linia nie powinna być dłuższa niż 70 znaków.
.PP
Oto przykład pixmapy w tym formacie:
.nf
P3
# feep.ppm
4 4
15
 0  0  0    0  0  0    0  0  0   15  0 15
 0  0  0    0 15  7    0  0  0    0  0  0
 0  0  0    0  0  0    0 15  7    0  0  0
15  0 15    0  0  0    0  0  0    0  0  0
.fi
.PP
Programy, które odczytują ten format, powinny być jak najwyrozumialsze,
akceptując wszystko, co z daleka wygląda na pixmapę.

.SH ZGODNOŚĆ

Przed kwietniem 2000 roku, plik w surowym formacie PPM nie mógł mieć
maksymalnej wartości większej niż 255. Dlatego nie mógł przechowywać więcej
niż jednego bajtu na próbkę. Stare programy mogą od tego zależeć.

Przed lipcem 2000 roku plik PPM mógł zawierać tylko jeden obraz. W wyniku
tego większość narzędzi przetwarzających pliki PPM ignoruje (nie czyta)
danych po pierwszym obrazie.

.SH "ZOBACZ TAKŻE"
giftopnm(1), gouldtoppm(1), ilbmtoppm(1), imgtoppm(1), mtvtoppm(1),
pcxtoppm(1), pgmtoppm(1), pi1toppm(1), picttoppm(1), pjtoppm(1),
qrttoppm(1), rawtoppm(1), rgb3toppm(1), sldtoppm(1), spctoppm(1),
sputoppm(1), tgatoppm(1), ximtoppm(1), xpmtoppm(1), yuvtoppm(1),
ppmtoacad(1), ppmtogif(1), ppmtoicr(1), ppmtoilbm(1), ppmtopcx(1),
ppmtopgm(1), ppmtopi1(1), ppmtopict(1), ppmtopj(1), ppmtopuzz(1),
ppmtorgb3(1), ppmtosixel(1), ppmtotga(1), ppmtouil(1), ppmtoxpm(1),
ppmtoyuv(1), ppmdither(1), ppmforge(1), ppmhist(1), ppmmake(1), ppmpat(1),
ppmquant(1), ppmquantall(1), ppmrelief(1), pnm(5), pgm(5), pbm(5)
.SH AUTOR
Copyright (C) 1989, 1991 Jef Poskanzer.
.\" Permission to use, copy, modify, and distribute this software and its
.\" documentation for any purpose and without fee is hereby granted, provided
.\" that the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.  This software is provided "as is" without express or
.\" implied warranty.
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika man są:
Przemek Borys (PTM) <pborys@dione.ids.pl>
i
Robert Luberda <robert@debian.org>.
.PP
Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją \fB 10.0 \fPoryginału.