home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / h / hq_tracker / Manual < prev   
Encoding:
Text File  |  1994-12-16  |  24.5 KB  |  670 lines

  1.                               INTRODUCTION
  2.                               ------------
  3.  
  4.  
  5. The purchase of an Acorn RISC-based micro introduces many powerful
  6. facilities to the user, the most immediate and obvious being the excellent
  7. graphics facilities. Unfortunately, the sound facilities provided are too
  8. often ignored, and whilst other machines work in audio glory, Acorn systems
  9. remain somewhat quieter, simply because comprehensive audio has not been
  10. made easily available.
  11.  
  12. The HQ-Tracker system is a collection of applications designed to increase
  13. the availability of the sound system, to users of all levels. Unlike
  14. previous packages, the HQ-Tracker system (hereafter referred to as just
  15. HQ-Tracker) is a professionally implemented, open-ended system.
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                               INSTALLATION
  22.                               ------------
  23.  
  24.  
  25. RISC OS 3
  26. ---------
  27. Users unfamiliar with the RISC OS 3 operating system may need to refer to
  28. the user manuals. This manual assumes a working knowledge of Acorn RISC OS
  29. computers.
  30.  
  31.  
  32. Making a backup
  33. ---------------
  34. The discs supplied are not copy-protected in any way, and as such users are
  35. advised to make a working backup before proceeding to use the software.
  36.  
  37.  
  38. Installing the software
  39. -----------------------
  40. Once a backup has been made, floppy disc users should use the backup floppy
  41. discs. Users of other media (eg. hard disc users) should create a directory
  42. for HQ-Tracker, and drag all applications from the backup floppy discs to
  43. the newly created directory.
  44.  
  45.  
  46. Using the software
  47. ------------------
  48. Once installed onto the destination media, it is possible to start using the
  49. software immediately. However, it is advisable to at least experiment with
  50. the applications one by one, using this manual and Acorn's !Help application
  51. to assist through the initial learning stages.
  52.  
  53. If problems are encountered first check the availability of the !SystemHQ
  54. folder (see below). If this does not solve the problem, refer to the
  55. trouble-shooting section of this manual (appendix 1).
  56.  
  57.  
  58. The !SystemHQ folder
  59. --------------------
  60. HQ-Tracker applications make use of certain modules. These are stored within
  61. the !SystemHQ folder, which acts similar to the standard !System folder
  62. supplied with all RISC OS computers.
  63.  
  64. When loading an HQ-Tracker application, if the !SystemHQ folder has not been
  65. seen, an error may be reported. If this should happen, open the directory
  66. containing the !SystemHQ folder, and double-click on the !SystemHQ icon
  67. before attempting to re-run any HQ-Tracker applications.
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                           USING HQ-PLAYER
  74.                           ---------------
  75.  
  76.  
  77. Purpose
  78. -------
  79. HQ-Player is a desktop application, designed in the fashion of a CD player,
  80. that allows pre-defined music applications (created by HQ-Tracker or
  81. ST-Ripper) to be played back.
  82.  
  83.  
  84. Loading
  85. -------
  86. To load HQ-Player, double-click on the !HQ-Player icon. After a short while
  87. a window, similar to that shown, will appear. As with HQ-Bars, HQ-Player
  88. does not install an icon on the iconbar.
  89.  
  90.  
  91. In Use
  92. ------
  93. HQ-Player provides a track list. Up to 16 music applications can be dragged
  94. onto the HQ-Player window whereupon, providing there is space available,
  95. they are appended to the track list.
  96.  
  97.  
  98. Managing tracks
  99. ---------------
  100. To view the track list, select the track icon from the window. If tracks
  101. have been installed, a menu will appear, listing these. The currently
  102. selected track is ticked. To alter this, select the required entry. (If the
  103. play icon has been pressed, the currently selected track is stopped before
  104. the new selection is started).
  105.  
  106. To remove the currently selected track, select the eject icon from the
  107. window. If the track is being played, it will be stopped prior to being
  108. removed.
  109.  
  110.  
  111. Playback mode
  112. -------------
  113. HQ-Player offers three modes of playback :
  114.  
  115. • Repeat         Only the selected track is played
  116. • Shuffle        Random tracks are played
  117. • Sequence       All tracks are played in sequence
  118.  
  119. To choose the desired mode of playback, select the mode icon from the
  120. window. A menu will appear listing the three modes, from which it is
  121. possible to select the mode required.
  122.  
  123. With the shuffle and sequence modes, subsequent tracks are selected after a
  124. preset time. This can be altered by selecting the time icon from the window.
  125. A menu will appear displaying the time allocation before the next track is
  126. selected. The lower two menu items may be selected to increase or decrease
  127. the time allocation, by 1 minute intervals.
  128.  
  129.  
  130. Playing music
  131. -------------
  132. To play the currently selected track, select the play icon from the window.
  133. Providing no problems are encountered, the music application will be loaded,
  134. and subsequently played. As with usual music systems, the stop, rewind,
  135. fast-forward and eject icons perform the stated functions.
  136.  
  137. To alter the overall volume of playback, select and hold down the up or down
  138. arrow, situated below the rewind icon.
  139.  
  140. To mute individual voices, select the appropriate voice icon, represented by
  141. a small blue box at the bottom left corner of the window.
  142.  
  143. Quitting
  144. --------
  145. To quit the HQ-Player application, click select on the close icon of the
  146. window.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.                             USING HQ-TRACKER
  153.                             ----------------
  154.  
  155.  
  156. Purpose
  157. -------
  158. HQ-Tracker is the music editing application. The PlayModule software, around
  159. which all HQ-Tracker applications are based, includes a fully-functional
  160. four channel sequencer. HQ-Tracker is an interface for this sequencer.
  161.  
  162.  
  163. Loading
  164. -------
  165. To load HQ-Tracker, double-click on the !HQTracker icon. After a short
  166. while, HQ-Tracker will install an icon on the iconbar.
  167.  
  168.  
  169. In Use
  170. ------
  171. The original design of the HQ-Tracker system was to allow users to
  172. incorporate sounds in their own software. At later stages, to popular
  173. request, a four-track sequencer was introduced. Using this, it is possible
  174. to automate the playing of four channel music with minimal user
  175. intervention, allowing production of soundtracks comparable to most popular
  176. games software.
  177.  
  178. To this extent the HQ-Tracker editor has taken on a form similar to the
  179. popular “tracker” genre, which enforce three simple concepts : instruments,
  180. patterns, and sequences.
  181.  
  182. These concepts are discussed in the following pages, and cover how they
  183. should be applied to the editor itself. Users should, however, be encouraged
  184. to experiment with the editor. Providing backups have been taken, no real
  185. damage is foreseeable.
  186.  
  187.  
  188. Instruments
  189. -----------
  190. An instrument is a sound sample that has been classified (usually by the
  191. !LibMaker application) for use with the HQ-Tracker system. The editor has
  192. slots for a maximum of 32 instruments, and it is the simple process of
  193. sequencing the playback of instruments that ultimately creates music.
  194.  
  195.  
  196. Installing an instrument
  197. ------------------------
  198. To install an instrument, either double-click on its icon, or drag it to any
  199. editor window. Memory permitting, it will be installed into the next
  200. available slot, and become the instrument currently in use. This is
  201. reflected by the main pane displaying the instrument's name. (To see this,
  202. select the editor's icon on the iconbar. The main window will appear, and
  203. the main pane is displayed at the top of this).
  204.  
  205. If the quality of the installed instrument differs to the quality currently
  206. in use, a warning is issued (see the Preferences section later for more
  207. details).
  208.  
  209.  
  210. Selecting an instrument
  211. -----------------------
  212. To choose an alternative instrument for editing purposes, select the
  213. arrow-icon in the main pane. A menu will appear listing all installed
  214. instruments, from which it is possible to make a selection.
  215.  
  216. The instrument may also be renamed by selecting and editing the textual
  217. icon containing the name.
  218.  
  219.  
  220. Removing an instrument
  221. ----------------------
  222. The removal process only affects the instrument currently in use. Bring up
  223. the main menu (by pressing menu over the main editor window), and select
  224. Instrument.Remove.
  225.  
  226. The instrument will be removed, but references to it within music are not
  227. altered. This allows an alternative instrument to be installed in place of
  228. the one just removed. (If music is played, any references to instruments not
  229. installed are simply ignored).
  230.  
  231.  
  232. Editing an instrument
  233. ---------------------
  234. Although instruments have already been classified, it is possible to adjust
  235. three parameters within the editor, if the need should arise. The parameters
  236. are :
  237.  
  238. • Volume            Default volume
  239. • Repeat offset     Offset to start of repeat block
  240. • Repeat length     Extent of repeat block
  241.  
  242. The repeat block simply dictates an area of the sample to be continuously
  243. replayed, once the main sample has been exhausted.
  244.  
  245. Selecting Instrument.Edit from the main menu will bring up the instrument
  246. editing window. The physical interpretation of the instrument's sample
  247. occupies the main area, whilst the lower section displays the three
  248. parameters.
  249.  
  250. The adjacent up/down arrows can be used to adjust the values of the volume
  251. parameter, from 0 (silent) to 127 (maximum volume).
  252.  
  253. The same process applies to the offset and length, which define the repeat
  254. block. Alternatively, by select-dragging the appropriate area on the upper
  255. half of the window, the repeat block can be defined much more efficiently.
  256. The resulting repeat block is highlighted in blue.
  257.  
  258. To listen to the modified instrument, select the Listen icon. If a repeat
  259. block exists, the ESCAPE key must be pressed to stop the instrument being
  260. played.
  261.  
  262. Once satisfied, select the OK icon to close the window.
  263.  
  264.  
  265. Libraries
  266. ---------
  267. With many instruments, it is easy for disorganisation to occur. The
  268. HQ-Tracker system adopts a policy of managing instrument libraries, whereby
  269. instruments may be grouped into common sets, increasing productivity,
  270. particularly when working on large music pieces.
  271.  
  272. The editor has slots for a maximum of 12 libraries.
  273.  
  274.  
  275. Installing a library
  276. --------------------
  277. To install an instrument library, either double-click on its icon, or drag
  278. it to any editor window. Space permitting, it will be installed in the next
  279. available slot. During this process an hourglass will appear whilst the
  280. instruments within the library are categorised. (The time taken depends upon
  281. the number of instruments contained in the library).
  282.  
  283.  
  284. Removing a library
  285. ------------------
  286. Selecting Edit.Libraries from the main menu will produce the library window.
  287. A combination of select/adjust can be used to highlight the required
  288. libraries from the list. Selected libraries become highlighted in red, and
  289. selecting the Remove icon will then remove these from the editor.
  290.  
  291. When satisfied, selecting the OK icon will remove the library window from
  292. the screen.
  293.  
  294.  
  295. Installing from a library
  296. -------------------------
  297. Once libraries have been installed, it is possible to install an instrument
  298. without recourse to searching for them manually, which can be time
  299. consuming. Selecting Instrument.Install from the main menu will cause a
  300. second menu to appear.
  301.  
  302. The top-level of this menu lists all instrument categories, and each
  303. sub-menu contains all instruments that fall under the particular category.
  304. Selecting the desired one will cause the editor to automatically install
  305. this.
  306.  
  307. Note that a number precedes each instrument name. This indicates the library
  308. number it belongs to, (which will, therefore, be a number from 1 to 12).
  309.  
  310.  
  311. Sequences
  312. ---------
  313. The reason why the editor is known as a sequencer is because it relies on a
  314. list that dictates the order in which to replay patterns. (Patterns are
  315. simple blocks of music, covered later).
  316.  
  317. This list is known as the sequence list. To view it, select
  318. Edit.Sequence list from the main menu, bringing up the sequence window.
  319.  
  320. The upper half of the window displays the available functions for the
  321. sequence list, whilst the lower half contains a scrollable pane, displaying
  322. the order of patterns. The currently selected sequence entry is highlighted
  323. in red, and can be altered by selecting the required entry.
  324.  
  325. To remove the selected entry, select the Remove icon; subsequent entries are
  326. re-aligned. To completely clear the sequence list, select the Clear icon.
  327. (Confirmation is first requested if necessary).
  328.  
  329. Inserting a pattern into the sequence list can be performed by selecting the
  330. After or Before icon. The chosen pattern (at the top of the window) is
  331. inserted in the appropriate position. To alter the chosen pattern for
  332. insertion, select the arrow-icon at the top, which produces a list of all
  333. available patterns. Select as appropriate.
  334.  
  335.  
  336. Patterns
  337. --------
  338. The pattern is effectively the simplest building block for sequenced music.
  339. It consists of 64 events, each event containing information for the four
  340. voices.
  341.  
  342. As music is played, the events are stepped through according to the music
  343. speed, and as each event occurs the music information for the four voices is
  344. replayed. When the pattern is exhausted, the sequence list is examined to
  345. find the next pattern to be played, and this process carries on indefinitely.
  346.  
  347.  
  348. Inserting a pattern
  349. -------------------
  350. This is performed by selecting Pattern.Insert from the main menu. Providing
  351. the maximum number of patterns is not exceeded (see the Preferences
  352. section), a new blank pattern will be inserted. This will become the pattern
  353. currently being edited, reflected in the status of the main pane.
  354.  
  355.  
  356. Selecting a pattern
  357. -------------------
  358. By selecting the arrow-icon in the main pane, a menu listing all available
  359. patterns will appear, from which it is possible to alter the one currently
  360. in use.
  361.  
  362.  
  363. Removing a pattern
  364. ------------------
  365. This operation removes the pattern currently in use, and can be performed by
  366. selecting Pattern.Remove from the main menu. If confirmed, the pattern will
  367. be removed, and all references to it in the sequence list are also removed.
  368.  
  369.  
  370. Cloning a pattern
  371. -----------------
  372. This is identical to inserting a pattern, but for the fact that the pattern
  373. currently in use is automatically duplicated into the new pattern. This
  374. operation is performed by selecting Pattern.Clone from the main menu.
  375.  
  376.  
  377. Clearing a pattern
  378. ------------------
  379. This operation completely blanks the pattern currently in use, and is
  380. performed by selecting Pattern.Clear from the main menu.
  381.  
  382.  
  383. Entering notes
  384. --------------
  385. The process of entering notes always uses the instrument currently in use,
  386. and inserts note information into the pattern currently in use. The pattern
  387. data in the main window reflects the four voices as columns, in 64 event
  388. rows.
  389.  
  390. Notes can be entered via the computer keyboard, where the keys relate to
  391. certain note values, and the +/- keys alter the octave in use.
  392. Alternatively, selecting Misc.Show Keyboard from the main menu produces a
  393. small window containing a graphic representation of a synthesizer keyboard,
  394. where notes may be selected more conventionally.
  395.  
  396.  
  397. Moving around
  398. -------------
  399. To gain the block cursor for editing, select the appropriate pattern entry.
  400. A blue block cursor will appear. Every time a note is entered it will be
  401. stored in this position before moving the block cursor to the next entry.
  402.  
  403. To position the block cursor elsewhere, either use the cursor keys, or
  404. reselect the required position in the pattern. To exit the editing mode,
  405. press ESCAPE.
  406.  
  407.  
  408. Octaves
  409. -------
  410. The main pane dictates which octave the notes are based on. To alter this,
  411. select the adjacent arrow-icon. A menu listing the available octaves will
  412. appear, from which it is possible to make a selection.
  413.  
  414.  
  415. Marking an area
  416. ---------------
  417. Operations are available to alter large areas of patterns, as opposed to
  418. just individual notes. The marking of an area requires dictation of the
  419. upper-left, and then lower-right, corners of the area.
  420.  
  421. To do so, move the block cursor to the top-left of the area, and press F6.
  422. Repeat this procedure with the block cursor at the bottom-right of the
  423. desired area, and the newly marked area will become highlighted.
  424.  
  425. Alternatively, if the entire area lies within the visible boundary of the
  426. main window, holding down select at the top-left and dragging the mouse to
  427. the bottom-right corner can be used to mark the required area.
  428.  
  429. Either way, once the area has been marked the following group operations
  430. may be performed…
  431.  
  432.  
  433. Copying
  434. -------
  435. Move the block cursor to the top-left of the area for copying. Selecting
  436. Select.Copy from the main menu will force the marked area to be copied into
  437. the destination area. Care may be needed if the source and destination areas
  438. overlap.
  439.  
  440.  
  441. Moving
  442. ------
  443. This operation is identical to that of copying, except that the source area
  444. is subsequently cleared, with the net effect being that the marked area has
  445. been moved. To perform this operation, select Select.Move from the main
  446. menu.
  447.  
  448.  
  449. Deleting
  450. --------
  451. This operation removes all note information from the marked area, and so
  452. should be used with caution. Use Select.Delete from the main menu to perform
  453. this operation.
  454.  
  455.  
  456. Clearing
  457. --------
  458. To unset the markers that identify the marked area, select Select.Clear
  459. from the main menu.
  460.  
  461.  
  462. Merging
  463. -------
  464. This operation can be used to effectively overlap the information from the
  465. marked area onto that of the destination area. Selecting Select.Merge from
  466. the main menu will perform this operation. Care may be needed if the source
  467. and destination areas overlap.
  468.  
  469.  
  470. Altering the note
  471. -----------------
  472. Selecting Edit.Alter note from the main menu causes the note-editing window
  473. to appear. This allows basic note information in the marked area to be
  474. altered. More specifically, the following three attributes can be modified :
  475.  
  476. • Instrument     Alter instrument
  477. • Note value     Change a note value
  478. • Octave         Change an octave value
  479.  
  480. Each option can be toggled on or off, and the arrow-icons can be used to
  481. select the source/destination values. When satisfied, selecting the OK icon
  482. causes the changes to take place.
  483.  
  484.  
  485. Altering the effects
  486. --------------------
  487. This option functions in the same way as that for altering note information,
  488. and can be utilised by selecting Edit.Alter effect from the main menu.
  489. However, the window allows for differing effects to be applied, and these
  490. are :
  491.  
  492. • Pan from        Stereo positioning
  493. • Volume          Volume control (0-127)
  494. • Speed           Speed changes (1-15)
  495. • Bend by         Pitch bending
  496.  
  497. Again, the individual effects may be toggled on or off, and the arrow-icons
  498. used to alter the desired values. When satisfied, selecting the OK icon
  499. causes the changes to take place.
  500.  
  501.  
  502. Pattern jumping
  503. ---------------
  504. One final effect available is to force a sequence jump. This is performed by
  505. selecting Pattern.Jump from the main menu. The pattern jump window will
  506. appear, from which it is possible to enter the sequence position to be
  507. jumped to.
  508.  
  509. This facility is useful for creating continuous music. For example, to jump
  510. back to the start of the sequence list, a value of 1 would be required.
  511.  
  512. Providing the value entered lies within the bounds of the sequence list, it
  513. will be stored in the pattern, and reflected as a red entry.
  514.  
  515.  
  516. Maintenance
  517. -----------
  518. Having covered the three concepts of sequenced music and their application
  519. to the editor, it should now be possible to experiment in making music. The
  520. only requirement left is to document the general maintenance of music,
  521. covering topics such as file saving and loading, etc.
  522.  
  523.  
  524. Playing
  525. -------
  526. To listen to music in the editor, select Misc.Play Music from the main menu.
  527. The play window will appear, from which it is possible to select the
  528. Play/Stop icons to play/stop the music.
  529.  
  530. The progress of music is continually updated in the window. Toggling the
  531. "From start?" icon dictates whether the music is played from the start of
  532. the sequence list, or from the currently selected entry in the sequence
  533. list (highlighted in red).
  534.  
  535.  
  536. Saving
  537. ------
  538. An editor would not be of much practical use if it did not allow information
  539. to be saved. From the Misc.Save entry of the main menu it is possible to
  540. save the following files :
  541.  
  542. • Application       Entire music application
  543. • Instrument        The current instrument
  544. • Music Data        Pattern data only
  545.  
  546. Music applications can be exported to packages such as !HQ-Player, whilst
  547. the extraction of instruments can be useful for exporting to libraries. The
  548. exporting of music data can be useful when collaborating on large pieces of
  549. music.
  550.  
  551.  
  552. Loading
  553. -------
  554. Music information can be reloaded into the editor. The loading of
  555. instruments has already been covered, leaving the other two to be detailed.
  556.  
  557. A music application can be loaded by double-clicking on its icon, or
  558. dragging it to any editor window. If the current data is unsaved,
  559. confirmation will be required. When loading a music application, if not
  560. enough memory could be allocated, the editor will intelligently try to load
  561. in as much as possible.
  562.  
  563. A music data file can be loaded explicitly, by the same process as above.
  564. The only difference is that with music data files the instruments are
  565. omitted.
  566.  
  567.  
  568. Preferences
  569. -----------
  570. The editor contains a preferences section, where global information on the
  571. status of the music system can be edited. The parameters catered for are :
  572.  
  573. • Voices                  Muting, stereo positions
  574. • Master Controls         Master speed and volume
  575. • Misc                    Quality and patterns
  576.  
  577.  
  578. Making changes
  579. --------------
  580. The Voices section allows each of the four voices to be switched on or off,
  581. and also defines the initial stereo position of each.
  582.  
  583. The Master Controls section allows the initial speed of music to be set, and
  584. also the overall volume of the music system (as a value from 0 to 127).
  585.  
  586. The Misc section contains two items. Quality allows the choice from a range
  587. of sample rates (measured in KHz). These cater for different sound qualities
  588. with high sample rates providing better sounds, but at the expense of speed
  589. and memory. The quality selected should match those of the instruments being
  590. used.
  591.  
  592. The second item is Reserved Patterns. This determines the maximum number of
  593. patterns reserved in the editor, from 1 to 256. The more patterns reserved,
  594. the more memory taken up by the editor. Any changes made to this value will
  595. not take effect until the next time the software is loaded.
  596.  
  597. To save the preferences as default, select the Save icon. To cancel any
  598. changes just made and restore the previous values select the Cancel icon.
  599. To accept the current preferences select the OK icon.
  600.  
  601.  
  602. Music information
  603. -----------------
  604. Available through Misc.Info… from the main menu. This details the memory
  605. usage within the editor, and also states the music title and author, which
  606. may be changed by selecting and editing the appropriate text icon.
  607.  
  608.  
  609. Quitting
  610. --------
  611. To quit the HQTracker application, select Quit from the iconbar menu,
  612. available from the HQTracker icon on the iconbar.
  613.  
  614.  
  615.  
  616.  
  617.  
  618.                              APPENDIX 1
  619.                           TROUBLE-SHOOTING
  620.                           ----------------
  621.  
  622.  
  623. Most problems that arise are reported using non-technical terms. However,
  624. this appendix gives solutions to the more awkward problems that may arise
  625. when using the HQ-Tracker system.
  626.  
  627. PlayModule not resident
  628. This occurs if an HQ-Tracker application is run, and the PlayModule software
  629. has not been installed. Double-click on the !SystemHQ application and try
  630. again. If this does not work, the copy of PlayModule in the !SystemHQ folder
  631. has been removed.
  632.  
  633. PlayModule out of date
  634. An application is being run which requires a later version of the
  635. PlayModule. Contact Mycroft Software for an upgrade.
  636.  
  637. PlayModule not found in the resources
  638. The copy of the PlayModule software, essential to the functioning of the
  639. HQ-Tracker system, has been removed from the !SystemHQ folder. Contact
  640. Mycroft Software for a replacement.
  641.  
  642. OManage not found in the resources
  643. The copy of the OManage software, essential to the functioning of the
  644. HQ-Tracker system, has been removed from the !SystemHQ folder. Contact
  645. Mycroft Software for a replacement.
  646.  
  647. An error occurred whilst saving…
  648. This occurs if storage information has failed to be written, such as when
  649. the preferences in the editor are saved and the disc is write-protected. The
  650. error itself is always accompanied by a description of the disc fault, which
  651. usually states the exact nature of the error.
  652.  
  653. The music has no ‹?›…
  654. This error is reported if a music application is being loaded and does not
  655. contain the exact information required. This is usually due to corruption,
  656. and unless the software can continue loading it, the music application
  657. should be regarded as corrupted.
  658.  
  659. Fatal Error : ‹error› (‹number›)
  660. In the unlikely event of a serious bug in the HQ-Tracker software, the above
  661. error will be reported.
  662.  
  663. If the error occurs before the software has installed itself, the error
  664. report will appear on a black screen. If the software has successfully
  665. installed before the problem occurs, the error will be reported in a
  666. standard error window. In either event, the description of the error should
  667. be noted down, and passed to Mycroft Software for analysis. (A full
  668. description of the machine it occurred on, and the events leading up to the
  669. error, should also be included).
  670.