Provided by: manpages-pl_0.7-2_all 
NAZWA
pgm - przenośny format szarej bitmapy
OPIS
Format PGM jest najmniejszym wspólnym mianownikiem plików w formacie odcieni szarości.
Został zaprojektowany, aby był niezmiernie łatwy do nauczenia i pisania programów jego
obsługi. (Jest tak prosty, że większość ludzi po prostu zastosuje inżynierię odwrotną
ponieważ jest to prostsze niż czytanie tej dokumentacji).
Obraz PGM reprezentuje graficzny obraz w odcieniach szarości. Istnieje wiele formatów
pseudo-PGM, różniących się od opisanego tutaj znaczeniem poszczególnych wartości pikseli.
Dla większości celów obraz PGM można sobie wyobrazić jako tablicę dowolnych liczb typu
integer, i wszystkie programy świata, które myślą, że przetwarzają obraz w odcieniach
szarości, mogą być prosto oszukane, by procesować cokolwiek innego.
Jednym z oficjalnych wariantów PGM jest maska przezroczystości. W bibliotece netpbm maska
przezroczystości jest reprezentowana przez obraz PGM, który zamiast intensywności pikseli
ma zapisane wartości nieprzezroczystości. Patrz niżej.
Definicja formatu jest następująca:
Plik PGM składa się z sekwencji jednego lub więcej obrazów PGM. Nie występują żadne inne
dane, separatory i wyrównania przed obrazami, po nich ani między nimi.
W skład każdego obrazu PGM wchodzą:
- "Numer magiczny", identyfikujący rodzaj pliku. Numerem magicznym pliku pgm są dwa znaki:
"P5".
- Biała spacja (spacje, tabulacje, CR, LF).
- Szerokość, sformatowana jako dziesiętne ASCII.
- Biała spacja.
- Wysokość, znów jako dziesiętne ASCII.
- Biała spacja.
- Maksymalna wartość szarości (maxval), znów jako dziesiętne ASCII. Musi być mniejsza od
65536.
- Znak nowej linii lub inny znak białej spacji.
- Raster o rozmiarze szerokość * wysokość wartości szarości, przetwarzany w normalnym
porządku czytania tekstu. Każda wartość szarości jest liczbą od zera do pewnej wartości
maksymalnej, gdzie 0 oznacza czerń, a wartość maksymalna - biel. Każda wartość szarości
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.
- Każda wartość szarości jest numerem proporcjonalnym do intensywności piksela, wyrównanej
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). Wartość 0 oznacza czerń.
Maksymalna wartość reprezentuje kolor biały CIE D65 i najbardziej intensywny kolor w
obrazie i w jakimkolwiek innym obrazie, z którym można by porównać bieżący obraz.
- Proszę zauważyć, że zwyczajową wariacją formatu PGM jest "liniowe" wymienianie wartości
szarości, tj. tak jak podano powyżej, z wyjątkiem braku wyrównania gamma. pnmgamma
potrafi przyjąć plik PGM w takim wariancie na wejściu i wyprodukować prawdziwy plik PGM
na wyjściu.
- W wariacji PGM zawierającej maskę przezroczystości wartość reprezentuje poziom
nieprzejrzystości. Jest proporcjonalna do ułamka intensywności piksela, który by się
pojawił zamiast podstawowego piksela, z zaaplikowaną taką samą funkcją transferu gamma,
jak opisana powyżej. Tak więc to, co normalnie oznacza kolor biały, oznacza tu całkowitą
nieprzezroczystość, a to co normalnie oznacza czerń, reprezentuje całkowitą
przezroczystość. Pomiędzy tymi wartościami należy sobie obliczyć intensywność piksela
złożonego z pikseli "poniżej" i "powyżej". używając wzoru: poniżej * 1
(1-(alpha/alpha_maxval)) + powyżej * (alpha/alpha_maxval).
- Znaki od "#" do znaku końca linii, przed linią maxval są ignorowane jako komentarze.
Proszę zauważyć, że można użyć pnmdepth do konwersji pomiędzy formatami używającymi 1
bajtu na wartość szarości i 2 bajtów na wartość szarości.
Istnieje także jeszcze jedna, dość rzadko spotykana, wersja formatu PGM: "czysty" format
PGM. Format opisany powyżej, który generalnie uważa się za zwykły format, jest znany jako
format "surowy" PGM. pbm(5) zawiera komentarze na temat relacji pomiędzy formatem czystym
a surowym.
Różnice formatu czystego to:
- Plik zawiera dokładnie jeden obraz.
- "Magiczny numer" to "P2" zamiast "P5".
- Każda piksel w rastrze jest reprezentowany jako numer dziesiętny ASCII (dowolnego
rozmiaru).
- Każdy piksel w rastrze ma biały znak przed i po. Pomiędzy dwoma dowolnymi pikselami musi
występować przynajmniej jeden biały znak, ale nie ma górnego ograniczenia na liczbę
białych znaków.
- Żadna z linii nie powinna być dłuższa niż 70 znaków.
Oto przykład małego obrazka w tym formacie:
P2
# feep.pgm
24 7
15
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 3 3 3 3 0 0 7 7 7 7 0 0 11 11 11 11 0 0 15 15 15 15 0
0 3 0 0 0 0 0 7 0 0 0 0 0 11 0 0 0 0 0 15 0 0 15 0
0 3 3 3 0 0 0 7 7 7 0 0 0 11 11 11 0 0 0 15 15 15 15 0
0 3 0 0 0 0 0 7 0 0 0 0 0 11 0 0 0 0 0 15 0 0 0 0
0 3 0 0 0 0 0 7 7 7 7 0 0 11 11 11 11 0 0 15 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Programy, które odczytują ten format powinny być jak najwyrozumialsze, akceptując
wszystko, co z daleka wygląda jak mapa szarości.
ZGODNOŚĆ
Przed kwietniem 2000 roku, plik w surowym formacie PGM 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 PGM mógł zawierać tylko jeden obraz. W wyniku tego większość
narzędzi przetwarzających pliki PGM ignoruje (nie czyta) danych po pierwszym obrazie.
ZOBACZ TAKŻE
fitstopgm(1), fstopgm(1), hipstopgm(1), lispmtopgm(1), psidtopgm(1), rawtopgm(1),
pgmbentley(1), pgmcrater(1), pgmedge(1), pgmenhance(1), pgmhist(1), pgmnorm(1), pgmoil(1),
pgmramp(1), pgmtexture(1), pgmtofits(1), pgmtofs(1), pgmtolispm(1), pgmtopbm(1), pnm(5),
pbm(5), ppm(5)
AUTOR
Copyright (C) 1989, 1991 Jef Poskanzer.
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>.
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ą 10.0
oryginału.
12 listopada 1991 pgm(5)