home *** CD-ROM | disk | FTP | other *** search
/ The Party 1994: Try This At Home / disk_image.bin / source / gallery / readme.txt < prev    next >
Text File  |  1994-06-15  |  4KB  |  110 lines
  1. SOURCE CODE FOR INCONEXIA'S ART-GALLERY SEQUENCE  //  ARM
  2.  
  3. Well, Jare & JCAB beat me to it, but here's the rest of the source code for
  4. Iguana's Inconexia :-)  After hours and hours of and moving and deleting
  5. files, I think I've managed to neatly sort out all this mess into
  6. subdirectories, with makefiles that make it easy to apply changes, rebuild,
  7. and run the program to see what they do.
  8.  
  9. You'll need 4DOS and Borland's TASM, TLINK, MAKE, and TP6.0 to use these
  10. sources as they are.
  11.  
  12.  
  13. Here are a few quick tips to get you started, you may want to print this:
  14.  
  15.  
  16. VIEW PREASSEMBLED SAMPLE PROGRAM
  17.  
  18. Run RUN\OTHER\NICE_EX.EXE and enjoy! ;-)  (sorry, but I seem to have lost
  19. the source for this one O:-( )
  20.  
  21.  
  22. BUILDING THE EXECUTABLE FROM THE SOURCES
  23.  
  24. Simply type "BUILD" (build.btm) to build and run A_GALLRY.EXE. You'll see
  25. that when freed from DemoVT the routine is not quite as slow as Inconexia
  26. makes it look O:-(  Note that the the makefile constructs this .exe with
  27. full debug info (TASM /zi, TLINK /v), you may have to assemble/link without
  28. those switches if you are running short on memory.
  29.  
  30. Use "CLEAN" (clean.btm) to erase all the files that BUILD creates (except
  31. A_GALLRY.EXE).
  32.  
  33.  
  34. MAKE OPTIONS
  35.  
  36. make -DSYNC_NO=0    .exe runs under DemoVT (pretty slow)
  37. make -DSYNC_NO=1    .exe synchronizes with system timer
  38. make -DSYNC_NO=2    (default) .exe runs at full speed, w/o synchronization
  39.  
  40. The last option gives the smoothest animation, but the camera's speed
  41. depends on the computer's speed... and that's no good for a demo :'(
  42.  
  43.  
  44. RUNNING THE DemoVT VERSION
  45.  
  46. "del a_gallry.obj" then make with "make -DSYNC_NO=0" then "copy
  47. a_gallry.exe run\". Change to RUN\ and use the batch file "RUN" (run.btm)
  48. to configure DemoVT and run the program.
  49.  
  50.  
  51. CHANGING TEXTURES
  52.  
  53. Simply drop your own 320x200x256 GIFs in place of any of the TEXTURE\*.GIF
  54. files and MAKE (from TEXTURE\MAKEFILE). You may also add new textures to
  55. the old ones, but then you must update both makefiles, add a new
  56. w_pic?.asm, edit the texture lists in a_gallry.asm, and edit MAP\MAP.GRI to
  57. use blocks with the new texture.
  58.  
  59.  
  60. CHANGING THE MAP
  61.  
  62. Edit "MAP\MAP.GRI" file with any ascii editor and then make from the base
  63. directory (the file's format is simple enough...).
  64.  
  65.  
  66. CHANGING THE CAMERA'S PATH
  67.  
  68. The hard way: edit DATA\SCRIPT.INC directly and make. (This lets you play
  69. with changing light levels and eye heights).
  70.  
  71. The easy way: "cd MAP" and execute PPATH.EXE. Load current path by typing
  72. "Lmypath.ppp" and edit it with the mouse, save with "Smypath.ppp" and then
  73. do a make from the base directory.
  74.  
  75. PPATH.PAS comments explain the available functions. For example: press t to
  76. place time restraint, which works like a sync point to let you synchronize
  77. the camera's motion to the music (units are in 1/50ths of a second since
  78. start of trajectory). Reasonable sync-points will be met closely, but keep
  79. in mind that they are adjusted with a B-spline to avoid generating jerky
  80. motion.
  81.  
  82. The script (script.inc) is simply a list of key-frames (camera
  83. position and angle, etc. for given times). When drawing each frame the main
  84. program simply reads the time and interpolates between the available
  85. key-frames.
  86.  
  87.  
  88. CHANGING THE PALETTE
  89.  
  90. Edit COLOR\COLORS file (16 basic colors, *ratios* red:green:blue) and then
  91. do a make from the base directory (this will rebuild all the TEXTURE\
  92. files, since all images have to be fitted to the new palette).
  93.  
  94. Note: "PAL2 /p colors" will create a palette.col file you can use with
  95. Autodesk Animator, in case you want it for anything. Remember that it's not
  96. necessary to adjust a GIFs palette because TEXTURE\MAKEFILE does a pretty
  97. good job fitting any GIF's colors to the program's palette (given in
  98. pal2bin.pal).
  99.  
  100.  
  101. ...................................................................
  102.  
  103. Have fun!
  104.  
  105.  
  106. Arturo Ramirez-Montesinos (ARM)
  107. 2:341/27.7 (FidoNet)
  108.  
  109.  
  110.