home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / sound / ptplay03 / ptplayer.doc next >
Text File  |  1994-12-16  |  4KB  |  99 lines
  1.  
  2.             PT-PLAYER version 1.03
  3.             ----------------------
  4.               (patched version)
  5.  
  6.      A Protracker Module-Player for Atari ST (released 07/12/1994)
  7.  
  8.      Coded by Petri Kuittinen (alias The Eye of Brainwash Company!)
  9.           Play routine by Martin Griffiths (Griff of EI)
  10.  
  11.  
  12.  
  13. General
  14. -------
  15.  
  16. This program is freeware. It means you can copy and use it freely as
  17. long as this file and all the other files related to this program are
  18. copied with it and remain unchanged. Donations are of course always
  19. welcome (I'm a poor student). ;-)
  20.  
  21. This is program is supposed to play Noise- and ProTracker module files
  22. via Yamaha-2149 sound chip. The sound output is 17.1 Khz mono PCM sound
  23. with 12-bit dynamics. This program works on all resolutions and on all
  24. screen refresh rates. It works on all Atari ST/STE models (with only 0.5
  25. Mb RAM you might have trouble playing large mods). It doesn't work
  26. correctly on machines with 32-bit 680x0 processors (eg. Atari Falcon and
  27. TT).
  28.  
  29.  
  30. History
  31. -------
  32.  
  33. I was fed up using the current crap mod-players which existed for Atari
  34. ST. All of them had at least few of the following faults:
  35.  
  36. - Poor sound quality (noisy, only 8 bits dynamics).
  37. - No real time volume variation.
  38. - Protracker effects don't play correctly/at all.
  39. - Lock up with Midi-data (or even keyboard data!).
  40. - Only work on low or med. resolution and under 50 Hz screen refresh
  41.   rate.
  42.  
  43. To correct the situation I spent few hours coding a small GEM front end
  44. (actually my first GEM prg!) and combined it with Griff's magnificent
  45. play routine. It took me many hours to to fix few bugs in it and to get
  46. it work independent of screen refresh rate. Griff's play routine uses
  47. the original Amiga PT-player source, so it really plays all the effects
  48. correctly, except filter setups (there are no filters in ST!) and CIA
  49. tempo values (I have fixed the code to approximate the tempo value with
  50. the nearest speed value. This is not a perfect solution).
  51.  
  52.  
  53. Manual
  54. ------
  55.  
  56. Pt-player is very easy to use. Just start the program and after that a
  57. dialog box, with the title 'PT-PLAYER v1.03', should appear on the
  58. screen. Pressing left mouse button on the title bar will show the
  59. credits. Below that reads the status (normally 'Waiting for selection')
  60. and below that is the module name. If there is no module in memory, name
  61. is a sequence of lines ('---------'). There are three buttons in the
  62. bottom of the dialog box: LOAD, PLAY and EXIT. LOAD will load a
  63. module-file to memory using standard GEM file selector. Program will
  64. warn you with alert boxes if you try to load a file which is not NT/PT
  65. mod-file. Pressing PLAY with left mouse button will start playing a
  66. module if there is one in memory. The play routine takes nearly all
  67. processor time on standard Atari ST. No other action is possible while
  68. playing. Pressing space bar will stop playing. Pressing EXIT will exit
  69. program.
  70.  
  71. You can also install this program for modules. PT-player will then
  72. automatically load the first file given for it.
  73.  
  74.  
  75. Known bug
  76. ---------
  77.  
  78. If you start the playing with a key (by changing the 'Play' button to a
  79. default one with a RSC-editor or by using an extended dialog handler)
  80. instead of mouse, module will restart to play as soon as you'll stop it.
  81. This is probably because PT-Player 'steals' all the interrupts.
  82.  
  83.  
  84. Greetings for this version go to:
  85. ---------------------------------
  86. - Eero Tamminen for the autoload/basepage patch.
  87.  
  88.  
  89. Contact the author for ideas, bug reports, demo stuff etc. via:
  90. ---------------------------------------------------------------
  91.  
  92. Electronic mail:    eye@niksula.cs.hut.fi (internet)
  93.  
  94. Ordinary mail:        Petri Kuittinen
  95.             Timpurinkuja 1 C 39
  96.             SF-02600 Espoo
  97.             FINLAND
  98.  
  99.