home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / p / ptplay12.zip / PTPLAYER.DOC next >
Text File  |  1993-03-14  |  4KB  |  96 lines
  1.  
  2.             PT-PLAYER version 1.02
  3.             ----------------------
  4.               (official version)
  5.  
  6.     A Protracker Module-Player for Atari ST (released 24/02/1993)
  7.  
  8.     Coded by Petri Kuittinen (alias The Eye of Brainwash Company!)
  9.         Play routine by Martin Griffiths (Griff of EI)
  10.  
  11. General
  12. -------
  13.  
  14. This program is freeware. It means you can copy and use it freely as
  15. long as this file and all the other files related to this program are
  16. copied with it and remain unchanged. Donations are of course always
  17. welcome (I'm a poor student). ;-)
  18.  
  19. This is program is supposed to play Noise- and Protracker module
  20. files via Yamaha-2149 sound chip. The sound output is 17.1 Khz
  21. mono PCM sound with 11 bits linear dynamics. This program works on all
  22. resolutions and on all screen refresh rates. It works on all
  23. Atari ST/STE models (with only 0.5 Mb RAM you might have trouble playing
  24. very large mods). It hopefully works on Atari Falcon and TT too
  25. (I don't have any machine to test with) if you turn the cache off
  26. (the player uses self-modifying code!).
  27.  
  28. History
  29. -------
  30.  
  31. I was fed up using the current crap mod-players which existed for Atari
  32. ST. All of them had at least few of the following faults:
  33. -poor sound quality (noisy, only 8 bits dynamics)
  34. -no real time volume variation
  35. -protracker effects don't play correctly/at all
  36. -only work on low or med. resolution and under 50 Hz screen refresh rate
  37. -lock up with Midi-data (or even keyboard data!)
  38.  
  39. To correct the situation I spent few hours coding a small GEM front
  40. end (actually my first GEM prg!) and combined it with Griff's magnificent
  41. play routine. It took me many hours to to fix few bugs in it and to
  42. get it work independent of screen refresh rate. Griff's play routine
  43. uses the original Amiga PT-player source, so it really plays all the
  44. effects correctly, except filter setups (there is no filters in ST!)
  45. and CIA tempo values (I have fixed the code to approximate the
  46. tempo value with the nearest speed value. This is not a perfect
  47. solution).
  48.  
  49. Manual
  50. ------
  51.  
  52. Pt-player is very easy to use. Just start the program and after
  53. that a dialog box, with the title 'PT-PLAYER v1.02', should appear on
  54. the screen. Pressing left mouse button on the title bar will show the
  55. credits. Below that reads the status (normally 'Waiting for selection')
  56. and below that is the module name. If there is no module in memory,
  57. name is a sequence of lines ('---------'). There are three buttons
  58. in the bottom of the dialog box: LOAD, PLAY and EXIT. LOAD will
  59. load a module-file to memory using standard GEM file selector.
  60. Program will warn you with alert boxes if you try to load a file
  61. which is not NT/PT mod-file. Pressing PLAY with left mouse button will
  62. start playing a module if there is one in memory. The play routine takes
  63. nearly all processor time on standard Atari ST. No other action
  64. is possible while playing. Pressing space bar will stop playing.
  65. Pressing EXIT will exit program.
  66.  
  67. Disclaimer
  68. ----------
  69. Use this program at your own risk. The author has no responsibility what
  70. so ever to the possible damage caused by this program.
  71.  
  72.  
  73. Greetings go to
  74. ---------------
  75. -Electronic Images (Hi Griff and Count Zero!)
  76. -The Exceptions (Mad Max and ES, sorry about the big confusion I have
  77. caused. I was fooled by some jerks in Irc. Real Mad Max and ES have
  78. NEVER joined The Brainwash Company.)
  79. -friends at school: then, hmallat and owl. 
  80. -Marinos Yannikos (Zork of SOTE) 
  81. -Delta Force (Yo Newmode, Slime, Hackbear, Karl_m and Wizzcat!)
  82. -Irc friends at #atari
  83. -Great mod-composers: Captain, Dr. Awesome, Tip, Firefox, Mantronix,
  84. Uncle Tom, 4mat, Walkman, Romeo Knight and Jesper Kyd.
  85.  
  86. Contact the author for ideas, bug reports, demo stuff etc. via
  87. --------------------------------------------------------------
  88.  
  89. Electronic mail:    eye@niksula.cs.hut.fi (internet)
  90.  
  91. Ordinary mail:        Petri Kuittinen
  92.             Timpurinkuja 1 C 39
  93.             SF-02600 Espoo
  94.             FINLAND
  95.  
  96.