home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / bincon.zip / readme < prev   
Text File  |  1994-10-26  |  5KB  |  116 lines
  1. October 26, 1994
  2.     /*=============================================================
  3.     =  (C)opyright 1994 Tim Triemstra and                         =
  4.     =  (C)opyright 1994 Empath Software, All Rights are Reserved  =
  5.     =                                                             =
  6.     =  The author can be contacted at:                            =
  7.     =  Internet: empath@umcc.umich.edu                            =
  8.     =============================================================*/
  9.  
  10.  
  11. INTRODUCTION:
  12. _____________
  13.  
  14.     Welp, first off, here's what the heck this program does!  It is
  15.     a very simple program (as the source code will attest to).
  16.     which simply takes ANY type of file (especially binary or image
  17.     files) and converts it into a list of numbers for linking into
  18.     your programs.  The data can be output in decimal or
  19.     hexidecimal formats and is formatted to look pretty nice.
  20.  
  21.     My main purpose for writing this program is for easy adding of
  22.     bitmaps and palette information into graphics programs.  This
  23.     is before I write my graphics library kernel, but I still want to
  24.     experiment with graphics bitmaps - reading from .BMPs stinks in my
  25.     opinion.  This is also good for data that you may not want users to
  26.     realize IS data.  This is done by having your data right into the
  27.     program, not in an external file for anyone to edit.
  28.  
  29. WHAT IS INCLUDED:
  30. _________________
  31.  
  32.     BINCON.EXE and BINCON2.EXE are the two compiled versions of
  33.     the program that are included.  They are DOS 32bit virtual
  34.     memory and OS/2 32bit versions, respectively.  Both should work
  35.     with an unlimmited file size.  However, many compilers become
  36.     unmanageable if you try to include too much data so be careful.
  37.  
  38.     The source code, BINCON.C, is also included.  It includes some of
  39.     the vital information included in this file at the top in comments.
  40.     More importantly, you can modify the way the hex or dec is printed
  41.     in the little loop at the bottom of the code.  This is so that you
  42.     can change the format of the output to your liking.
  43.  
  44.  
  45. HOW TO USE IT:
  46. ______________
  47.  
  48.     Here's the command line:
  49.     BINCON <filename> <D|H> (start) (end) >output.dat
  50.  
  51.     FILENAME is obviously the input file.  It is the file you'd like
  52.     to convert to raw data.  The D or H represent (D)ecimal or (H)ex
  53.     output.  Both of the previous commands are required.  The (start)
  54.     is the first byte to start dumping from, (end) is where to stop.
  55.     You can enter a start without and end and the file will simply
  56.     be processed to the end.  No start opion indicates to do the
  57.     entire file.
  58.  
  59.     The >output.dat is just a pipe of output into a desired file.  I
  60.     decided to do it this way to allow yu to run the program through
  61.     the screen.  I do this alot to check through palettes.  It is also
  62.     good because you can print it out from the command line and such.
  63.     What the hey, DOS and UNIX created piping for a reason, I'm just
  64.     using it...  Modify it if you'd like something else.  Skip the
  65.     parameters and you'll get a parameter list.
  66.  
  67. EXTRA STUFF: -> Included in the source code header
  68. __________________________________________________
  69.  
  70.  
  71.     This file is probably pretty ugly to alot of you "professional
  72.     programmers" (or anybody else actually.)  However, since I am
  73.     completely self-taught there are bound to be areas where I can
  74.     improve - just ask my professors.
  75.  
  76.     This code should, however, compile just fine for pretty much
  77.     any operating system.  I haven't tested it with a 16bit compile
  78.     but it should work (with somewhat limitted usefulness, look at
  79.     the comments for reasons why.)
  80.  
  81.     I included the source because there is probably a situation
  82.     that someone out there might like some more functionality.  I can't
  83.     really think of anything off the top of my head, though.
  84.  
  85.     If this code influences you to write an application along this
  86.     line, please release it as shareware/freeware.  The world needs
  87.     good programs and if we all have to spend our precious minutes
  88.     writing small tools like this then the real programs will take
  89.     alot longer.  The only thing I ask is that if you use it constantly
  90.     then distribute it.  After all, you're not the only wierd one out
  91.     there that may like    this program.
  92.  
  93.     You can mail me anything you think I may want/need (I always
  94.     accept money :) at the following addresses:
  95.  
  96.     Tim Triemstra
  97.     Empath Software
  98.     P.O.Box 40901
  99.     Redford, MI 48240
  100.  
  101.     I can be (and prefer to be) contacted at:
  102.     Internet:  empath@umcc.umich.edu
  103.     UUCPmail:  umcc!roofus!empath   (I think this still works :)
  104.  
  105. ___
  106.  
  107. I sure hope this code helps SOMEONE besides myself, although the people
  108. that may find it useful may never see it - unless you distribute the
  109. program.  PLEASE - distribute this file to your local BBS systems and
  110. FTP sites where people look for programming tools.  You could be helping
  111. the guy that figures out how to do a FAST fractal on a 8088 or some other
  112. gound breaking research =)
  113.  
  114. Tim.
  115.  
  116.