home *** CD-ROM | disk | FTP | other *** search
/ Large Pack of OldSkool DOS MOD Trackers / tc669132.zip / TC669.DOC < prev    next >
Text File  |  1993-12-24  |  20KB  |  512 lines
  1. ──────────────────────────────────────────────────────────────────────────────
  2.               TopEND ConFiG 669 Trekker
  3.               Version 1.32 - 24/12/1993
  4.  
  5.                   This product is
  6.  
  7.             F    R    E    E    W    A    R    E
  8.  
  9.                FOR THE GRAVIS ULTRASOUND CARD
  10.  
  11.  
  12.                  = MERRY CHRISTMAS =
  13.  
  14. ──────────────────────────────────────────────────────────────────────────────
  15.  
  16.  
  17. 1.                              Quick start
  18. ───────────────────────────────────────────
  19.  
  20. Ok, you want to skip the boring bits and get right down to it.....
  21.  
  22.  
  23. type in "TC669". all too easy....
  24.  
  25.  
  26. Well, not quiet...make sure that you have the "ULTRASND" directive in
  27. your config file. If you have correctly installed your Gravis Ultrasound
  28. software, then this would have done it for you.
  29.  
  30.  
  31. When you've played around with it, and determined if it's worth keeping on your
  32. harddisk, you may like to read the rest of this document.
  33.  
  34. If you are a novice computer user, it will pay you to read on.
  35.  
  36.                    * * * * * * *
  37.  
  38. ──────────────────────────────────────────────────────────────────────────────
  39.               TopEND ConFiG 669 Trekker
  40.               Version 1.32 - 24/12/1993
  41.  
  42.             By TopEND ConFiG PTY SOFTWARE HOUSE!
  43.  
  44. Designed and Coded by Jason Nunn [BBBUS Computing/NTU] (aka JsNO BAR----NUNN)
  45.  
  46.             (c) 1993, TopEND ConFiG PTY
  47.  
  48.  
  49.                   This product is
  50.  
  51.             F    R    E    E    W    A    R    E
  52.  
  53.  
  54.  
  55.                 =Contacts=
  56.  
  57.               Snail:  32 Rothdale Road,
  58.                   Moil, DARWIN, NT,
  59.                   0810,
  60.                   AUSTRALIA.
  61.             TEL:  (089) 278088 (Strictly business hours only!!!)
  62.  
  63.          InterNET Email:  dcug@nutmeg.cs.ntu.edu.au
  64.  
  65.                   If your are in the Darwin area, you may like to
  66.                   leave message for me on the Mark's Amiga Retreat
  67.                   BBS (089) 451516 or John Ross's "SENTINEL" BBS
  68.                   TEL: (089) 452708
  69.  
  70.                   Or contact:
  71.  
  72.                   Mark Keogh (markk@nutmeg.cs.ntu.edu.au)
  73.                   He will pass any messages on to me.
  74.  
  75.  
  76.                   =Thanks you's=
  77.  
  78.         Dick HP verweij - For his constructive criticism and testing.
  79.         Mark Keogh      - For providing a SB card (V2.0).
  80.         Thomas Wong     - For testing.
  81. ──────────────────────────────────────────────────────────────────────────────
  82.  
  83.  
  84.  
  85.  
  86.  
  87. 1.                                 Synopsis
  88. ───────────────────────────────────────────
  89.  
  90. This version was supposed to be version 2.00ß with beta version SB
  91. routines. Running SB the routines under test conditions sounded great- The
  92. theory, concept and implementation looked "very good on paper". These routines
  93. were written to page tiny chucks in sample from extended memory, then mix 
  94. these little pieces in conventional, then squirt it down the DMA.
  95. They seemed that they wouldn't slow things down too much....I was wrong.
  96. Running them in a testing foreground, they sounded fine,....when adding them 
  97. to the tracker and they *just* barely worked on my 486-33 Mhz machine. They 
  98. have been an absolute bloody disaster to say the least.
  99.  
  100. Well...there is a lesson in this:- For any body writing software in real mode
  101. that use extended memory,...please don't do it....you will be waiting your
  102. time. Well, at least we know now.
  103.  
  104. My next SB routines will be restricted to the 8086 1 meg boundary. I
  105. estimate that you could have a sample space of between 300k to 420k (if
  106. you're very lucky...note also that the extra 120k or so will not be
  107. contingous). At current, you will be able to play 89% of 669 files. This will
  108. be a much, much faster routine as it won't have to do extended memory paging
  109. and will be a whole lot simpler (These current routines would be fine if there
  110. was no tracker code :-} ).
  111.  
  112.  
  113. There is a lot more things I would like to do with this version, but I have
  114. seriously ran out of time....
  115.  
  116. New features are two signal component spliting graphs, a shell facility, and
  117. a tagg file system.
  118.  
  119.  
  120.  
  121.  
  122. 2.                        INSTALLATION AND USAGE
  123. ────────────────────────────────────────────────
  124.  
  125.  
  126. Ok, first off, if you haven't installed your Gravis Software correctly,
  127. please do it now. The reason why you must properly install it is that the
  128. Ultrasound installation program puts an environment variable in the
  129. AUTOEXEC.BAT file. TC669 needs this in order to determine your PORT and
  130. IRQ settings for your card.
  131.  
  132. You *may* like to set your path environment (Note: it is not mandatory). Add
  133. the following entry to the end of your "PATH=" entry in your AUTOEXEC.BAT file.
  134.  
  135. ;<the path of your TC669 player>
  136.  
  137. (For example, if your path looked like:
  138. PATH=C:\DOS;C:\WINDOWS\C:\ULTRASND
  139.  
  140. then you would add this:
  141. PATH=C:\DOS;C:\WINDOWS\C:\ULTRASND;C:\TC669
  142.  
  143. Once done, save the AUTOEXEC.BAT file, and restart your computer.
  144.  
  145. Then, type in "TC669" at the DOS prompt and press ENTER. The title screen
  146. should appear. Once you have looked at it enough, press any key to make it
  147. disappear. You should then see the actual tracking screen. Up the top of the
  148. screen you will see 8 menu items. Move the LEFT or RIGHT arrow keys until the
  149. "FILE" menu item is lightlighted (note it is highlighted by default), then
  150. press enter. A file directory should then appear. This will allow you to look
  151. around your file system to find and load *.669 files (669 files have "669"
  152. extensions). Directories are highlighted a different colour from 669 files,
  153. to go into a directory, move the hightlight bar over a directory (using the
  154. UP and DOWN arrow keys) and then press ENTER.
  155. Once you have reached a directory containing 669 files. Move the highlight bar
  156. over a desired 669 file and press ENTER. The selected 669 file will then play.
  157. If you do not have enough sample memory to load all samples, then these samples
  158. will be silenced (The tracker will tell you this if it ever occurred).
  159.  
  160. The above procedure will allow you to play a single file. The loaded tune will
  161. continuously repeat until you load another file.
  162. You can also "tagg" files. That is, you can tell the tracker to play a set
  163. number of files. These files will be loaded a played as though you were doing
  164. it by hand. It do this, go to a directory with 669's (do this with the procedure
  165. described above), then select a set of files using the SPACE BAR. As you are
  166. selecting these files, they will change colour (denoting that they are
  167. highlighted). Once you have finished selecting the files you want to play, press
  168. ENTER. These files will then play one after the other. The tracker will allow
  169. you to tagg up to 100 files.
  170.  
  171. The root screen is made up of 5 boxes. The first one is "Song Name". This is a
  172. 108 byte field that presents author information about the playing 669 (eg when
  173. it was rippped etc)
  174.  
  175. The next box is the "Info" box. It describes a pot-porri of information, like:
  176.   - Number of Samples,
  177.   - Number of Patterns,
  178.   - The current sequence playing,
  179.   - etc
  180.  
  181. It also displays a little progress bar called "Prog".
  182.  
  183. The next box called "T" (down the bottom) is called the "Pattern Tracker" box.
  184. It displays a given pattern playing at a given sequence. As you can see, it
  185. displays the "treks" and "slots". In each slot there appears an entry similar
  186. to "00C#1F--". This contains info about the "sample-note-volume-command"
  187. components.
  188. For null notes, nothing appears. They are "void" notes. Hence the name- "null
  189. notes". They look like these: "      --". Only commands can be used with these
  190. types of slots. When used, they will appear as: "      f4".
  191.  
  192. For normal notes, the slot characteristics appear as follows:
  193.  
  194. If you had a slot looking like "00C-21d1", then the sample component would be
  195. "00", the note component would be "C-2", the volume component would be "1", and
  196. the command bit would be "d1" (frequency sync)
  197.  
  198. Concatenate it all together and you get "00C-21d1". You can make active use of
  199. all components with these types of slots (from a composer perspective).
  200.  
  201. The last type of slot is the "Volume Only" slot. It looks like "  VOL9--". Only
  202. volume and commands can be used in these types of slots. If commands are used
  203. then they will appear like this "  VOL9e3". Here the vibrato command is being
  204. used in this "volume only" slot.
  205.  
  206. The last box displays the slot tracking of samples. It displays (i) The sample
  207. name being played in a given channel at a given time (ii) the volume level that
  208. was played in the slot (indicated by the jam bars)
  209.  
  210. (Note, The words "SLOT" and "NOTE" mean the same thing)
  211.  
  212.  
  213.  
  214. SINFO (sample Information)
  215. ──────────────────────────
  216.  
  217. This displays statistical and sample information on a currently playing file.
  218. You can not access this section if there is no file loaded (for those people
  219. who have asked why they sometimes can't get into it).
  220.  
  221. To the right, you will see a table. This contains a list of sample decriptions
  222. which display the sample file names in the 669 currently playing. However, It 
  223. is customary for composers to put any additional information in here.
  224.  
  225. If the number of samples exceeds the table length, then you can use the UP
  226. and DOWN arrow keys to view the rest- this will scroll the sample table.
  227.  
  228.  
  229. SCOPE
  230. ─────
  231.  
  232. This displays a 300 point scope on a VGA 320*200 256 colour BMP picture.
  233.  
  234. You can change the BMP picture that is loaded for the scope, by loading TC669
  235. in another directory that has a different BMP file in it. TC669 looks in the
  236. directory that it is in and uses the first BMP file it finds. Note that the
  237. BMP loading algorithm that I made is only intelligent enough to load a 320x200
  238. 256 colour BMP file. If it finds any other type of BMP then it will not 
  239. display it.
  240.  
  241. (NB/ BMP is a MicroSoft windows graphics standard which stands for "BIT MAP
  242. PICTURE")
  243.  
  244. Press ESC to exit back to the main screen.
  245.  
  246.  
  247. F32 (32 point fourier Transformation graph)
  248. ───────────────────────────────────────────
  249.  
  250. This will put the screen in to 80*50 mode and displays the graph in the bottom
  251. half of the screen.
  252.  
  253. The fourier algorithm computes delta's at each point a long an output signal.
  254. These delta's determine the proxy frequency components of a signal. If it is a
  255. big delta, then chances are that there is a really high frequency getting 
  256. pumped out of output. If the delta's are very small then chances are that low 
  257. frequencies are being played...
  258.  
  259. and so, we record these different frequency "tallies" on a graph as follows.
  260.  
  261.  │   / <- cut off
  262.  │  /                     *
  263.  │ /                      *
  264.  │/     low freq.         *
  265.  │ *    present in        *  <- high frequency present in output signal.
  266.  │ * <- output signal.    *
  267.  │ *                      *
  268.  └──────────────────────────────
  269.  
  270.  
  271. To get back to a normal the normal screen, press the "F32" button again. If
  272. doesn't work then press the "ESC" key.
  273.  
  274.  
  275. D32 (AMP Stat Graph - also affectionately called the "Dancing Pig")
  276. ───────────────────────────────────────────────────────────────────
  277.  
  278. Again, a 80*50 text screen will appear; The D32 graph will run at the bottom 
  279. of the screen, and the main tracking screen will run on the top half.
  280.  
  281. This statistically records pitch levels of a signal from a fixed level in
  282. a signal and displays them on a graph.
  283.  
  284. The operation of using D32 is the same as D32.
  285.  
  286.  
  287. SHELL
  288. ─────
  289.  
  290. This forks a shell and allows you to do DOS operations and use a limited 
  291. number of applications. Don't load up any games, operating system extensions
  292. (eg Windows), as this will crash your machine. As a general rule, don't load 
  293. up any "real time" applications.
  294. Tagging will not work in the Shell unfortunity. Implementing it produces
  295. complications for DOS and the GUS card. I should have a solution for this by
  296. next version.
  297.  
  298. To exit back into the tracker, type in "EXIT".
  299.  
  300.  
  301. INFO
  302. ────
  303.  
  304. Displays a copyright notice about TC669.
  305.  
  306. EXIT
  307. ────
  308.  
  309. This will exit you out of the tracker.
  310.  
  311.  
  312.  
  313. --
  314. Just one last note, if you load up the tracker and find that it's really
  315. ultraclicky, type in "ultrinit". I've got a dicky init route that gets
  316. effected by other previously loaded programs that don't clean up properly.
  317.  
  318.  
  319.  
  320.  
  321.  
  322. About the 669 Format
  323. ──────────────────────────────────────────────────────────────────────────────
  324.  
  325. This section is going to explain to you what a 669 file is. I'm going to attempt to explain it is very simple terms.
  326.  
  327. If you can imagine a musical band consisting of 8 people. Each person can play
  328. at the same time and each of them have to read from a musical script that tells
  329. them to play certain notes at certain times. Normal bands are stuck with the
  330. same instruments. The 669 band however is a little different. They possess the
  331. ability to change their instruments when ever they are instructed to.
  332.  
  333. In more technical terms, this 669 tracker represents the people playing the
  334. instruments. When a 669 file is loaded, it *gives* the tracker the instruments
  335. to play, and tells it to play the instruments in certain channels (the people)
  336. at certain times.
  337.  
  338. The musical script that the tracker reads from is organised in such a manor
  339. that it splits up music into so called "patterns". A pattern is a length of
  340. musical notes for each channel. The reason for this is because music tends
  341. to repeat itself. This is handly, because instead of having two identical
  342. patterns that are played at different times,it can tell the tracker to play the
  343. same pattern at those different times. This is done with a "Sequence" table.
  344. This table tells the tracker to play the patterns in a given order.
  345.  
  346.  
  347. The instruments are called "samples". They represent "real Life" digital
  348. recordings, identical to that of recorded CD's, and that is all a 669 file is!.
  349.  
  350. The 669's purpose in life is to be used in games and demos. However many people
  351. produce 669's just for the sheer pleasure of making them.
  352.  
  353. 669's (and any module formats for that matter) make good economic use of space.
  354. They represent the same thing as a single stream of raw digital recording (like
  355. on a CD), accept module formats reduce redundancy of sound to be played, and
  356. that is why they call them "module" formats - They make digital music as small
  357. and compact as possible by eliminating repetition.
  358.  
  359.  
  360.  Here is some comparison information about the 669 format in point form:
  361.  
  362.  - It's IBM PC born (doesn't come from whizz click Amiga's)
  363.  - Inventor: Tomasz Pytel (aka "Tran") of RENAISSANCE
  364.  - 8 Channel Tracker
  365.  - Total no of sequences is 128 (refered to as an ORDER LIST)
  366.  - Total no of patterns is 128
  367.  - Total no of samples in format is 65 (yes, yes I know that you can only
  368.    play samples from 0 to 63 and pattern 64 can never be played)
  369.  - A pattern consists of 64 so called "treks" (same as ProTrk)
  370.  - Each trek consists of 8 "slots"
  371.  - A slot defines the note to be played in a given channel, in a given trek,
  372.    in a given pattern, in a given sequence (sounds clumsy, but mathematically
  373.    correct). A slot is organised in the following manor:
  374.      o Sample to be played (with a precision of 64 samples)
  375.       o Note Value (4 octaves....NB: TC669 supports 5)
  376.       o Volume Value (16 settings)
  377.       o 6 possible commands  a Portamento Up    (slides freq. up)
  378.                  b Portamento Down  (slides freq. down)
  379.                  c Note Portamento  (slides freq. from notes)
  380.                  d Frequency Sync   (adjusts freq.)
  381.                  e Vibrato          (vibrates freq.)
  382.                  f Tempo            (sets tracking speed)
  383.  
  384.  
  385.  
  386. How to make a 669
  387. ─────────────────
  388.  
  389. There isn't a lot of composing software for 669's. Their are two that I know of:
  390. "COMPOSED" (the original) and "FAREDOLE".
  391.  
  392. After TC669 has SB support, I will commence work on a Gravis and SB composer.
  393.  
  394. You can use my 66D (669 Description Language Compiler) to build 669's. Although
  395. it is not ment to be used to make 669's (only for hacking them), you can do it,
  396. BUT you have to be very good with music (not to mention patient).
  397.  
  398.  
  399. Where to get 669's
  400. ──────────────────
  401.  
  402. Once upon a time, they were pretty hard to come by. Now they are quiet abundant.
  403. If you have InterNET access then you can find them on:
  404.  
  405.  "wuarchive.wustl.edu" in the filepath of "/micros/pc/gravis/music/669/files"
  406.   OR
  407.  "archive.orst.edu" in the filepath of "/micros/packages/gravis/music/669/
  408.                      files"
  409.   OR
  410.  "klingon.epas.utoronto.ca in the filepath of "/pub/pc/ultrasound/music/669/
  411.                         files"
  412.  
  413. If you have a modem or a CDROM drive, you will find them on SIMTEL CD's and on
  414. most popular BBS's.
  415.  
  416.  
  417. About TopEND ConFiG
  418. ───────────────────
  419.  
  420.  
  421. After finishing my Bachelor of Business Degree, I hunted for work for 4 months.
  422. I didn't want to leave Darwin, as my family is up here. After doing some work
  423. experience, I was inspired to go into business for myself.
  424.  
  425. TopEND ConFiG PTY started business in May 1993. At the moment, this business
  426. specialises in making custom built systems for organisations around the Topend
  427. vicinity. Much Later on, shareware and commerical software will follow suit.
  428.  
  429.  
  430.  
  431.  
  432.                   WHAT'S NEW
  433. ────────────────────────────────────────────
  434.  
  435.  
  436.  
  437. =WHAT'S NEW=
  438. ────────────
  439.  
  440. 1- TC669 V1.00ß and 66D V1.0|V1.0     - Thursday 18/08/93    (BETA RELEASE)
  441.  
  442.     o First released TC669 & 66D on InterNET.
  443.  
  444.  
  445. 2- TC669 V1.01ß and 66D V1.0|V1.0     - Monday 22/08/93
  446.  
  447.     o Released it around Darwin (might release this version on InterNET)
  448.     o A small intra-sequence bug was found. "WORLD.669" now plays without
  449.       pausing intra-sequence...EG the 3535...53535"4"353...535"4"3535 effect.
  450.     o Bug in finding "no of sequences" has been fixed. "FINAL.669" now plays
  451.       without going RS at the end of the song.
  452.     o Fixed minor problems regarding the jam bars.
  453.  
  454.  
  455. 3- TC669 V1.02                        - Saturday 23/10/1993
  456.  
  457.     o I got one response back from somebody in Darwin, hence TC669 is no
  458.       longer a beta version.
  459.     o 66D is now software in it's own right and will no longer be distributed
  460.       with TC669.
  461.     o More compact and optimised code.
  462.     o Ditched the EGA 640x350 title screen.
  463.     o Ditched the TC669 environment variable.
  464.     o Runs off the GUS IRQ.
  465.     o Totally Ultraclick free.
  466.     o bugs fixes.
  467.     o Modified tracker screen (and bug fixes).
  468.     o Scope has been implemented.
  469.     o "SINFO" has now been implemented.
  470.     o TC669 is now fully compliant.
  471.     o 16 screens of on-line documentation.
  472.  
  473.  
  474. 4- TC669 V1.30                       - Saturday 18/12/1993 (Test version - 
  475.                                 Given to Dick)
  476.  
  477.     o ok,...my mistake. There is nothing wrong with the 669 file called
  478.       "LOST IN GERMANY" (GERMANY.669). I made a wrong assumption regarding
  479.       the difference between a looped sample and a normal sample when loading
  480.       a 669 file. Lost in Germany plays ok ...(and so do every other 669 that
  481.       were converted using MOD2669).
  482.     o Chucked the V1.00ß sequence control code back in (with a few
  483.       modifications). All 669's will now play right.
  484.     o Improved the scope.
  485.     o Stuck SB code in - sounded like shit - so then I took it out again :(.
  486.     o Added a 32 bit real time text "fourier transformation" graph.
  487.     o Added 32 bit real time text "Amp stat" graph (aka "dancing Pig")..
  488.     o Improved effects so that they all now sound identical to COMPOSD.
  489.     o Slowed down the tracker a bit (it tracked a bit too fast).
  490.     o Dos shell facility added.
  491.     o Added tagg file facility "select-em then play-em" type thingy.
  492.     o Ditched U-click option. You would never need it now.
  493.  
  494. (Note: I put in a Delta Attractor graph, however, it looked pretty much the
  495.  same as a fourier, so a decided to rip it out).
  496.  
  497. 5- TC669 V1.31-1.32                      - Saturday 22-24/12/1993
  498.  
  499.    o Fixed a minor bugs with the help of Dick and Thomas.
  500.  
  501. =WHAT's NEXT?=
  502. ──────────────
  503.  
  504.  
  505.  - SB support (back to the drawing board).
  506.  - SETS (Top secret)
  507.  - Try and get the tagging system to work in DOS.
  508.  - Findles etc.
  509.  
  510.  
  511.                  ooo0ooo
  512.