Specifica<?>ii privind formatul PGM(5)                     File Formats Manual



NUME
       pgm - formatul de imagine in tonuri de gri Netpbm


DESCRIERE
       Acest program face parte din Netpbm(1).

       Formatul PGM este un format de fi<?>ier in tonuri de gri cu cel mai mic
       numitor comun. Este conceput pentru a fi extrem de u<?>or de inva<?>at
       <?>i de scris programe pentru acesta; (este atat de simplu incat
       majoritatea oamenilor vor face pur <?>i simplu inginerie inversa pentru
       ca este mai u<?>or decat sa citeasca aceasta specifica<?>ie).

       O imagine PGM reprezinta o imagine grafica in tonuri de gri. Exista
       multe formate pseudo-PGM in uz, in care totul este a<?>a cum este
       specificat aici, cu excep<?>ia semnifica<?>iei valorilor individuale
       ale pixelilor.In cele mai multe scopuri, o imagine PGM poate fi
       considerata ca o matrice de numere intregi arbitrare, iar toate
       programele din lume care cred ca proceseaza o imagine in tonuri de gri
       pot fi cu u<?>urin<?>a pacalite sa proceseze altceva.

       Numele "PGM" este un acronim derivat de la ,,Portable Gray Map" (harta
       de griri portabila.

       O varianta oficiala a PGM este masca de transparen<?>a. O masca de
       transparen<?>a in Netpbm este reprezentata de o imagine PGM, cu
       excep<?>ia faptului ca in locul intensita<?>ilor pixelilor exista
       valori de opacitate. A se vedea mai jos.


FORMATUL
       Defini<?>ia formatului este urmatoarea. Pute<?>i utiliza biblioteca de
       subrutine libnetpbm(1) C pentru a citi <?>i interpreta in mod
       convenabil <?>i precis formatul.

       Un fi<?>ier PGM este format dintr-o secven<?>a de una sau mai multe
       imagini PGM. Nu exista date, delimitatori sau umplutura inainte, dupa
       sau intre imagini.

       Fiecare imagine PGM este compusa din urmatoarele elemente:




       o      Un ,,numar magic" pentru identificarea tipului de fi<?>ier.
              Numarul magic al unei imagini pgm este format din cele doua
              caractere ,,P5".


       o      Spa<?>iu alb (spa<?>ii goale, TAB-uri(tabulatoare),
              CR-uri(retururi de carucior), LF-uri(salturi de linie)).


       o      O la<?>ime, formatata in caractere ASCII in zecimale.


       o      Spa<?>iu alb.


       o      O inal<?>ime, din nou in format ASCII zecimal.


       o      Spa<?>iu alb.


       o      Valoarea maxima a griului (Maxval), din nou in ASCII zecimal.
              Trebuie sa fie mai mica decat 65536 <?>i mai mare decat zero.


       o      Un singur caracter de spa<?>iu alb (de obicei o linie noua).


       o      Un raster de randuri de inal<?>ime, in ordine de sus in jos.
              Fiecare rand este format din valori gri ale la<?>imii, in ordine
              de la stanga la dreapta.  Fiecare valoare gri este un numar de
              la 0 la Maxval, 0 fiind negru <?>i Maxval fiind alb. Fiecare
              valoare gri este reprezentata in binar pur prin 1 sau 2
              octe<?>i. In cazul in care Maxval este mai mica de 256, aceasta
              reprezinta 1 octet. In caz contrar, este de 2 octe<?>i. Cel mai
              semnificativ octet este primul.

              Un rand al unei imagini este orizontal. O coloana este
              verticala. Pixelii din imagine sunt patra<?>i <?>i contigui.

              Fiecare valoare de gri este un numar propor<?>ional cu
              intensitatea pixelului, ajustata prin func<?>ia de transfer
              gamma din Recomandarea ITU-R BT.709; (aceasta func<?>ie de
              transfer specifica un numar gamma de 2,2 <?>i are o sec<?>iune
              liniara pentru intensita<?>i mici). Prin urmare, o valoare de
              zero reprezinta negru. O valoare de Maxval reprezinta albul CIE
              D65 <?>i cea mai intensa valoare din imagine <?>i din orice alta
              imagine cu care imaginea ar putea fi comparata.

              Re<?>ine<?>i ca o varia<?>ie obi<?>nuita fa<?>a de formatul PGM
              este ca valoarea de gri sa fie ,,liniara", adica a<?>a cum se
              specifica mai sus, dar fara ajustarea gamma. pnmgamma prime<?>te
              ca intrare o astfel de varianta PGM <?>i produce ca ie<?>ire un
              PGM adevarat.

              In varianta de masca de transparen<?>a din PGM, valoarea
              reprezinta opacitatea. Ea este propor<?>ionala cu frac<?>iunea
              de intensitate a unui pixel care ar aparea in locul unui pixel
              de baza. Astfel, ceea ce in mod normal inseamna alb reprezinta
              opacitate totala, iar ceea ce in mod normal inseamna negru
              reprezinta transparen<?>a totala. Intre aceste doua valori, se
              calculeaza intensitatea unui pixel compus dintr-un pixel ,,sub"
              <?>i ,,peste" ca fiind sub * (1-(alfa/alfa_maxval)) + peste *
              (alfa/alfa_maxval). Re<?>ine<?>i ca nu exista o func<?>ie de
              transfer gamma in masca de transparen<?>a.



       <?>irurile care incep cu ,,#" pot fi comentarii, la fel ca in cazul
       PBM(1) .

       Re<?>ine<?>i ca pute<?>i utiliza pamdepth pentru a face conversia intre
       formatul cu 1 octet pe valoare de gri <?>i cel cu 2 octe<?>i pe valoare
       de gri.

       Toate caracterele la care se face referire in prezentul document sunt
       codificate in ASCII. ,,linie noua" se refera la caracterul cunoscut in
       ASCII sub numele de ,,Line Feed" sau LF (salt de linie). Un caracter
       ,,spa<?>iu alb" este un spa<?>iu, CR, LF, TAB, VT sau FF (adica ceea ce
       func<?>ia C isspace() din standardul ANSI nume<?>te ,,spa<?>iu alb").


   PGM simplu ,,plain"
       De fapt, exista o alta versiune a formatului PGM care este destul de
       rara: formatul PGM ,,simplu". Formatul de mai sus, care este considerat
       in general cel normal, este cunoscut sub numele de format PGM ,,brut".
       A se vedea pbm(1) pentru cateva comentarii privind modul in care
       formatele simplu <?>i brut se raporteaza unul la celalalt <?>i cum sa
       le utiliza<?>i.

       Diferen<?>a in format simplu este urmatoarea:



       o

              Exista exact o singura imagine intr-un fi<?>ier.

       o

              ,,Numarul magic" este ,,P2" in loc de ,,P5".

       o

              Fiecare pixel din raster este reprezentat ca un numar zecimal
              ASCII (de dimensiune arbitrara).

       o

              Fiecare pixel din raster are un spa<?>iu alb inainte <?>i dupa
              el. Trebuie sa existe cel pu<?>in un caracter de spa<?>iu alb
              intre doi pixeli, dar nu exista un maxim.

       o

              Niciun rand nu trebuie sa aiba mai mult de 70 de caractere.


       Iata un exemplu de imagine mica in format simplu (plain) PGM.

       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

       La sfar<?>itul fiecareia dintre aceste linii se afla un caracter de
       linie noua.

       Programele care citesc acest format trebuie sa fie cat se poate de
       indulgente, acceptand orice lucru care seamana cat de cat cu un PGM.



TIP DE SUPORT INTERNET
       Nu a fost inregistrat la IANA niciun Internet Media Type (aka MIME
       type, content type) pentru PGM, dar valoarea image/x-portable-graymap
       este conven<?>ionala.

       Re<?>ine<?>i ca se aplica <?>i PNM Internet Media Type
       image/x-portable-anymap.



NUME DE FI<?>IER
       Nu exista cerin<?>e privind numele unui fi<?>ier PGM, dar conven<?>ia
       este de a utiliza sufixul ,,.pgm". ,,pnm" este, de asemenea,
       conven<?>ional, pentru cazurile in care nu este convenabil sa se faca
       distinc<?>ia intre sub-formatele particulare ale PNM.



COMPATIBILITATE
       Inainte de aprilie 2000, un fi<?>ier PGM in format brut nu putea avea o
       valoare maxima mai mare de 255. Prin urmare, acesta nu putea avea mai
       mult de un octet pe e<?>antion. Programele vechi pot depinde de acest
       lucru.

       Inainte de iulie 2000, un fi<?>ier PGM putea con<?>ine cel mult o
       imagine. Ca urmare, majoritatea instrumentelor de procesare a
       fi<?>ierelor PGM ignorau (<?>i nu citeau) niciun fel de date dupa prima
       imagine.


CONSULTA<?>I <?>I
       pnm(1)  , pbm(1)  , ppm(1)  , pam(1)  , libnetpbm(1) , programs that
       process PGM(1)  ,


AUTOR
       Drepturi de autor (C) 1989, 1991 pentru Jef Poskanzer.

SURSA DOCUMENTULUI
       Aceasta pagina de manual a fost generata de instrumentul Netpbm
       <<makeman>> din sursa HTML. Documenta<?>ia principala este la

              http://netpbm.sourceforge.net/doc/pgm.html

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

documenta<?>ia netpbm          27 noiembrie 2013
                                        Specifica<?>ii privind formatul PGM(5)