home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / dos / tools / sjgpl120 / sjgplay.doc < prev    next >
Text File  |  1995-07-30  |  64KB  |  1,420 lines

  1. SJGPLAY DOCUMENTATION      Version: 1.20               (C)1995 Steve J. Gray
  2. =====================      Revised: Jul 30, 1995       =====================
  3.  
  4. Welcome to SJGPLAY: The Audio CD Player with Lyrics!
  5.  
  6. SJGPLAY is FREEWARE, which means:
  7.  
  8.     You may use it without payment of any kind. However, I retain full 
  9.     copyrights to the program. You may not modify, sell, or use it for 
  10.     commercial purposes. You may include it in FREEWARE/SHAREWARE 
  11.     compilations provided all files and documentation are included and 
  12.     un-modified (I'd appreciate being informed if you plan to include 
  13.     SJGPLAY on a CD-ROM. I'd accept a free copy of any CD containing 
  14.     SJGPLAY too... Hey, it's worth a try :-)
  15.  
  16. That said... If you use this program I'd like to hear your comments or 
  17. suggestions (tell me your most and least favorite feature). I can be reached 
  18. via e-mail at: sgray@acs.ryerson.ca
  19.  
  20.   Included in the archive is SAMPLES.ZIP which contains data files for most 
  21. of my personal CD collection as well as over 90 songs. (Note: Maintenance 
  22. releases may not include the SAMPLES.ZIP file). I hope you'll find some you 
  23. can use.. It may save you some typing and let you see the lyrics features in 
  24. action. Use the catalog (F7) feature to see which CD's are included in the 
  25. sample data. Feel free to delete the CD's you don't need. If you find we have 
  26. some CD's in common how 'bout typing and sync'ing the missing lyrics from the 
  27. sample CD's. If you e-mail them to me or send them to me on disk I can 
  28. include them in future revisions of the program. 
  29.  
  30. My snail-mail address is:  
  31.  
  32.   Steve Gray
  33.   10 Crestview Ave.,
  34.   Brampton, Ontario
  35.   Canada  L6W-2R6
  36.  
  37.  
  38. DISCLAIMER
  39. ==========
  40.  
  41.   Since I wrote SJGPLAY for my own pleasure, and I'm not asking for any
  42. money, please don't expect support of any kind. I will try to fix any bugs
  43. that pop up, but since I don't own every combination of CD-ROM drive and
  44. computer I may not be able to do anything if it doesn't work properly on
  45. your system.
  46.  
  47.   If you want to report a bug please try to include the following information
  48. when you e-mail me:
  49.  
  50.   * SJGPLAY version
  51.   * CD-ROM drive and interface (SoundBlaster, SCSI, EIDE, propietary, etc)
  52.   * DOS and MSCDEX version
  53.   * CPU type or any other hardware you think might be causing problems
  54.  
  55.   SJGPLAY works on my system and on several systems at work. All CD-ROM
  56. manipulation is handled by the (registered shareware) "Audio CD Toolkit"
  57. library by DSE SOFTWARE PUBLISHING and uses MSCDEX to interface to the 
  58. CD-ROM unit.
  59.  
  60.   SJGPLAY is provided as is. The author shall not be liable for any damages
  61. resulting in use or misuse of this program including... Hey, I'm no lawyer,
  62. you know the routine...
  63.  
  64.  
  65. INTRODUCTION
  66. ============
  67.  
  68.   You've probably heard this before but... I've tried several other CD audio
  69. player programs and none of them had all the features I wanted. I tried both
  70. DOS and WINDOWS programs but wasn't impressed. I figured I could do better,
  71. but until ACDKIT from DSE came along I couldn't do anything about it.
  72.  
  73.   Have you ever noticed that most shareware programs are ugly? The screens
  74. are all cluttered and confusing. They use weird background characters and
  75. fancy pop-up boxes with shading and the colors overwhelm you. Well, not
  76. SJGPLAY! It's uncluttered and clean. You can even remove most of the display
  77. information if you want to. You only see what you want to see and the
  78. controls are intuitive (usually the first letter of the function). There is a
  79. built-in help screen available any time if you need it, but once you're
  80. comfortable with the controls you'll never need it again. I believe in
  81. functionality not window-dressing...
  82.  
  83.   I've always favoured DOS more than WINDOWS. I think everybody should be
  84. able to use my program and DOS is the common denominator. Even older PC's
  85. should be able to run SJGPLAY without any problems. SJGPLAY will also run
  86. (as a DOS application) under WINDOWS. See your Windows manual for information
  87. on how to install DOS applications on your desktop (I like to run SJGPLAY in
  88. a window).
  89.  
  90.  
  91. FEATURES
  92. ========
  93.  
  94.   SJGPLAY has most, if not all, of the features you will ever need in a CD
  95. audio player. I've tried to incorporate all the features I could think of,
  96. while keeping in mind the limitations of DOS text-mode. I'm open to
  97. suggestions if you can think of anything that could be added (see Ideas for
  98. future versions). I've tried to make it easy to use, so almost no
  99. documentation is required (but here it is anyway :-). Hope you like it!
  100.  
  101. * Mouse control of most functions
  102.     - Three Button-Bars for easy mouse control (click the plus-minus symbol)
  103.  
  104. * Track controls
  105.     - Play, Pause/Continue, Stop
  106.     - Next/Previous Track (skip)
  107.     - Play specified track (you must enter a two-digit track number)
  108.     - Fastforward/Reverse search (plus 2 times and one-minute search)
  109.     - Re-Start track
  110.     - Jump to near end of track
  111.  
  112. * Repeat Modes
  113.     - Repeat Track
  114.     - Repeat CD
  115.     - Repeat CD's in all Drive Units
  116.     - Single play tracks (stop after each track)
  117.     - A/B segment repeat
  118.  
  119. * Intro Mode
  120.     - Play first few seconds (adjustable) of each track
  121.  
  122. * Time Display
  123.     - Elapsed/Remaining track time
  124.     - Elapsed/Remaining CD time
  125.     - Track/Remaining frame# (used for lyric synchronization)
  126.  
  127. * CD Cataloging
  128.     - CD Name and Artist
  129.     - Track names
  130.     - Automatic recognition of CD
  131.     - Catalog CD's, Lyrics or Albums files
  132.           * Delete, Edit, Sort, Print
  133.  
  134. * Programming (playlist)
  135.     - Up to 99 steps
  136.     - Playlist saved for each individual CD
  137.     - Insert/Delete steps
  138.     - Clear All/Use All tracks
  139.     - Edit playlist WHILE CD is being played
  140.     - Shuffle (jumble) tracks
  141.     - Select only tracks with lyrics
  142.     - Program pauses
  143.     - Fit to tape length (insert pauses at the appropriate spots)
  144.     - Toggle programmed or standard play (track order)
  145.  
  146. * Lyrics
  147.     - Built-in text editor for lyric entry (autosave)
  148.           * Memorize/Recall/Paste/Restore/Erase line
  149.           * Insert/Delete line
  150.           * Block Define/Copy
  151.           * Track control during editing (pause/reverse/fastforward/replay)
  152.     - Easy synchronization process
  153.     - Fine-tune synchronization
  154.     - Synchronized playback of lyrics
  155.           * Paged style
  156.           * Karaoke-style (with next-line display)
  157.     - Lyric "traffic light" (prepares you for the next line)
  158.     - Lyrics stay sync'd during fastforward, reverse or pause
  159.     - Import (extract)/Export lyrics from/to "Album files"
  160.     - Rename lyric files (if an external editor was used)
  161.  
  162. * Display
  163.     - CD and Track Title
  164.     - Status (playing/paused/open etc)
  165.     - Large track number and time indicator
  166.     - Total CD time, Drive unit, Volume
  167.     - Intro, Program Mode, Step#, Repeat mode
  168.     - Track percentage and total time
  169.     - Elapsed "time-bar" and frame-blip (those green divider lines...)
  170.     - Time of day clock
  171.     - Full-screen mode
  172.     - 25/43/50 line video modes
  173.  
  174. * Large "Mode" Window
  175.     - Track list or playlist
  176.     - CD Information
  177.     - Paged and Karaoke style Lyrics
  178.     - Large display of track name or CD title
  179.     - Catalog: CD, Lyric or Album files
  180.     - Configuration and Program Info
  181.     - Simulated Spectrum Analyzer (requires SoundBlaster)
  182.     - Waveform Scope (requires SoundBlaster)
  183.  
  184. * Printing
  185.     - Print CD Info, CD's, Lyrics, or Album Catalog
  186.  
  187. * Device Control
  188.     - Supports multiple CD-ROM drive units
  189.     - Reset drive
  190.     - Volume control via SoundBlaster (CD input or master)
  191.     - Eject/Close CD tray
  192.  
  193. * Miscellaneous Stuff
  194.     - Timed event based on time of day clock
  195.           * Display a message, Play a track, Switch display modes
  196.     - Display mode Timer
  197.           * Rotates between selected display modes
  198.  
  199. * Configuration
  200.     - Initial display mode and full-screen mode
  201.     - Auto edit new CD info
  202.     - Auto playback
  203.     - Stop or Eject on program exit
  204.     - Define alternate video mode
  205.     - Define fastforward/reverse and intro time
  206.     - Define volume control device
  207.     - Set initial repeat mode
  208.     - Full control while configuration displayed
  209.     - Configuration saved as a text file
  210.     - Environment variable "SJGPLAY" to define data-file and config-file
  211.       location (run SJGPLAY.EXE from anywhere if in PATH)
  212.  
  213. * Command-line mode
  214.     - Select an alternate config file
  215.     - Check for presence of disc
  216.     - Control playback of CD's through batch files
  217.           * Play, Stop, Eject, Next/Previous track, Single play
  218.     - Displays CD information:
  219.           * Track List, CD title, track title, elapsed time
  220.     - Conditional control of command-line arguments
  221.  
  222. * Help
  223.     - Built-in Help screen and Utility Help
  224.     - Full control while help displayed
  225.     - Intuitive controls
  226.  
  227. * And the best feature...
  228.     - It's free! No more guilty conscience for not sending in that
  229.       shareware registration :-)
  230.  
  231.  
  232. RUNNING THE PROGRAM
  233. ===================
  234.  
  235.   The only file that is REQUIRED is SJGPLAY.EXE. If no configuration file
  236. is found, built-in defaults will be used. The program will search the current
  237. directory when looking for the configuration file (SJGPLAY.CFG), CD Info 
  238. files (CD{idnum}.CD) and lyric files (CD{idnum}.{tracknum}) UNLESS a path is 
  239. set via the SJGPLAY environment variable (see below) or in an alternate 
  240. config file as specified by "CONFIG:" on the command line.
  241.  
  242.   If you want to place SJGPLAY.EXE in another location and still be able to
  243. find your lyrics and CD info files you must add the following line to your
  244. AUTOEXEC.BAT file:
  245.  
  246.         SET SJGPLAY={path}
  247.  
  248.              where {path} is the complete path to your files.
  249.              For example: SET SJGPLAY=C:\UTILS\SJGPLAY
  250.  
  251.   If you don't use the above method then you will need to change into the
  252. proper directory first by using the CD (change directory) command. For
  253. example: CD \UTILS\SJGPLAY
  254.  
  255.   To start the program simply type: SJGPLAY
  256.  
  257.   If you want to specify an alternate configuration, conditionally run the
  258. program, or control CD's via batch files see the section titled "Command-line 
  259. arguments"
  260.  
  261.  
  262. DATA FILES
  263. ==========
  264.  
  265.   All data files are strictly text-based. Filenames are constructed using a
  266. number based on the total number of FRAMES on a CD. A frame is 1/75th of a
  267. second in length. Most CD's should have a unique number of frames which
  268. allows the program to automatically use the correct data files. We'll call
  269. this number {idnum} from now on. The largest this number can be is about
  270. 351,000 (78 minutes * 60 seconds/min * 75 frames/sec).
  271.  
  272.   The CD Title and Track titles are stored as plain text in a file with the
  273. format: CD{idnum}.CD (example: CD123456.CD).
  274.  
  275.   Lyrics and synchronization data are stored as plain text in a file with the
  276. format: CD{idnum}.{tracknum}, where {tracknum} is a three digit number
  277. corresponding to the specific track (example: CD123456.001).
  278.  
  279.   Album files, which contain lyrics for an entire album in one file, are 
  280. stored as plain text in a file with the format: CD{idnum}.ALB
  281.  
  282. Why text files?
  283. ---------------
  284.  
  285.   Every time I tried a new CD player program I had to re-enter each CD since
  286. they all seemed to have their own format for storing their database info.
  287. I wanted my program to be able to read standard text files so that data can
  288. easily be shared with other programs. Textfiles are universal so CD info and
  289. lyrics can easily be sent electronically and people can share their stuff.
  290. There are sites on the internet that contain lyrics files, so you might be
  291. able to download (ftp) them instead of re-typing them.
  292.  
  293.   I'm hoping people will start to distribute synchronized lyrics. They don't
  294. add too much to the size of the file and the files are still readable for
  295. those who don't have a CD-ROM player. 
  296.  
  297.   The only drawbacks to text files are that they take up a lot of harddrive
  298. space (especially drives with large sector sizes) and they tend to clutter
  299. up the directory (If this is a problem I may consider changing this). 
  300.  
  301.   If/when you've typed in the lyrics for a complete album you can replace all 
  302. the individual lyrics files with one big "Album" file (see the utilities 
  303. section). This should clear up some of the clutter and reduce the space
  304. requirements on your hard drive.
  305.  
  306.  
  307. SCREEN LAYOUT
  308. =============
  309.  
  310. The screen is divided into three sections...
  311.  
  312. The top section:
  313.  
  314.    Displays the CD title and Track title. On the right is the current
  315. time-of-day and status. The status displays whether the CD is paused or
  316. playing or if the CD tray is open. It will also indicate when you are in
  317. SYNCHRO mode, FINETUNE mode, or which line you are editing in EDIT mode.
  318. When full-screen mode is enabled the time-of-day will be replaced by a
  319. "H=Help" message. The top and middle sections are divided by a green line
  320. with a travelling "frame-blip" which zips across the line when the CD is
  321. being played. If you have a mouse you can click on the "plus/minus" symbol
  322. and change this to mouse button-bars.
  323.  
  324. The middle section:
  325.  
  326.   This is where all the action is. It is used to display or edit various
  327. information as selected by the current mode. The current display mode name is
  328. displayed in the bottom section (if enabled) at the very bottom right of the
  329. screen.
  330.  
  331. The bottom section:
  332.  
  333.   Displays all the track, time and mode information. Dividing the middle and
  334. bottom sections is the green time-bar indicator which shows elapsed track
  335. progress. Below is the track number and time indicator using large digits. To
  336. the right of the time display is the time mode indicator, indicating elapsed
  337. or remaining time for either the track or entire CD. If program mode is
  338. enabled the step# will be displayed to the left of the track number. On the
  339. right side of this section is the total CD time, current drive unit, elapsed
  340. track percentage, repeat mode and the current display mode.
  341.  
  342.   When full-screen mode is enabled the bottom section is not displayed.
  343.  
  344.  
  345. KEYBOARD CONTROLS
  346. =================
  347.  
  348.   Selecting Display Modes:
  349.   ------------------------
  350.     F1 to F12 .....Select specific Mode (see display modes)
  351.     TAB or M ......Go to the next mode (F1 to F6 only)
  352.     SHIFT-TAB .....Go to the previous mode
  353.     H .............Display Help screen
  354.     F .............Toggle Full-screen mode
  355.     V .............Toggle alternate Video mode (VGA cards only)
  356.  
  357.   Selecting Other Modes:
  358.   ----------------------
  359.     I .............Toggle Intro mode
  360.     T .............Cycle time display:
  361.                      * Elapsed, Remaining, Elapsed CD, Remaining CD
  362.                      * Track Frame#
  363.     E .............Edit information (depends on current mode)
  364.     ? .............Print information (depends on current mode)
  365.     DEL ...........Delete information (depends on current mode)
  366.     
  367.   Playing Tracks:
  368.   ---------------
  369.     P or ENTER ....Play current track
  370.     0 to 9 ........Play specified track number. Must be two digits!
  371.     + or - ........Next Track or Previous track
  372.     S or PERIOD ...Stop track (if stopped, jumps to start of playlist)
  373.     SPACE .........Pause/Resume playback
  374.  
  375.   Track Shuttle:
  376.   --------------
  377.     LEFT/RIGHT ....Reverse/Fastforward
  378.     UP/DOWN .......Reverse/Fastforward times 2
  379.     PAGEUP/DOWN ...Reverse/Fastforward one minute
  380.     HOME ..........Re-start track
  381.     END ...........Jump to near end of track
  382.  
  383.   Special Track Shuttle:  (while in edit, program or configuration mode)
  384.   ----------------------
  385.     ALT-LEFT .........Reverse
  386.     ALT-RIGHT ........Fast Forward
  387.     ALT or CTRL-UP....Pause/Resume playback
  388.     ALT or CTRL-DOWN..Re-start track
  389.  
  390.   Repeat Modes:
  391.   -------------
  392.     R .............Cycle Repeat mode (or cancel A/B repeat)
  393.                      * One ......Repeat selected track
  394.                      * Single ...Stop after end of track (P to play next)
  395.                      * All ......Repeat entire CD
  396.                      * Drives ...Repeat all CD's in all CD-ROM drives
  397.     A or B ........Set A or B repeat points
  398.  
  399.   Programming:
  400.   ------------
  401.     G .............Toggle program mode
  402.     CURSOR KEYS ...Move Marker
  403.     DEL ...........Delete step under marker
  404.     BACKSPACE .....Delete step to left of marker
  405.     0 to 9 ........Insert specified track number. Must be two digits!
  406.     J .............Jumble Tracks (random shuffle)
  407.     C .............Clear ALL tracks (if clear, reset to all tracks)
  408.     L .............Load playlist as saved with CD info file
  409.     W .............Write (save) playlist to CD info file
  410.  
  411.   Utilities:
  412.   ----------
  413.     U .............Display Utility Help screen
  414.     Z .............Set Event
  415.     D .............Set Display Timer
  416.     ! .............Renames files with specified {name} to the proper {idnum}
  417.     @ .............Renames files with {idnum} of 000000 to the proper {idnum}
  418.     # .............Extract Lyrics for current track from an "Album" file
  419.     $ .............Makes an "Album" file with track info and lyrics
  420.     % .............Programs playlist for tape dub (insert pauses)
  421.     ^ .............Programs playlist with only tracks with lyrics
  422.     & .............Imports lyrics for current track from specified file
  423.     * .............Exports lyrics for current track to specified file
  424.  
  425.   Device and Misc Controls:
  426.   -------------------------
  427.     X .............Open (eject caddy)/Close CD tray
  428.     [ and ] .......Adjust volume
  429.     = .............Mute volume/Restore volume
  430.     < and > .......Select CD-ROM drive unit
  431.     ~ .............Reset CD-ROM and MSCDEX driver
  432.     ESC or Q ......Quit program
  433.  
  434.  
  435. MOUSE CONTROL
  436. =============
  437.  
  438.   You can use the mouse to control most functions. The RIGHT mouse button
  439. works just like the TAB or M keys to change the mode. The operation of the
  440. LEFT mouse button changes depending on the position of the pointer and which
  441. display mode is selected. For easier mouse control activate the mouse
  442. "button-bars" by clicking one of the "plus/minus" symbols on the third line.
  443. Each time you click it will cycle to the next "bar" (there are three).
  444.  
  445. Top Section:
  446.  
  447.     Where clicked           Key(s) Function
  448.     -------------           ------ --------
  449.     Word "DISC"             X      Eject Disc or close tray
  450.     CD Title                E      Edit CD Title
  451.     Word "TRACK"            +      Next Track
  452.     Track Title             E      Edit Track Title
  453.     Time or Word "H=Help"   Z/H    Set Event or Help
  454.     Status                  P/S    Play or Stop
  455.     Green divider - line    SPACE  Pause or Continue playback
  456.     Green divider - ends    NONE   Previous/Next Display mode (all modes)
  457.     Plus/minus symbols      NONE   Toggles between Button-Bars and "blip"
  458.     Button-Bar              ACTION Clicking on a button performs the action
  459.  
  460. Middle Section:
  461.     
  462.     Mode    Where clicked      Key(s)  Function
  463.     ----    -------------      ------  --------
  464.     F1      Track Box          P       Play Track
  465.             Up/Down Arrow      CURSOR  Move marker (program mode)
  466.     F2      Number/Time        P       Play Track
  467.             Track Title        E       Edit track title
  468.             Up/Down Arrow      NONE    Scroll track list
  469.     F3/F4   Anywhere           F4/F3   Toggle between Karaoke/Paged lyrics
  470.     F5/F6   Anywhere           F6/F5   Toggle between Track/Disc title
  471.     F7      Number/Filename    INS     Sort Catalog
  472.             Title              \       Cycle Catalog type
  473.             Up/Down Arrow      CURSOR  Scroll list
  474.     F8      Anywhere           F1      Jump to Playlist
  475.     F9      Config Line        CURSOR  Select Line
  476.             "<" or ">"         CURSOR  Change Setting
  477.             "W"                W       Write Config
  478.     F10     Anywhere           F1      Jump to Playlist
  479.     F11/F12 Anywhere           F12/F11 Toggle between Frequency Bars/Scope
  480.     
  481.  
  482. Bottom Section:
  483.  
  484.     Where clicked          Key(s) Function
  485.     -------------          ------ --------
  486.     Green Bar - middle     NONE   Track shuttle (jump to absolute position)
  487.     Green Bar - ends       -/+    Previous/Next track
  488.     Word "Track"           G      Toggle playlist
  489.     Red Track Number       -/+    "-" on first digit, "+" on second digit
  490.     Time indicator         T      Toggle time display
  491.     Below time indicator   I      Toggle intro
  492.     Big Track Time         A/B/R  "A" on minutes, "B" on Seconds,"R" on colon
  493.     The "*"                V      Toggle alternate video mode
  494.     Word "Volume"          =      Mute
  495.     Volume number          [/]    "[" on first digit, "]" on second digit
  496.     Repeat()               R      Cycle repeat
  497.     H=Help                 H      Help
  498.     M=Mode()               TAB/M  Next display mode (modes 1 to 6)
  499.     Elsewhere on last line F      Toggle full screen (when off)
  500.     Bottom right corner    F      Toggle full screen
  501.  
  502.  
  503. PROGRAM CONFIGURATION
  504. =====================
  505.  
  506.   Press F9 to display the configuration screen. Use cursor UP and DOWN to
  507. select a configuration option then use LEFT or RIGHT to change the setting.
  508.  
  509.   To save the current settings press the W key. Settings are saved to the
  510. directory specified beside "Data Path =". The configuration file is a plain
  511. text file and contains lines in the form "xxxx = nn", where "xxxx" is the
  512. name of the configuration setting (as displayed under the NAME column) and
  513. "nn" is a value for that setting (0 being OFF, and 1 being ON). Valid values 
  514. are displayed under the RANGE column.
  515.   
  516.     NAME  DEF  DESCRIPTION
  517.     ----- ---  -----------
  518.     MODE    1  Sets the initial startup display mode (see display modes)
  519.     FULL    0  Enables fullscreen mode on startup
  520.     PRG     1  Automatically use programmed playlist if saved with CD
  521.     EDIT    0  Auto-edit new CD info when new (unknown) CD is inserted
  522.     PLAY    0  Automatically plays new CD when inserted
  523.     EXIT    0  CD action on Exit (0=none, 1=stop or 2=eject)
  524.     VIDEO   0  Alternate video lines (0=25, 1=43, 2=50)
  525.     INTRO  15  Sets the intro time (in seconds)
  526.     FFREW   5  Sets the fastforward/Reverse time (in seconds)
  527.     VDEV    0  Specifies how the volume is controlled (CD or SoundBlaster)
  528.     REPT    0  Sets the initial repeat mode (0=No,1=One,2=STP,3=All)
  529.  
  530.          (DEF = Built-in default)
  531.  
  532.  
  533. DISPLAY MODES
  534. =============
  535.  
  536.   Rather than cluttering up the display with overwhelming information, the
  537. program lets you choose what you want to see. This is the display mode, and
  538. it occupies the entire middle of the screen, or all but the top three lines
  539. when in full-screen mode.
  540.  
  541.   Each mode gives you specific information as follows:
  542.  
  543.     KEY  MODE     DESCRIPTION
  544.     ---  ----     -----------
  545.     F1   Playlst  List of tracks to play (Playlist)    (.=Lyrics available)
  546.     F2   CD Info  Track number, Times, Flag and Titles (*=Lyrics available)
  547.     F3   Lyrics   Paged-style lyrics synchronized to playback
  548.     F4   Karaoke  Karaoke-style lyrics synchronized to playback
  549.     F5   Track    Track Title in large letters
  550.     F6   CDTitle  CD Title in large letters
  551.     F7   Catalog  Catalog for CD's, Lyrics or Albums
  552.     F8   Utils    Utilities Help Screen
  553.     F9   Config   Configuration Screen
  554.     F10  About    Program info, including version number
  555.     F11  FreqBrs  Frequency Bars (simulated spectrum analyzer)
  556.     F12  Scope    Waveform scope
  557.  
  558.  
  559. F1 - Playlist:
  560.  
  561.   Track numbers displayed in the order they will be played. Normally all
  562. tracks on the CD will be shown in numerical order from 1 to the total number
  563. of tracks on the CD. Track numbers are displayed inside a box. The currently
  564. playing track (if any) will be displayed in red, all others will be blue. If
  565. a track has lyrics a period will be displayed after the track number.
  566.  
  567.   When program mode is enabled, only those tracks that are programmed will
  568. appear. A small yellow "marker" (or cursor) appears which can be moved about
  569. for program editing (adding or deleting tracks).
  570.  
  571. F2 - CD Info:
  572.  
  573.   All tracks on the CD are listed in track-order. The track number, time,
  574. lyric flag and title are shown. Titles may be edited and saved so that next
  575. time the CD is inserted they will automatically appear. The track time
  576. displayed will change depending on the currently selected "time mode". This
  577. can be elapsed track or CD time, remaining track or CD time, or a frame
  578. number.
  579.  
  580.   The lyric flag indicates if there are lyrics available for the track.
  581. Tracks shown with "*" have lyrics available. Tracks shown with a "-" do not.
  582.  
  583.   The currently playing track is highlighted. If there are more tracks on the
  584. CD than can fit on the screen, the list will shift up or down so that the
  585. currently playing track is as close to the middle as possible.
  586.  
  587. F3 - Lyrics
  588.  
  589.   Lyrics will be displayed in a paged format, synchronized to playback. Each
  590. line will be highlighted as it is sung. Just before the line is sung a small
  591. "traffic light" indicator will light red, yellow, then green indicating the
  592. time remaining until the line is sung:
  593.  
  594.   Red square     - More than 1 second
  595.   Yellow square  - Less than 1 second..... Get ready!
  596.   Green triangle - Less than 1/4 second... Sing it! (if you want to...)
  597.  
  598.   If no lyrics have been entered the message: "Lyrics not available" will be
  599. displayed followed by the required filename.
  600.  
  601. F4 - Karaoke
  602.  
  603.   Lyrics will be displayed in Karaoke format, synchronized to playback. Each
  604. line will be displayed in very large letters as it is sung. The next line
  605. to be sung will be displayed in small letters just below with the same
  606. "traffic light" indicator as above. If no lyrics have been entered, "Lyrics 
  607. not available" will be displayed.
  608.  
  609.   The lyrics are displayed in a large font with 13 characters per line. The 
  610. number of lines available depends on the screen mode and whether full-screen 
  611. is enabled. Four lines are available in 25-line mode with full-screen on. If
  612. full-screen mode is off one less line will be visible (keep this in mind 
  613. when typing lyrics)!
  614.  
  615. F5 - Track
  616.  
  617.   Displays the current track title in large letters.
  618.  
  619. F6 - CDTitle
  620.  
  621.   Displays the current CD title in large letters.
  622.  
  623. F7 - CD Catalog
  624.  
  625.   Loads and displays a catalog of CD's, lyrics or Albums. You can delete or 
  626. edit entries or sort the list by number, time (frames) or title.
  627.  
  628. F8 - Utility Help Screen
  629.  
  630.   Displays description of available utilities.
  631.  
  632. F9 - Configuration Screen
  633.  
  634.   Displays a configuration screen where startup options and program options
  635. can be set. Options such as intro time and fast-forward time take effect
  636. immediately when changed.
  637.  
  638. F10 - About Screen
  639.  
  640.   Displays freeware message, program version number, and author info.
  641.  
  642. F11 - Frequency Bars
  643.  
  644.   Displays a simulated "spectrum analyzer" of the SoundBlaster input.
  645.  
  646. F12 - Scope
  647.  
  648.   Displays a waveform of the SoundBlaster input.
  649.  
  650.  
  651. PLAYING CD'S
  652. ============
  653.  
  654.   There are two playback modes; standard or programmed. Standard mode
  655. consists of all tracks in numerical order. Programmed mode is a list of
  656. tracks in any order. In programmed mode you can select only those tracks that
  657. you want or even repeat tracks. You can have up to 99 programmed "steps". 
  658. When program mode is enabled the step number will be displayed at the bottom 
  659. left of the screen beside the track number. In either case (standard or 
  660. programmed) the order of the tracks will be referred to as the "playlist".
  661.  
  662.   At the top right of the screen is the status indicator. It will indicate
  663. the status of the CD and drive. If no CD is inserted it will say "open". If
  664. a CD is inserted but not playing it will say "stopped".
  665.  
  666.   Use the "P" key or ENTER to play the currently selected track. If the CD is
  667. not playing, pressing "+" or "-" will select a track. When the CD is playing
  668. the status indicator will say "playing". To pause playback press SPACE. The
  669. status indicator will flash "paused". To resume playback press SPACE again.
  670. To stop playback press the "S" or "." keys. If you press "S" or "." when the
  671. CD is already stopped it will reset the playlist to the beginning (ie: press
  672. "SS" to go to step 1).
  673.  
  674.   The "+" and "-" keys will jump to the next or previous track. If you are at
  675. the beginning or end of the playlist it will wrap around. To jump to a
  676. specific track enter a two-digit track number (this only works if program
  677. mode is NOT enabled!). When you enter the first digit it will be displayed
  678. followed by a "?" flashing at the bottom left of the screen reminding you
  679. that another digit is needed. If you enter an invalid first digit or track
  680. number it will not be accepted and the flashing message will be cleared. To
  681. clear an incorrect first digit press the BACKSPACE key.
  682.  
  683.   To control playback of an individual track use the CURSOR KEYS. The cursor
  684. LEFT key or ALT-LEFT key will reverse (rewind). The cursor RIGHT key or
  685. ALT-RIGHT key will fastforward. The cursor UP and DOWN keys will reverse or
  686. fast forward by twice the time of the LEFT and RIGHT cursor keys. The
  687. fastforward and reverse times can be adjusted in the configuration screen.
  688. The HOME key will re-start playback from the beginning of the CURRENT track.
  689. The END key will jump to a point near the end of the current track.
  690.  
  691. Repeat Modes:
  692. -------------
  693.  
  694.   The "R" key cycles between the following REPEAT modes:
  695.  
  696.     OFF - No repetition. Displayed as (---)
  697.     ONE - Repeats the currently selected track. 
  698.     STP - Single Track Play. Stops playback after each track ends.
  699.           You must press P to play the next track.
  700.     ALL - Repeats the entire CD
  701.     DRV - Repeats all CD's in all available Drive units
  702.  
  703.   The DRV repeat mode is only available if you have more than one CD-ROM
  704. drive (or a 6-pack drive configured with separate drive letters). This allows 
  705. you to have continuous music playback. When one CD is finished the CD in the 
  706. next drive will play and so on. When the last CD has played it will repeat 
  707. back to the first drive. If a drive has no CD inserted, DRV mode will be
  708. cancelled.
  709.  
  710.   Pressing "A" or "B" selects segment repeat mode, which repeats the selected
  711. section of the CD. Press "A" at the start of the segment. The repeat
  712. indicator will show (A- ). Press "B" at the end of the segment. The repeat
  713. indicator will show (A-B) and the segment will repeat over and over. While
  714. the segment is repeating you may press "B" to reduce the segment time even 
  715. further. To cancel A-B repeat mode press "R".
  716.  
  717.  
  718. Intro Mode:
  719. -----------
  720.  
  721.   Pressing "I" will enable INTRO mode. The word "INTRO" will flash just to
  722. the left of the time indicator. This will play the beginning of each track 
  723. then jump to the next track. When intro mode is enabled repeat mode is set to 
  724. "ALL". If intro mode is enabled after playback has passed the intro period, 
  725. it will jump to the next track immediately. Pressing "I" again disables intro 
  726. mode. The intro time is adjustable via the configuration screen.
  727.  
  728.  
  729. CHANGING THE DISPLAY
  730. ====================
  731.  
  732.   Use the "TAB" or "M" keys to switch to the next display mode. Use SHIFT-TAB
  733. to switch to the previouse display mode. The (SHIFT)TAB/M keys will only
  734. switch from F1 to F6 modes. To jump to a specific display mode press the 
  735. desired FUNCTION KEY (F1 to F12).
  736.  
  737.   Use the "F" key to toggle full-screen mode. When full-screen mode is on,
  738. the bottom section is removed and the selected display mode is extended to
  739. the bottom of the screen.
  740.  
  741.   If you have a VGA display you may use the "V" key to toggle the video mode
  742. between 25 lines or 43/50 lines as set in the configuration.
  743.  
  744.   Press the "H" key to display a help screen with a summary of the most
  745. common control keys. Also displayed on the help screen is the {idnum} for the
  746. current CD. Press "H" again to return to the previous display mode or choose
  747. a specific mode by pressing the proper function key.
  748.  
  749.   Press the "T" key to change the time display. The time display can show
  750. elapsed or remaining time for either the current track or the entire CD. It
  751. can also display the track FRAME number. The track frame number is used to
  752. synchronize the lyrics to playback. A frame is one seventy-fifth of a second,
  753. which gives very precise control over lyric timing. Depending on the speed
  754. of your computer and how your CD-ROM is connected (SCSI, IDE, parallel port
  755. etc) this number may change smoothly or jump many numbers at a time (on MY
  756. computer the last digit is just a blur :-) )
  757.  
  758.   Note: Since only the last 5 digits of the track frame number are displayed,
  759.   ~~~~~ after 22:16 the frame number will appear to reset to zero.
  760.  
  761.   Note2: Times are read directly from the disc and may not match those
  762.   ~~~~~~ printed on the CD and/or jewel case.
  763.  
  764.   Most key commands will operate the same regardless of the DISPLAY mode.
  765. For example, you can press "+" to jump to the next track even when help is
  766. being displayed. The only exceptions to this are the NORMAL cursor control 
  767. keys. The cursor keys usually control track shuttle, however when program 
  768. mode is enabled they control the yellow marker, and when in the configuration 
  769. screen the cursor keys select and change option settings. When in these modes 
  770. you can use the CTRL-CURSOR keys for track shuttle control.
  771.  
  772.   When in EDIT mode the opposite is true. Obviously, typing a letter will
  773. insert it into the edit field, therefore you can't change modes or tracks, or
  774. change the time display while in edit mode. When in edit mode the only
  775. control of the CD you have is via the ALT or CTRL plus CURSOR keys to control 
  776. playback of the CURRENT track. To exit EDIT mode press ENTER (if a single 
  777. field) or ESC (with multiple fields).
  778.  
  779.  
  780. FREQUENCY BARS AND SCOPE
  781. ========================
  782.  
  783.   These functions (F11 and F12) require a fast computer with a SoundBlaster
  784. or compatible card. The sound output from your CD-ROM drive must be connected 
  785. to either the internal CD-line connector or to the line input of the 
  786. SoundBlaster card. The "BLASTER" enviroment variable must also be correctly
  787. set in your AUTOEXEC.BAT for these modes to work! See your SoundBlaster manual
  788. for installation instructions. For best result make sure the input volume is
  789. set as high as possible.
  790.  
  791. F11 - Frequency Bars
  792.  
  793.   This displays a SIMULATED spectrum analyzer. In a REAL spectrum analyzer
  794. the bars correspond to specific frequencies; low frequencies on the left and
  795. higher frequencies to the right. The louder the freqency the higher the bar.
  796. Eventually I'd like to have a real spectrum analyzer but for now it's just
  797. simulated... Now the bars are more like "waveform delta" bars. At least it's
  798. interesting to watch. The following keys adjust the bars:
  799.  
  800.   { and } ....Set sampling size. {=faster/lower, }=Slower/higher.
  801.               (Set this according to the speed of your computer)
  802.   ; and ' ....Shift bars left/right. There are 255 bars but only a few are
  803.               visible depending on the bar width.
  804.   : and " ....Set bar width. :=Smaller, "=Bigger.
  805.   INS ........Toggle display of the above settings.
  806.  
  807. F12 - Scope
  808.  
  809.   This displays the waveform of the sound input much like an oscilliscope. On
  810. a really fast computer you may need to adjust the delay between samples. On a
  811. slow computer you may only see what appears to be random dots. When no sound
  812. is input you should see a straight line all the way across the middle of the
  813. screen. The following keys adjust the scope:
  814.  
  815.   { and } ....Adjust the sampling delay
  816.   : ..........Reset the sampling delay to zero (fastest display)
  817.   " ..........Toggle slow-motion
  818.   INS ........Toggle the display of the delay setting.
  819.  
  820.   Note: These modes don't seem to work (at least for me) while running under
  821.   ~~~~~ Windows or even AFTER running windows. You may need to turn the
  822.         computer off and back on again to reset the soundblaster card.
  823.  
  824.  
  825. DEVICE CONTROL AND EXITING
  826. ==========================
  827.  
  828.   If you have more than one CD-ROM drive unit attached to your computer you
  829. may select which one you control by pressing the "<" and ">" keys. Switching
  830. to another unit switches control completely to the new unit. If the previous
  831. unit was playing it will continue to play, however, any and all control of
  832. that unit is lost (track order, repeat etc). Switching from one unit to
  833. another may cause the new unit to jump to another track if "use programmed
  834. playlist if available" is set to "yes" and the currently playing track is not
  835. in the playlist (this can also occur if SJGPLAY is exited then re-started
  836. while the CD is still playing). If "auto play" is enabled the CD will start
  837. to play automatically when the unit is switched. A list of available drive
  838. units is displayed on the help screen.
  839.  
  840.   To completely reset the current CD-ROM drive press the "~" key. This will
  841. stop playback and re-read the CD.
  842.  
  843.   To control the volume use the "[" and "]" keys to decrease or increase the
  844. level from 0 to 99. Use the "=" key to mute the volume. Pressing "=" again
  845. will restore volume to the previous level. Use the configuration screen to
  846. select which DEVICE is controlled by the volume keys. You can select the
  847. volume via the SoundBlaster (or compatible) card's CD input level or master 
  848. output level.
  849.  
  850.   To eject the CD press "X". If your CD-ROM is a tray-type (as opposed to
  851. the caddy-type), pressing "X" again will close the tray door. If "auto play"
  852. is enabled the CD will start to play automatically when it is inserted.
  853.  
  854.   To exit the program press the "ESC" or "Q" key. You will be asked to
  855. confirm that you want to quit by pressing "Y" for yes or "N" for no. When the
  856. program exits the CD may stop or may be ejected depending on the settings
  857. in the configuration screen.
  858.  
  859.  
  860. PRINTING INFORMATION
  861. ====================
  862.  
  863.   Pressing the "?" key prints information for the specific mode as follows:
  864.  
  865.     MODE           PRINT WHAT?
  866.     ----           -----------
  867.     F1/F2 Tracks   CD Info (track titles and times).
  868.     F3/F4 Lyrics   Lyrics for CURRENT track.
  869.     F7    Catalog  Currently displayed catalog (CD's/Lyrics/Albums) printed
  870.                    in the currently sorted order.
  871.     All Others     None
  872.  
  873.   You will be asked to confirm printing by pressing "Y" or "N". Make sure
  874. your printer is ready before pressing "Y"!
  875.  
  876.  
  877. DELETING INFORMATION
  878. ====================
  879.  
  880.   Pressing the DEL key deletes information for the specific mode as follows:
  881.  
  882.     MODE           DELETE WHAT?
  883.     ----           ------------
  884.     F1    Tracks   Programmed step at marker
  885.     F2    CDInfo   CD Info files and ALL lyric files for CURRENT CD
  886.     F3/F4 Lyrics   File for current lyrics
  887.     F7    Catalog  CDs...: All files for selected CD 
  888.                    Lyrics: Selected lyric file
  889.                    Albums: Selected album file
  890.     All Others     None
  891.  
  892.  
  893. EDITING INFORMATION
  894. ===================
  895.  
  896.   Pressing "E" lets you edit information for the specific mode as follows:
  897.  
  898.     MODE        EDIT WHAT?                          SEE ALSO (section)
  899.     ----        -----------                         ------------------
  900.     F1 Tracks   None (Enables playlist)             Programming
  901.     F2 CDInfo   CD Title and ALL Track Names        Editing Keys
  902.     F3 Lyrics   Lyrics                              Entering lyrics
  903.     F4 Karaoke  Synchronization or Finetuning       Synchronizing lyrics
  904.     F5 Track    Current track name                  Editing Keys
  905.     F6 Title    CD Title                            Editing Keys
  906.     F7 Catalog  Selected file (Shell to DOS EDIT)   [MS-DOS Manual for EDIT]
  907.     F9 Config   None (use "W" to save settings)     Configuration
  908.     All Others  None
  909.  
  910.  
  911. EDITING KEYS
  912. ============
  913.  
  914.   When you press "E" (while in modes F2, F3, F5 or F6) you enter EDIT mode
  915. where you may enter information into a field or fields. The background
  916. under the edit field will turn blue, and the following keys will be active:
  917.  
  918.     LEFT/RIGHT ......Move cursor Left/Right
  919.     TAB .............Move cursor Right 8 characters
  920.     DEL .............Delete character at cursor
  921.     BACKSPACE .......Delete character to left of cursor
  922.                      (if at the FIRST character it erases the ENTIRE field)
  923.     INSERT ..........Toggle insert mode
  924.                      (thick cursor for insert or thin for typeover mode)
  925.     ESC .............Save and Exit edit mode
  926.     ENTER ...........Save and Exit  OR  Go to next field in a group
  927.     UP/DOWN .........Select field to edit in a group of fields
  928.     HOME/END ........Move to First/Last field in a group of fields
  929.     PAGE UP/DOWN ....Page Up/Down in a group of fields
  930.  
  931.     CTRL-PAGEUP .....Memorize entire field
  932.     CTRL-PAGEDOWN ...Recall entire memorized field
  933.     CTRL-HOME .......Erase entire field
  934.     CTRL-END ........Restore original field contents
  935.     CTRL-V ..........Insert memorized field at current cursor position
  936.  
  937.     ALT-U/L .........Convert entire field to Uppercase/Lowercase
  938.     ALT-I/D .........Insert/Delete field (lower fields move up or down)
  939.     ALT-T/B .........Mark Top/Bottom of block
  940.     ALT-C ...........Copy marked block
  941.  
  942. Special Track control keys while in edit mode:
  943.  
  944.   These keys allow you to control playback of the current track, since the
  945. normal cursor keys control cursor movement. These are handy when entering
  946. lyrics so you don't need to keep re-playing the track over and over...
  947. (These keys also work outside of edit mode).
  948.  
  949.     ALT or CTRL-UP .....Pause/Resume playback
  950.     ALT or CTRL-DOWN ...Re-start track
  951.     ALT-LEFT/RIGHT......Reverse/Fastforward search
  952.  
  953.  
  954. ENTERING LYRICS
  955. ===============
  956.  
  957.   You may enter lyrics using the built-in editor. This is a simple line-based
  958. editor with NO text wrapping ability. See the "Editing Keys" section for a
  959. detailed explanation of individual keys. This section covers the general
  960. process of entering lyrics. If you have used an external editor to type the
  961. lyrics see the "Utilities" section.
  962.  
  963.   Press the Lyrics key (F3) then press "E". This will edit lyrics for the
  964. CURRENTLY selected track.
  965.  
  966.   Editing the lyrics does not stop playback, however you may use the
  967. "ALT/CTRL-CURSOR" keys to control playback while editing. The CTRL-UP key
  968. is particularly handy as it allows you to listen to a line then pause
  969. playback while you type it in. When you're ready for the next line press
  970. CTRL-UP again. If you miss a line or need to re-play a line you can use
  971. ALT-LEFT to reverse a bit then ALT-RIGHT to catch up (or just let it play).
  972.  
  973.   Most songs have a chorus which is repeated one or more times during the
  974. song. You can copy these lines using the BLOCK keys. Move to the first line 
  975. of the chorus and press ALT-T to mark the top, then move to the last line and 
  976. press ALT-B to mark the bottom of the block. You can then move to the line 
  977. where the chorus is repeated then press ALT-C to copy the marked lines.
  978.  
  979.   If a certain line or phrase is repeated often, use CTRL-PGUP to memorize
  980. that line then use CTRL-PGDN to recall it (entire line) or CTRL-V to insert
  981. it into the current line (at the cursor position). Feel free to leave some 
  982. lines blank for clarity.
  983.  
  984.   After you have typed in a rough version of the lyrics you might want to
  985. use CTRL-DOWN to re-start playback from the beginning while following along
  986. with the lyrics using the cursor DOWN key. This will also let you get a
  987. "feel" for the timing which will come in handy when you synchronize the 
  988. lyrics later on (see next section).
  989.  
  990.   Try to enter all the lyrics for a song BEFORE you synchronize them. When
  991. you insert lines (ALT-I) or copy lines (ALT-C) no synchronization data will
  992. be available for those lines. This will cause lyric playback to stop, and you
  993. will have to re-sync the entire track. Lines without sync information will
  994. have a "." displayed at the beginning of the line.
  995.  
  996.   To exit Lyrics entry press the ESC key. Lyrics will automatically be saved
  997. with the appropriate filename (CD{idnum}.{tracknum} format).
  998.  
  999.   And one last thing: Don't trust the lyrics that may be included with the
  1000. CD... They're rarely correct!
  1001.  
  1002.  
  1003. SYNCHRONIZING LYRICS
  1004. ====================
  1005.  
  1006.   Select Karaoke mode (F4) then press "E". Playback will be stopped. You will
  1007. be presented with a summary of keys that control synchronization.
  1008.  
  1009.   Select "I" for an Initial synchronization, or "F" to finetune the
  1010. synchronization. If you don't want to synchronize press the ESC key.
  1011.  
  1012.   You must have already entered some lyrics before you can synchronize them
  1013. and you must already have synchronized the lyrics before you can finetune
  1014. them (duh)! The initial synchronization process plays the track from start
  1015. to end and you do the entire track in a linear manner. Finetuning will loop
  1016. playback of the selected line so you can adjust when it starts. The current
  1017. line is indicated by a triangular yellow marker.
  1018.  
  1019.   Note: When you press "I" or "F" playback will begin, so be ready!
  1020.  
  1021.   Initial Synchronization Keys:
  1022.   -----------------------------
  1023.  
  1024.     SPACE ........Press SPACE at the moment the line is sung
  1025.     BACKSPACE ....Re-try the previous line. Playback will return to the
  1026.                   line before the previous line to give you a chance to
  1027.                   get ready for the line again
  1028.     ESC ..........Abort without saving
  1029.  
  1030.     Note: The timing information will automatically be saved when the last
  1031.     ~~~~~ line has been synchronized.
  1032.  
  1033.   Finetuning Keys:
  1034.   ----------------
  1035.  
  1036.     UP/DOWN ......Select line to adjust
  1037.     PAGE UP/DOWN .Select Previous or Next Page
  1038.     LEFT .........Start line earlier (5/75ths of a second)
  1039.     CTRL-LEFT ....Start line earlier (half a second)
  1040.     RIGHT ........Start line later   (5/75ths of a second)
  1041.     CTRL-RIGHT ...Start line later   (half a second)
  1042.     + or - .......Increase/Decrease loop time (20/75ths of a second)
  1043.     * ............Set loop to repeat to the start of the next line
  1044.     / ............Reset loop time (half the fastforward/reverse time)
  1045.     END ..........Exit and Save
  1046.     ESC ..........Abort without saving
  1047.  
  1048.   TIP: for blank lines, if possible, try to start them just AFTER the
  1049.   ~~~~ previous line ends so that the line can remain on the screen when in
  1050.        Karaoke mode. If there is a long delay before the next line is sung
  1051.        wait on the blank line until just a few seconds before it starts.
  1052.         
  1053.  
  1054. PROGRAMMING
  1055. ===========
  1056.  
  1057.   Press the Playlist key (F1). To toggle program mode press "G". Use the
  1058. CURSOR keys to move the yellow marker above the track numbers. The name of
  1059. the track under the marker will be displayed at the bottom of the display
  1060. window. You can press DEL or BACKSPACE to delete steps from the playlist. To
  1061. add a track, enter a two-digit number such as "03" or "14". The track will be
  1062. INSERTED at the marker position. Only valid track numbers and "00" will be
  1063. accepted. Entering "00" will insert a pause in the playlist (you must press 
  1064. "P" to continue playback).
  1065.  
  1066.   IMPORTANT NOTE!:  When program mode is ENABLED, entering a two-digit track
  1067.   ~~~~~~~~~~~~~~~~  number inserts it into the program playlist regardless of
  1068.                     the display mode! It does NOT play the track.
  1069.  
  1070.   You can clear all tracks by pressing "C". Pressing it again will select all
  1071. tracks in track-number order. Shuffle (jumble) all tracks with the "J" key.
  1072. The "^" (shift 6) key will program only those tracks that have lyrics.
  1073.  
  1074.   If you want to dub the CD to tape use the "%" (shift 5) key. It will ask
  1075. for the length (in minutes) of one side of the tape and insert pauses at the
  1076. correct locations so that songs are not cut off and you can have time to flip
  1077. the tape over or change tapes. You must press P to start playback after the
  1078. CD pauses.
  1079.  
  1080.   The currently playing track will be highlighted in red. If you delete a
  1081. track that is playing, the next track (if any) will be played. To save
  1082. programmed tracks press the "W" key. The program will be saved in the same
  1083. file that is used for CD information "CD{idnum}.CD" so that each CD can have
  1084. it's own favourite track programming. If you want to re-load the program 
  1085. saved in this file press "L". If you don't want programmed tracks for the
  1086. current CD press "C" to clear the program then "W" to write it to the file.
  1087.  
  1088.   When "use programmed playlist if available" is enabled the programmed
  1089. tracks will automatically be loaded and enabled when the CD is next inserted.
  1090.  
  1091.  
  1092. CATALOGING
  1093. ==========
  1094.  
  1095.   There are three different catalogs:
  1096.  
  1097.     CD's   (.CD ) -- Displays CD titles
  1098.     Lyrics (.nnn) -- Displays individual Lyric files
  1099.     Albums (.ALB) -- Album files contain lyrics for an entire CD
  1100.   
  1101.   Press F7 for the catalog. This will read each CD{idnum}.* file and extract 
  1102. the appropriate title from the first line then display a list on the screen. 
  1103. To cycle between CDs, Lyrics, or Album files press the "\" key. Use the UP or 
  1104. DOWN keys to scroll through the list. Use the LEFT and RIGHT keys to page up 
  1105. or down the list. A yellow triangle marker at the top of the list shows the 
  1106. currently selected line. Press the INS key to sort the catalog by number 
  1107. (disk order), ID (time), or title. The yellow marker will point to the sorted 
  1108. column. 
  1109.  
  1110.   To delete the currently selected file press the DEL key. To edit the file 
  1111. press the "E" key. This will shell to the DOS EDIT command (see your DOS 
  1112. manual. Press ALT-F then X to return to SJGPLAY). 
  1113.  
  1114.   Notes: The DOS EDIT command must be in your path for the "E" command to
  1115.   ~~~~~~ work. When in the DOS editor all CD control is lost. Be careful when
  1116.          editing lyrics with syncronization numbers!
  1117.  
  1118.          You can not have both lyrics and catalog entries. Switching to 
  1119.          either lyric (F3/F4) mode will clear the catalog.
  1120.   
  1121.  
  1122. UTILITIES
  1123. =========
  1124.  
  1125.   Pressing the "U" or F8 keys will display the Utilities help screen. All
  1126. utilities work at any time, not just when the utility screen is displayed.
  1127. The utility screen is just a reference to help you remember the key commands.
  1128.  
  1129.   Key Description
  1130.   --- -----------
  1131.   !   Rename data files with specified {name} to the proper {idnum}
  1132.   @   Rename data files with an {idnum} of 000000 to the proper {idnum}
  1133.   #   Extract Lyrics for current track from 'Album' file
  1134.   $   Export lyrics to 'Album' file
  1135.   %   Program Playlist for Cassette Tape Dub
  1136.   ^   Program Playlist with only those tracks that have lyrics
  1137.   &   Import lyrics for current track from specified file
  1138.   *   Export Lyrics for current track to specified file
  1139.   Z   Set Event
  1140.   D   Set Display Timer
  1141.  
  1142. Lyric and Information files
  1143. ---------------------------
  1144.  
  1145.   The following functions are useful when you have used a text editor to edit
  1146. the lyrics or have obtained a text file containing lyrics from another source.
  1147. There are internet/WWW sites containing song lyrics. Some files may contain
  1148. lyrics for many songs all in a single file (referred to as an "Album" file).
  1149.  
  1150. Renaming:
  1151.  
  1152.   The "!" and "@" keys will rename all files to the proper format. If you're
  1153. not running the program and don't know the {idnum} of a specific CD, you can
  1154. substitute "CD000000" or a {name} of your own choosing while creating the
  1155. files. When the CD is inserted and the proper {idnum} is known they can be
  1156. renamed. Only the first part of the filename will be renamed! Files must
  1157. still end in the proper format (.CD for information files or .001, .002 etc
  1158. for lyric files) The "@" key will prompt you for the {name} of the files.
  1159.  
  1160.   So, for example, if you typed out the lyrics for tracks one and two from
  1161. the CD "Ace of Base - The Sign" and called them "thesign.001" and
  1162. "thesign.002" you would press "@" then enter "thesign" when prompted for the
  1163. {name}. This would then rename the files to "CD206107.001" and "CD206107.002"
  1164. since the {idnum} for that CD is 206107. The {idnum} for the current CD is
  1165. displayed on the help screen if you want to know what it is. You can also
  1166. type: SJGPLAY INFO on the command line.
  1167.  
  1168. Album Files: (Extracting/Exporting)
  1169.  
  1170.   The "#" key will extract lyrics from an "Album" file containing many songs.
  1171. Each song in the file must begin with the text "@SONG:" followed by the song
  1172. name. The program will extract all lines after that line, up until another
  1173. "@SONG" line is reached (or if all lines are filled).
  1174.  
  1175.   You will be prompted to enter the complete path of the "Album" file and the
  1176. name of the song to extract. The name of the song must exactly BEGIN with
  1177. what is entered, however it is not case-sensitive. If you enter an incomplete
  1178. song name, the first song matching that will be extracted. For example, if
  1179. you enter "do i" as the song name, it would extract "Do I Love You" or
  1180. "Do I Know", whichever came first in the "Album" file.
  1181.  
  1182.   If the Song is not found, a list of song names will be displayed. This
  1183. information is held temporarily as lyrics and will disappear if the display
  1184. mode or track is changed.
  1185.  
  1186. Make an Album file:
  1187.  
  1188.   The "$" key will create an Album file for the current CD. You will be asked
  1189. for an optional comment and if you'd like to delete the individual lyric
  1190. files. Only answer YES if you've entered all the lyrics and syncronized them
  1191. and you're happy with them. Once an album file is created the program will
  1192. automatically extract individual lyrics from the album file when needed, so
  1193. individual lyric files are not strictly nessesary (although once they are
  1194. deleted you won't be able to list the song names in the lyric catalog). Album
  1195. files take up less hard drive space than individual lyric files.
  1196.  
  1197.   Important: The make album function REQUIRES individual lyric files. Don't 
  1198.   ~~~~~~~~~~ try to make another album file once you've deleted the 
  1199.              individual files... You will loose all the lyrics! (You WILL be 
  1200.              warned!) To re-create individual lyric files, press F3 then edit 
  1201.              EACH track (IE: E, ESC, +, E, ESC, + etc...). 
  1202.  
  1203. Importing (copy):
  1204.  
  1205.   The "&" key will copy a lyric file into the data directory with the proper
  1206. filename. If the file is not in the current directory you must enter the 
  1207. complete path along with the filename. It will be copied to the data 
  1208. directory with the proper CD{idnum}.{tracknum} filename.
  1209.  
  1210. Exporting (save as):
  1211.  
  1212.   The "*" key will save the current lyrics to a file with a name of your
  1213. choice. You will be prompted to enter the filename. This is useful for songs
  1214. that appear on more than one CD in your collection. Just give the file the
  1215. appropriate file name (in the format CD{idnum}.{tracknum}) for the other CD.
  1216. Or, you can give it any name (be sure to end the name with the proper track
  1217. number ie: 002) then when you insert the other CD, go to the proper track and
  1218. use the "@" key to rename it.
  1219.  
  1220. Set Event:
  1221.   
  1222.   Press "Z" to set the Event. When the time of day reaches the specified time
  1223. the event is performed. You can set any or all of the following:
  1224.  
  1225.     Message........Display message in big letters (leave blank to skip)
  1226.     Track Control..Track#=Play track, 0=No change, -1=Stop
  1227.     Display Mode...Set display mode (0=No change)
  1228.  
  1229. The time must be specified to the exact second. If a message is entered it
  1230. will be displayed for 5 seconds. The event time is cleared after each event.
  1231.  
  1232. Set Display Timer:
  1233.  
  1234.   Press "D" to set the Display Timer. After a specified time interval the
  1235. display mode will rotate to the next mode in the mode list. Each display mode
  1236. is a single digit or character. Do not enter spaces in the mode list.
  1237.  
  1238.   Modes 1 to 9 correspond to function keys F1 to F9. Mode "A", "B" and "C" 
  1239. correspond to F10, F11 and F12 respectively. To cancel display mode rotation 
  1240. enter "0" as the time interval or select a display mode via one of the 
  1241. function keys.
  1242.  
  1243.  
  1244. ERROR CONDITIONS
  1245. ================
  1246.  
  1247.   If an error occurs in the program (if you enter an illegal character in a
  1248. filename, or the printer is off, for example) the program will print an error
  1249. message and, depending on the type of error, give you the opportunity to
  1250. either: Retry, Cancel, or Abort the program. Choose "Retry" if the problem is 
  1251. something you can fix (ie: turning the printer online or feeding paper).
  1252. Choose "Cancel" if it's something you can't fix (ie: don't have a printer)
  1253. and the program will cancel the operation. Choose "Abort" if "retry"
  1254. keeps giving you the same error and "Cancel" won't work either (probably my
  1255. programming error...).
  1256.  
  1257.  
  1258. COMMAND-LINE ARGUMENTS
  1259. ======================
  1260.  
  1261.   SJGPLAY can be controlled through command-line arguments. These may be used
  1262. to modify how the program is run or can be used to control CD functions from
  1263. the command line (or via a batch file) without actually interacting with the
  1264. program. Program-mode options must appear on the command line by themselves.
  1265. Control-mode options may be listed with spaces separating each one, and will 
  1266. be executed in the order they appear.
  1267.  
  1268.   Program-mode arguments:
  1269.   ~~~~~~~~~~~~~~~~~~~~~~~
  1270.     CHECK..........Checks if a CD is in the drive. If there is no CD in the
  1271.                    drive the program will exit. If there is a CD in the drive
  1272.                    the program will run normally. This can be used in your
  1273.                    AUTOEXEC.BAT file so that you can play CD's when the
  1274.                    computer boots up.
  1275.  
  1276.     CONFIG:file....Specifies a secondary configuration file. Settings in
  1277.                    this file override those set in the default config file
  1278.                    (which is read first). You can use a text editor to create 
  1279.                    the file (or edit the default configuration) to include 
  1280.                    only those setting you want to change. The file may also 
  1281.                    include a "PATH=" statement to change the data path from 
  1282.                    the default set via the SJGPLAY environment variable.
  1283.  
  1284.   NOTE: The following arguments can be shortened to the first 4 characters
  1285.  
  1286.   Control-mode arguments:
  1287.   ~~~~~~~~~~~~~~~~~~~~~~~
  1288.     Device control:
  1289.  
  1290.     UNIT:xx....Select drive unit# xx (0=first drive, 1=second drive etc)
  1291.     EJECT......Eject any type of CD
  1292.     NODATA.....Eject CD-ROM's only
  1293.     NOAUDIO....Eject Audio CD's only
  1294.  
  1295.     Playback:
  1296.  
  1297.     PLAY:xx....Play track xx (plays current track if xx not specified)
  1298.     SINGLE:xx..Single-play track:xx (stops at end of track)
  1299.     NEXT.......Play next track
  1300.     PREVIOUS...Play previous track
  1301.     STOP.......Stop CD playback
  1302.  
  1303.     Information:
  1304.  
  1305.     INFO.......Display CD info including track titles and time, total time
  1306.     TRACK......Display track name and number
  1307.     TNUMBER....Display track number only
  1308.     ELAPSED....Display track elapsed time
  1309.     TITLE......Display CD title
  1310.     
  1311.     Conditionals:
  1312.  
  1313.     The following arguments can be used to stop command line parsing if the
  1314.     specified condition is false, or continue if the condition is true:
  1315.  
  1316.     IFSTOPPED..If the CD is stopped then continue parsing CMDLIST
  1317.     IFPLAYING..If the CD is playing then continue parsing CMDLIST
  1318.     IFCD.......If a CD is inserted then continue parsing CMDLIST,
  1319.                If not, then exit with ERRORLEVEL=1 (useful in batch files)
  1320.  
  1321.     if the condition is false then the remaining arguments on the
  1322.     command-line are ignored.
  1323.  
  1324.   When in command-line mode, commands are executed in order and control is
  1325.   returned to the dos prompt (or calling program).
  1326.  
  1327.   Some examples:
  1328.  
  1329.   SJGPLAY CHECK ....................Run the program if a CD is in the drive
  1330.   SJGPLAY INFO .....................Display name, track titles of current CD
  1331.   SJGPLAY PLAY:1 ...................Play track 1 (put this in your AUTOEXEC!)
  1332.   SJGPLAY IFSTOPPED PLAY:5 .........Play track 5 if the CD is NOT playing
  1333.   SJGPLAY UNIT:0 STOP UNIT:1 PLAY ..Stop CD in unit 0 then start playing the
  1334.                                     current track of unit 1
  1335.   SJGPLAY NOAUDIO ..................Eject the CD if it is an audio CD.
  1336.                                     (maybe your system gets confused if an
  1337.                                      audio disc is inserted?)
  1338.   SJGPLAY CONFIG:C:\MYCONFIG.CFG ...Specify a secondary config file called
  1339.                                     "myconfig.cfg" located in the root
  1340.                                     directory of drive C:
  1341.  
  1342. REVISION CHANGES
  1343. ================
  1344.  
  1345.   1.00 - Initial Public Release.
  1346.   1.01 - Fixed large "[" and "y" characters, A/B repeat lyric scrolling.
  1347.          Fixed DEL key to delete program step (deleted twice).
  1348.          Fixed bug that caused repeat modes to fail with programmed tracks.
  1349.          Fixed INTRO when REPEAT enabled.
  1350.   1.02 - Fixed Extract. Changed time display while in edit mode to update
  1351.          only once per second to speed up editing. Added save lyric message.
  1352.   1.03 - Fixed playback stopping. Fixed command line "single" option. 
  1353.          Allow track jumping even if Repeat set to "one".
  1354.          Added printing of CDInfo, Lyrics and Catalog.
  1355.   1.04 - Added initial repeat mode to config. Added Reset CD-ROM ("~").
  1356.          Added reset playlist ("S" when CD stopped). Added Import Lyric("&"). 
  1357.          Changed disc-change-detection and volume routines.
  1358.          Improved error trapping (this added 14K to the program size...)
  1359.   1.05 - Small speed improvements and code re-organization.
  1360.          Minor text and color changes.
  1361.   1.06 - Well, seems that code re-org broke a few things... specifically
  1362.            the updating of track titles...fixed (sorry about that).
  1363.          If using SoundBlaster, volume level defaults to current volume 
  1364.            setting (rather than 99%).
  1365.   1.10 - Added mouse control. Added SHIFT-TAB to go to previous mode.
  1366.          Added Remaining frame time mode.
  1367.   1.20 - Added Frequency Bars (F11), Scope (F12), Display Timer ("D").
  1368.          Added "Drv" Repeat mode to link drives. Added Mouse Button-Bars.
  1369.          Added mouse control for "Yes/No" responses.
  1370.          Replaced Catalog sorting routine with quicksort (much faster!).
  1371.          Faster Help and Configuration screen drawing.
  1372.          Fixed updating of Drive Unit Letter when no disc inserted.
  1373.          Fixed command-line "ifcd" and "unit" operation.
  1374.          Fixed mouse clicking (leaving the wrong color behind) and mouse 
  1375.            disappearing when over areas that changed. 
  1376.          Changed action of left mouse click on certain display modes.
  1377.          Removed command-line "monitor" command.         
  1378.          Program will now recognize and use album files directly.
  1379.  
  1380.  
  1381. KNOWN BUGS AND MISSING FEATURES
  1382. ===============================
  1383.  
  1384.   I've tried to test the program as thoroughly as possible, however bugs will
  1385. still occur. As stated at the beginning, I can't test every possible
  1386. combination of equipment, so your milage may vary... Anyway, here are a few
  1387. of the bugs I haven't been able to squash (yet!):
  1388.  
  1389.     - Command-line option "NODATA" to eject cd-roms not working - all cd's
  1390.       appear to be audio to the DSE library's "IsData%" function.
  1391.     - volume control via CD-ROM not working (SoundBlaster works fine... this
  1392.       seems to be a missing feature in the library. I'm waiting for a
  1393.       response from DSE...)
  1394.     - the cursor sometimes jumps one character to the right when editing.
  1395.  
  1396.  
  1397. IDEAS FOR FUTURE VERSIONS
  1398. =========================
  1399.  
  1400.   Some of the things I'm considering for future versions of the program
  1401. (in no particular order):
  1402.  
  1403.     - ability to include comments with each CD or Lyric file
  1404.     - more cataloging information like music category (rock, pop, etc)
  1405.     - programming across multiple drive units.
  1406.     - searching (find song titles or lyrics)
  1407.  
  1408.   If you want to see any of these added, have ideas of your own, or have a
  1409. comment, send me a message via e-mail. I can't promise you I'll add them but 
  1410. I will consider all reasonable requests.
  1411.  
  1412.   If you have assembly source code for a REAL spectrum analyzer which you'd 
  1413. like to donate (that could be integrated into Microsoft's Basic PDS 7.1),
  1414. please e-mail me.
  1415.  
  1416.   Thank-you for using SJGPLAY!
  1417.  
  1418. END.
  1419.  
  1420.