home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 13 / amigaformatcd13.iso / c / quadraplayer.guide (.txt) < prev    next >
Amigaguide Document  |  1997-02-27  |  14KB  |  324 lines

  1. @DATABASE "QuadraPlayer.guide"
  2. @AUTHOR "Bo Lincoln"
  3. @FONT topaz.font 8
  4. @WORDWRAP
  5. ## $VER: QuadraPlayer.guide v1.2 (23.11.94)
  6. @NODE Main "Main"
  7. @{b}                         QuadraPlayer v 1.2
  8. @{ub}                           By Bo Lincoln
  9.                                    
  10.                     Copyright 
  11.  1994 Bo Lincoln.
  12.                         All rights reserved.
  13. @{b}                        U S E R  M A N U A L
  14. @{ub}
  15. @{"Distribution         " LINK Distribution} @{i}Who can spread and use QuadraPlayer?@{ui}
  16. @{"Requirements         " LINK Requirements} @{i}What do you need to run QuadraPlayer?@{ui}
  17. @{"Windows              " LINK Windows} @{i}The user interface explained...@{ui} :-)
  18. @{"History              " LINK History} @{i}What has been done?@{ui}
  19. @ENDNODE
  20. @NODE Distribution "Distribution"
  21. @TOC Main
  22. @{b}DISTRIBUTION:@{ub}
  23. You are hereby given permission to distribute the
  24. QuadraPlayer v1.2 and this manual, as long as you DON'T take any fee 
  25. for the program itself, only the costs for the media itself.
  26. @{b}FREEWARE:@{ub}
  27. QuadraPlayer is freeware, so you may use it and copy it as long as you
  28. follow the rules above. (You could always send me something if you like
  29. it... ;-) )
  30. @{b}COPYRIGHTS:@{ub}
  31. QuadraPlayer is Copyright 
  32.  1994 Bo Lincoln.
  33. QuadraPlayer makes use of reqtools.library for the requesters.
  34. ReqTools is Copyright 
  35.  Nico Fran
  36. Amiga is a registered trademark of Commodore-Amiga Inc.
  37. @{b}DISCLAIMER@{ub}
  38. (Don't blame me...)
  39.    THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  40. APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  41. HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  42. OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  43. THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  44. PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  45. PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
  46. COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  47.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  48. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  49. PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  50. GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  51. USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
  52. OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
  53. THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  54. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  55. POSSIBILITY OF SUCH DAMAGES.
  56. @{b}THE AUTHOR:@{ub}
  57. SnailMail:  Bo Lincoln
  58.             Rydsv
  59. gen 246 A:23
  60.             S-582 51 LINK
  61.             SWEDEN
  62. Email:      d94bosli@isy.liu.se
  63. @ENDNODE
  64. @NODE Requirements "Requirements"
  65. @TOC Main
  66. @{b}REQUIREMENTS:@{ub}
  67. What you need to run QuadraPlayer v1.2:
  68. * An Amiga 500(+), 600, 1000, 1200, 2000, 2500, 3000 or 4000 with
  69.   at least kickstart 2.0 installed.
  70. * "diskfont.library", "reqtools.library" and "gadtools.library".
  71. * Some nice modules.
  72. * Luck. (No no no, just kidding).
  73. @ENDNODE
  74. @NODE Windows "Windows"
  75. @TOC Main
  76. @{b}WINDOWS:@{ub}
  77. (What @{i}does@{ui} that button mean?)
  78.      @{b}QuadraPlayer v1.2@{ub}
  79.     +----------------------------------------------+
  80.     |@{"Pick..." LINK w_Pick}@{"Modlist..." LINK w_ModList}@{"PopCorny.EMOD " LINK w_ModName}@{"<" LINK w_NextPrev}@{">" LINK w_NextPrev}@{"Iconify" LINK w_Iconify}|
  81.     |@{"       Play module    " LINK w_PlayMod}@{"    Loop Position     " LINK w_LoopPos}|
  82.     |@{"          Stop        " LINK w_StopMod}@{"      Options         " LINK w_Options}|
  83.     |Position @{"      |                          |<>" LINK w_Pos}|
  84.     |Position: 7 / 55  Time 1:16 / 6:43            |
  85.     |+-------------------------++-----------------+|
  86.     ||@{" VU-Meters  " LINK w_VUMeters}@{" Monoscope " LINK w_MonoScope}||        |||||||| ||
  87.     ||@{"Spectrascope" LINK w_SpectraScope}@{" Analyzer  " LINK w_Analyzer}||ChanVol:|||||||| ||
  88.     |+-------------------------++-----------------+|
  89.     +----------------------------------------------+
  90. @ENDNODE
  91. @NODE w_Pick "Pick..."
  92. @TOC Windows
  93. @{b}PICK@{ub} @{i}Main Window@{ui}
  94. Displays a file requester, in which you can choose one or more 
  95. modules to play. One of the choosen modules will be loaded.
  96. The modules will be added to / replace the @{"module list" LINK w_ModList}.
  97. (This depending on the settings of @{"Choosen Module" LINK ow_ChoosenMod}).
  98. @ENDNODE
  99. @NODE w_ModList "Module List..."
  100. @TOC Windows
  101. @{b}MODULE LIST@{ub} @{i}Main Window@{ui}
  102. This is a window displaying the names of the modules in the current
  103. module list. The module list is saved in the prefs file, see
  104. @{"Save Prefs" LINK ow_Save}. Some modules will have the name of the song attached
  105. to the file name, this if you have choosen @{"Load Name" LINK ow_ChoosenMod} in the
  106. options window.
  107. To choose a module in the list, double click on it.
  108. If you want to rearrange the module list, use the buttons in the
  109. bottom of the window.
  110. The module list contains info about filename, path and (optionally) module
  111. name.
  112. @ENDNODE
  113. @NODE w_ModName "Module Name"
  114. @TOC Windows
  115. @{b}MODULE NAME@{ub} @{i}Main Window@{ui}
  116. This displays the name of the current module.
  117. If you type a module file name here it will be treated as if you
  118. chose it in the @{"Pick" LINK w_Pick} requester.
  119. @ENDNODE
  120. @NODE w_NextPrev "Next (Previous) Module"
  121. @TOC Windows
  122. @{b}NEXT (PREVIOUS) MODULE@{ub} @{i}Main Window@{ui}
  123. This will pick the next (previos) module in the @{"Module List" LINK w_ModList}.
  124. If you have chosen @{"Random" LINK ow_NewMod} in the @{"Options" LINK w_Options} window, it doesn't
  125. matter which button you press.
  126. @{i}Shortkey:@{ui} If a QuadraPlayer window is active, press right, enter
  127. or down for next module and up or left for previous module.
  128. You can always use the @{"Shortkeys" LINK ow_ShortKeys} defined in the
  129. @{"Options" LINK w_Options} window.
  130. @ENDNODE
  131. @NODE w_Iconify "Iconify"
  132. @TOC Windows
  133. @{b}ICONIFY@{ub} @{i}Main Window@{ui}
  134. This button will remove the main window and put a little icon on
  135. the workbench. To open the window again, double click on the icon
  136. or use the @{"Shortkeys" LINK ow_ShortKeys} defined in the @{"Options" LINK w_Options} window.
  137. @ENDNODE
  138. @NODE w_PlayMod "Play Module"
  139. @TOC Windows
  140. @{b}PLAY MODULE@{ub} @{i}Main Window@{ui}
  141. Starts playing the current module at the current position.
  142. @{i}Shortkey:@{ui} If a QuadraPlayer window is active, press right alt.
  143. @ENDNODE
  144. @NODE w_LoopPos "Loop Position"
  145. @TOC Windows
  146. @{b}LOOP POSITION@{ub} @{i}Main Window@{ui}
  147. Loops the current position.
  148. @{i}Shortkey:@{ui} If a QuadraPlayer window is active, press right amiga.
  149. @ENDNODE
  150. @NODE w_StopMod "Stop Module"
  151. @TOC Windows
  152. @{b}STOP MODULE@{ub} @{i}Main Window@{ui}
  153. Stops the module.
  154. @{i}Shortkey:@{ui} If a QuadraPlayer window is active, press space.
  155. @ENDNODE
  156. @NODE w_Options "Options"
  157. @TOC Windows
  158. @{b}OPTIONS@{ub} @{i}Main Window@{ui}
  159.      @{b}QuadraPlayer Options@{ub}
  160.     +--------------------------------------------------------+
  161.     |+--------------------------------------++--------------+|
  162.     || Fade Out Time @{" |" LINK ow_FadeTime} MonoScope Acc. @{"  |" LINK ow_MonoAcc}||@{"   Screen    " LINK ow_Screen}||
  163.     ||  Fade In Time @{"| " LINK ow_FadeTime} Analyzer Speed @{"|  " LINK ow_AnSpeed}||+------------+||
  164.     |+--------------------------------------+||            |||
  165.     |+--------------------------------------+|+------------+||
  166.     || @{"   New Module  " LINK ow_NewMod} @{" At Module End    " LINK ow_AtModEnd} |+--------------+|
  167.     || (O)              | |                 |+--------------+|
  168.     || (O)                                  ||              ||
  169.     ||                                      ||              ||
  170.     || @{"   At startup  " LINK ow_AtStartup} @{"Choosen Module(s) " LINK ow_ChoosenMod} ||              ||
  171.     || | |              (O)       | |       ||  @{"Colours" LINK ow_Colours}    ||
  172.     || | |              (O)                 ||              ||
  173.     ||                  (O)                 ||              ||
  174.     |+--------------------------------------+|              ||
  175.     |+--------------------------------------++--------------+|
  176.     || Next Mod  Prev Mod  Window  Mod List |                |
  177.     ||@{"|        ||        ||      ||       |" LINK ow_ShortKeys}| @{"  About...   " LINK ow_About} |
  178.     |+--------------------------------------+                |
  179.     |@{"        Save       " LINK ow_Save}@{"      Use       " LINK ow_Use}@{"     Cancel       " LINK ow_Cancel}|
  180.     +--------------------------------------------------------+
  181. @{i}Shortkey:@{ui} If a QuadraPlayer window is active, press "o".
  182. @ENDNODE
  183. @NODE ow_FadeTime "Fade Time"
  184. @TOC w_Options
  185. @{b}FADE TIME@{ub} @{i}Options Window@{ui}
  186. This is where you set the time of the fade in / fade out when
  187. a new module is loaded. :*)
  188. @ENDNODE
  189. @NODE ow_MonoAcc "MonoScope Accuracy"
  190. @TOC w_Options
  191. @{b}MONOSCOPE ACCURACY@{ub} @{i}Options Window@{ui}
  192. This number is sets how many dots will be plotted per voice per frame
  193. in the monoscope.
  194. @ENDNODE
  195. @NODE ow_AnSpeed "Analyzer Speed"
  196. @TOC w_Options
  197. @{b}ANALYZER SPEED@{ub} @{i}Options Window@{ui}
  198. This is where you set the speed of the analyzer scrolling. 
  199. @ENDNODE
  200. @NODE ow_NewMod "New Module"
  201. @TOC w_Options
  202. @{b}NEW MODULE@{ub} @{i}Options Window@{ui}
  203. (O) Next in list         <- When a new module is picked it will be in
  204.                             module list order...
  205. (O) Random               <- ...or in random order.
  206. @ENDNODE
  207. @NODE ow_AtModEnd "At Module End"
  208. @TOC w_Options
  209. @{b}AT MODULE END@{ub} @{i}Options Window@{ui}
  210. | | Load New             <- When the last position is reached,
  211.                             a new module will be loaded.
  212. @ENDNODE
  213. @NODE ow_AtStartup "At Startup"
  214. @TOC w_Options
  215. @{b}AT STARTUP@{ub} @{i}Options Window@{ui}
  216. | | Load Module          <- Loads a module from the list when
  217.                             QuadraPlayer is started.
  218. | | Start Iconified      <- Startup with the main window iconified.
  219. @ENDNODE
  220. @NODE ow_ChoosenMod "Choosen Module(s)"
  221. @TOC w_Options
  222. @{b}CHOOSEN MODULES@{ub} @{i}Options Window@{ui}
  223. (O) Add To List          <- Adds the picked module(s) to the
  224.                             current module list.
  225. (O) Replace List         <- Replace the current list with the
  226.                             picked module(s).
  227. (O) Play Separately      <- If only one module is picked, it will
  228.                             not affect the module list, but it
  229.                             will be played.
  230. | | Load Name            <- When modules are picked, the names of
  231.                             the modules (not only the filenames) 
  232.                             will be read. @{i}Note:@{ui} This function
  233.                             may be very slow...
  234. @ENDNODE
  235. @NODE ow_ShortKeys "Shortkeys"
  236. @TOC w_Options
  237. @{b}SHORTKEYS@{ub} @{i}Options Window@{ui}
  238. These shortkeys works globally on your Amiga:
  239. Next Mod                 <- The shortkey for load next module.
  240. Prev Mod                 <- The shortkey for load prev module.
  241. Window                   <- The shortkey to open the main window.
  242. Mod List                 <- The shortkey to open the module list window.
  243. @ENDNODE
  244. @NODE ow_Screen "Screen"
  245. @TOC w_Options
  246. @{b}SCREEN@{ub} @{i}Options Window@{ui}
  247. This is a list of all the available public screens on your Amiga.
  248. If you pick one, the QuadraPlayer windows will be moved to that one
  249. when "Use" or "Save" is pressed.
  250. @ENDNODE
  251. @NODE ow_Colours "Colours"
  252. @TOC w_Options
  253. @{b}COLOURS@{ub} @{i}Options Window@{ui}
  254. Here you can set the colour settings for the sample display windows.
  255. @ENDNODE
  256. @NODE ow_About "About"
  257. @TOC w_Options
  258. @{b}ABOUT@{ub} @{i}Options Window@{ui}
  259. Displays an about requester.
  260. @ENDNODE
  261. @NODE ow_Save "Save"
  262. @TOC w_Options
  263. @{b}SAVE@{ub} @{i}Options Window@{ui}
  264. Saves the current settings to the file "ENVARC:QuadraPlayer.prefs".
  265. If you have a module list it will be saved, too.
  266. @ENDNODE
  267. @NODE ow_Use "Use"
  268. @TOC w_Options
  269. @{b}USE@{ub} @{i}Options Window@{ui}
  270. Keeps the option changes.
  271. @ENDNODE
  272. @NODE ow_Cancel "Cancel"
  273. @TOC w_Options
  274. @{b}CANCEL@{ub} @{i}Options Window@{ui}
  275. Cancels all actions in the options window.
  276. @ENDNODE
  277. @NODE w_Pos "Position Slider"
  278. @TOC Windows
  279. @{b}POSITION SLIDER@{ub} @{i}Main Window@{ui}
  280. This slider shows the current module position. You move around the
  281. slider to set a new module position.
  282. Below this slider there is a text field which displays the current
  283. position number, and the time in the beginning of the position.
  284. @ENDNODE
  285. @NODE w_VUMeters "VU-Meters"
  286. @TOC Windows
  287. @{b}VU-METERS@{ub} @{i}Main Window@{ui}
  288. Displays a window containing two (left, right) vu-meters.
  289. @ENDNODE
  290. @NODE w_SpectraScope "SpectraScope"
  291. @TOC Windows
  292. @{b}SPECTRASCOPE@{ub} @{i}Main Window@{ui}
  293. Displays a window containing a spectrum analyzer. It is @{b}not@{ub} a
  294. FFT analyzer, but it works allright anyway.
  295. @ENDNODE
  296. @NODE w_MonoScope "MonoScope"
  297. @TOC Windows
  298. @{b}MONOSCOPE@{ub} @{i}Main Window@{ui}
  299. Displays a window containing a "MonoScope".
  300. A lot of people keep asking how this effect is created, and I can
  301. tell you that it is @{b}very@{ub} simple. But, if you can't figure
  302. it out anyway, you'll have to ask me... %-)
  303. @ENDNODE
  304. @NODE w_Analyzer "Analyzer"
  305. @TOC Windows
  306. @{b}ANALYZER@{ub} @{i}Main Window@{ui}
  307. This is a 256 point FFT analyer, displayed in 2D or "3D". If you
  308. make the window bigger, the filter curve will be scrolled.
  309. @ENDNODE
  310. @NODE History "History"
  311. @TOC Main
  312. @{b}HISTORY:@{ub}
  313. Ver:    Changes:
  314. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  315. 1.0        First public release.
  316. 1.1        Fixed @{b}LOTS@{ub} of bugs.
  317.         Added module list.
  318. 1.2        Added analyzer.
  319.         Fixed "load module name" bug. It is now much
  320.         faster...
  321.         Fixed an add module bug / feature. Now one of the dropped /
  322.         picked modules is played, instead of one in the list.
  323. @ENDNODE
  324.