Gecko [ 122.154.134.11 ]

Name	Size	Permission
411toppm.html	1.76 KB	-rw-r--r--
anytopnm.html	2.56 KB	-rw-r--r--
asciitopgm.html	2.4 KB	-rw-r--r--
atktopbm.html	945 B	-rw-r--r--
bioradtopgm.html	1.43 KB	-rw-r--r--
blend1.gif	18.25 KB	-rw-r--r--
blend3.gif	21.23 KB	-rw-r--r--
blend4.gif	24.56 KB	-rw-r--r--
blend6.gif	21.87 KB	-rw-r--r--
blend7.gif	26.28 KB	-rw-r--r--
bmptopnm.html	2.13 KB	-rw-r--r--
bmptoppm.html	562 B	-rw-r--r--
brushtopbm.html	953 B	-rw-r--r--
cameratopam.html	5.21 KB	-rw-r--r--
cistopbm.html	1.36 KB	-rw-r--r--
cmuwmtopbm.html	945 B	-rw-r--r--
ddbugtopbm.html	3.22 KB	-rw-r--r--
directory.html	32.33 KB	-rw-r--r--
escp2topbm.html	2.21 KB	-rw-r--r--
extendedopacity.html	6.7 KB	-rw-r--r--
eyuvtoppm.html	1.1 KB	-rw-r--r--
faxformat.html	3.66 KB	-rw-r--r--
fiascotopnm.html	6.04 KB	-rw-r--r--
fitstopnm.html	3.7 KB	-rw-r--r--
flatebug.png	32.86 KB	-rw-r--r--
fstopgm.html	1.95 KB	-rw-r--r--
g3topbm.html	4.36 KB	-rw-r--r--
gemtopbm.html	512 B	-rw-r--r--
gemtopnm.html	1.38 KB	-rw-r--r--
giftopnm.html	7.57 KB	-rw-r--r--
globe.jpg	14.04 KB	-rw-r--r--
gobot.gif	1.37 KB	-rw-r--r--
gouldtoppm.html	911 B	-rw-r--r--
hdifftopam.html	1.5 KB	-rw-r--r--
hipstopgm.html	1.03 KB	-rw-r--r--
hpcdtoppm.html	11.18 KB	-rw-r--r--
icontopbm.html	903 B	-rw-r--r--
ilbmtoppm.html	3.29 KB	-rw-r--r--
imgtoppm.html	1.03 KB	-rw-r--r--
index.html	41.28 KB	-rw-r--r--
infotopam.html	6.53 KB	-rw-r--r--
jbigtopnm.html	3.91 KB	-rw-r--r--
jpeg2ktopam.html	5.3 KB	-rw-r--r--
jpegtopnm.html	12.51 KB	-rw-r--r--
leaftoppm.html	1.1 KB	-rw-r--r--
liberror.html	8.46 KB	-rw-r--r--
libmaketmpfile.html	2.43 KB	-rw-r--r--
libmaketmpfilefd.html	1.72 KB	-rw-r--r--
libnetpbm.html	3.55 KB	-rw-r--r--
libnetpbm_dir.html	9.03 KB	-rw-r--r--
libnetpbm_draw.html	4.22 KB	-rw-r--r--
libnetpbm_image.html	23.34 KB	-rw-r--r--
libnetpbm_ug.html	10.79 KB	-rw-r--r--
libpbm.html	9.34 KB	-rw-r--r--
libpgm.html	7.63 KB	-rw-r--r--
libpm.html	16.81 KB	-rw-r--r--
libpnm.html	9.87 KB	-rw-r--r--
libppm.html	26.63 KB	-rw-r--r--
libsystem.html	14.36 KB	-rw-r--r--
libtmpfile.html	1.71 KB	-rw-r--r--
libtmpfilefd.html	1.3 KB	-rw-r--r--
lispmtopgm.html	1.94 KB	-rw-r--r--
macptopbm.html	1.87 KB	-rw-r--r--
manweb.html	9.26 KB	-rw-r--r--
mdatopbm.html	1.61 KB	-rw-r--r--
mgrtopbm.html	1.03 KB	-rw-r--r--
mrf.html	4.3 KB	-rw-r--r--
mrftopbm.html	1.54 KB	-rw-r--r--
mtvtoppm.html	1.04 KB	-rw-r--r--
neotoppm.html	1.18 KB	-rw-r--r--
palmtopnm.html	3.49 KB	-rw-r--r--
pam.html	11.75 KB	-rw-r--r--
pamaddnoise.html	3.96 KB	-rw-r--r--
pamarith.html	10.82 KB	-rw-r--r--
pambackground.html	4.85 KB	-rw-r--r--
pambayer.html	3.54 KB	-rw-r--r--
pamchannel.html	2.53 KB	-rw-r--r--
pamcomp.html	12.64 KB	-rw-r--r--
pamcut.html	6.69 KB	-rw-r--r--
pamdeinterlace.html	2.52 KB	-rw-r--r--
pamdepth.html	2.12 KB	-rw-r--r--
pamdice.html	4.52 KB	-rw-r--r--
pamditherbw.html	5.99 KB	-rw-r--r--
pamedge.html	2.24 KB	-rw-r--r--
pamendian.html	2.55 KB	-rw-r--r--
pamenlarge.html	2.18 KB	-rw-r--r--
pamfile.html	2.93 KB	-rw-r--r--
pamfixtrunc.html	3.12 KB	-rw-r--r--
pamflip.html	8.42 KB	-rw-r--r--
pamfunc.html	8.51 KB	-rw-r--r--
pamgauss.html	3.7 KB	-rw-r--r--
pamgradient.html	2.88 KB	-rw-r--r--
pamlookup.html	9.66 KB	-rw-r--r--
pammasksharpen.html	4.62 KB	-rw-r--r--
pammixinterlace.html	3.1 KB	-rw-r--r--
pamoil.html	2.36 KB	-rw-r--r--
pamperspective.html	17.28 KB	-rw-r--r--
pampick.html	2.35 KB	-rw-r--r--
pampop9.html	2.4 KB	-rw-r--r--
pamrgbatopng.html	2.26 KB	-rw-r--r--
pamscale.html	25.23 KB	-rw-r--r--
pamseq.html	2.77 KB	-rw-r--r--
pamsharpmap.html	2.38 KB	-rw-r--r--
pamsharpness.html	1.73 KB	-rw-r--r--
pamsistoaglyph.html	6.65 KB	-rw-r--r--
pamslice.html	4.2 KB	-rw-r--r--
pamsplit.html	2.8 KB	-rw-r--r--
pamstack.html	3.41 KB	-rw-r--r--
pamstereogram.html	10.08 KB	-rw-r--r--
pamstretch-gen.html	1.62 KB	-rw-r--r--
pamstretch.html	3.72 KB	-rw-r--r--
pamsumm.html	3.64 KB	-rw-r--r--
pamsummcol.html	4.1 KB	-rw-r--r--
pamthreshold.html	6.25 KB	-rw-r--r--
pamtilt.html	4.53 KB	-rw-r--r--
pamtodjvurle.html	1.78 KB	-rw-r--r--
pamtofits.html	4 KB	-rw-r--r--
pamtogif.html	13.12 KB	-rw-r--r--
pamtohdiff.html	3.32 KB	-rw-r--r--
pamtohtmltbl.html	2.71 KB	-rw-r--r--
pamtojpeg2k.html	8.36 KB	-rw-r--r--
pamtompfont.html	2.07 KB	-rw-r--r--
pamtooctaveimg.html	3.21 KB	-rw-r--r--
pamtopam.html	1.67 KB	-rw-r--r--
pamtopfm.html	3.1 KB	-rw-r--r--
pamtopnm.html	2.77 KB	-rw-r--r--
pamtosvg.html	7.02 KB	-rw-r--r--
pamtotga.html	4.42 KB	-rw-r--r--
pamtotiff.html	21.19 KB	-rw-r--r--
pamtouil.html	2.49 KB	-rw-r--r--
pamtoxvmini.html	1.09 KB	-rw-r--r--
pamundice.html	6.96 KB	-rw-r--r--
pamx.html	8.02 KB	-rw-r--r--
pbm.html	5.8 KB	-rw-r--r--
pbmclean.html	3.45 KB	-rw-r--r--
pbmlife.html	1 KB	-rw-r--r--
pbmmake.html	1.32 KB	-rw-r--r--
pbmmask.html	2.89 KB	-rw-r--r--
pbmminkowski.html	529 B	-rw-r--r--
pbmpage.html	2.84 KB	-rw-r--r--
pbmpscale.html	1.82 KB	-rw-r--r--
pbmreduce.html	2.29 KB	-rw-r--r--
pbmtext.html	9.38 KB	-rw-r--r--
pbmtextps.html	3.46 KB	-rw-r--r--
pbmto10x.html	1.37 KB	-rw-r--r--
pbmto4425.html	1.75 KB	-rw-r--r--
pbmtoascii.html	1.75 KB	-rw-r--r--
pbmtoatk.html	934 B	-rw-r--r--
pbmtobbnbg.html	1.32 KB	-rw-r--r--
pbmtocis.html	1.49 KB	-rw-r--r--
pbmtocmuwm.html	1.03 KB	-rw-r--r--
pbmtodjvurle.html	1.18 KB	-rw-r--r--
pbmtoepsi.html	3.24 KB	-rw-r--r--
pbmtoepson.html	3.11 KB	-rw-r--r--
pbmtoescp2.html	3.94 KB	-rw-r--r--
pbmtog3.html	2.24 KB	-rw-r--r--
pbmtogem.html	1.16 KB	-rw-r--r--
pbmtogo.html	1.24 KB	-rw-r--r--
pbmtoibm23xx.html	2.31 KB	-rw-r--r--
pbmtoicon.html	1005 B	-rw-r--r--
pbmtolj.html	3.34 KB	-rw-r--r--
pbmtoln03.html	1.45 KB	-rw-r--r--
pbmtolps.html	1.48 KB	-rw-r--r--
pbmtomacp.html	1.81 KB	-rw-r--r--
pbmtomatrixorbital.html	1.46 KB	-rw-r--r--
pbmtomda.html	1.75 KB	-rw-r--r--
pbmtomgr.html	1.03 KB	-rw-r--r--
pbmtomrf.html	1.4 KB	-rw-r--r--
pbmtonokia.html	3.28 KB	-rw-r--r--
pbmtopgm.html	2.47 KB	-rw-r--r--
pbmtopi3.html	1.11 KB	-rw-r--r--
pbmtopk.html	4.3 KB	-rw-r--r--
pbmtoplot.html	1.06 KB	-rw-r--r--
pbmtoppa.html	10.29 KB	-rw-r--r--
pbmtopsg3.html	1.8 KB	-rw-r--r--
pbmtoptx.html	1.05 KB	-rw-r--r--
pbmtowbmp.html	1.32 KB	-rw-r--r--
pbmtox10bm.html	631 B	-rw-r--r--
pbmtoxbm.html	1.49 KB	-rw-r--r--
pbmtoybm.html	1.13 KB	-rw-r--r--
pbmtozinc.html	1.11 KB	-rw-r--r--
pbmupc.html	1.91 KB	-rw-r--r--
pc1toppm.html	1.13 KB	-rw-r--r--
pcdindex.html	315 B	-rw-r--r--
pcdovtoppm.html	2.32 KB	-rw-r--r--
pcxtoppm.html	2.27 KB	-rw-r--r--
pfm.html	3.24 KB	-rw-r--r--
pfmtopam.html	1.89 KB	-rw-r--r--
pgm.html	6.86 KB	-rw-r--r--
pgmabel.html	3.27 KB	-rw-r--r--
pgmbentley.html	1.14 KB	-rw-r--r--
pgmcrater.html	6.58 KB	-rw-r--r--
pgmdeshadow.html	1.89 KB	-rw-r--r--
pgmedge.html	504 B	-rw-r--r--
pgmenhance.html	1.53 KB	-rw-r--r--
pgmhist.html	1.03 KB	-rw-r--r--
pgmkernel.html	2.26 KB	-rw-r--r--
pgmmake.html	1.72 KB	-rw-r--r--
pgmmedian.html	3.39 KB	-rw-r--r--
pgmminkowski.html	3.48 KB	-rw-r--r--
pgmmorphconv.html	3.87 KB	-rw-r--r--
pgmnoise.html	1.86 KB	-rw-r--r--
pgmnorm.html	504 B	-rw-r--r--
pgmoil.html	492 B	-rw-r--r--
pgmramp.html	2.7 KB	-rw-r--r--
pgmslice.html	478 B	-rw-r--r--
pgmtexture.html	2.16 KB	-rw-r--r--
pgmtofs.html	1.08 KB	-rw-r--r--
pgmtolispm.html	1.81 KB	-rw-r--r--
pgmtopbm.html	1.58 KB	-rw-r--r--
pgmtopgm.html	1.64 KB	-rw-r--r--
pgmtoppm.html	4.08 KB	-rw-r--r--
pi1toppm.html	1.17 KB	-rw-r--r--
pi3topbm.html	1.12 KB	-rw-r--r--
picttoppm.html	5.36 KB	-rw-r--r--
pjtoppm.html	1.27 KB	-rw-r--r--
pktopbm.html	2.04 KB	-rw-r--r--
pngtopam.html	8.02 KB	-rw-r--r--
pngtopnm.html	1.87 KB	-rw-r--r--
pnm.html	1.86 KB	-rw-r--r--
pnmalias.html	2.81 KB	-rw-r--r--
pnmarith.html	752 B	-rw-r--r--
pnmcat.html	2.42 KB	-rw-r--r--
pnmcolormap.html	8.08 KB	-rw-r--r--
pnmcomp.html	2.05 KB	-rw-r--r--
pnmconvol.html	11.35 KB	-rw-r--r--
pnmcrop.html	6.18 KB	-rw-r--r--
pnmcut.html	1000 B	-rw-r--r--
pnmdepth.html	840 B	-rw-r--r--
pnmenlarge.html	534 B	-rw-r--r--
pnmfile.html	509 B	-rw-r--r--
pnmflip.html	953 B	-rw-r--r--
pnmgamma.html	12.02 KB	-rw-r--r--
pnmhisteq.html	6.31 KB	-rw-r--r--
pnmhistmap.html	5.21 KB	-rw-r--r--
pnmindex.html	3.14 KB	-rw-r--r--
pnminterp.html	569 B	-rw-r--r--
pnminvert.html	1.27 KB	-rw-r--r--
pnmmargin.html	1.77 KB	-rw-r--r--
pnmmercator.html	5.44 KB	-rw-r--r--
pnmmontage.html	4.49 KB	-rw-r--r--
pnmnlfilt.html	7.24 KB	-rw-r--r--
pnmnoraw.html	751 B	-rw-r--r--
pnmnorm.html	10.82 KB	-rw-r--r--
pnmpad.html	4.78 KB	-rw-r--r--
pnmpaste.html	3.63 KB	-rw-r--r--
pnmpsnr.html	2.1 KB	-rw-r--r--
pnmquant.html	2.39 KB	-rw-r--r--
pnmremap.html	10.68 KB	-rw-r--r--
pnmrotate.html	4.94 KB	-rw-r--r--
pnmscale.html	1.01 KB	-rw-r--r--
pnmscalefixed.html	2.66 KB	-rw-r--r--
pnmshear.html	3.81 KB	-rw-r--r--
pnmsmooth.html	3.24 KB	-rw-r--r--
pnmsplit.html	676 B	-rw-r--r--
pnmstitch.html	4.03 KB	-rw-r--r--
pnmtile.html	1.4 KB	-rw-r--r--
pnmtoddif.html	2.26 KB	-rw-r--r--
pnmtofiasco.html	10.94 KB	-rw-r--r--
pnmtofits.html	495 B	-rw-r--r--
pnmtojbig.html	9.61 KB	-rw-r--r--
pnmtojpeg.html	21.33 KB	-rw-r--r--
pnmtopalm.html	9.55 KB	-rw-r--r--
pnmtopclxl.html	6 KB	-rw-r--r--
pnmtoplainpnm.html	733 B	-rw-r--r--
pnmtopng.html	17.96 KB	-rw-r--r--
pnmtopnm.html	2.51 KB	-rw-r--r--
pnmtops.html	15.06 KB	-rw-r--r--
pnmtorast.html	1.53 KB	-rw-r--r--
pnmtorle.html	3.25 KB	-rw-r--r--
pnmtosgi.html	1.96 KB	-rw-r--r--
pnmtosir.html	1.14 KB	-rw-r--r--
pnmtotiff.html	495 B	-rw-r--r--
pnmtotiffcmyk.html	7.16 KB	-rw-r--r--
pnmtoxwd.html	1.69 KB	-rw-r--r--
ppm.html	6.75 KB	-rw-r--r--
ppm3d.html	4.3 KB	-rw-r--r--
ppmbrighten.html	5.67 KB	-rw-r--r--
ppmchange.html	5.5 KB	-rw-r--r--
ppmcie.html	13.67 KB	-rw-r--r--
ppmcolormask.html	3.95 KB	-rw-r--r--
ppmcolors.html	497 B	-rw-r--r--
ppmdcfont.html	1.63 KB	-rw-r--r--
ppmddumpfont.html	1.11 KB	-rw-r--r--
ppmdim.html	1.34 KB	-rw-r--r--
ppmdist.html	2.07 KB	-rw-r--r--
ppmdither.html	2.05 KB	-rw-r--r--
ppmdmkfont.html	1.26 KB	-rw-r--r--
ppmdraw.html	8.33 KB	-rw-r--r--
ppmfade.html	4.86 KB	-rw-r--r--
ppmflash.html	2.04 KB	-rw-r--r--
ppmforge.html	16.43 KB	-rw-r--r--
ppmglobe.html	4.93 KB	-rw-r--r--
ppmhist.html	4.72 KB	-rw-r--r--
ppmlabel.html	5.82 KB	-rw-r--r--
ppmmake.html	1.9 KB	-rw-r--r--
ppmmix.html	1.35 KB	-rw-r--r--
ppmnorm.html	538 B	-rw-r--r--
ppmntsc.html	3.06 KB	-rw-r--r--
ppmpat.html	2.65 KB	-rw-r--r--
ppmquant.html	2.82 KB	-rw-r--r--
ppmquantall.html	2.16 KB	-rw-r--r--
ppmrainbow.html	3.37 KB	-rw-r--r--
ppmrelief.html	1.25 KB	-rw-r--r--
ppmrough.html	4.88 KB	-rw-r--r--
ppmshadow.html	10.07 KB	-rw-r--r--
ppmshift.html	2.4 KB	-rw-r--r--
ppmspread.html	1.37 KB	-rw-r--r--
ppmsvgalib.html	4.55 KB	-rw-r--r--
ppmtoacad.html	5.64 KB	-rw-r--r--
ppmtoarbtxt.html	5.09 KB	-rw-r--r--
ppmtobmp.html	3.99 KB	-rw-r--r--
ppmtoeyuv.html	1.28 KB	-rw-r--r--
ppmtogif.html	2.63 KB	-rw-r--r--
ppmtoicr.html	3.77 KB	-rw-r--r--
ppmtoilbm.html	5.25 KB	-rw-r--r--
ppmtojpeg.html	590 B	-rw-r--r--
ppmtoleaf.html	1.15 KB	-rw-r--r--
ppmtolj.html	1.97 KB	-rw-r--r--
ppmtomap.html	1.12 KB	-rw-r--r--
ppmtomitsu.html	4.1 KB	-rw-r--r--
ppmtompeg-par.gif	36.52 KB	-rw-r--r--
ppmtompeg-snr.gif	2.3 KB	-rw-r--r--
ppmtompeg.html	45.06 KB	-rw-r--r--
ppmtoneo.html	1.18 KB	-rw-r--r--
ppmtopcx.html	5.92 KB	-rw-r--r--
ppmtopgm.html	2.09 KB	-rw-r--r--
ppmtopi1.html	1.14 KB	-rw-r--r--
ppmtopict.html	1.67 KB	-rw-r--r--
ppmtopj.html	2.89 KB	-rw-r--r--
ppmtopjxl.html	3.02 KB	-rw-r--r--
ppmtoppm.html	1.8 KB	-rw-r--r--
ppmtopuzz.html	1.17 KB	-rw-r--r--
ppmtorgb3.html	1.55 KB	-rw-r--r--
ppmtosixel.html	2.67 KB	-rw-r--r--
ppmtoterm.html	2.79 KB	-rw-r--r--
ppmtotga.html	541 B	-rw-r--r--
ppmtouil.html	395 B	-rw-r--r--
ppmtowinicon.html	3.96 KB	-rw-r--r--
ppmtoxpm.html	6.95 KB	-rw-r--r--
ppmtoyuv.html	2.84 KB	-rw-r--r--
ppmtoyuvsplit.html	1.92 KB	-rw-r--r--
ppmtv.html	1.58 KB	-rw-r--r--
ppmwheel.html	1.84 KB	-rw-r--r--
psidtopgm.html	1.88 KB	-rw-r--r--
pstopnm.html	13.03 KB	-rw-r--r--
qrttoppm.html	982 B	-rw-r--r--
rasttopnm.html	1.26 KB	-rw-r--r--
rawtopgm.html	5.19 KB	-rw-r--r--
rawtoppm.html	2.98 KB	-rw-r--r--
rgb3toppm.html	1.27 KB	-rw-r--r--
rlatopam.html	1.34 KB	-rw-r--r--
rletopnm.html	3.79 KB	-rw-r--r--
sbigtopgm.html	1.3 KB	-rw-r--r--
sgitopnm.html	2.02 KB	-rw-r--r--
sirtopnm.html	1.22 KB	-rw-r--r--
sldtoppm.html	5.89 KB	-rw-r--r--
spctoppm.html	1.08 KB	-rw-r--r--
spottopgm.html	2.62 KB	-rw-r--r--
sputoppm.html	1.09 KB	-rw-r--r--
testimg.png	48.11 KB	-rw-r--r--
testimg_histbar.png	1.08 KB	-rw-r--r--
testimg_histdot.png	1014 B	-rw-r--r--
tgatoppm.html	2.12 KB	-rw-r--r--
thinkjettopbm.html	1.75 KB	-rw-r--r--
tifftopnm.html	13.08 KB	-rw-r--r--
vidtoppm.html	755 B	-rw-r--r--
wbmptopbm.html	1.31 KB	-rw-r--r--
winicontoppm.html	2.64 KB	-rw-r--r--
xbmtopbm.html	1.04 KB	-rw-r--r--
ximtoppm.html	2.14 KB	-rw-r--r--
xpmtoppm.html	2.62 KB	-rw-r--r--
xvminitoppm.html	1.38 KB	-rw-r--r--
xwdtopnm.html	4.34 KB	-rw-r--r--
ybmtopbm.html	1.12 KB	-rw-r--r--
yuvsplittoppm.html	1.68 KB	-rw-r--r--
yuvtoppm.html	1.54 KB	-rw-r--r--
zeisstopnm.html	1.33 KB	-rw-r--r--

Code Editor : libppm.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE>User manual for old ppm functions</TITLE>
<META NAME="manual_section" CONTENT="3">
</HEAD>
<BODY>
<H1>libppm</H1>
Updated: 8 May 2009
 
<A HREF="#index">Table Of Contents</A>

libppm - functions for PPM programs

<H2 id="synopsis">SYNOPSIS</H2>

#include &lt;netpbm/ppm.h&gt;

void ppm_init(int * argcP,
 char * argv[]);

pixel ** ppm_allocarray(

int cols,int rows);

pixel * ppm_allocrow(int cols);

void ppm_freearray(pixel ** pixels,
 int rows);

void ppm_freerow(pixel * pixelrow);

void ppm_readppminit(FILE * fp,
 int * colsP,
 int * rowsP,

pixval * maxvalP,int * formatP );

void ppm_readppmrow(FILE *fp,
 pixel * pixelrow,
 int cols,
 pixval maxval,
 int format);

pixel ** ppm_readppm(FILE * fp,
 int * colsP,
 int * rowsP,
 pixvalP * maxvalP);

void ppm_writeppminit(FILE * fp,
 int cols,
 int rows,
 pixval maxval,
 int forceplain);

void ppm_writeppmrow(FILE * fp,
 pixel * pixelrow,
 int cols,
 pixval maxval,
 int forceplain);

void ppm_writeppm(FILE * fp,
 pixel ** pixels,
 int cols,
 int rows,
 pixval maxval,
 int forceplain);

void ppm_nextimage(FILE * file,
 int * const eofP);

void ppm_check(FILE * file,
 const enum pm_check_type check_type,
 const int format,
 const int cols,
 const int rows,
 const int maxval,

enum pm_check_code * const retval);

typedef ... pixel;

typedef ... pixval;

#define PPM_MAXMAXVAL ...

#define PPM_OVERALLMAXVAL ...

#define PPM_FORMAT ...

#define RPPM_FORMAT ...

#define PPM_TYPE PPM_FORMAT

#define PPM_FORMAT_TYPE(format) ...

pixval PPM_GETR(pixel p)

pixval PPM_GETG(pixel p)

pixval PPM_GETB(pixel p)

void PPM_ASSIGN(pixel p,
 pixval red,
 pixval grn,
 pixval blu)

int PPM_EQUAL(pixel p,
 pixel q)

int PPM_ISGRAY(pixel p)

void
 PPM_DEPTH(pixel newp,
 pixel p,
 pixval oldmaxval,
 pixval newmaxval)

pixel ppm_parsecolor(char * colorname,
 pixval maxval)

char * ppm_colorname(pixel * colorP,
 pixval maxval,
 int hexok)

void ppm_readcolornamefile(
 const char *fileName, 
 int mustOpen,
 colorhash_table * chtP, 
 const char *** colornamesP
 )

<H2 id="description">DESCRIPTION</H2>

These library functions are part of <a href="index.html">Netpbm</a>.

<H3 id="types">TYPES AND CONSTANTS</H3>

Each pixel contains three pixvals, each of which should
contain only the values between 0 and PPM_MAXMAXVAL.

<H3 id="manipulating_pixels">MANIPULATING PIXELS</H3>

The macros PPM_GETR, PPM_GETG, and PPM_GETB
retrieve the red, green, or blue sample, respectively, from the given
pixel.

The PPM_ASSIGN macro assigns the given values to the red,
green, and blue samples of the given pixel.

The PPM_EQUAL macro tests two pixels for equality.

The PPM_ISGRAY macro tests a pixel for being gray. It
returns true if and only if the color of pixel p is black,
white, or gray.

The PPM_DEPTH macro scales the colors of pixel p
according the old and new maxvals and assigns the new values to
newp. It is intended to make writing ppmtowhatever easier.

The PPM_LUMIN, PPM_CHROM_R, and PPM_CHROM_B
macros determine the luminance, red chrominance, and blue chrominance,
respectively, of the pixel p. The scale of all these values is
the same as the scale of the input samples (i.e. 0 to maxval for
luminance, -maxval/2 to maxval/2 for chrominance).

Note that the macros do it by floating point multiplication. If
you are computing these values over an entire image, it may be
significantly faster to do it with multiplication tables instead.
Compute all the possible products once up front, then for each pixel,
just look up the products in the tables.

<H3 id="initialization">INITIALIZATION</H3>

ppm_init() is identical to pm_proginit.

ppm_init() is obsolete. Use pm_proginit() instead.

<H3 id="memorymanagement">MEMORY MANAGEMENT</H3>

ppm_allocarray() allocates an array of pixels.

ppm_allocrow() allocates a row of the given number of
pixels.

ppm_freearray() frees the array allocated with
ppm_allocarray() containing the given number of rows.

ppm_freerow() frees a row of pixelss allocated with
ppm_allocrow().

<H3 id="readingfiles">READING FILES</H3>

If a function in this section is called on a PBM or PGM format
file, it translates the PBM or PGM file into a PPM file on the fly and
functions as if it were called on the equivalent PPM file. The
format value returned by ppm_readppminit() is, however,
not translated. It represents the actual format of the PBM or PGM
file.

ppm_readppminit() reads the header of a PPM file, returning
all the information from the header and leaving the file positioned
just after the header.

ppm_readppmrow() reads a row of pixels into the
pixelrow array. format, cols, and maxval
are the values returned by ppm_readppminit().

ppm_readppm() reads an entire PPM image into memory,
returning the allocated array as its return value and returning the
information from the header as rows, cols, and
maxval. This function combines ppm_readppminit(),
ppm_allocarray(), and ppm_readppmrow().

<H3 id="writingfiles">WRITING FILES</H3>

ppm_writeppminit() writes the header for a PPM file and leaves
it positioned just after the header.

forceplain is a logical value that tells
ppm_writeppminit() to write a header for a plain PPM format
file, as opposed to a raw PPM format file.

ppm_writeppmrow() writes the row pixelrow to a PPM
file. For meaningful results, cols, maxval, and
forceplain must be the same as was used with
ppm_writeppminit().

ppm_writeppm() write the header and all data for a PPM
image. This function combines ppm_writeppminit() and
ppm_writeppmrow().

<H3 id="miscellaneous">MISCELLANEOUS</H3>

ppm_nextimage() positions a PPM input file to the next image
in it (so that a subsequent ppm_readppminit() reads its
header).

ppm_nextimage() is analogous to pbm_nextimage(), but
works on PPM, PGM, and PBM files.

ppm_check() checks for the common file integrity error
where the file is the wrong size to contain all the image data.

ppm_check() is analogous to pbm_check(), but works
on PPM, PGM, and PBM files.

<h3 id="color">COLOR</h3>

<H4 id="luminance">Luminance, Chrominance (YcbCr)</H4>

<pre>
<code>
 float PPM_LUMIN(pixel p);
 float PPM_CHROM_B(pixel p);
 float PPM_CHROM_R(pixel p);
</code>
</pre>

PPM_LUMIN takes a pixel as an argument and returns
the luminance of that pixel, with the same maxval as the pixel
(e.g. if the pixel's maxval is 255, a PPM_LUMIN value of 255
means fully luminant).

PPM_CHROM_B and PPM_CHROM_R are similar, for the red
and blue chrominance values.

<PRE>
<CODE>
 pixel
 ppm_color_from_ycbcr(unsigned int y, 
 int cb, 
 int cr);
</CODE>
</PRE>

ppm_color_from_ycbcr() converts in the other direction.
Given luminance and chrominance, it returns a pixel value.

<h4 id="hsv">Hue, Saturation, Value (HSV)</h4>

<pre>
<code>
 struct hsv {
 double h; /* hue (degrees) 0..360 */
 double s; /* saturation (0-1) */
 double v; /* value (0-1) */
 };
</code>
</pre>

<pre>
<code>
 pixel
 ppm_color_from_hsv(struct hsv const hsv,
 pixval const maxval);
</code>
</pre>

<pre>
<code>
 struct hsv
 ppm_hsv_from_color(pixel const color,
 pixval const maxval);
</code>
</pre>

These convert a color between from pixel (RGB) form and HSV.

<pre>
<code>
 pixval
 ppm_saturation(pixel const p,
 pixval const maxval);
</code>
</pre>

This gives you the saturation of a color, as a pixval. (e.g. if
the saturation of p is 50% and maxval is 100,
ppm_saturation() returns 50).

<h4 id="berlinkay">Berlin-Kay Color</h4>

Brent Berlin and Paul Kay in 1969 did a study which identified
a set of 11 basic colors people universally recognize. They are:

<ul>
<li>black
<li>gray
<li>white
<li>red
<li>orange
<li>yellow
<li>green
<li>blue
<li>violet
<li>purple
<li>brown
</ul>

The bk_color type represents a color from this set:

<pre>
<code>
 typedef enum {
 BKCOLOR_BLACK = 0,
 BKCOLOR_GRAY,
 BKCOLOR_WHITE,
 BKCOLOR_RED,
 BKCOLOR_ORANGE,
 BKCOLOR_YELLOW,
 BKCOLOR_GREEN,
 BKCOLOR_BLUE,
 BKCOLOR_VIOLET,
 BKCOLOR_PURPLE,
 BKCOLOR_BROWN
 } bk_color;
</code>
</pre>

You can use this as an index of an array, in which case you might also
want macro BKCOLOR_COUNT, which is the number of colors in the
set (11).

To translate between the bk_color type and the English names
of the colors, use ppm_bk_color_from_name() and
ppm_name_from_bk_color():

<pre>
<code>
 bk_color
 ppm_bk_color_from_name(const char * name);
 
 const char *
 ppm_name_from_bk_color(bk_color bkColor);
</code>
</pre>

ppm_bk_color_from_color() tells you to which Berlin-Kay color
a certain color is closest, by way of a fuzzy color matching algorithm:

<pre>
<code>
 bk_color
 ppm_bk_color_from_color(pixel color,
 pixval maxval);
</code>
</pre>

maxval is the maxval on which color is based.

ppm_color_from_bk_color() converts the opposite way: given
a Berlin-Kay color, it gives the color, in pixel form, that best
represents it.

<pre>
<code>
 pixel
 ppm_color_from_bk_color(bk_color bkColor,
 pixval maxval);
</code>
</pre>

maxval is the maxval on which the returned color is based.

All of the facilities in this section were new in Netpbm 10.34
(June 2006).

<H3 id="colorname">COLOR NAMES</H3>

<h4 id="dictionary">System Color Dictionary</h4>

Netpbm uses the system's X11 color dictionary (usually in
/usr/lib/X11/rgb.txt). This is the same file the X Window
System typically uses to associate colors with their names.

The color dictionary that Netpbm uses is in the file whose name is
the value of the RGBDEF environment variable. If RGBDEF
is not set, Netpbm defaults to the first existing file from this list:

<ol>
<li>/usr/lib/X11/rgb.txt
<li>/usr/openwinlib/rgb.txt
<li>/usr/X11R6/lib/X11/rgb.txt
</ol>

You can see the color names from a typical X11 color dictionary,
which is probably very close to what is on your system, along with the
colors, <a
href="http://www.swiss.ai.mit.edu/~jaffer/Color/x11.pdf">here</a>. <a
href="http://www.swiss.ai.mit.edu/~jaffer/Color/Dictionaries.html">This
website</a> shows a bunch of other versions you could use.

Netpbm is packaged with a color dictionary. A standard Netpbm
installation installs this file as "misc/rgb.txt" in the Netpbm
directory. This color dictionary has colors from everywhere the
Netpbm maintainer could find them, and is a superset of XFree 86's
color dictionary.

<H4 id="ppm_parsecolor">ppm_parsecolor</H4>

ppm_parsecolor() interprets a color specification and returns a
pixel of the color that it indicates. The color specification is
ASCII text, in one of these formats:

<ul>

<li>a name, as defined in the <a href="#rgb.txt">system color dictionary
</a>.

<LI> An X11-style hexadecimal specifier:
<tt>rgb:r/g/b</tt>, where r, g, and
b are each 1- to 4-digit hexadecimal numbers. For each, the maxval
is the maximum number that can be represented in the number of hexadecimal
digits given. Example: <tt>rgb:01/ff/8000</tt> specifies 1/255 red
intensity, maximum green intensity, and about half blue intensity.

<LI> An X11-style decimal specifier:
<tt>rgbi:r/g/b</tt>, where r, g,
and b are floating point numbers from 0 to 1.

<li>an old-X11-style hexadecimal triple: <tt>#rgb</tt>, <tt>#rrggbb</tt>, 
<tt>#rrrgggbbb</tt>, or <tt>#rrrrggggbbbb</tt>.

<li>A triplet of decimal floating point numbers from 0.0 to 1.0,
representing red, green, and blue intensities respectively, separated
by commas. E.g. <tt>1.0,0.5,.25</tt>. This is for backwards compatibility;
it was in use before MIT came up with the similar and preferred rgbi style).

</ul>

If the color specification does not conform to any of these
formats, including the case that it is a name, but is not in the
system color dictionary, ppm_parsecolor() <a
href="liberror.html">throws an error</a>.

<h4 id="ppm_colorname">ppm_colorname</h4>

ppm_colorname() returns a string that describes the color
of the given pixel. If a <a href="#rgb.txt">system color dictionary</a>
is available and the color appears in it, ppm_colorname()
returns the name of the color from the file. If the color does not
appear in a system color dictionary and hexok is true,
ppm_colorname() returns a hexadecimal color specification
triple (#rrggbb). If a system color dictionary is available but the
color does not appear in it and hexok is false,
ppm_colorname() returns the name of the closest matching color
in the color file. Finally, if there is no system color dictionary
available and hexok is false, ppm_colorname() fails and
<a href="liberror.html#error">throws an error</a>.

The string returned is in static libppm library storage which is
overwritten by every call to ppm_colorname().

<h4 id="ppm_readcolornamefile">ppm_readcolornamefile</h4>

ppm_readcolornamefile() reads the entire contents of the color
dictionary in the file named fileName into data structures you
can use to access it easily.

The function returns all the color names as an array of
null-terminated strings. It mallocs the space for this array and
returns its address at colornamesP.
(*colornamesP)[i] is the address of the first
character in the null-terminated string that is the name of the
ith color in the dictionary.

The function also returns a colorhash_table (see <a
href="#colorindex">COLOR INDEXING</a>) that matches all these color names
up to the colors they represent. It mallocs the space for the
colorhash_table and returns its address at chtP. The
number that the colorhash_table associates with each color is
the index into the color name array described above of the name of
that color.

You may specify a null pointer for fileName to indicate the
default color dictionary.

mustOpen is a boolean. If it is nonzero, the function fails
and aborts the program if it is unable to open the specified color dictionary
file. If it is zero, though, it simply treats an unopenable color dictionary
as an empty one. The colorhash and color name array it returns contain no
colors or names.

ppm_readcolornamefile() was new in Netpbm 10.15 (April 2003).

<H3 id="colorindex">COLOR INDEXING</H3>

Sometimes in processing images, you want to associate a value with
a particular color. Most often, that's because you're generating a
color mapped graphics format. In a color mapped graphics format, the
raster contains small numbers, and the file contains a color map that
tells what color each of those small numbers refers to. If your image
has only 256 colors, but each color takes 24 bits to describe, this
can make your output file much smaller than a straightforward RGB
raster would.

So, continuing the above example, say you have a pixel value
for chartreuse and in your output file and you are going to represent
chartreuse by the number 12. You need a data structure that allows
your program quickly to find out that the number for a chartreuse
pixel is 12. Netpbm's color indexing data types and functions
give you that.

colorhash_table is a C data type that associates an integer
with each of an arbitrary number of colors. It is a hash table, so it
uses far less space than an array indexed by the color's RGB values
would.

The problem with a colorhash_table is that you can only look
things up in it. You can't find out what colors are in it. So Netpbm
has another data type for representing the same information, the
poorly but historically named colorhist_vector. A
colorhist_vector is just an array. Each entry represents a
color and contains the color's value (as a pixel) and the
integer value associated with it. The entries are filled in starting
with subscript 0 and going consecutively up for the number of colors
in the histogram.

(The reason the name is poor is because a color histogram is only
one of many things that could be represented by it).

colorhash_table ppm_alloccolorhash()

This creates a colorhash_table using dynamically allocated
storage. There are no colors in it. If there is not enough storage,
<a href="liberror.html#error">throws an error</a>.

void ppm_freecolorhash()

This destroys a ppm_freecolorhash and frees all the storage
associated with it.

int ppm_addtocolorhash( colorhash_table cht, const pixel * const
colorP, const int value)

This adds the specified color to the specified colorhash_table
 and associates the specified value with it.

You must ensure that the color you are adding isn't already present
in the colorhash_table.

There is no way to update an entry or delete an entry from a 
colorhash_table.

int ppm_lookupcolor( const colorhash_table cht, const pixel *
const colorP )

This looks up the specified color in the specified
colorhash_table. It returns the integer value associated with
that color.

If the specified color is not in the hash table, the function
returns -1. (So if you assign the value -1 to a color, the return
value is ambiguous).

colorhist_vector ppm_colorhashtocolorhist( const colorhash_table cht,

const int ncolors )

This converts a colorhash_table to a
colorhist_vector. The return value is a new
colorhist_vector which you must eventually free with
ppm_freecolorhist().

ncolors is the number of colors in cht. If it has
more colors than that, ppm_colorhashtocolorhist does not create
a colorhist_vector and returns NULL.

colorhash_table ppm_colorhisttocolorhash( const colorhist_vector chv, 
const int ncolors )

This poorly named function does not convert from a
colorhist_vector to a colorhash_table.

It does create a colorhash_table based on a
colorhist_vector input, but the integer value for a given color
in the output is not the same as the integer value for that same color
in the input. ppm_colorhisttocolorhash() ignores the integer
values in the input. In the output, the integer value for a color is
the index in the input colorhist_vector for that color.

You can easily create a color map for an image by running
ppm_computecolorhist() over the image, then
ppm_colorhisttocolorhash() over the result. Now you can use
ppm_lookupcolor() to find a unique color index for any pixel in
the input.

If the same color appears twice in the input,
ppm_colorhisttocolorhash() <a href="liberror.html#error">throws an
error</a>.

ncolors is the number of colors in chv.

The return value is a new colorhash_table which you must
eventually free with ppm_freecolorhash().

<H3 id="histogram">COLOR HISTOGRAMS</H3>

The Netpbm libraries give you functions to examine a Netpbm image
and determine what colors are in it and how many pixels of each color
are in it. This information is known as a color histogram. Netpbm
uses its colorhash_table data type to represent a color
histogram.

colorhash_table ppm_computecolorhash( pixel ** const pixels,
const int cols, const int rows, const int maxcolors, int* const colorsP )

This poorly but historically named function generates a
colorhash_table whose value for each color is the number of
pixels in a specified image that have that color. (I.e. a color
histogram). As a bonus, it returns the number of colors in the image.

(It's poorly named because not all colorhash_tables are
color histograms, but that's all it generates).

pixels, cols, and rows describe the input
image.

maxcolors is the maximum number of colors you want
processed. If there are more colors that that in the input image,
ppm_computecolorhash() returns NULL as its return value and
stops processing as soon as it discovers this. This makes it run
faster and use less memory. One use for maxcolors is when you
just want to find out whether or not the image has more than N colors
and don't want to wait to generate a huge color table if so. If you
don't want any limit on the number of colors, specify
maxcolors=0.

ppm_computecolorhash() returns the actual number of colors
in the image as *colorsP, but only if it is less than or equal
to maxcolors.

colorhash_table ppm_computecolorhash2( FILE * const ifp,
const int cols, const int rows, const pixval maxval, const int format,

const int maxcolors, int* const colorsP )

This is the same as ppm_computecolorhash() except that
instead of feeding it an array of pixels in storage, you give it an
open file stream and it reads the image from the file. The file must
be positioned after the header, at the raster. Upon return, the file
is still open, but its position is undefined.

maxval and format are the values for the image
(i.e. information from the file's header).

colorhist_vector ppm_computecolorhist( pixel ** pixels,
int cols, int rows, int maxcolors, int * colorsP )

This is like ppm_computecolorhash() except that it creates a
colorhist_vector instead of a colorhash_table.

If you supply a nonzero maxcolors argument, that is the
maximum number of colors you expect to find in the input image. If
there are more colors than you say in the image,
ppm_computecolorhist() returns a null pointer as its return
value and nothing meaningful as *colorsP.

If not, the function returns the new colorhist_vector as
its return value and the actual number of colors in the image as
*colorsP. The returned array has space allocated for the
specified number of colors regardless of how many actually exist. The
extra space is at the high end of the array and is available for your
use in expanding the colorhist_vector.

If you specify maxcolors=0, there is no limit on the
number of colors returned and the return array has space for 5 extra
colors at the high end for your use in expanding the
colorhist_vector.

colorhist_vector ppm_computecolorhist2( FILE * ifp,
int cols, int rows, int maxcolors, pixval maxval, int format,
int * colorsP )

This is the same as ppm_computecolorhist() except that
instead of feeding it an array of pixels in storage, you give it an
open file stream and it reads the image from the file. The file must
be positioned after the header, at the raster. Upon return, the file
is still open, but its position is undefined.

<A HREF="pbm.html">pbm</A>,
<A HREF="pgm.html">pgm</A>,
<A HREF="libpbm.html">libpbm</A>

<H2 id="author">AUTHOR</H2>

<HR>
<H2 id="index">Table Of Contents</H2>
<UL>
<LI><A HREF="#synopsis">SYNOPSIS</A>
<LI><A HREF="#description">DESCRIPTION</A>
 <UL>
 <LI><A HREF="#types">TYPES AND CONSTANTS</A>
 <LI><A HREF="#manipulating_pixels">MANIPULATING PIXELS</A>
 <LI><A HREF="#initialization">INITIALIZATION</A>
 <LI><A HREF="#memorymanagement">MEMORY MANAGEMENT</A>
 <LI><A HREF="#readingfiles">READING FILES</A>
 <LI><A HREF="#writingfiles">WRITING FILES</A>
 <LI><A HREF="#miscellaneous">MISCELLANEOUS</A>
 <LI><A HREF="#color">COLOR</A>
 <ul>
 <li><a href="#luminance">Luminance, Chrominance (YcbCr)</a>
 <li><a href="#berlinkay">Berlin-Kay Color</a>
 </ul>
 <LI><A HREF="#colorname">COLOR NAMES</A>
 <ul>
 <li><a href="#dictionary">System Color Dictionary</a>
 <li><a href="#ppm_parsecolor">ppm_parsecolor</a>
 <li><a href="#ppm_colorname">ppm_colorname</a>
 <li><a href="#ppm_readcolornamefile">ppm_readcolornamefile</a>
 </ul>
 <LI><A HREF="#colorindex">COLOR INDEXING</A>
 <LI><A HREF="#histogram">COLOR HISTOGRAMS</A>
 </UL>
 <LI><A HREF="#seealso">SEE ALSO</A>
 <LI><A HREF="#author">AUTHOR</A>
 </UL>
</BODY>
</HTML>

${this.title}

Code Editor : libppm.html