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 : pamscale.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Pamscale User Manual</TITLE></HEAD>
<BODY>
<H1>pamscale</H1>
Updated: 18 February 2005
 
<A HREF="#index">Table Of Contents</A>

pamscale - scale a Netpbm image
<H2 id="synopsis">SYNOPSIS</H2>

<pre>
 pamscale
 [ 
 scale_factor 
 |
 {-xyfit | -xyfill | -xysize} cols rows 
 |
 -reduce reduction_factor 
 |
 [-xsize=cols | -width=cols | -xscale=factor]
 [-ysize=rows | -height=rows | -yscale=factor]
 |
 -pixels n
 ]
 [
 [-verbose]
 [
 -nomix 
 |
 -filter=functionName [-window=functionName]
 ]
 [-linear]
 }
 [pnmfile]

</pre>

Minimum unique abbreviation of option is acceptable. You may use
double hyphens instead of single hyphen to denote options. You may use
white space in place of the equals sign to separate an option name
from its value.

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

This program is part of <a href="index.html">Netpbm</a>.

pamscale scales a Netpbm image by a specified factor, or
scales individually horizontally and vertically by specified factors.

You can either enlarge (scale factor &gt; 1) or reduce (scale factor
&lt; 1).

<h3 id="scalefactor">The Scale Factors</h3>

The options -width, -height, -xsize, -ysize,
-xscale, -yscale, -xyfit, -xyfill, -reduce,
and -pixels control the amount of scaling. For backward compatibility,
there is also -xysize and the scale_factor argument, but you
shouldn't use those.

-width and -height specify the width and height in pixels
you want the resulting image to be. See below for rules when you specify
one and not the other.

-xsize and -ysize are synonyms for -width and
-height, respectively.

-xscale and -yscale tell the factor by which you want the
width and height of the image to change from source to result (e.g.
-xscale 2 means you want to double the width; -xscale .5
means you want to halve it). See below for rules when you specify one and
not the other.

When you specify an absolute size or scale factor for both
dimensions, pamscale scales each dimension independently
without consideration of the aspect ratio.

If you specify one dimension as a pixel size and don't specify the
other dimension, pamscale scales the unspecified dimension to
preserve the aspect ratio.

If you specify one dimension as a scale factor and don't specify
the other dimension, pamscale leaves the unspecified dimension
unchanged from the input.

If you specify the scale_factor parameter instead of
dimension options, that is the scale factor for both dimensions. It
is equivalent to -xscale=scale_factor
-yscale=scale_factor.

Specifying the -reduce reduction_factor option is
equivalent to specifying the scale_factor parameter, where
scale_factor is the reciprocal of reduction_factor.

-xyfit specifies a bounding box. pamscale scales
the input image to the largest size that fits within the box, while
preserving its aspect ratio. -xysize is a synonym for this.
Before Netpbm 10.20 (January 2004), -xyfit did not exist, but
-xysize did.

-xyfill is similar, but pamscale scales the input image
to the smallest size that completely fills the box, while preserving
its aspect ratio. This option has existed since Netpbm 10.20 (January
2004).

-pixels specifies a maximum total number of output pixels.
pamscale scales the image down to that number of pixels. If
the input image is already no more than that many pixels,
pamscale just copies it as output; pamscale does not
scale up with -pixels.

If you enlarge by a factor of 3 or more, you should probably add a
pnmsmooth step; otherwise, you can see the original pixels in
the resulting image.

<h3 id="usage">Usage Notes</h3>

A useful application of pamscale is to blur an image. Scale
it down (without -nomix) to discard some information, then
scale it back up using pamstretch.

Or scale it back up with pamscale and create a
&quot;pixelized&quot; image, which is sort of a computer-age version
of blurring.

<h3 id="transparency">Transparency</h3>

pamscale understands transparency and properly mixes pixels
considering the pixels' transparency.

Proper mixing does not mean just mixing the transparency
value and the color component values separately. In a PAM image, a
pixel which is not opaque represents a color that contains light of
the foreground color indicated explicitly in the PAM and light of a
background color to be named later. But the numerical scale of a
color component sample in a PAM is as if the pixel is opaque. So a
pixel that is supposed to contain half-strength red light for the
foreground plus some light from the background has a red color sample
that says full red and a transparency sample that says 50%
opaque. In order to mix pixels, you have to first convert the color
sample values to numbers that represent amount of light directly
(i.e. multiply by the opaqueness) and after mixing, convert back
(divide by the opaqueness).

<h3 id="imagetype">Input And Output Image Types</h3>

pamscale produces output of the same type (and tuple type if
the type is PAM) as the input, except if the input is PBM. In that
case, the output is PGM with maxval 255. The purpose of this is to
allow meaningful pixel mixing. Note that there is no equivalent
exception when the input is PAM. If the PAM input tuple type is
BLACKANDWHITE, the PAM output tuple type is also BLACKANDWHITE, and
you get no meaningful pixel mixing.

If you want PBM output with PBM input, use pamditherbw to
convert pamscale's output to PBM. Also consider
pbmreduce.

pamscale's function is essentially undefined for PAM input
images that are not of tuple type RGB, GRAYSCALE, BLACKANDWHITE, or
the _ALPHA variations of those. (By standard Netpbm backward compatibility,
this includes PBM, PGM, and PPM images).

You might think it would have an obvious effect on other tuple
types, but remember that the aforementioned tuple types have
gamma-adjusted sample values, and pamscale uses that fact in
its calculations. And it treats a transparency plane different from any
other plane.

pamscale does not simply reject unrecognized tuple types
because there's a possibility that just by coincidence you can get
useful function out of it with some other tuple type and the right
combination of options (consider -linear in particular).

<h3 id="methods">Methods Of Scaling</h3>

There are numerous ways to scale an image. pamscale implements
a bunch of them; you select among them with invocation options.

<h4 id="mixing">Pixel Mixing</h4>

Pamscale's default method is pixel mixing. To understand this, imagine the
source image as composed of square tiles. Each tile is a pixel and has
uniform color. The tiles are all the same size. Now take a transparent sheet
the size of the target image, marked with a square grid of tiles the same
size. Stretch or compress the source image to the size of the sheet and lay
the sheet over the source.

Each cell in the overlay grid stands for a pixel of the target
image. For example, if you are scaling a 100x200 image up by 1.5, the
source image is 100 x 200 tiles, and the transparent sheet is marked
off in 150 x 300 cells.

Each cell covers parts of multiple tiles. To make the target image,
just color in each cell with the color which is the average of the colors
the cell covers -- weighted by the amount of that color it covers. A
cell in our example might cover 4/9 of a blue tile, 2/9 of a red tile,
2/9 of a green tile, and 1/9 of a white tile. So the target pixel
would be somewhat unsaturated blue.

When you are scaling up or down by an integer, the results are
simple. When scaling up, pixels get duplicated. When scaling down,
pixels get thrown away. In either case, the colors in the target
image are a subset of those in the source image.

When the scale factor is weirder than that, the target image can
have colors that didn't exist in the original. For example, a red
pixel next to a white pixel in the source might become a red pixel,
a pink pixel, and a white pixel in the target.

This method tends to replicate what the human eye does as it moves
closer to or further away from an image. It also tends to replicate
what the human eye sees, when far enough away to make the pixelization
disappear, if an image is not made of pixels and simply stretches
or shrinks.

<h4 id="sampling">Discrete Sampling</h4>

Discrete sampling is basically the same thing as pixel mixing except
that, in the model described above, instead of averaging the colors of
the tiles the cell covers, you pick the one color that covers the most
area.

The result you see is that when you enlarge an image, pixels
get duplicated and when you reduce an image, some pixels get discarded.

The advantage of this is that you end up with an image made from the
same color palette as the original. Sometimes that's important.

The disadvantage is that it distorts the picture. If you scale up
by 1.5 horizontally, for example, the even numbered input pixels are
doubled in the output and the odd numbered ones are copied singly. If
you have a bunch of one pixel wide lines in the source, you may find
that some of them stretch to 2 pixels, others remain 1 pixel when you
enlarge. When you reduce, you may find that some of the lines
disappear completely.

You select discrete sampling with pamscale's -nomix
option.

Actually, -nomix doesn't do exactly what I described above.
It does the scaling in two passes - first horizontal, then vertical.
This can produce slightly different results.

There is one common case in which one often finds it burdensome to
have pamscale make up colors that weren't there originally:
Where one is working with an image format such as GIF that has a
limited number of possible colors per image. If you take a GIF with
256 colors, convert it to PPM, scale by .625, and convert back to GIF,
you will probably find that the reduced image has way more than 256
colors, and therefore cannot be converted to GIF. One way to solve
this problem is to do the reduction with discrete sampling instead of
pixel mixing. Probably a better way is to do the pixel mixing, but
then color quantize the result with pnmquant before converting
to GIF.

When the scale factor is an integer (which means you're scaling
up), discrete sampling and pixel mixing are identical -- output pixels
are always just N copies of the input pixels. In this case, though,
consider using pamstretch instead of pamscale to get the
added pixels interpolated instead of just copied and thereby get a
smoother enlargement.

pamscale's discrete sampling is faster than pixel mixing,
but pamenlarge is faster still. pamenlarge works only
on integer enlargements.

discrete sampling (-nomix) was new in Netpbm 9.24 (January
2002).

<h4 id="resampling">Resampling</h4>

Resampling assumes that the source image is a discrete sampling of some
original continuous image. That is, it assumes there is some non-pixelized
original image and each pixel of the source image is simply the color of
that image at a particular point. Those points, naturally, are the
intersections of a square grid.

The idea of resampling is just to compute that original image, then
sample it at a different frequency (a grid of a different scale).

The problem, of course, is that sampling necessarily throws away the
information you need to rebuild the original image. So we have to make
a bunch of assumptions about the makeup of the original image.

You tell pamscale to use the resampling method by specifying
the -filter option. The value of this option is the name of a
function, from the set listed below.

To explain resampling, we are going to talk about a simple
one dimensional scaling -- scaling a single row of grayscale
pixels horizontally. If you can understand that, you can easily
understand how to do a whole image: Scale each of the rows of the
image, then scale each of the resulting columns. And scale each of the
color component planes separately.

As a first step in resampling, pamscale converts the source
image, which is a set of discrete pixel values, into a continuous step
function. A step function is a function whose graph is a staircase-y
thing.

Now, we convolve the step function with a proper scaling of the
filter function that you identified with -filter. If you don't
know what the mathematical concept of convolution (convolving) is, you
are officially lost. You cannot understand this explanation. The
result of this convolution is the imaginary original continuous image
we've been talking about.

Finally, we make target pixels by picking values from that function.

To understand what is going on, we use Fourier analysis:

The idea is that the only difference between our step function and
the original continuous function (remember that we constructed the
step function from the source image, which is itself a sampling of the
original continuous function) is that the step function has a bunch of
high frequency Fourier components added. If we could chop out all the
higher frequency components of the step function, and know that
they're all higher than any frequency in the original function, we'd
have the original function back.

The resampling method assumes that the original function
was sampled at a high enough frequency to form a perfect sampling. A
perfect sampling is one from which you can recover exactly the
original continuous function. The Nyquist theorem says that as long
as your sample rate is at least twice the highest frequency in your
original function, the sampling is perfect. So we assume
that the image is a sampling of something whose highest frequency is
half the sample rate (pixel resolution) or less. Given that, our
filtering does in fact recover the original continuous image from the
samples (pixels).

To chop out all the components above a certain frequency, we just
multiply the Fourier transform of the step function by a rectangle
function.

We could find the Fourier transform of the step function, multiply
it by a rectangle function, and then Fourier transform the result
back, but there's an easier way. Mathematicians tell us that
multiplying in the frequency domain is equivalent to convolving in the
time domain. That means multiplying the Fourier transform of F by a
rectangle function R is the same as convolving F with the Fourier
transform of R. It's a lot better to take the Fourier transform of
R, and build it into pamscale than to have pamscale
take the Fourier transform of the input image dynamically.

That leaves only one question: What is the Fourier
transform of a rectangle function? Answer: sinc. Recall from
math that sinc is defined as sinc(x) = sin(PI*x)/PI*x.

Hence, when you specify -filter=sinc, you are effectively
passing the step function of the source image through a low pass
frequency filter and recovering a good approximation of the original
continuous image.

<h4>Refiltering</h4>

There's another twist: If you simply sample the reconstructed
original continuous image at the new sample rate, and that new sample
rate isn't at least twice the highest frequency in the original
continuous image, you won't get a perfect sampling. In fact, you'll
get something with ugly aliasing in it. Note that this can't be a
problem when you're scaling up (increasing the sample rate), because
the fact that the old sample rate was above the Nyquist level means so
is the new one. But when scaling down, it's a problem. Obviously,
you have to give up image quality when scaling down, but aliasing is
not the best way to do it. It's better just to remove high frequency
components from the original continuous image before sampling, and
then get a perfect sampling of that.

Therefore, pamscale filters out frequencies above half the
new sample rate before picking the new samples.

<h4>Approximations</h4>

Unfortunately, pamscale doesn't do the convolution
precisely. Instead of evaluating the filter function at every point,
it samples it -- assumes that it doesn't change any more often than
the step function does. pamscale could actually do the true
integration fairly easily. Since the filter functions are built into
the program, the integrals of them could be too. Maybe someday it
will.

There is one more complication with the Fourier analysis. sinc
has nonzero values on out to infinity and minus infinity. That makes
it hard to compute a convolution with it. So instead, there are
filter functions that approximate sinc but are nonzero only within a
manageable range. To get those, you multiply the sinc function by a
window function, which you select with the -window
option. The same holds for other filter functions that go on forever
like sinc. By default, for a filter that needs a window function,
the window function is the Blackman function.

<h4>Filter Functions Besides Sinc</h4>

The math described above works only with sinc as the filter
function. pamscale offers many other filter functions, though.
Some of these approximate sinc and are faster to compute. For most of
them, I have no idea of the mathematical explanation for them, but
people do find they give pleasing results. They may not be based on
resampling at all, but just exploit the convolution that is
coincidentally part of a resampling calculation.

For some filter functions, you can tell just by looking at the
convolution how they vary the resampling process from the perfect one
based on sinc:

The impulse filter assumes that the original continuous image is in
fact a step function -- the very one we computed as the first step in
the resampling. This is mathematically equivalent to the discrete
sampling method.

The box (rectangle) filter assumes the original image is a
piecewise linear function. Its graph just looks like straight lines
connecting the pixel values. This is mathematically equivalent to the
pixel mixing method (but mixing brightness, not light intensity, so
like pamscale -linear) when scaling down, and interpolation
(ala pamstretch) when scaling up.

<h4>Gamma</h4>

pamscale assumes the underlying continuous function is a
function of brightness (as opposed to light intensity), and therefore
does all this math using the gamma-adjusted numbers found in a PNM or
PAM image. The -linear option is not available with resampling
(it causes pamscale to fail), because it wouldn't be useful enough
to justify the implementation effort.

Resampling (-filter) was new in Netpbm 10.20 (January 2004).

<h4>The filter functions</h4>

Here is a list of the function names you can specify for the
-filter option. For most of them, you're on your own to figure
out just what the function is and what kind of scaling it does. These
are common functions from mathematics.

<dl>
<dt>point
<dd>The graph of this is a single point at X=0, Y=1.

<dt>box

<dd>The graph of this is a rectangle sitting on the X axis and centered
on the Y axis with height 1 and base 1.

<dt>triangle

<dd>The graph of this is an isosceles triangle sitting on the X axis
and centered on the Y axis with height 1 and base 2.

<dt>quadratic
<dt>cubic
<dt>catrom
<dt>mitchell
<dt>gauss
<dt>sinc
<dt>bessel
<dt>hanning
<dt>hamming
<dt>blackman
<dt>kaiser
<dt>normal
<dt>hermite
<dt>lanczos
<dd>Not documented</dd>
</dl>

<H3 id="linear">Linear vs Gamma-adjusted</H3>

The pixel mixing scaling method described above involves intensities
of pixels (more precisely, it involves individual intensities of
primary color components of pixels). But the PNM and PNM-equivalent
PAM image formats represent intensities with gamma-adjusted numbers
that are not linearly proportional to intensity. So pamscale,
by default, performs a calculation on each sample read from its input
and each sample written to its output to convert between these
gamma-adjusted numbers and internal intensity-proportional numbers.

Sometimes you are not working with true PNM or PAM images, but
rather a variation in which the sample values are in fact directly
proportional to intensity. If so, use the -linear option to
tell pamscale this. pamscale then will skip the
conversions.

The conversion takes time. In one experiment, it increased by a factor of
10 the time required to reduce an image. And the difference between
intensity-proportional values and gamma-adjusted values may be small enough
that you would barely see a difference in the result if you just pretended
that the gamma-adjusted values were in fact intensity-proportional. So just
to save time, at the expense of some image quality, you can specify
-linear even when you have true PPM input and expect true PPM output.

For the first 13 years of Netpbm's life, until Netpbm 10.20
(January 2004), pamscale's predecessor pnmscale always
treated the PPM samples as intensity-proportional even though they
were not, and drew few complaints. So using -linear as a lie
is a reasonable thing to do if speed is important to you. But if
speed is important, you also should consider the -nomix option
and pnmscalefixed.

Another technique to consider is to convert your PNM image to the
linear variation with pnmgamma, run pamscale on it and
other transformations that like linear PNM, and then convert it back
to true PNM with pnmgamma -ungamma. pnmgamma is often
faster than pamscale in doing the conversion.

With -nomix, -linear has no effect. That's because
pamscale does not concern itself with the meaning of the sample
values in this method; pamscale just copies numbers from its
input to its output.

<H3 id="precision">Precision</H3>

pamscale uses floating point arithmetic internally. There
is a speed cost associated with this. For some images, you can get
the acceptable results (in fact, sometimes identical results) faster
with pnmscalefixed, which uses fixed point arithmetic.
pnmscalefixed may, however, distort your image a little. See
the pnmscalefixed user manual for a complete discussion of the
difference.

<A HREF="pnmscalefixed.html">pnmscalefixed</A>,
<A HREF="pamstretch.html">pamstretch</A>,
<A HREF="pamditherbw.html">pamditherbw</A>,
<A HREF="pbmreduce.html">pbmreduce</A>,
<A HREF="pbmpscale.html">pbmpscale</A>,
<A HREF="pamenlarge.html">pamenlarge</A>,
<A HREF="pnmsmooth.html">pnmsmooth</A>,
<A HREF="pamcut.html">pamcut</A>,
<A HREF="pnmgamma.html">pnmgamma</A>,
<A HREF="pnmscale.html">pnmscale</A>,
<A HREF="pnm.html">pnm</A>,
<A HREF="pam.html">pam</A>

<H2 id="history">HISTORY</H2>

pamscale was new in Netpbm 10.20 (January 2004). It was
adapted from, and obsoleted, pnmscale. pamscale's
primary difference from pnmscale is that it handles the PAM
format and uses the "pam" facilities of the Netpbm programming
library. But it also added the resampling class of scaling method.
Furthermore, it properly does its pixel mixing arithmetic (by default)
using intensity-proportional values instead of the gamma-adjusted
values the pnmscale uses. To get the old pnmscale
arithmetic, you can specify the -linear option.

The intensity proportional stuff came out of suggestions by <a
href="mailto://amc+j5luho+@nicemice.net">Adam M Costello</a> in January
2004.

The resampling algorithms are mostly taken from code contributed by
<a href="mailto://reinelt@eunet.at">Michael Reinelt</a> in December 2003.

The version of pnmscale from which pamscale was
derived, itself evolved out of the original Pbmplus version of
pnmscale by Jef Poskanzer (1989, 1991). But none of that
original code remains.

<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="#scalefactor">The Scale Factors</a>
 <LI><A HREF="#usage">Usage Notes</a>
 <LI><A HREF="#transparency">Transparency</a>
 <LI><A HREF="#imagetype">Input And Output Image Types</a>
 <LI><A HREF="#methods">Methods Of Scaling</a>
 <UL>
 <LI><A HREF="#mixing">Pixel Mixing</a>
 <LI><A HREF="#sampling">Discreate Sampling</a>
 <LI><A HREF="#resampling">Resampling</a>
 </UL>
 <LI><A HREF="#linear">Linear vs Gamma-adjusted</a>
 <LI><A HREF="#precision">Precision</A>
 </UL>
 <LI><A HREF="#seealso">SEE ALSO</A> 
 <LI><A HREF="#history">HISTORY</A> 
 </UL>

</BODY>
</HTML>

${this.title}

Code Editor : pamscale.html