home *** CD-ROM | disk | FTP | other *** search
/ Mega A/V / mega_av.zip / mega_av / GRAPHUTL / PBMPLUS.ZIP / LIBPGM.MAN < prev    next >
Text File  |  1991-08-11  |  8KB  |  133 lines
  1.  
  2.  
  3. libpgm(3)                  Unix Programmer's Manual                  libpgm(3)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      libpgm - functions to support portable graymap programs
  8.  
  9. SSSYYYNNNOOOPPPSSSIIISSS
  10.  
  11.      #include <pgm.h>
  12.      cc ... libpgm.a libpbm.a
  13.  
  14.  
  15. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  16.  
  17.      typedef ... gray;
  18.      #define PGM_MAXMAXVAL ...
  19.      extern gray pgm_pbmmaxval;
  20.  
  21.      EEEaaaccchhh gggrrraaayyy should contain only the values  between  000  and  PPPGGGMMM___MMMAAAXXXMMMAAAXXXVVVAAALLL.
  22.      pppgggmmm___pppbbbmmmmmmaaaxxxvvvaaalll  is  the  maxval  used when a PGM program reads a PBM file.
  23.      Normally it is 1; however, for some programs, a larger value gives better
  24.      results.
  25.  
  26.      #define PGM_FORMAT ...
  27.      #define RPGM_FORMAT ...
  28.      #define PGM_TYPE PGM_FORMAT
  29.      int PGM_FORMAT_TYPE( int format )
  30.  
  31.      FFFooorrr dddiiissstttiiinnnggguuuiiissshhhiiinnnggg dddiiiffffffeeerrreeennnttt fffiiillleee fffooorrrmmmaaatttsss aaannnddd tttyyypppeeesss...
  32.  
  33.      vvvoooiiiddd pppgggmmm___iiinnniiittt((( iiinnnttt*** aaarrrgggcccPPP,,, ccchhhaaarrr*** aaarrrgggvvv[[[]]] )))
  34.  
  35.      AAAllllll PPPGGGMMM ppprrrooogggrrraaammmsss mmmuuusssttt cccaaallllll ttthhhiiisss rrrooouuutttiiinnneee...
  36.  
  37.      gggrrraaayyy****** pppgggmmm___aaallllllooocccaaarrrrrraaayyy((( iiinnnttt cccooolllsss,,, iiinnnttt rrrooowwwsss )))
  38.  
  39.      AAAllllllooocccaaattteee aaannn aaarrrrrraaayyy ooofff gggrrraaayyysss...
  40.  
  41.      gggrrraaayyy*** pppgggmmm___aaallllllooocccrrrooowww((( iiinnnttt cccooolllsss )))
  42.  
  43.      AAAllllllooocccaaattteee aaa rrrooowww ooofff ttthhheee gggiiivvveeennn nnnuuummmbbbeeerrr ooofff gggrrraaayyysss...
  44.  
  45.      vvvoooiiiddd pppgggmmm___fffrrreeeeeeaaarrrrrraaayyy((( gggrrraaayyy****** gggrrraaayyysss,,, iiinnnttt rrrooowwwsss )))
  46.  
  47.      FFFrrreeeeee ttthhheee aaarrrrrraaayyy  aaallllllooocccaaattteeeddd  wwwiiittthhh  pppgggmmm___aaallllllooocccaaarrrrrraaayyy((()))  containing  the  given
  48.      number of rows.
  49.  
  50.      void pgm_freerow( gray* grayrow )
  51.  
  52.      FFFrrreeeeee aaa rrrooowww ooofff gggrrraaayyysss...
  53.  
  54.      vvvoooiiiddd pppgggmmm___rrreeeaaadddpppgggmmmiiinnniiittt((( FFFIIILLLEEE*** fffppp,,, iiinnnttt*** cccooolllsssPPP,,, iiinnnttt***  rrrooowwwsssPPP,,,  gggrrraaayyy***  mmmaaaxxxvvvaaalllPPP,,,
  55.      iiinnnttt*** fffooorrrmmmaaatttPPP )))
  56.  
  57.      RRReeeaaaddd ttthhheee hhheeeaaadddeeerrr fffrrrooommm aaa PPPGGGMMM fffiiillleee,,, fffiiilllllliiinnnggg iiinnn ttthhheee rrrooowwwsss,,,  cccooolllsss,,,  mmmaaaxxxvvvaaalll  aaannnddd
  58.      fffooorrrmmmaaattt vvvaaarrriiiaaabbbllleeesss...
  59.  
  60.      vvvoooiiiddd pppgggmmm___rrreeeaaadddpppgggmmmrrrooowww((( FFFIIILLLEEE*** fffppp,,, gggrrraaayyy*** gggrrraaayyyrrrooowww,,, iiinnnttt cccooolllsss,,, gggrrraaayyy mmmaaaxxxvvvaaalll,,,  iiinnnttt
  61.      fffooorrrmmmaaattt )))
  62.  
  63.  
  64.                                                                              1
  65.  
  66.  
  67.  
  68.  
  69. libpgm(3)                  Unix Programmer's Manual                  libpgm(3)
  70.  
  71.  
  72.      RRReeeaaaddd aaa rrrooowww ooofff gggrrraaayyysss iiinnntttooo ttthhheee gggrrraaayyyrrrooowww aaarrrrrraaayyy...   FFFooorrrmmmaaattt,,,  cccooolllsss,,,  aaannnddd  mmmaaaxxxvvvaaalll
  73.      wwweeerrreee fffiiilllllleeeddd iiinnn bbbyyy pppgggmmm___rrreeeaaadddpppgggmmmiiinnniiittt((())).
  74.  
  75.      gray** pgm_readpgm( FILE* fp, int* colsP, int* rowsP, gray* maxvalP )
  76.  
  77.      RRReeeaaaddd aaannn eeennntttiiirrreee gggrrraaayyymmmaaappp fffiiillleee iiinnntttooo mmmeeemmmooorrryyy,,, rrreeetttuuurrrnnniiinnnggg  ttthhheee  aaallllllooocccaaattteeeddd  aaarrrrrraaayyy
  78.      aaannnddd  fffiiilllllliiinnnggg  iiinnn  ttthhheee  rrrooowwwsss,,,  cccooolllsss  aaannnddd  mmmaaaxxxvvvaaalll vvvaaarrriiiaaabbbllleeesss...  TTThhhiiisss fffuuunnnccctttiiiooonnn
  79.      cccooommmbbbiiinnneeesss pppgggmmm___rrreeeaaadddpppgggmmmiiinnniiittt((())), pppgggmmm___aaallllllooocccaaarrrrrraaayyy((())) and pppgggmmm___rrreeeaaadddpppgggmmmrrrooowww((())).
  80.  
  81.      void pgm_writepgminit( FILE* fp, int cols, int  rows,  gray  maxval,  int
  82.      forceplain )
  83.  
  84.      WWWrrriiittteee ttthhheee hhheeeaaadddeeerrr fffooorrr aaa pppooorrrtttaaabbbllleee gggrrraaayyymmmaaappp fffiiillleee...  TTThhheee fffooorrrccceeeppplllaaaiiinnn ffflllaaaggg fffooorrrccceeesss
  85.      aaa ppplllaaaiiinnn-fffooorrrmmmaaattt fffiiillleee tttooo bbbeee wwwrrriiitttttteeennn,,, aaasss oooppppppooossseeeddd tttooo aaa rrraaawww-fffooorrrmmmaaattt ooonnneee...
  86.  
  87.      vvvoooiiiddd pppgggmmm___wwwrrriiittteeepppgggmmmrrrooowww((( FFFIIILLLEEE*** fffppp,,, gggrrraaayyy*** gggrrraaayyyrrrooowww,,, iiinnnttt cccooolllsss,,, gggrrraaayyy mmmaaaxxxvvvaaalll,,, iiinnnttt
  88.      fffooorrrccceeeppplllaaaiiinnn )))
  89.  
  90.      WWWrrriiittteee aaa rrrooowww fffrrrooommm aaa pppooorrrtttaaabbbllleee gggrrraaayyymmmaaappp...
  91.  
  92.      vvvoooiiiddd pppgggmmm___wwwrrriiittteeepppgggmmm((( FFFIIILLLEEE*** fffppp,,, gggrrraaayyy******  gggrrraaayyysss,,,  iiinnnttt  cccooolllsss,,,  iiinnnttt  rrrooowwwsss,,,  gggrrraaayyy
  93.      mmmaaaxxxvvvaaalll,,, iiinnnttt fffooorrrccceeeppplllaaaiiinnn )))
  94.  
  95.      WWWrrriiittteee ttthhheee hhheeeaaadddeeerrr aaannnddd aaallllll dddaaatttaaa fffooorrr  aaa  pppooorrrtttaaabbbllleee  gggrrraaayyymmmaaappp...   TTThhhiiisss  fffuuunnnccctttiiiooonnn
  96.      cccooommmbbbiiinnneeesss pppgggmmm___wwwrrriiittteeepppgggmmmiiinnniiittt((())) and pppgggmmm___wwwrrriiittteeepppgggmmmrrrooowww((())).
  97.  
  98. SSSEEEEEE AAALLLSSSOOO
  99.      libpbm(3), libppm(3), libpnm(3)
  100.  
  101. AAAUUUTTTHHHOOORRR
  102.      Copyright (C) 1989, 1991 by Tony Hansen and Jef Poskanzer.
  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.                                                                              2
  131.  
  132.  
  133.