home *** CD-ROM | disk | FTP | other *** search
/ Mega A/V / mega_av.zip / mega_av / GRAPHUTL / PBMPLUS.ZIP / README.DOS < prev    next >
Text File  |  1991-08-11  |  7KB  |  196 lines
  1. This is my second (and hopefully better) attempt at porting the PBMPlus package
  2. to MS-DOS.
  3.  
  4. I used D.J. Delorie's port of the GNU GCC compiler to DOS to compile the 
  5. package.  The GCC compiler generates 386 specific, protected mode code.  Used
  6. with DJ's DOS extender (built into the executables distributed with this        
  7. package) allows for some pretty powerful programs.    The current DOS extender
  8. (or rather, the one I'm currently using, there may be newer version with more
  9. compatibilities), is not compatible with much of anything besides vanilla DOS.
  10. No EMM386.SYS, QEMM.SYS, Desqview, Windows, etc.  Source for the
  11. DOS extender is available with the GCC package.  You can obtain the package 
  12. from the internet at grape.ecs.clarkson.edu:pub/msdos/djgcc/* or 
  13. (315)268-6667:pub/msdos/djgcc/*. Feel free to add VCPI or DPMI support.     
  14.  
  15. Improvements:
  16.  
  17.     o    RAWBITS binary formats for p?m files.  This allows MUCH faster             
  18.         executions times, as well as smaller temporary files.  This same
  19.         fix also allows for the familiar unix-style pipings, such as:
  20.  
  21.         tgatoppm dkbtest.tga | ppmquant 256 | ppmtogif > dkbtest.gif
  22.  
  23.         This makes for this source code to be much closer to the PBMPLUS
  24.         package as distributed by Jef Poskanzer.
  25.  
  26.         The only minor problem this causes is when you want to use an ASCII
  27.         only p?m file, you have to change all the LF/CR sequences into LF only
  28.         (that is, run it through a DOS-to-UNIX text file filter).
  29.  
  30.     o    MERGE option for binaries.    This essentially creates one big exectuable
  31.         file rather than a bunch of smaller ones.  On unix systems, you can use
  32.         this option, as well as file links (pointers to a file, rather than an
  33.         actuall file) to point to this one exectuable.    It can save a            
  34.         tremendous amount of space.  How the program works depends on what the
  35.         name is of program when you execute it.  On a DOS machine, you have to
  36.         copy or rename the executable to get the appropriate function (remember,
  37.         how the program works depends on how it's named).  If you want the whole
  38.         package, the MERGE option will take up more room on a DOS machine, but
  39.         it makes for a smaller package to send around the net, and smaller and
  40.         putting all the unused files into an archive if you only want part of 
  41.         the package.                
  42.  
  43.         The entire PBMPLUS package, when compiled into separate binaries, takes
  44.         up just over 6 Megs of diskspace.  The equivalent package compiled using
  45.         the merge option takes up about 300k.
  46.  
  47. The executables I plan to distribute are the merged binaries.  The binaries can
  48. be renamed/copied to the following to get the desired results:
  49.  
  50.                     pbmmerge.exe  to    brushtop.exe
  51.                                         cmuwmtop.exe
  52.                                         g3topbm.exe
  53.                                         icontopb.exe                  
  54.                                         gemtopbm.exe
  55.                                         macptopb.exe
  56.                                         mgrtopbm.exe                  
  57.                                         pbmlife.exe
  58.                                         pbmmake.exe
  59.                                         pbmmask.exe
  60.                                         pbmpaste.exe
  61.                                         pbmreduc.exe
  62.                                         pbmtext.exe
  63.                                         pbmto10x.exe
  64.                                         pbmtoasc.exe
  65.                                         pbmtobbn.exe
  66.                                         pbmtocmu.exe
  67.                                         pbmtoeps.exe
  68.                                         pbmtog3.exe
  69.                                         pbmtogem.exe
  70.                                         pbmtogo.exe
  71.                                         pbmtoico.exe
  72.                                         pbmtolj.exe
  73.                                         pbmtomac.exe
  74.                                         pbmtomgr.exe
  75.                                         pbmtopi3.exe
  76.                                         pbmtoplo.exe
  77.                                         pbmtoptx.exe
  78.                                         pbmtox10.exe
  79.                                         pbmtoxbm.exe
  80.                                         pbmtoybm.exe
  81.                                         pbmtozin.exe
  82.                                         pbmupc.exe
  83.                                         pi3topbm.exe
  84.                                         xbmtopbm.exe
  85.                                         ybmtopbm.exe
  86.  
  87.                     pgmmerge.exe to     fitstopg.exe
  88.                                         fstopgm.exe
  89.                                         hipstopg.exe
  90.                                         lispmtop.exe
  91.                                         pgmbentl.exe
  92.                                         pgmenhan.exe
  93.                                         pgmhist.exe
  94.                                         pgmnorm.exe
  95.                                         pgmoil.exe
  96.                                         pgmramp.exe
  97.                                         pgmtopbm.exe
  98.                                         pgmtofit.exe
  99.                                         pgmtofs.exe
  100.                                         pgmtolis.exe
  101.                                         pgmtops.exe
  102.                                         psidtopg.exe
  103.                                         rawtopgm.exe
  104.                                         pgmedge.exe
  105.  
  106.                     ppmmerge.exe to     giftoppm.exe
  107.                                         gouldtop.exe
  108.                                         ilbmtopp.exe
  109.                                         imgtoppm.exe
  110.                                         mtvtoppm.exe
  111.                                         pcxtoppm.exe
  112.                                         pgmtoppm.exe
  113.                                         pi1toppm.exe
  114.                                         picttopp.exe
  115.                                         ppmhist.exe
  116.                                         ppmmake.exe
  117.                                         ppmquant.exe
  118.                                         ppmrelie.exe
  119.                                         ppmtogif.exe
  120.                                         ppmtoicr.exe
  121.                                         ppmtoilb.exe
  122.                                         ppmtopcx.exe
  123.                                         ppmtopgm.exe
  124.                                         ppmtopi1.exe
  125.                                         ppmtopic.exe
  126.                                         ppmtops.exe
  127.                                         ppmtopuz.exe
  128.                                         ppmtorgb.exe
  129.                                         ppmtouil.exe
  130.                                         ppmtoxpm.exe
  131.                                         qrttoppm.exe
  132.                                         rawtoppm.exe
  133.                                         rgb3topp.exe
  134.                                         spctoppm.exe
  135.                                         sputoppm.exe
  136.                                         tgatoppm.exe
  137.                                         ximtoppm.exe
  138.                                         xpmtoppm.exe
  139.                                         ppmpat.exe
  140.                                         
  141.  
  142.                     pnmmerge.exe to     pnmarith.exe
  143.                                         pnmcat.exe
  144.                                         pnmconvo.exe
  145.                                         pnmcrop.exe
  146.                                         pnmcut.exe
  147.                                         pnmdepth.exe
  148.                                         pnmenlar.exe
  149.                                         pnmfile.exe
  150.                                         pnmflip.exe
  151.                                         pnminver.exe
  152.                                         pnmnoraw.exe
  153.                                         pnmpaste.exe
  154.                                         pnmscale.exe
  155.                                         pnmtile.exe
  156.                                         pnmtoras.exe
  157.                                         pnmtoxwd.exe
  158.                                         rasttopn.exe
  159.                                         xwdtopnm.exe
  160.                                         pnmgamma.exe
  161.                                         pnmrotat.exe
  162.                                         pnmshear.exe
  163.  
  164.  
  165. Diffs will be also be distributed for those who want to compile the package on
  166. their own (The DOS port of GCC is necessary for this).    Aside from the 
  167. introduction of the fmod() function to all the main programs, there are some 
  168. minor adjustments made to the makefiles to make them work with the DOS port of 
  169. GNU-Make.  Two batch files, all.bat and merge.bat are provided to run the make 
  170. process.  ALL.BAT will complete make all of the stand alone executables (.exe's
  171. files).  MERGE.BAT will only make the 32-bit code in a file called 
  172. p?mmerge. which will have to be manually appended to the appropriate STUB.EXE 
  173. or GO32.EXE which comes with the DOS port of GCC.  These two batch files are 
  174. found in the root directory.  In each of the p?m directory, there are two more 
  175. batch files called delp?m.bat and exep?m.bat.  DELP?M.BAT just goes through and 
  176. cleans up all the 32-bit code generated by the compiler and should be used after 
  177. you make all of the .exe files.  EXEP?M.BAT goes through and prepends with the 
  178. go32.exe or stub.exe DOS extenders to each of the 32-bit code segments.  Edit 
  179. that batch file to have the appropriate environment variable point to whichever 
  180. you want.  I used the BETA TEST distribution of 05feb91 to generate this        
  181. version of pbmplus (I no longer have net access, so at this time I'm not sure if
  182. this is the latest version).
  183.  
  184. NOTICE:  I made one minor modification to ppmtogif.c.  It now sorts the palette
  185. based on it's luminisity.  This makes the darkest color the background color,    
  186. which is a personal preference.               
  187.  
  188. I no longer have *reliable* net access, but can be reached via phone and snail 
  189. mail at the following:
  190.  
  191. Mike Castle
  192. Deer Run Apartments 
  193. Apt #29
  194. Wright City, MO 63390
  195. (314) 745-3164
  196.