home *** CD-ROM | disk | FTP | other *** search
/ The Equalizer BBS / equalizer-bbs-collection_2004.zip / equalizer-bbs-collection / DEMOSCENE-STUFF / BYTE-SRC.ZIP / BYTE-SRC.NFO next >
Text File  |  1993-12-28  |  9KB  |  157 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │     ███████ ██   ██ ▄██████          ██████▄ ██   ██ ███████ ▄██████       │
  3. │       ▐█▌   ██▄▄▄██ ██▄▄▄▄           ██▄▄▄█▀ ██▄ ▄██   ▐█▌   ██▄▄▄▄        │
  4. │       ▐█▌   ██▀▀▀██ ██▀▀▀▀           ██▀▀▀██  ▀███▀    ▐█▌   ██▀▀▀▀        │
  5. │       ▐█▌   ██   ██ ▀██████          ██████▀   ▐█▌     ▐█▌   ▀██████       │
  6. │                                                                            │
  7. │           ██████▄ ▄██████ ▄██████ ▄█████▄ ██████▄ ▄██████                  │
  8. │           ██▄▄▄█▀ ██▄▄▄▄  ██▄▄▄▄  ██   ██ ██   ██ ██▄▄▄▄                   │
  9. │           ██▀▀▀██ ██▀▀▀▀  ██▀▀▀▀  ██   ██ ██████  ██▀▀▀▀                   │
  10. │           ██████▀ ▀██████ ██      ▀█████▀ ██  ▀██ ▀██████                  │
  11. │                                                                            │
  12. │   ▄█████▄ ██   ██ ██████▄ ▐██▌ ▄█████▄ ███████ ▄██████▄ ▄█████▄ ▄█████▄    │
  13. │   ██      ██▄▄▄██ ██   ██  ██  ██▄▄▄▄    ▐█▌   ██ ██ ██ ██▄▄▄██ ██▄▄▄▄     │
  14. │   ██      ██▀▀▀██ ██████   ██   ▀▀▀▀██   ▐█▌   ██ ██ ██ ██▀▀▀██  ▀▀▀▀██    │
  15. │   ▀█████▀ ██   ██ ██  ▀██ ▐██▌ ▀█████▀   ▐█▌   ██ ██ ██ ██   ██ ▀█████▀    │
  16. │                                                                            │
  17. │                      The source code!                                      │
  18. │                _______  /                                                  │
  19. │                   /    /      ┌──┌┐  │─┬─┌──┌─┐┌─┐┌─┐o┌──┌──┌──            │
  20. │                  /    /       ├─ │└─┐│ │ ├─ ├┬┘├─┘├┬┘│└─┐├─ └─┐            │
  21. │            /____/    /_____   └──│  └┘ │ └──│ \│  │ \│──┘└────┘            │
  22. │                                                                            │
  23. └────────────┐                            ┌───────────────────┐            ┌─┘
  24.              └────────────────────────────┘                   └────────────┘
  25.  
  26.  
  27. Well, I've released my source, just like I said in my demo.  This zip file
  28. contains directories, so if you didn't extract it using the '/d' option on
  29. pkzip, then you're obviously going to have a little trouble (why don't they
  30. just make that switch default on all copies of pkzip?).  Anyways, compiling
  31. this monster takes quite a bit of time, even on my 486.  Most of the time
  32. is spent converting the binary image files into an includeable format for
  33. assembly, but once you've converted it, MAKE won't bother converting it
  34. again.  That brings me to another thing; the requirements for compilation:
  35.  
  36. You'll need the following programs in your path:
  37.     MAKE (I use the version that comes with Borland C++ 3.1)
  38.     TASM (I am using version 3.1, but I'm sure pretty old versions will
  39.             handle my code too)
  40.     TLINK (of course)
  41.     PKLITE (although this isn't a requirement, it cuts the size of those
  42.             executables down greatly because of all the graphic data)
  43.     PKZIP (version 2.04g--this isn't necessary, but if you want to let the
  44.             main makefile run through without errors, then you'll need this)
  45.     QuickBasic (version 4.5--this really isn't necessary, but some of the
  46.             utilities and include computing programs are written in it)
  47.     Borland C++ (version 3.1--again, this really isn't necessary.  I think
  48.             the only programs that this is needed for are JLIB and PCX2PBM)
  49.  
  50. That last one brings up another good point:  I've included some of the
  51. utilities that I've developed over my programming experience.  BINDUMP was
  52. written just for this demo (first time I needed it) to convert any binary
  53. file into an include file that contains all of the data in 'DB' statements.
  54. PCX2PBM was written a few months ago when I started working on my game.
  55. (Yes, I'm still working on it.  Maybe it'll be out in a few years :)
  56. That program will read in PCX files and write out XLIB PBM files and also
  57. a PALette file.  BANNER was written a long time ago when I thought about
  58. setting up my own BBS and needed to put my BBS's banner on every file.
  59. Unfortunately, (I guess) I decided not to do a BBS because it would mean
  60. tying up my system and the phone line all of the time.  I wrote BANNER
  61. because all of the banner programs that I could find at the time required
  62. me to register it, otherwise it would stick in some other advertisement in
  63. it.  Well, my solution was to write my own!  
  64.  
  65. The next utility may come in use to people reading my source....  Believe
  66. it or not, I use the MS-DOS editor for just about all of my programming!
  67. Well, I set it to use tabs of 4 spaces and do my programming like that.
  68. Unfortunately, the MS-DOS editor thinks that if you set the tab spacing to
  69. 4 spaces, it can put tab characters instead of 4 spaces (even though tabs
  70. are really supposed to be 8 spaces).  Well, this may be fine, but the MS-DOS
  71. editor doesn't always replace spaces with tabs, so that makes it a little
  72. more difficult for people who aren't viewing my code in the MS-DOS editor
  73. (when it's set to 4 spaces) because nothing lines up.  I wrote TABTRIM to
  74. solve this problem.  It changes all tab characters to the correct number of
  75. spaces, assuming you've set the tabs to 4.  It also, removes any trailing
  76. spaces at the end of lines to try and reduce the size of files a bit (note
  77. that 'detabbing' files causes them to get larger)
  78.  
  79. JLIB is one of the most recent and most powerful utilities I've written yet.
  80. It allows you to combine more than one file into a UNIX 'tar'-like archive.
  81. Using either JLIBHOST (for transparent, but slow access time), or JLIBIO (the
  82. programming library functions that allows almost no decrease in access time)
  83. you can access the files in the library quite easily.  Note that JLIB.EXE is
  84. not really that powerful right now because I haven't added wildcard support,
  85. but I'm getting to it...  Also, note that I'm changing the format somewhat
  86. frequently as I come up with better ways to do things.  For example, I
  87. changed the structure from the initial demo release to this release by moving
  88. the directory entries from the beginning of the file to the end of the
  89. archive.  This allows faster updating is you want to add or delete file.
  90. Previously, you had to move all of the data in the archive to make room for
  91. the new file information block.  
  92.  
  93. [Last minute note--I've had to completely restructure the programming for
  94. JLIB, but I've done it!  That is, I've added willdcard support so now you
  95. can JLIB entire directories or extract all EXEs (or whatever) with one
  96. command!  Not too sure if it's completely bug free (probably not), but at
  97. least it's fairly usuable.  Restructuring the code also gave JLIB.EXE a great
  98. speed increase (before, it opened, made a temporary swap file, closed, etc.
  99. for *each* file).  Now, that's only done once.]
  100.  
  101. That brings me to another point (getting a little redundant here?)...  This
  102. is version 1.1 of the demo.  It turned out that the version of GoldPlay I
  103. was using in the first demo was 1.0 and the latest was 1.1!  (that's what
  104. happens when I just use whatever I have laying on my disk here instead of
  105. checking UWP first).  Anyways, that fixed a bug that I discovered in the
  106. initial version that I had to figure out a way to code around.  I don't
  107. know if the new version of Goldplay fixes anything else, but I may resolve
  108. problems with the Non-GUS output that several people have been having (Hi
  109. Patch!)  The other thing I changed was the library format, but that's it!
  110.  
  111. One more thing before I leave...  To compile the demo, change into each
  112. directory and type 'make'.  After it is done, change to the next directory
  113. and continue until all parts have been compiled.  Then, change to the main
  114. directory (where this file is found) and type 'make'.  That last make binds
  115. everything into one neat little JLIB file and zips everything up.
  116.  
  117. Ooops!  Remembered one more thing!  Each of the sections will leave the
  118. screen 'black' when they terminate (except for 'FIRE', I think) if you run  
  119. them separately.  Don't panic!  The screen is simply left in graphics mode
  120. with the palette set to all black.  It's done simply to avoid some flickering
  121. between the parts of the demo.  To fix it, run your screen resetting program
  122. that came with your VGA card.  You don't have one you say?  Try typing
  123. "MODE CO80" as soon as the section terminates.  I have a batch file on my
  124. system called RESET which resets the screen, so all I do is type 'RESET'
  125. and the screen changes back the VGA text mode (aren't you jealous? :)
  126.  
  127.  
  128. - Jeff
  129.  
  130.  
  131. I can reached via Snail-mail at:
  132.  
  133.         Jeff Lawson
  134.         1893 Kaweah Drive
  135.         Pasadena, CA 91105-2174
  136.         USA
  137.  
  138. or through E-mail at:
  139.  
  140.         haroldf@rcf.usc.edu
  141.  
  142. also via phone at:
  143.  
  144.         (213) 258-5604
  145.  
  146. or (if previous line is busy):
  147.  
  148.         (213) 258-4264
  149.  
  150.  
  151. Although I'm not asking any money for it, I'm aware that there are people who
  152. like to send money anyways.  If you happen to be one of these types of people,
  153. feel free to contact me!  :)
  154.  
  155.  
  156. Thanks for downloading this!
  157.