home *** CD-ROM | disk | FTP | other *** search
/ Esprit de Apple Corps / EDAC-2.iso / Sound / MOD.Utilities / SoniqTracker / soniqTEACH next >
Text File  |  1993-04-22  |  12KB  |  115 lines

  1.                 soniqTracker v0.6.2¬
  2.                                                                      Written by Tim Meekins
  3.                                                         Copyright ⌐ 1992,1993 by Tim Meekins
  4.  
  5. Welcome to soniqTracker. soniqTracker is my attempt to fill a void in Apple IIgs music applications. When finished, soniqTracker will be a complete music and instrument editing system using custom music formats. The music editor is currently under construction and is not included with this version. This version of soniqTracker will import Amiga-style
  6. ╥mod╙ songs into soniqTracker's internal format. Also included is a jukebox player and an alarm clock. Future versions will include a music and instrument editor and the ability to import numerous other music formats. The soniqTracker sequencing engine may also become available for use in other programs.
  7.  
  8. This version of soniqTracker is freeware! All donations are accepted, but not required. No, you don╒t need to destroy this program after using it. Give it to all your friends and astound them!
  9.  
  10. User beware! soniqTracker is a fully copyrighted work! If any code from soniqTracker is used without my written permission or any portion of soniqTracker is sold for profit without my written consent, I will prosecute. Don╒t abuse free software! Let╒s push the GS to the 21st century! Stealing free software is stupid.
  11.  
  12. Now, a word from Max:
  13.  
  14. To run soniqTracker, just launch it from your favorite program launcher such as the Finder¬ or Switch-It!¬. You╒ll see a splash screen with the soniqTracker logo after it starts. Press any key or click the mouse button to continue. If you have a weak audio card or a SonicBlaster that can╒t handle the Ensoniq 5503 being pushed to its limits, then lower the volume setting in the ╥Preferences...╙ menu (discussed below). There╒s also potentiometer on the SonicBlaster, when turned to a low setting,. will also remove distortiion. For the ultimate in stereo output, get the SoundMeister card forthcoming from Econ Technologies. soniqTracker will definitely support this hardware in the future.
  15.  
  16. soniqTracker was written by Tim Meekins, but I couldn╒t have done it without the great support of the II community. Kudos to everyone! Also, big applause to Dave Seah for providing some wonderful artwork and the numerous suggestions and attention to detail. Apologies to those not listed, more credits are provided in soniqTracker╒s about screen.
  17.  
  18. First, a description of the menu options:
  19.  
  20. Apple
  21.  
  22. About soniqTracker...
  23.  
  24. Displays a nice picture and cycles through the soniqTracker credits. Let all these people know that you appreciate their help.
  25.  
  26. File
  27.  
  28. Open...
  29.  
  30. Open is used for importing music modules. After selecting this menu, a standard file dialog will be presented. Simply select the song to load, or press the ╥cancel╙ button. Very rarely, soniqTracker will come across a mod file it cannot load and it may get confused. In fact, if you do encounter such a file, please let me know! Songs that are not music modules are also hard to recognize, since the basic NoiseTracker-style module contains no special identification bytes in the file. soniqTracker will do bounds checking and will abort if the file does not appear to be a music module. If you get error $BADD when loading a mod, it isn't mod of the types supported by soniqTrackerl, or, it isn't even a mod.
  31.  
  32. Quit
  33.  
  34. This is probably the most rarely used option, but it was provided as a convenience for some users. This option will quit soniqTracker and return to the launching application.
  35.  
  36. Edit
  37.  
  38. These menu items are not used by soniqTracker and are provided as a convenience for New Desk Accessories.
  39.  
  40. Sound
  41.  
  42. Play Music
  43.  
  44. To begin playing the module, select the ╥Play Music╙ menu option or simply press OA-P.  You╒ll be shown the special player screen and music will begin playing.  In the center of the player screen are the VU meters, representing the approximate volumes of each track during a note trigger. below the VU meter is the song name box. To the right is a numeric display showing the song position number, pattern number, and line number. If a song should have a problem, write down this number approximately where the problem occurred and send it to me -- that way, find and reproducing the problem is much simpler. To the left of the VU meters is a special message box. When you change the player parameters, you╒ll see messages here. Also, if the player encounters an effect in a song it does not handle, it will also display a message here. I support every effect that I have a module to test with, so if you get an unknown effect message, please send me the song so I can support the effect. Above the control panel are the ╥dancing lights╙ and they can be turned off in the preferences dialog box. Turning them off will result in the hidden oscilloscope mode!
  45.  
  46. When a song is being played, the following key commands are available:
  47.  
  48.     option, escape, ╘q╒        stop the song and quit the player
  49.     ╘1╒-╘4╒            toggle tracks ╘1╒ through ╘4╒ on or off
  50.     space            pause the song, press any key to resume, but it will be intrepreted
  51.                                    so pressing ╘q╒ will stop. I recommend pressing ╘return╒
  52.     ╘<╒,╘>╒            decrease or increase the volume
  53.     ╘s╒            tab through each of the stereo modes (see preferences section)
  54.     ╘h╒            toggle between 50Hz and 60Hz
  55.     ╘n╒            skip to next song (see Jukebox Player below)
  56.  
  57. JukeBox Player...
  58.  
  59. This feature combines the ╥Open...╙ and ╥Play Music╙ menu options into a special Jukebox player. After selecting this option, the user is presented with a dialog box. The user can select a single file or multiple files. Selecting more than one file is very simple. Clicking an item selects it. Open-Apple Clicking an item selects adds it to the list of selected items. Open-Apple dragging will select a range of files, and shift-clicking can also select a range. soniqTracker currently limits you to 400 songs (and will take about a day to play through).
  60.  
  61. Also included in the standard file selection dialog box is a checkbox marked ╥Shuffle Songs.╙ Checking this box will randomly shuffle your songs before playing them, this is nice when you have a large collection of songs and don╒t like having the jukebox player always playing them in the same order.
  62.  
  63. Once a list of songs is selected, the JukeBox player will play them one at a time. When the last song is played, it wraps around and begins playing the first song again. 
  64.  
  65. During the JukeBox player, each of the command keys from the player are available, plus, the ╘n╒ key will skip to the next song on the song list.
  66.  
  67. Preferences...
  68.  
  69. This option presents a dialog containing various user preferences that control how soniqTracker works. Below is a description of each option and how or why it should be used or changed.
  70.  
  71. Default Speed
  72.  
  73. This option lets you select between a default 50 Hz or 60 Hz clock rate. Every mod that I know of uses 50 Hz, but due to the nature of the Amiga¬, it is possible that some modules may have been written at 60 Hz. If the song seems too slow at 50 Hz, try setting the default to 60 Hz. Use the ╘h╒ command in the player to adjust the speed while playing.
  74.  
  75. Dancing Lights
  76.  
  77. When playing a song, dots are drawn on the player screen representing the pitch being played on each track. If you do not like this effect, simply uncheck this box. Turning it off will result in the hidden oscilloscope mode.
  78.  
  79. Stereo Mode
  80.  
  81. Music modules are written using stereo effects,  except instruments are played on either the left or right, but not partially on one or the other. This produces a bothersome ╥split╙ in the music. Professionally produced music uses stereo mixing so that even for an instrument that is on the left, it can still be heard faintly on the right. The Stereo Mode option provides soniqTracker with similar stereo mixing. Full Stereo means instruments are played 100% on the left or right. 75% Stereo is 75% volume on the primary channrel (left or right) and 25% on the opposite channel. Similarly for 50% and 25%. These percentages are slightly misleading, though. 25% does not mean 25% on primary, and 75% on the opposite. It should be treated as 100% being full stereo and 0% being mono, therefore, 25% means that the songs is basically played as mono, but the primary channel is 25% louder. Although the terminology is odd, it does make sense and sounds quite well, especially with headphones. Although you may shy away from trying the stereo option, I highly suggest everyone trying the 50% Stereo setting, especially with headphones. It produces a very similar atmosphere like when listening to the radio with headphones. Stereo mixing can also be changes while listening to a song by pressing the ╘s╒ key. Special thanks to James Brookes for suggesting that this option be added to soniqTracker.
  82.  
  83. Volume
  84.  
  85. Select a volume level from 1 to 10, where 1 is very quiet and 10 is good and loud (maybe too loud for some stereo cards). This can also be changed in the player using the ╘>╒ and ╘>╒ keys.
  86.  
  87. Windows
  88.  
  89. Instruments
  90. This window contains a list of instruments used in the song. You can edit instrument names, but can╒t save them yet.
  91.  
  92. soniqAlarm
  93. This window is used for setting up the soniqAlarm¬ option in soniqTracker. This will eventually be accessible from menus besides ╥Windows.╙ Three scroll-bars are used to set the alarm time. Press the button to select a song to be used to  when the alarm is triggered. Once a song is selected, you may activate or deactivate the alarm. soniqAlarm is only activated from the main desktop of soniqTracker, not from the player or about screen. If you activate the alarm and walk away, the screen blanker will kick in and display the current time and alarm time. All alarm parameters are stored in the configuration file. So, if every morning you wake-up at 6:30 AM (eck, gastly hour, but makes a nice example), simply set the alarm to 6:30 AM and activate it. When you quit SoniqTracker, this seting is automatically saved. The next time soniqTracker is run, the alarm is automatically activated if the checkbox was checked. So, continuing with our example, to wake-up every morning at 6:30, simply turn on your Apple IIgs and launch soniqTracker before going to bed. The alarm doesn╒t need to be set, as it╒s ready to go from last time. Since this alarm mode is used mainly at night, Dave Seah has provided a nice night-time pictiure for the screen blanker.
  94.  
  95. Alarm tips: 1. the song is only played once. If you╒re a hard waker, try to find a long song, a loud song, or a song with built-in looping. If anyone really wants a snooze button, let me know, but give me suggestions how you want it implemented. Possibly the spacebar tha pauses could time out after 10 minutes and resume playing... Tip #2: make sure the disk containing the music you selected has been mounted before activating the alarm. A future version of soniqTracker may request that it be mounted.
  96.  
  97.                                                                A note about music modules
  98.  
  99. The music module format originated on the Amiga in the program SoundTracker¬. Additional music players followed such as NoiseTracker¬, ProTracker¬, StarTrekker¬, and numerous others. Along with these additional players came differences in the file format, yet despite the differences, they use identical signature bytes (except StarTrekker) and provide no method for differentiating between them. Luckily, the ProTracker format has gained momentum and the number of modules using features of other players is diminishing. soniqTracker primarily supports ProTracker modules, but does have advanced code for recognizing other formats.
  100.  
  101.  
  102. Those all important addresses:
  103.  
  104. internet: meekins@cis.ohio-state.edu
  105. America Online: GNO Tim2              (gnotim2@aol.com)
  106.  
  107. Or surface mail:
  108.   351 Olema Rd. Apt  #12
  109.   Fairfax, CA 94930
  110.  
  111. If you want to see new and original software produced for the Apple IIgs, contact Procyon, Inc. for more information call:   (303) 933 - 4649.  Be sure to ask Procyon about its software library availble for sale and upcoming releases, including GNO/ME 1.1, Pick-n-Pile, Switch-It!, and Splat!
  112.  
  113. Also, be sure to support Alliance International, Inc. and the European GS project.
  114.  
  115. Do Svidanya!