Dokumentacja formatu PPM(5) File Formats Manual Dokumentacja formatu PPM(5) NAZWA PPM - format obrazu kolorowego Netpbm OPIS Program jest czescia Netpbm(1). Jest to prosty format PPM przeznaczony do obrazow kolorowych. Nalezy zauwazyc, ze ten format jest strasznie niewydajny. Jest bardzo rozwlekly i zawiera wiele informacji, ktorych ludzkie oko nie jest w stanie dostrzec. Co wiecej, oprocz podstawowych kolorow format nie dostarcza wiecej innych informacji, co oznacza, ze oprocz pliku w tym formacie trzeba w innym miejscu przechowywac pozostale informacje, tak zeby mozna bylo z tego sensownie korzystac. Jednakze w bardzo latwy sposob mozna napisac i analizowac programy przetwarzajace ten format - i to jest glowna zaleta. It should also be noted that files often conform to this format in every respect except the precise semantics of the sample values. These files are useful because of the way PPM is used as an intermediary format. They are informally called PPM files, but to be absolutely precise, you should indicate the variation from true PPM. For example, 'PPM using the red, green, and blue colors that the scanner in question uses.' Nazwa ,,PPM" jest akronimem slow ,,Przenosna Mapa Pikseli" (,,Portable Pixel Map"). Obrazy w tym formacie (lub jego poprzednikach) byly niegdys zwane rowniez ,,przenosnymi pixmapami". FORMAT Definicja formatu jest jak nastepuje. Mozna skorzystac z biblioteki podprogramu C libnetpbm(1), aby latwo i dokladnie odczytywac i interpretowac format. Plik PPM sklada sie z sekwencji jednego lub wiecej obrazow PPM. Nie wystepuja zadne inne dane, separatory i wyrownania przed obrazami, po nich ani miedzy nimi. W sklad kazdego obrazu PPM wchodza: o A 'magic number' for identifying the file type. A ppm image's magic number is the two characters 'P6'. o Biala spacja (spacje, tabulacje, CR, LF). o Szerokosc, sformatowana jako dziesietne znaki ASCII. o Biala spacja. o Wysokosc, sformatowana jako dziesietne znaki ASCII. o Biala spacja. o Maksymalna wartosc komponentu kolorowego (maxval), znow jako dziesietne ASCII. Musi byc mniejsza od 65536 i wieksza od zera. o Pojedynczy znak bialej spacji (zwykle znak nowego wiersza). o Raster o rozmiarze Wysokosci wierszy, w kolejnosci od gory do dolu. Kazdy wiersz sklada sie z Szerokosci pikseli, od lewej do prawej. Kazdy piksel jest trojka kolorow czerwonego, zielonego i niebieskiego, w tej wlasnie kolejnosci. Kazda probka jest reprezentowana binarnie albo na jednym bajcie albo na dwoch bajtach. Jesli wartosc maksymalna jest mniejsza niz 256, bedzie to jeden bajt. W przeciwnym wypadku sa uzywane dwa bajty. Najbardziej znaczacy bajt jest podawany pierwszy. Wiersz jest poziomy. Kolumna jest pionowa. Piksele w obrazie sa kwadratowe i ciagle. In the raster, the sample values are 'nonlinear.' They are proportional to the intensity of the ITU-R Recommendation BT.709 red, green, and blue in the pixel, adjusted by the BT.709 gamma transfer function. (That transfer function specifies a gamma number of 2.2 and has a linear section for small intensities). A value of Maxval for all three samples represents CIE D65 white and the most intense color in the color universe of which the image is part (the color universe is all the colors in all images to which this image might be compared). ITU-R Recommendation BT.709 jest zmieniona nazwa wczesniejszej CCIR Recommendation 709. Gdy CCIR zostala wchlonieta w swoja organizacje nadrzedna, ITU, okolo roku 2000, standard zostal przemianowany. Ten dokument odnosil sie niegdys do tego standardu jako CIE Rec. 709, lecz nie jest obecnie jasne, czy byl to w ogole standard CIE. Note that another popular color space is the newer sRGB. A common variation on PPM is to substitute this color space for the one specified. Note that a common variation on the PPM format is to have the sample values be 'linear,' i.e. as specified above except without the gamma adjustment. pnmgamma takes such a PPM variant as input and produces a true PPM as output. Strings starting with '#' may be comments, the same as with PBM(1) . Note that you can use pamdepth to convert between a the format with 1 byte per sample and the one with 2 bytes per sample. All characters referred to herein are encoded in ASCII. 'newline' refers to the character known in ASCII as Line Feed or LF. A 'white space' character is space, CR, LF, TAB, VT, or FF (I.e. what the ANSI standard C isspace() function calls white space). Prosty PPM There is actually another version of the PPM format that is fairly rare: 'plain' PPM format. The format above, which generally considered the normal one, is known as the 'raw' PPM format. See pbm(1) for some commentary on how plain and raw formats relate to one another and how to use them. Roznice w prostym formacie sa nastepujace: o Plik zawiera dokladnie jeden obraz. o ,,Magiczny numer" to ,,P3" zamiast ,,P6". o Kazda probka w rastrze jest reprezentowana jako numer dziesietny ASCII (dowolnego rozmiaru). o Kazda probka w rastrze ma bialy znak przed i po. Pomiedzy dwoma dowolnymi probkami musi wystepowac przynajmniej jeden bialy znak, ale nie ma gornego ograniczenia na liczbe bialych znakow. Piksele nie sa od siebie rozdzielane w jakis szczegolny sposob -- wystarczy obowiazkowa separacja pomiedzy probka biala jednego piksela a probka czerwona kolejnego piksela. o Linia nie powinna byc dluzsza niz 70 znakow. Oto przyklad malego obrazu w tym formacie: 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 Na koncu kazdego wiersza znajduje sie znak nowego wiersza. Programy, ktore odczytuja ten format, powinny byc jak najwyrozumialsze, akceptujac wszystko, co z daleka wyglada na obraz PPM. IDENTYFIKATOR INTERNETOWY (MIME) Dla formatu PPM nie zarejestrowano internetowego identyfikatora formatu danych (Internet Media Type -- MIME) w IANA, lecz konwencjonalna jest wartosc image/x-portable-pixmap. Prosze zauwazyc, ze image/x-portable-anymap dotyczy tez PNM. NAZWA PLIKU There are no requirements on the name of a PPM file, but the convention is to use the suffix '.ppm'. 'pnm' is also conventional, for cases where distinguishing between the particular subformats of PNM is not convenient. ZGODNOSC Przed kwietniem 2000 roku, plik w surowym formacie PPM nie mogl miec maksymalnej wartosci wiekszej niz 255. Dlatego nie mogl przechowywac wiecej niz jednego bajtu na probke. Stare programy moga od tego zalezec. Przed lipcem 2000 roku plik PPM mogl zawierac tylko jeden obraz. W wyniku tego wiekszosc narzedzi przetwarzajacych pliki PPM ignoruje (nie czyta) danych po pierwszym obrazie. ZOBACZ TAKZE pnm(1), pgm(1), pbm(1), pam(1); programy, ktore przetwarzaja PPM ZRODLO DOKUMENTU Niniejsza strone podrecznika wygenerowano za pomoca narzedzia Netpbm ,,makeman" ze zrodel HTML. Glowna dokumentacja jest dostepna pod adresem http://netpbm.sourceforge.net/doc/ppm.html TLUMACZENIE Tlumaczenie niniejszej strony podrecznika: Przemek Borys , Robert Luberda 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 . dokumentacja netpbm 02 November 2013 Dokumentacja formatu PPM(5)