home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / sound / mus_play / stp141.lha / STP.doc < prev    next >
Text File  |  1993-05-09  |  34KB  |  952 lines
  1.  
  2.  ****************************************************************************
  3.  
  4.                           D.E.R. ST-Player V1.41
  5.  
  6.  ****************************************************************************
  7.  
  8.                          © 1990-93 Wolfgang BREYHA
  9.  
  10.  
  11.  
  12.  
  13.                                  I N D E X
  14.                                  =========
  15.  
  16.  
  17.         1. Important
  18.           1.1     Important Notes
  19.           1.2     Testkonfiguratons
  20.           1.3     Limits           
  21.           1.4     Requirements     
  22.           1.5     Features         
  23.  
  24.         2. Startoptions and Tooltypes
  25.           2.1     Defaultvalues          
  26.           2.2     CLI-Start              
  27.           2.3     WB-Start               
  28.           2.4     Fire and Forget        
  29.  
  30.         3. Usage
  31.           3.1     While STP is running   
  32.           3.2     Volume-control         
  33.           3.3     Filter-control         
  34.           3.4     Positions-, Notecontrol
  35.           3.5     Songcontrol            
  36.           3.6     Sequence-control       
  37.           3.7     Random                 
  38.           3.8     Auto-Fade              
  39.           3.9     Time-control           
  40.           3.10    Scan-control           
  41.           3.11    Info-Button
  42.           3.12    The Analyser           
  43.           3.13    Change of Directory    
  44.  
  45.         4. Tips & Tricks
  46.           4.1     Tactical Hints         
  47.           4.2     Tips for XPK           
  48.           4.3     Info for musicians     
  49.           4.4     Start of objectmodules 
  50.  
  51.         5. general informationen
  52.           5.1     Warranty               
  53.           5.2     Distributors           
  54.           5.3     Credits                
  55.           5.4     Info about Program     
  56.           5.5     Info about the coder   
  57.           5.6     Contacts               
  58.           5.7     History                
  59.           5.8     Comming next           
  60.  
  61.  
  62.                             1.1 Important Notes
  63.                             ===================
  64.  
  65. Before you use Player please read this:
  66. ---------------------------------------
  67.  
  68. I have worked almost 3 years on this code and i think it's a very nice
  69. program. So I have a little request! I don't want to earn any money with my 
  70. Player, because I have written it for fun and for my own use, 
  71. but please LET ME KNOW, IF YOU FIND SOME BUGS!
  72.  
  73. If you really want to send me some money, then do it! I'll take it, and it
  74. makes no difference how much! Maybe I'm the first Freeware-Coder, who earns
  75. millions with his program. So help me being the first one and send only
  76. sums bejond one million US-Dollar!!
  77.  
  78. If you have troubles with a module please send me a disk with it!
  79. You'll get it back with a new version of STP!!
  80.  
  81. After I've got my A2000 with A2630, Kick 2.0 and ECS, I've tried to fix the
  82. problems with Cache, Kick 2.0, Workbench 2.1 and all the other troubles with
  83. this fucking fast machine!!
  84.  
  85. Many other Players have troubles with turboboards as fast as the
  86. G-Force030 50/50 (Protracker 2.2-3.0 too!!), STP not!!
  87. On 68040 I give no garanties, cause I couldn't test it.
  88. Please help me if you are a 68040 guru with some 'how to code'-tips.
  89.  
  90. Version 1.1 is the first released Version. V1.0 was spread internal only!!
  91. But who knows?! Perhaps you have a copy of 1.0!?! 
  92.  
  93.  
  94.                           1.2 Testconfigurations
  95.                           ======================
  96.  
  97. Tests are made on following systems:
  98. AMIGA   Kick    GFX Chip Other
  99. ----------------------------------------------------------------------
  100. A2000C  3/2/1.3 ECS 1Mb  A2630 25/50/4Mb; GVP Serie II/2Mb     (Wolfi)
  101. A2000C  2.0     ECS 1Mb  GVP Serie II'030 28/33/4Mb; Nexus 4Mb (Reini)
  102. A2000C  2.0     ECS 1Mb  GVP GForce'030 50/50/8Mb - A2320      (Michl)
  103. A2000C  2.0    ECS 1Mb  GVP GForce'030 50/50/4Mb              (Peter)
  104. A4000   3.0     AGA 2Mb  8Mb                                   (Alex )
  105. A1200   3.0     AGA 2Mb                                        (Erwin)
  106. A500+   2.0     ECS 1Mb  Multievolution/2Mb                    (Elchi)
  107. A500    2.0     ECS 1Mb  1.5Mb Rangermem                       (Michi)
  108. ZX81    0.1     ORG 16Kb Datasette (tests are not succesfull, sorry:->
  109.  
  110.  
  111.                                 1.3 Limits
  112.                                 ==========
  113.  
  114. What I'll never do:
  115. -------------------
  116.  
  117. I'll never build in other playroutines then the one of Soundtracker
  118. (and Clones), because there are so many good modules for ST (I've 140; 14 Mb)
  119. and there are enough other players playing all formats.
  120.  
  121.  
  122.                              1.4 Requirements
  123.                              ================
  124.  
  125. Needed Hardware:
  126. ----------------
  127.  
  128. Any Amiga, at least Kick 1.2 and a very good stereo amplifier!!!!
  129. (And good speakers, too:-)))
  130.  
  131. Needed Software:
  132. ----------------
  133.  
  134. Many Soundtracker-modules!!
  135. If you use MachIII please read the tactical hints using STP!!!
  136.  
  137.  
  138.  
  139.                                1.5 Features
  140.                                ============
  141.  
  142. D.E.R. ST-Player is a Soundtracker-Moduleplayer with some special features!
  143.  
  144. - CD-Player GUI
  145. - 'Fire and Forget'-System (you will see what I mean)
  146. - fantastic Channel-Analyser!
  147. - 100% assembler
  148. - STP makes an own Process!!!
  149. - STP is full multitasking-compatible (except allocation of audio-cannels!)
  150. - STP works with 1(and more)MByte chipmem! (Ok, that's a feature of Kick1.3!)
  151. - STP should work on 680x0 processor cards!!
  152. - plays Soundtracker V2.0-V2.6, Noisetracker V1.0-V2.0 and
  153.         Protracker  -V2.3 Modules
  154. - If the screen is in background Player needs no CPU-Time!(Except Playroutine!!)
  155. - full filtercontrol
  156. - Position- and Notecontrol
  157. - Volumecontrol
  158. - NonStop loading
  159. - programmable
  160. - also handles PP20- and FileImploder-files!!
  161.   since V1.22 also XPK-files
  162. - Start from CLI and Workbench possible!!
  163. - (FOR EXPERIENCED USERS ONLY!!: Player is able to run objectmodules)
  164.  
  165.  
  166.  
  167.                              2.1 Defaultvalues
  168.                              =================
  169.  
  170. Start STP with or without options. If no arguments are given, STP
  171. has following defaults:
  172.  
  173. - STP searches the file ENV:PlayerDir. There you can save the directory
  174.   where the modules are stored. If the file doesn't exist ->
  175. - default directory is 'ST-00:modules'
  176. - STP takes as much memory as he needs or he can catch.
  177. - the songs are played alphabetically (A-Z) (German chars are sorted correct!)
  178. - STP dosen't looks for 'mod.'-files only
  179. - STP loads the next song when the current one is finished
  180. - The 'B'-Cmd(Position-Jmp) of ST is enabled
  181. - Auto-Fade is off
  182. - Analysermode is set to high frequencies
  183. - Timemode is set to normal positionview
  184. - Clones Workbench (also Lace or Nonlace)
  185. - allocates Channels with a Precedence of -50
  186.  
  187.  
  188.  
  189.                                2.2 CLI-Start
  190.                                =============
  191.  
  192. STP [DIR-Name | Module-Name] [-m][-sxxx][-r][-n][-j][-a][-f][-d][-tx]
  193.                              [-lx][-pxxx] [?]
  194.  
  195. Options:
  196.    ?    -> Shows helpscreen!!
  197.  
  198.   -m    -> Player takes only files beginning with 'mod.' (not case-sensitive!!!)
  199.  
  200.   -sxxx -> Player uses only that amount of chipmem you have selected.
  201.            ('xxx' means the amount in KByte!!!! (xxx*1024=amount in Bytes!
  202.            I'm living in europe and here we're calculating with 1024 not 1000))
  203.            Songs longer than 'xxx'-KByte won't be loaded.
  204.  
  205.   -r    -> Player will randomize the sequence.
  206.  
  207.   -j    -> disables the Position-Jump command from ST.
  208.            (Very nice option for songs with a endless loop)
  209.  
  210.   -n    -> Player tries to load the next song if the current has 3 patterns
  211.            left to play. It only works if you have enough Fast-Mem!!
  212.  
  213.   -d    -> Switches the Mode-Button to On-position
  214.  
  215. since V1.1:
  216.   -f    -> Switches Auto-Fade On
  217.  
  218. since V1.3:
  219.   -tx   -> TimeMode; x=0 normal
  220.                      x=1 remaining Patterns
  221.                      x=2 Time
  222.  
  223. since V1.4:
  224.   -lx   -> LaceMode; 0=nonlace; 1=lace; 2=WBClone;
  225.            STP always try to clone the full screenmode from WB (on AGA
  226.            he also uses Productivity etc.). Only nonlace or lace is in your
  227.            hands.
  228.  
  229.   -pxxx -> Precedence of STP audiochannel-allocation. (-128 to 127);
  230.            If you set it to 127 nobody will steal the audiochannels.
  231.            Only bad coded programs (like STP befor V1.4:-D
  232.  
  233.  
  234. You can start Player also with a filename. Then Player switches 'Repeat' on and
  235. disables the 'Prev' and 'Next'-gadgets!!!
  236.  
  237.  
  238.  
  239.                             2.3 Workbenchstart
  240.                             ==================
  241.  
  242. You can define a tooltype called 'SONGDIR'. STP loads all songs in this
  243. directory!!!
  244. 1. Click the STP-Icon once
  245. 2. Select 'Info' (or Information in Kick2.0) in the Workbench-Menu
  246. 3. Click on 'ADD' (or New) in the 'TOOL TYPES'-Bar
  247. 4. Type 'SONGDIR=' and the full directory-name you want. e.g.:'dh1:modules'
  248.    'modules' only is not enough!!!! (The tooltype itself is casesensitve!
  249.    Please type them all in upper case!
  250. 5. Now click on 'save'
  251. 6. doubleclick the STP-Icon and enjoy the music!!!
  252.  
  253. If you didn't spezify a SONGDIR-Tooltype, Player searches also for the 
  254. 'ENV:PlayerDir'-File. If available he uses it automatically!
  255.  
  256. I've included some other Tooltypes, too!! Defaults in ().
  257.  
  258. TOOLTYPE                 CLI-Option
  259. -----------------------------------
  260. RANDOM   -> ON/(OFF);       -r   e.g.:'RANDOM=ON';
  261. ANALYZER -> (ON)/OFF;       -a
  262. NONSTOP  -> ON/(OFF);       -n
  263. NOPOSJMP -> ON/(OFF);       -j
  264. MODONLY  -> ON/(OFF);       -m
  265. AMODE    -> ON/(OFF);       -d   (up to Version V1.24->MODE)
  266.  
  267. MAXCHIP :                   -s
  268.           sets maximum usage of CHIP-RAM!!
  269.           e.g.:'MAXCHIP=200' -> use 200K maximum
  270.  
  271. since V1.1:
  272. AUTOFADE -> ON/(OFF);       -a
  273.  
  274. since V1.3:
  275. TIMEMODE -> (0)/1/2;        -t
  276.  
  277. since V1.4:
  278. LACE     -> ON/OFF/(CLONE)  -l
  279. AUDPRI   -> xxx             -p
  280.  
  281.  
  282.  
  283.                             2.4 Fire and Forget
  284.                             ===================
  285.  
  286. If STP is configured with a correct path, he will start playing at once.
  287.  
  288.  
  289.  
  290.                          3.1 While STP is running
  291.                          ========================
  292.  
  293. If no ENV-File and no Dir-name was given, you first must turn the STP on!!
  294. Then STP asks you for a directory-path and reads this directory.
  295. Since V1.1 I use the ASL-Request (Kick 2.0 only)
  296.  
  297. Now STP loads the first module. (Display shows 'loading Song...')
  298.  
  299. Then STP starts playing.......
  300.  
  301.  
  302.  
  303.                             3.2 Volume-control
  304.                             ==================
  305.  
  306. With the proportinal gadget you can control the volume.
  307.  
  308.  
  309.  
  310.                             3.3 Filter-control
  311.                             ==================
  312.  
  313. These are the two switches on the right side from the Volume-control.
  314.  
  315.                 On        Auto   <- Function if Switch is pressed
  316.      Switch ->  ++   ||    ++    <- Switch    
  317.                 Off      Manual  <- Function if Switch is released
  318.                       ^
  319.                     Lamp
  320.  
  321. In the 'Manual'-position (default) the 'E'-command from Soundtracker is
  322. ignored (but internal stored!!) and the Filter is set by the on/off-switch.
  323.  
  324. If switched to 'Auto' the filter is set as given from the last ST-command.
  325. The other switch is now disabled and the filtercontrol is given back to the
  326. playroutine!!
  327.  
  328.  
  329.  
  330.                       3.4 Position- and Note-control
  331.                       ==============================
  332.  
  333. Below the display you can notice two pairs of gadgets. ( < > )
  334. The left pair controls the position and the right pair controls the note.
  335. The position-gadgets have a little delay!!
  336. Try it and you will know how to use them.
  337.  
  338.  
  339.  
  340.                               3.5 Songcontrol
  341.                               ===============
  342.  
  343. On the right side of the Player are four gadgets.
  344. |<,>|   : Load next,previous song in sequence.
  345. Stop    : Will stop playing. Now you can try to open the Player.
  346. Play    : Play/Pause toggle!
  347.  
  348. Below the display you notice two other switches:
  349.  
  350. RepS    : Repeat the song. As long as Repeat is highlighted in the display
  351.           Player repeats the song.
  352. Select  : Klick on it. Now you can see a '>' in front of the current song.
  353.           Use the |< and >| gadgets to select a song.
  354.           Since V1.1 this buttons are repeated in this case!
  355.           If you have found the right name press the play-gadget and Player
  356.           reads the song at once.
  357.  
  358.  
  359.  
  360.                            3.6 Sequence-control
  361.                            ====================
  362.  
  363. STP is full programmable.
  364.  
  365. Press the "Prog"-gadget
  366. You are now in the Program-Mode. (shown in the display!!)
  367. Choose a song with the |< and >| gadgets.
  368. Now you have the following possibilities:
  369. 'Prog'  : Toggles between programmed and cleared-status.
  370.           stored in the sequence -> you see 'xx P'<- Nr. in the sequence
  371.           cleared -> '   C'
  372. 'Select': Select all songs
  373. 'Random': randomize the current sequence
  374. 'Stop'  : Clear the program and cancel the Program-Mode
  375. 'Play'  : Start playing with the first song in sequence
  376.  
  377. How to clear a program:
  378. -----------------------
  379. Press the Stop-Button twice
  380.  
  381.  
  382.  
  383.  
  384.                              3.7 Random (V1.1)
  385.                              =================
  386.  
  387. Random is now available in normal play-mode.
  388. Simply press the RANDOM-Button and a program will be initialised!
  389.  
  390.  
  391.  
  392.  
  393.                            3.8 Auto-Fade (V1.1)
  394.                            ====================
  395.  
  396. This means, player fades the volume on the last Pattern to zero.
  397. This is usefull, if an endless song is played!
  398.  
  399.  
  400.  
  401.                               3.9 Time (V1.3)
  402.                               ===============
  403.  
  404. You can toggle between three modes
  405. 1.) Normal mode
  406. 2.) Remaining patterns and notes     (Thanks to Andreas Kirchwitz from Berlin)
  407. 3.) Time mode. 
  408.  
  409.  
  410.  
  411.                              3.10 Scan (V1.4)
  412.                              ================
  413.  
  414. If scan is enabled, 'Scan' apears in the display and STP will load the next song
  415. after 10 seconds.
  416.  
  417.  
  418.  
  419.                              3.11 Info (V1.41)
  420.                              ================
  421.  
  422. If you press the button, STP displays the stored info again.
  423. If no info is stored, you will see all samplenames.
  424.  
  425.  
  426.  
  427.                              3.12 The Analyser
  428.                              =================
  429.  
  430. There are four buttons!!
  431.  
  432.    ++     <-  Mode
  433.  
  434.    ++     <-  Analyser On/Off
  435.  
  436.    ++     <-  VU-Meter On/Off
  437.  
  438.   ++++    <-  Power-Switch
  439.  
  440. Mode:   I calculate which part of a sample is played each vertical blank.
  441.         Each of the 4 windows shows 40 values of the actual part.
  442.         The parts are often larger then 40 bytes and so i've found two
  443.         ways to show them
  444.         Released Button:
  445.                 I show the first 40 bytes of the actual part then i add the
  446.                 length of the remaining part.
  447.                 (Good to display high frequencies!)
  448.         Pressed Button:
  449.                 I calculate the length of the part diveded by 40. Now I show
  450.                 the first byte then a add the result of the upper expression.
  451.                 Then i show the next byte and so on...
  452.                 (Good to display low frequencies)
  453.  
  454.  
  455.  
  456.  
  457.                          3.13 Change of Directory
  458.                          ========================
  459.  
  460. Press Stop and then Open (on the disc-drawer)
  461. Now Player asks again which directory you want!!
  462.  
  463. Yes, you are right! A CD-Player usually opens without pressing STOP, but
  464. it's a security system!
  465.  
  466. V1.1: If your machine works under Kickstart 2.0, you can make this with the
  467.       ASL-Requester!
  468.  
  469.  
  470.  
  471.  
  472.                             4.1 Tactical Hints
  473.                             ==================
  474.  
  475. Player checks each file if it's a ST-Module.
  476. It's possible (0.0001%) that the check-routine failes and he tries to play
  477. a file which is not a ST-Module! Please remove this file from your 
  478. directory for safe usage!!
  479.  
  480. Using powerpacked Files requires the PowerPacker.library in libs: !!!
  481. For XPK you need the xpkmaster.library and at least one sublibrary
  482.  
  483. If you have only 512KB ChipMem use the -s option (MAXCHIP) to leave free Mem!
  484. e.g.: -s200 (I've always used this one, but now I've 1MB-Chip!!)
  485.  
  486. STP always allocates the size of the largest modules, because there are
  487. many troubles always freeing a block and allocating the next one.
  488. Memory get's more and more fragmented, until STP is not longer able
  489. to allocate the songmem!! I think this solution is better for longtime-
  490. usage and always remember Amigas with fewer then 1MB-Chipmem are ...
  491. (Try Intuitracker, he uses the other way. After about 10 Songs it's over!!)
  492.  
  493. If you are running MACHIII V3.0 get a version V3.1 or higher, cause of a
  494. major bug in V3.0. Every time you will run Player while MACHIII is running,
  495. your machine will stop every activity without a guru!!
  496. First I've thought that it was my fault, but after it works with V3.1 ...
  497.  
  498. STP needs much time in his VB-interuptroutine. It's possible that you get
  499. in trouble running other programms using VB-Int's too. (I haven't recognized
  500. any problems of this nature, but it's possible!!).
  501.  
  502.  
  503.  
  504.  
  505.                              4.2 Tips for XPK
  506.                              ================
  507.  
  508. Since V1.4 you can use multiple packed XPK-Files! So you can use the DLTA
  509. and NUKE on one file. If the file gets larger again after the second cruncher
  510. it is possible that STP has not enough memory left! This function was ment
  511. for use with an encrypter (DLTA) and one cruncher (NUKE or so), only.
  512. Don't forget the force option using XPack.
  513.  
  514.  
  515.  
  516.                           4.3 Info for musicians
  517.                           ======================
  518.  
  519. I have included the information-system from IntuiTracker!!
  520. You can use the samplenames for messages.
  521. Each message (samplename) starting with '#' is displayed.
  522. Player stops at the first samplename which begins not with '#'!!
  523.  
  524. V1.41: Now every sample with '#' is displayed, independend if there
  525.        is one without '#'
  526.  
  527.  
  528.  
  529.  
  530.                       4.4 How to start object-modules
  531.                       ===============================
  532.  
  533. AND NOW SOME HINTS FOR VERY EXPERIENCED USERS ONLY!
  534. ---------------------------------------------------
  535.  
  536. STP is able to run objectmodules! But take care, it's up to the module
  537. to work with STP!!!
  538. You ask why? There are many other good soundprograms available on AMIGA
  539. (for example SoundFX,TFMX..). If you got an executeable file which playes the 
  540. song rename it into 'run.???????'. When STP recognizes such a file
  541. he tries to load it with 'loadseg()' and jumps directly into it's code!!
  542. Now it's your problem how you stop playing and return to STP!
  543.  
  544. There is another problem with this feature!
  545. I have to give back all my memory starting the Obj-Mod.
  546. And after all I must get it back!! Do you know what I mean?!?!
  547. No! It's quiet simple!! It's possible that there isn't enough memory left
  548. after this action! STP will then quit playing!!!
  549. That's why I'm always allocating the length of the largest Module!!!!
  550. Because that's the only way to be sure not running out of memory!
  551. So please hold your memoryconsumtion low (use -s option. Usually I use -s200!!)
  552.  
  553. I have found a new problem since STP makes an own precess!!!
  554. Some playroutines test if the process is started from CLI. If not they wait
  555. for a WB-Message!!! It's on you to remove this part of the code!!
  556. A little hint: look out for a FindTask(0L) (sub.l a1,a1; jsr -294(a6))
  557. then look if the programm tests 172(a?) of the process-structure.
  558. Remove exactly this test! But be careful. The code must always go the way
  559. it goes started from CLI!
  560.  
  561. But after all that troubleshooting I have to say you: I did it!!!
  562.  
  563.  
  564.  
  565.  
  566.                                5.1 Warranty
  567.                                ============
  568.  
  569.                 D.E.R. ST-Player © 1990-93 Wolfgang BREYHA
  570.  
  571.  
  572.     This Program is FREEWARE and it may be freely distributed if:
  573.  
  574.      - The Program, it's Icon and the .doc-Files are all copied
  575.        together
  576.      - No Changes (except crunching) are made without
  577.        MY permission!!!
  578.      - saled only for prime cost+copy fee(5DM or 5US$)
  579.        (any disputes arising hereunder will be settled before a
  580.         competent Vienna court of law!!!)
  581.  
  582.     Hello Fred Fish, please include it in your library:-)
  583.  
  584.                                   Warning
  585.                                   =======
  586.  
  587.  
  588.                       I give no garantees using Player.
  589.              System crashes and other unkown bugs are possible!!
  590.                         Use Player on your own risk!!!
  591.  
  592. Player only reads data! It's impossible that Player
  593. destroys data on a Disk or HD. (only in your RAM, HeHeHe;-)
  594.  
  595.         All my friends are using Player since Summer 1990 with their HD and
  596.                            they have no problems!!
  597.  
  598. But nobody is perfect!! And my name is certainly not 'Nobody'!
  599. So please let me know all the bugs you notice!!
  600.  
  601.  
  602.  
  603.  
  604.                              5.2 Distributers
  605.                              ================
  606.  
  607. 1. FTP: I always upload my last version on "amiga.physik.unizh.ch" in the
  608.         directory "mus/play"
  609.  
  610. 2. TIME-PD: The Time-PD-Serie has included STP 1.31 on Disk #146.
  611.  
  612.  
  613.  
  614.  
  615.                                 5.3 Credits
  616.                                 ===========
  617.  
  618. Last but not least thanks to:
  619.  
  620.                 Michael Matzl(Mad Matz), Reinhardt Franz(Killersoft),
  621.                 Erwin Kloibhofer(Putenschnitzel), Stefan Kainz(Elchi),
  622.                 Dieter Henkel, Peter Scherbaum, Alex Wochner
  623.                 and some members of the 'D.E.R. Computerclub'
  624.  
  625.                 for beta-testing, bugreports, good ideas and very good friendship.
  626.  
  627.  
  628.                 following STP-Fans, which have sent Mail:
  629.                 (sorted by date of first mail)
  630.                 Andreas M. Kirchwitz, Berlin        , 18 Jan 93 21:26
  631.                 William M. Biesele  , Utah          , 19 Jan 93 16:48
  632.                 Stefan Schulz       , Kaiserslautern,  9 Feb 93 14:31
  633.                 Roland Tögel        , Vienna        , 26 Feb 93 11:39
  634.                 Steve Anichini      , Chicago       , 26 Feb 93 21:41
  635.                 Altaz Valani        , Ontario       , 14 Mar 93 02:21
  636.                 Matti Rintala       , Finland       , 23 Mar 93 16:09
  637.  
  638.                 to all people sending me standard mail
  639.                 Roland Tögel     , Vienna
  640.                 TIME PD-Serie    , Germany
  641.                 Lothar Werzinger , Germany
  642.                 Arne Hinrichsen  , Germany
  643.  
  644.  
  645.                 all of you out there in the whole world for using my STP.
  646.                 and always remember: it's FREEWARE so spread it around the world.    
  647.  
  648.                 to all of you sending me bugreports, ideas and funny mails. 
  649.  
  650.                 to Dino Dini for Final Whistle, the best soccer game on AMIGA,
  651.                 and to all members of our private FW-League for the greatest
  652.                 duels every Friday evening.
  653.  
  654.         to F.G.T.H for all their Maxi-Singles.
  655.  
  656.         to Citroen for the 2CV, my current car.
  657.  
  658.         to Robert Altman for MASH, the best film ever in cinema.
  659.  
  660.         to mom and dad for .....
  661.  
  662.                                                    //
  663.                 Commodore for development of the \X/AMIGA.
  664.                                           
  665.  
  666.  
  667.  
  668.                     5.4 Informations about the Program
  669.                     ==================================
  670.  
  671. Start of coding:        April 1990
  672. SourceCode:             160kB - pure assembler-source (~9100 lines)
  673. ObjectCode:              39kB
  674. Assembler:              ASM-One (in the beginning Masterseka 1.80)
  675. GFX:                     45kB - 3 Planes,Hires(640*170) (also pixled by me)
  676.  
  677.  
  678.  
  679.  
  680.                      5.5 Informations about the coder
  681.                      ================================
  682.  
  683. I'm 22 years old and I'm living in Vienna, Austria. 
  684.  
  685. My first computer was a ZX-81 with 16Kb. After a VC-20 I've got a C-64.
  686.  
  687. In 1988 the first AMIGA, an A500 with 1MB and a 1084 was my own.
  688.  
  689. My current configuration is:
  690. A2000C, ECS, 1MB-Chip
  691. A2630 25/50, 4MB 32Bit
  692. GVP Serie II 2MB 16Bit + 120MB Maxtor + 52MB Quantum
  693. A2320 Flickerfixer
  694. AOC BM337 14" SVGA-Monitor
  695.  
  696. My hobbies are: (except AMIGA)
  697. windsuring, skiing, carambol-billard, tabletennis, repairing old technical
  698. machines (like flippers and Jukeboxes) and driving with my old 2CV(Citroen).
  699.  
  700.  
  701.  
  702.  
  703.                                5.6 Contacts
  704.                                ============
  705.  
  706. Snailmail:      Wolfgang BREYHA
  707.                 Großer Ring 42
  708.                 1130  Vienna
  709.                 Austria             (not Australia, no Kangaroos!!
  710.                                      we are those with Lipizaner, you know:->
  711.  
  712. E-Mail:         ookummer@swwwnext.tuwien.ac.at
  713.                 Boys and girls, I *love* mail!!
  714.  
  715.  
  716. Come to:        D.E.R. Computer-Club
  717.                 Stiegerg. 5/1
  718.                 1150  Vienna
  719.                 Austria
  720.                 Monday and Tuesday, 17-20 PM
  721.  
  722.  
  723.  
  724.  
  725.                                 5.7 History
  726.                                 ===========
  727.  
  728.      5.7.1    About STP 
  729.      5.7.2    Versions  
  730.  
  731.  
  732.  
  733.                               5.7.1 About STP
  734.                               ===============
  735.  
  736. The first step was a CLI-Utility called PlayV2. This one has done nothing else
  737. except playing one ST-V2.0-Module until you press the left mousebutton.
  738.  
  739. Christmas 1989 I've got my first harddrive for my A500 with Kick 1.2.
  740. In January I bought Kick 1.3. Then it was perfect: A OMTI-5520-MFM-Controller
  741. with A.L.F.-Software and a CDC 40MB harddisk with reboot under 1.3.
  742.  
  743. In April 1990 I had born the idea to make a tool which reads a whole 
  744. directory of ST-Modules and plays one after the other. I program
  745. called Player was born.
  746.  
  747. But this was not enough. Some control is very usefull, and so I've implemented
  748. many functions. It was a really small window, I think 160x30 pixels, and there
  749. were nearly the same control-features as in the STP from today. Note- and
  750. Positioncontrol, Volume, programable, select, pause and filtercontrol.
  751.  
  752. After half a year of speartimecoding it was a really nice tool. But then comes
  753. the time of all new trackers like Noisetracker, Startekker, Soundtracker2.6,
  754. Protracker and so on. But I've made it, I've already made one Playroutine
  755. for all of them. Everything STP is able to play is played from one play-
  756. routine. It was hard but I've really made it.
  757.  
  758. I think it was in November 1990. My dear friend Erwin Kloibhofer (Coder of
  759. the great Jump-and-Run Game 'Lionheart' of Thalion Software) said to me
  760. that the Player is a very nice tool, but a novice-user doesn't know what a
  761. program is worth without a fantastic userinterface and Player looks like
  762. a Hacker/Cracker-Tool.
  763.  
  764. So I've drawed a CD-Player and after only one week the code was changed for
  765. the new look of player (I think that's not my owing, it's Commodores. The
  766. OS is fantastic for things like that). All my friends were surprised.
  767. All of them were using CDP (I've called the new Program CDP) for a long time.
  768.  
  769. In Spring 1991 was the time of all these fucking great demos with analyzers.
  770. So I've tried to make a fast routine for use in multitasking. Again I've
  771. drawed a new CD-Player with this wonderfull analyzer (Thanks to Elchi for
  772. the nice feet). Again some new features, perfect.
  773.  
  774. In Summer 1991 I've got Kick 2.0. Hoppla, there was something wrong. CDP
  775. doesn't work from Workbench only from CLI. Bugfixes without end. 
  776.  
  777. Since Oktober 1991 I'm a member of the D.E.R.Computerclub in Vienna. What?
  778. The name?! What's wrong?!? Ahhh!! Yes. D.E.R.ST-Player. Correct.
  779. It's my publicity campaign for the club.
  780.  
  781. The year 1992 was filled up with some new features like tooltypes, autofade,
  782. more Kick2.0 features like ASL-Request ......... and bugfixes. And in Summer
  783. I've got my new A2000 with A2630 25/50MHz 4MB and GVP Serie II Controller
  784. with a Maxtor 120MB HD and 2MB 16Bit-Ram. But STP runs without any bugs.
  785.  
  786. And now we have the year 1993!
  787.  
  788.  
  789.  
  790.  
  791.                               5.7.2 Versions
  792.                               ==============
  793.  
  794. ;* $Revision Header built automatically *************** (do not edit) ************
  795. ;*
  796. ;* © Copyright by M.A.S.H (Modern Art Soft Hietzing)
  797. ;*
  798. ;* File             : ACDP.s
  799. ;* Created in       : December 1990 
  800. ;* Created by       : Wolfgang BREYHA
  801. ;* Current revision : V1.41
  802. ;*
  803. ;*
  804. ;* Purpose
  805. ;* -------
  806. ;*     D.E.R. ST-Player is a Soundtracker-Moduleplayer
  807. ;*     with a CD-Player-like graphics-userinterface
  808. ;*     see notes below
  809. ;*
  810. ;* Revision V1.41
  811. ;* --------------
  812. ;* changed on Sunday, 09-May-93 22:49:20  by  Wolfgang BREYHA.   LogMessage :
  813. ;*     Enforcerhit removed (Sorry, small debuginfo forgotten:-)
  814. ;*     Scanfunction fits now with other functions 
  815. ;*     Next Song Ready -> Previous: plays now previous not next:)
  816. ;*     New Info-Button included; Small Bugfixes
  817. ;*
  818. ;* Revision V1.40
  819. ;* --------------
  820. ;* changed on Wednesday, 18-Apr-93 17:55:19  by  Wolfgang BREYHA.   LogMessage :
  821. ;*     Now all Errorwindows are fontsensitive (+bugfixes).
  822. ;*     Cancel in ASL-Request returns to last state.
  823. ;*     Bugfixes in Open-part
  824. ;*
  825. ;* Revision V1.39
  826. ;* --------------
  827. ;* changed on Wednesday, 31-Mar-93 01:59:30  by  Wolfgang BREYHA.   LogMessage :
  828. ;*     New GFX for numbers and gfx-symbols for operation.
  829. ;*     (very special thanks to Matti Rintala for the idea:-)
  830. ;*
  831. ;* Revision V1.38
  832. ;* --------------
  833. ;* changed on Friday, 25-Mar-93 00:30:39  by  Wolfgang BREYHA.   LogMessage :
  834. ;*     25-Mar-93 No AbortIO only ACMD_FREE
  835. ;*     11-Mar-93 Bug in CloseAudio -> Guru when started twice (thanx to me:-)
  836. ;*     08-Mar-93 Bug in ppdecrunch while nonstop removed (thanx to S. Schulz)
  837. ;*     01-Mar-93 Play always starts music now (thanx to Mad Matz)
  838. ;*
  839. ;* Revision V1.37
  840. ;* --------------
  841. ;* changed on Friday, 26-Feb-93 14:48:04  by  Wolfgang BREYHA.   LogMessage :
  842. ;*     GFX imploded now! 50% gain on executable. STP exhaust now 
  843. ;*     not so much chipmem as before (about 40K). bugfix in GetMonID
  844. ;*     I've added a little animation (especially for Reini)
  845. ;*
  846. ;* Revision V1.36
  847. ;* --------------
  848. ;* changed on Tuesday, 23-Feb-93 02:03:41  by  Wolfgang BREYHA.   LogMessage :
  849. ;*     Hello audio.device! Now i get the channels with userdefine-
  850. ;*     able precedence. (Special thanks to Mad Matz for help.
  851. ;*     I think it was a little bit nerve-racking). All Gadgets are
  852. ;*     sleeping now when busy. Busypointer no longer fragments 
  853. ;*     chipmem. Interlace-toggle (No lace GFX, sorry).
  854. ;*
  855. ;* Revision V1.35
  856. ;* --------------
  857. ;* changed on Friday, 19-Feb-93 18:26:06  by  Wolfgang BREYHA.   LogMessage :
  858. ;*     Automatic Screenmode detection->STP tries to Clone
  859. ;*     DefPubScreen, ShowSamples works now with all Monitortypes
  860. ;*     Bug in Clear-Routine removed (thanx again to Stefan Schulz)
  861. ;*
  862. ;* Revision V1.34
  863. ;* --------------
  864. ;* changed on Thursday, 18-Feb-93 18:29:45  by  Wolfgang BREYHA.   LogMessage :
  865. ;*     XPK-multiple packed files. Minor Bugfixes (powerpacked Files).
  866. ;*     Long Enforcer and Mungwall tests without hits
  867. ;*
  868. ;* Revision V1.33
  869. ;* --------------
  870. ;* changed on Friday, 15-Feb-93 12:31:11  by  Wolfgang BREYHA.   LogMessage :
  871. ;*     Minor GFX-changes; ShowSample-Routine debugged; Playroutine debugged;
  872. ;*     what an ugly bug, rests of selfmodifying code confused 68040 Cards
  873. ;*     4K Cache is enough for half of the playroutine! (Special thanks
  874. ;*     to Roland Tögel who reported this bug by snailmail)
  875. ;*     Now all selfmodifying code is removed!! Minor Bugfixes!
  876. ;*
  877. ;* Revision V1.32
  878. ;* --------------
  879. ;* changed on Thursday, 28-Jan-93 11:47:55  by  Wolfgang BREYHA.   LogMessage :
  880. ;*     Minor bugfix! (thanks to Elchi)
  881. ;*     and on 11-Feb-93 23:45:32 -> bugfixes in program- and select-mode
  882. ;*     (thanks to Mad Matz and Stefan Schulz)
  883. ;*
  884. ;* Revision V1.31
  885. ;* --------------
  886. ;* changed on Sunday, 24-Jan-93 23:06:56  by  Wolfgang BREYHA.   LogMessage :
  887. ;*     File-limit up to 999, prog is able to store 65535, only
  888. ;*     Display is to small (thanks to W.M.Biesele);
  889. ;*     Stop first stops music, after second
  890. ;*     touch program is cleared; Pause is removed if Stop is
  891. ;*     pressed
  892. ;*
  893. ;* Revision V1.30
  894. ;* --------------
  895. ;* changed on Thursday, 21-Jan-93 17:49:53  by  Wolfgang BREYHA.   LogMessage :
  896. ;*     New button called "Time". Toggles between patterns,
  897. ;*     remaining patterns and time. Error- and Info-windows are
  898. ;*     now fontindependent (thanks to William M. Biesele).
  899. ;*     New GFX for Time-Button -> Revision jump
  900. ;*
  901. ;* Revision V1.24
  902. ;* --------------
  903. ;* changed on Sunday, 17-Jan-93 15:08:33  by  Wolfgang BREYHA.   LogMessage :
  904. ;*     Major bug in XPK-unpack part! used dbf-loop, but $FFFF 
  905. ;*     longwords are to few for some modules!
  906. ;*
  907. ;* Revision V1.23
  908. ;* --------------
  909. ;* changed on Saturday, 26-Dec-92 23:43:13  by  Wolfgang BREYHA.   LogMessage :
  910. ;*     Bug in errormessages. Message for XPK-NoMem.
  911. ;*
  912. ;* Revision V1.22
  913. ;* --------------
  914. ;* changed on Wednesday, 16-Dec-92 00:27:23  by  Wolfgang BREYHA.   LogMessage :
  915. ;*     XPK is very nice! And so I'll use it!
  916. ;*
  917. ;* Revision V1.21
  918. ;* --------------
  919. ;* changed on Monday, 14-Dec-92 14:52:12  by  Wolfgang BREYHA.   LogMessage :
  920. ;*     Bug in mt_init fixed!! replen wrong!!
  921. ;*     Converted to ASM-ONE; Includes used; SECTION used; no more makecdp!!
  922. ;*
  923. ;* Revision V1.20
  924. ;* --------------
  925. ;* changed on Monday, 16-Nov-92 00:51:42  by  Wolfgang BREYHA.   LogMessage :
  926. ;*     BusyPointer, Better Busy-Message-Handling
  927. ;*
  928. ;* Revision V1.10
  929. ;* --------------
  930. ;* changed in 1991 by  Wolfgang BREYHA.   LogMessage :
  931. ;*     Kick 2.0 features, AutoFade, Next- and Prevgadget repeated
  932. ;*
  933. ;* Revision V1.00
  934. ;* --------------
  935. ;*     --- Initial release ---
  936. ;*
  937. ;*********************************************************************************
  938.  
  939.  
  940.  
  941.                              5.8 Comming Next
  942.                              ================
  943.  
  944. 1. All further versions will only work on Kick2.0 or higher.
  945.    (Kick 1.3 was very good but 2.0 is much better. If you
  946.     already using 1.3, forget it; Get the new one:-))))
  947. 2. The first step for 2.0 is a Preferences-program.
  948. 3. If there is enough response I'll make some new features
  949.    for the 'Scan'-function.
  950.  
  951.  
  952.