home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / DEMO / PRG / CTHUG53X.ZIP / CTG100A.ZIP / CTG.DOC < prev    next >
Encoding:
Text File  |  1995-01-17  |  7.3 KB  |  203 lines
  1. Cthugha Table Generator v1.0a
  2.  
  3. BETA RELEASE!  PLEASE DO NOT DISTRIBUTE OR LEAVE IN REACH OF CHILDREN!
  4. BETA RELEASE!  PLEASE DO NOT DISTRIBUTE OR LEAVE IN REACH OF CHILDREN!
  5. BETA RELEASE!  PLEASE DO NOT DISTRIBUTE OR LEAVE IN REACH OF CHILDREN!
  6.  
  7. WHAT IS?
  8. Make your own translation tables for Cthugha v5.0 and up!
  9. Turn useless physics concepts into productive screen effects!
  10. Its also a convenient way to in effect swap TABs across the net
  11.     because .ctg files are comparitively very short
  12.  
  13.  
  14. REQUIRES
  15. vbrun300.dll  (not included)
  16. threed.vbx  (not included)
  17. A 386 w/Windows 3.1  (not included)
  18.  
  19.  
  20. FILES
  21. ctg.exe - the program
  22. ctg.doc - this!
  23. ctg2tab.exe - DOS tab compiler (no .ctg editing) *coming soon!
  24.  ***the following files generate .tabs of the same name
  25. creator.ctg - uses one of each vector; a fave
  26. donut.ctg - wierd child of gravities, Qs, and rotation
  27. inspin.ctg - pretty simple showing of gravity, rotation
  28. outspin.ctg - very similar to inspin.ctg
  29. rearview.ctg - one vector causes BIG 3D effect
  30. rot_bug.ctg - illustrates the rotational ANOMALY
  31. serpent.ctg - a little complicated; a fave
  32. sky.ctg - nice use of (anti)gravity, grit
  33. warp.ctg - just like real space travel
  34.  
  35.  
  36. GETTING STARTED
  37. unzip all files to a unique directory (you don't HAVE to)
  38. run windows, run ctg.exe
  39. go to Options, Paths; setup paths to your stuff
  40.     (If you must go get them, copy
  41.      vbrun300.dll and threed.vbx to 
  42.      \windows\system directory)
  43.  
  44.  
  45. BASICS
  46. the large black area represents the Cthugha screen
  47. the Vector window edits all vector properties
  48. .ctg files hold vectoring information for Open and Save
  49. .tabs are compiled using File, Make
  50. keep your eye on the status area under the Cthugha screen
  51. play ALOT with the numbers, and DryRun to check it out
  52.  
  53.  
  54. OPERATION, MAIN WINDOW
  55. when a shift key is depressed, cursor is in SELECT MODE
  56. left mouse button  1) drops a new vector if none is selected
  57.            2) drags a vector if one is selected
  58. right mouse button deselects vector
  59. Options, Dry Run features are useful for checking your work
  60.  
  61.  
  62. OPERATION, VECTOR WINDOW
  63. the combo box selects the vector type
  64. each text box is a vector property; watch the status bar!
  65. click in the vector area to change direction, use shift to lock to 45deg
  66. the data slider suggests decent (family) ranges for each property
  67. the vector listbox can select vectors (nice if two+ are on same coords)
  68.  
  69.  
  70. SOME SPECIFICS OFF THE MENU
  71. File menu:
  72.     New, Open, Save, Save As, Exit - standard stuff
  73.     Make - compiles your .tab files
  74.  
  75. Edit menu:
  76.     Copy, Cut, Delete - must have a vector selected to do these
  77.     Paste - must have a vector in the copy buffer (Copy, Cut)
  78.  
  79. Options menu:
  80.     * a dry run does vector processing without saving anything to file
  81.     * the lines of colors that appear demonstrate velocity thresholds
  82.     * velocity is measured here in PIXELS per SCREEN FRAME
  83.     * a SCREEN FRAME is one 'still' of Cthugha's animation
  84.     * stop reading this garbage and try some, its not hard!
  85.     
  86.     DryRun Vector - dry run just the selected vector
  87.     DryRun All - dry run the whole thing, same as Make without the .tab!
  88.     Velocity Zones... - configure dry running
  89.     X resolution - e.g. set to 1 to check every X pixel
  90.     Y resolution - e.g. set to 3 to check every third Y pixel
  91.     Velocity Zone 1 tolerance - threshold value to display zone1 color
  92.         threshold for Zone2 color is 2X this value
  93.         threshold for Zone3 color is 3X this value
  94.     Zone1-Zone3 color - try all 16!
  95.  
  96.     Confirm Tab Overwrite - overwrite existing tabs automatically, or not
  97.     Enable Make Options - set Path, filename, etc. each time you Make
  98.     Make Priority - if set to High, you won't be doing much during Make
  99.     Wrap effect - check this IF you want effect to spill left/right across
  100.     the screen (even if its off, many flames can still cause this)
  101.        *** this can be set for each .CTG file!
  102.  
  103.     Set paths... - where's your stuff?
  104.     Vector picking... 
  105.     use crosshairs - highly suggested
  106.     circle the current vector - highly suggested
  107.     snap tolerance - how close to vectors to select (using shift key)
  108.  
  109.     Beep Data Errors - toggle audible recognition of boners
  110.     Save Settings - like it says, @ exit
  111.    
  112. Help menu:
  113.     How much help do you need?!?
  114.  
  115.  
  116. ** VECTOR PROPERTIES
  117. **
  118. ** vector types
  119. **     linear - moves in one direction
  120. **     rotational - moves around a common center
  121. **     gravitational - pulls into a common center
  122. **     chaos - pulls a pixel from ??? (you have SOME control)
  123. **
  124. ** X position - duh (approx -159 to 160)
  125. ** Y position - duh (approx -101 to 102)
  126. **  
  127. ** direction - which way to go (0 to 360 degrees)
  128. **   only effects linear vectors UNTIL aspect works!
  129. **
  130. ** magnitude - kindalike velocity(pixels/frame when Q=1)    
  131. **   negative makes rotation counterclockwise
  132. **   negative make anti-gravity / repulsion
  133. **
  134. ** Q means bandwidth or something...    
  135. **   Q=1 -> vector effects entire screen equally
  136. **   Q>1 -> vector effects in its proximity (gravity)
  137. **           the higher, the more localized the effect
  138. **   Q<1 -> vector effects away from its proximity (ungravity?)
  139. **            the smaller the more distant the effect
  140. **
  141. ** grit - adds graininess as a +/- percent of magnitude
  142. **
  143. ** saturation - how much effect actually shows (0%-100%)
  144. **      when set to 0% the effect is completely transparent
  145. **
  146. ** creep - directly alter magnitude with distance from vector
  147. **   use creep with magnitude=0 to understand its effect
  148. **
  149. ** gate - minimum or maximum radius (in pixels) for the effect
  150. **         to occur; e.g. 40 makes effect happen within a 40 
  151. **         pixel radius, -40 makes effect happen outside of
  152. **         a 40 pixel radius
  153.  
  154.  
  155. A NOTE ON ROTATIONALS
  156. When DryRunning, please note that you are seeing thresholds of
  157. LINEAR DISPLACEMENT; therefore, a rotational vector with a magnitude
  158. of 360degrees and a Q=1 will show NO velocity!
  159.  
  160. Using two rotational vectors with a (near) common center can yield
  161. some unexpected results.  Check out rot_bug.ctg and notice the 
  162. magnification in the middle where NOTHING should be happening!
  163. This is due to the 'linearization' this program does to all vectors.
  164. (e.g. a +ROT and a -ROT of same Q and magnitude... the point at the
  165. very top is pulled left 10 and down 3 AND right 10 and down 3, netting
  166. 0 horizontal displacement and 6 pixels vertical displacement.)  
  167. This probably won't be fixed.  Several million have already been dumped
  168. into R&D, and all my federal funding has been cut off!
  169.  
  170.  
  171.  
  172. LICSENSING
  173. this program has a free 30 year trial period...
  174.      after which you must register for US $5
  175. seriously just keep all the files together and have...
  176.      phun (old physics joke)
  177.  
  178. COPYRIGHT
  179. but it does still belong to me & the computer boolage :)
  180.  
  181.  
  182. STILL COMING...
  183. perhaps an aspect property (makes affected zones elliptical)
  184.  
  185.  
  186. KNOWN BUGS
  187. rotational anomaly... try rot_bug.ctg for example
  188. you can temporarily LOSE the Vector window under certain circumstances
  189. drive heads can warp if gravitational vector magnitude set too high
  190. otherwise, perfect code!
  191. contact me if you find otherwise... 
  192.  
  193.     gregory.coster@cccbbs.cincinnati.oh.usa
  194.  
  195.             ...should be good through October95
  196. feel free to write positive feedback also, and send .ctg files :)
  197.  
  198.  
  199.  
  200.  
  201. RELEASE LOG
  202. 17Jan95  ctg10a.zip  initial beta release
  203.