home *** CD-ROM | disk | FTP | other *** search
/ Chip Hitware 7 A / CHIP_HITWARE_7A.iso / Multimedia / SJG / sjgplayw.tx_ / sjgplayw.tx
Text File  |  1998-04-26  |  30KB  |  745 lines

  1. SJGPlay for Windows      Preliminary Documentation    (C)1998 Steve J. Gray
  2. ===================         V0.52, Apr 26, 1998       =====================
  3.  
  4. << Double-click titlebar for full screen! >>
  5.  
  6. Email: sgray@acs.ryerson.ca
  7. WWW  : http://www.ryerson.ca/~sgray
  8.  
  9.  
  10. Please see the README.TXT file for version info, changes, bugs etc.
  11.  
  12.  
  13. Disclaimer:
  14. -----------
  15.  
  16.   This is FREEWARE BETA software. Use at own risk!!! I will attempt to
  17. correct any BUGS that are reported to me, however since this is FREEWARE,
  18. please understand that I cannot provide SUPPORT if it doesn't work on
  19. your system.
  20.  
  21.  
  22. Data Files:
  23. -----------
  24.  
  25.   Sample data files are not included. They are available on my web
  26. page. Make sure you set the paths to the sample files via the CONFIG
  27. screen then save the config. If you create a complete album including
  28. lyrics for all songs please e-mail them to me and I can add to the
  29. samples.zip file.
  30.  
  31.  
  32. MCI Formats:
  33. ------------
  34.  
  35.   SJGPlay supports various Media formats via the Windows MCI interface.
  36. Some formats are standard, while others are only supported when additional
  37. hardware and/or software is installed (ie: MPEG files). To see which MCI
  38. devices you have installed run the Microsoft Media player and look at the
  39. "device" menu.
  40.  
  41.   Current formats supported:
  42.  
  43.     Waveform Audio...: WAV
  44.     MIDI Sequences...: MID, RMI, KAR
  45.     Video For Windows: AVI
  46.     Quicktime Video..: MOV, QT
  47.     MPEG Video.......: MPG, DAT, MPEG
  48.     MMMovie..........: MMM
  49.     Animation........: FLC, FLI
  50.     GoldDisk Anims...: AWA, AWM
  51.     * Music Modules..: MOD, MTM, FAR, 669, OKT, STM, S3M, NST, WOW, XM
  52.     ActiveMovie 2....: AU, SND, AIF, AIFF, AIFC, MP1, MP2, MP3, MPA
  53.     
  54.     (*) Using MOD4WIN driver, currently in BETA testing.
  55.  
  56.   Additional formats can be defined in the MCI tab of the config window.
  57.  
  58.  
  59. SJGPlay Files:
  60. --------------
  61.  
  62. SJGPlay creates and/or uses these files:
  63.  
  64.     CD Information...: CDxxxxxx.CD
  65.     CD Lyrics tracks.: CDxxxxxx.Tnn
  66.     CD+G files for CD: CDxxxxxx.Gnn
  67.     CD Albums........: CDxxxxxx.ALB
  68.     Digitized Covers.: CDxxxxxx.BMP
  69.  
  70.     Multimedia Lists.: *.MML
  71.     Media file Lyrics: *.TXT
  72.     Media CD+G file..: *.CDG
  73.  
  74. (where xxxxxx is the CD Identification number based on the total number
  75.  of FRAMES on the CD, and nn is the track number; 01 to 99. All files
  76. (except album covers) are plain text files)
  77.  
  78.    Tip: To make album covers you must first get the CD's "ID Number" from
  79.     the edit window's title bar or the catalog then scan/digitize or
  80.     rename the BMP file of the cover and place it in the cover directory.
  81.     Example: Say the ID for the CD is 123456; the program will look for
  82.     and display a file called CD123456.BMP in the cover directory.
  83.  
  84.  
  85. First-time users:
  86. -----------------
  87.  
  88.   The first time you run the program it will use the built-in default
  89. settings. The default mode is "media" which will cause the edit window
  90. to automatically appear. Just click cancel if you want to play a CD. In
  91. the top section use the pull-down menu to change "media" to "CD 1". I
  92. recommend you create some directories to store your data files then
  93. click on the "config" button to set up the initial mode and the paths
  94. to the data files. Remember to save the config.
  95.  
  96.  
  97. INTRODUCTION
  98. ============
  99.  
  100.   SJGPlay is a program to play Audio CD's and Multimedia files. It is
  101. available in 16 and 32 bit versions. You must install the complete
  102. release of SJGPlay in order to properly install the VisualBASIC
  103. runtime files.
  104.  
  105.   One of it's main features is the ability to add lyrics to both CD
  106. audio tracks and media files. As well, it has the ability to display
  107. lyrics from Karaoke Midi files (KAR format) and Display graphics from
  108. CD+G files (created from Karaoke CD's).
  109.  
  110.  
  111. WINDOWS
  112. =======
  113.  
  114. The following windows make up the program:
  115.  
  116. * Main Window    - consist of various "sections" for control of the
  117.           program or for displaying information.
  118. * Config Window    - lets you set all the program options.
  119. * Edit window    - to enter album title and track name information
  120.           and/or to add media files.
  121. * Lyric Window    - Displays lyrics in sync with track playback.
  122. * CDG Window    - Displays CD+G graphics in sync to CD audio
  123.           or media (MP3, Wav etc)
  124. * Cover Window    - Displays digitized album covers.
  125. * Catalog Window- Displays catalog of cds, albums, lyrics or media lists.
  126. * Sync Window    - Lets you synchronize lyrics to track playback.
  127. * Remote Window    - A "remote control" just like your VCR remote.
  128. * Help Window    - Displays this help text.
  129.  
  130.  
  131. CONFIG WINDOW
  132. =============
  133.  
  134.   The configuration window is where all the program options can be set. At
  135. the top of the window is the current version and date. At the bottom of the
  136. window is the copyright notice and a button to save the configuration and
  137. one to close the window.
  138.  
  139. The window can be brought up by any of the following methods:
  140.  
  141.     * Click on the Side Configure button (if enabled)
  142.     * Click on the Config button in the button bar section
  143.     * Click on the "!" button on the remote, or
  144.     * Press the "!" key on the keyboard
  145.  
  146. The window consists of 6 tabbed sections:
  147.  
  148.     * Display - Options related to the look of the program
  149.     * Options - Startup and exiting options and miscellaneos features
  150.     * Lyrics  - Lyrics font and colour and window options
  151.     * Paths   - Paths for various data and to media files
  152.     * Misc    - Miscellaneos settings
  153.     * MCI     - For Custom MCI drivers
  154.  
  155.     Options on each tab are grouped by similar function.
  156.  
  157. 1) Display tab:
  158.     Display List;
  159.         Presets menu lets you select pre-defined screen layouts.
  160.         A Layout consist of one or more sections in any order. Each
  161.         section is lettered from A to J. You can also choose the
  162.         "custom" preset which lets you define your own layout (see
  163.         below). The current layout is listed. The current may be
  164.         different from the preset if you have removed sections
  165.         manually by clicking on the close button beside the section
  166.         in the main window.
  167.  
  168.         There is a checkbox to enable the "Toolbar" which will
  169.         always be at the top of the window. The toolbar activates
  170.         most common program features.
  171.  
  172.     Custom Display List;
  173.         Lets you define your own screen layout. The CC button
  174.         copies the current layout from the Display List section.
  175.         The X button clears the display list. Below are    boxes for
  176.         each section (A to J). Clicking on a box toggles the
  177.         section in the display list. Sections are added to the end
  178.         of the list. Selecting a section will cause the lettered
  179.         box to turn green so you know which sections are included.
  180.  
  181.         Tip: To design your own layout make sure the Display List
  182.         is set for "Custom", then as you click on each letter box
  183.         the main window will be updated    immediately.
  184.     Display Area;
  185.         Controls the layout of the display area (section A). Use
  186.         the Layout menu to select from one to four sections. Below
  187.         are 4 drop-down menus corresponding to the 4 areas. You    can
  188.         choose what is displayed in each area. If you select the
  189.         same option for more than one area only one will actually
  190.         appear.    The horizontal and vertical % boxes determine how
  191.         the area is split. The split can also be adjusted via the
  192.         mouse by dragging the divider bar in the area itself.
  193.     Time Display;
  194.         Lets you choose the style for the time display. There are
  195.         three styles: LCD, Red LED, and Green LED.
  196.     LCD Panel;
  197.         Determines what information is displayed in the LCD Panel
  198.         (section J), the mini control section, and the titlebar.
  199.         Check the "cycle" box to have the LCD Panel cycle between
  200.         all selected items. When cycle is off the information can
  201.         be cycled manually by clicking in the LCD panel itself.
  202.     Window On Top;
  203.         Check the boxes of the windows you want to "float" above
  204.         all other windows (provided they themselves are not set on
  205.         top as well). Note: This can cause confusion if you have
  206.         set a window to be on top and the window has been
  207.         maximixed. This will efectively shield other windows from
  208.         becoming visible! Tip: double-clicking on a window titlebar
  209.         will toggle a window from maximized to normal.
  210.     Misc;
  211.         * Titlebar:
  212.            selects what is displayed on the titlebar of the main
  213.           window. You can choose nothing, track title, album
  214.           title or the same as the LCD Panel.
  215.         * Config/Close buttons:
  216.           turns on a close button to the left of each section as
  217.           well as one big config button on the right.
  218.         * Stretch bitmaps:
  219.           if enabled makes the album cover bitmaps fill the
  220.           entire window. If not enabled the bitmap will always be
  221.           square.
  222.         * Black section outlines:
  223.           causes each section to have a black line around it to
  224.           make it appear more distinct.
  225.         * Large LCD:
  226.           Selects the large LCD character set rather than small.
  227.         * 1-Line TB:
  228.           limits the trackbutton section to a single line adding
  229.           scroll buttons if nessary.
  230.  
  231. 2) Options tab:
  232.     On Startup;
  233.         * Initial Mode:
  234.           selects CD or media mode or Remember last used.
  235.         * Auto Play;
  236.           enables auto play when each CD is inserted.
  237.         * Initial Repeat:
  238.           sets the repeat mode on startup.
  239.     On Exit;
  240.         Determines the actions when the program exits. You can have
  241.         the CD stop or be ejected. Config settings can
  242.         automatically be saved.
  243.     Shuttle;
  244.         Controls the intro time, fast-forward and reverse times.
  245.         There are two times; ">" for small and ">>" for large.
  246.     Misc;
  247.         * Auto Edit new CD:
  248.           opens edit window if CD not in catalog.
  249.         * Exit on disc ejection:
  250.           exits program if CD ejected.
  251.         * Eject CD when completed:
  252.           ejects disc at end of CD or program.
  253.         * Initial CD Unit scan:
  254.           detects number of CD units for menu.
  255.         * Use programmed tracks if available
  256.           enables program mode if there is a program saved with the
  257.           CD data file.
  258.         * Allow any file to be selected for media album:
  259.           lets you choose any file (except common files like
  260.           exe, com. bat etc) to a media album. You must have the
  261.           proper MCI driver installed to play the file.
  262.         * CD Polling:
  263.           Sets how often the CD is checked. Used for lyric playback,
  264.           blip, etc. Don't set too low or your system may be
  265.           adversely affected!        
  266.  
  267. 3) Lyrics tab:
  268.     Appearance;
  269.         Lets you select the typeface, forground and background
  270.         colours    for the lyrics via the standard windows dialogs.
  271.         Just click inside the appropriate box.
  272.     Current/Preview Size;
  273.         Chooses how lyrics are displayed. The size of the lyrics
  274.         can be set to a fixed size or can change size depending on
  275.         the size of the lyrics window or area. Limit font size
  276.         forces text to the limit set in the Font Size Limit box.
  277.     Paged List Size;
  278.         Similar to above for use with the "paged" lyrics area.
  279.         Selecting "no change" prevents the program from using the
  280.         selected Typeface on startup and/or disables further font
  281.         changes. Limit font size same as above.
  282.     Font Size Limits;
  283.         Sets the maximum and minimum allowable font size. Lets you
  284.         restrice font sizes when windows are sized so that they
  285.         don't become unreadable (too small) or too slow (big).
  286.     Separate Lyrics Window;
  287.         Sets options for the separate lyrics window. Select a
  288.         layout from the menu. You can select various combinations
  289.         of current, preview (next) or paged lyrics. If "show
  290.         control bar" is selected there will be an additional
  291.         section at the bottom that contains playback controls and
  292.         buttons    to change the layout mode or close the window. If
  293.         this section is not displayed you must close the window by
  294.         pressing the "K" key or clicking on the "Lyrics" button in
  295.         the main window. Auto open/close determines if the window
  296.         automatically opens when the track has lyrics and closes
  297.         for tracks without lyrics.
  298.         Background Picture options; None, Same as cover picture or
  299.         specific BMP file. Click on the "..." button to browse.
  300.     Misc;
  301.         Show traffic light enables the "red, yellow, green" bar
  302.         which changes to indicate when the next lyric line will
  303.         be displayed. IE: If you are using it for Karaoke this
  304.         helps you get ready to sing the next line. If "split KAR
  305.         lines" is enabled the lyrics will be split based on how
  306.         much time is between syllables. This will usually cause
  307.         words to be split in the middle (and be hyphenated), but
  308.         does allow you to better syncronize your singing. If not
  309.         enabled lines will be split as specified in the midi file.
  310.  
  311. 4) Paths tab:
  312.     Lets you specify the locations of the various data and media files.
  313.  
  314.     Data;
  315.          Audio CD Info - location of ".CD" files. 
  316.         Cover Bitmaps - location of ".BMP" files.
  317.          Media Albums - location of ".MML" files.
  318.     Media Files;
  319.         Default Path - the default path when the edit window opens.
  320.         All others - location of various media types as specified.
  321.     Misc;
  322.         Set last path as default - remembers the last path and uses
  323.         it as the default path.
  324.  
  325. 5) Misc tab:
  326.         Enter custom message and MIDI reset file.
  327.  
  328. 6) MCI tab:
  329.         Enter MCI driver names and associated extensions.
  330.  
  331.  
  332. MAIN WINDOW
  333. ===========
  334.  
  335.   The main window is designed to be as flexible as possible and to let
  336. you display as much or as little as possible while still allowing
  337. control of the program, and as such, many program functions are duplicated
  338. in the various sections. 
  339.  
  340.   The main window is fully scalable and consists of various "sections".
  341. Each section displays specific information. These sections may be in any
  342. order or not displayed at all as set in the configuration. If
  343. "Side section/config buttons" is selected in the configuration screen then
  344. there will be a button on the left of each section. Double-clicking on this
  345. button will remove the section from the main window. Clicking once and
  346. draging will allow you to move the section up or down in the window.
  347. On the right side of the window will be one tall button that is used to
  348. bring up the configuration screen.
  349.  
  350.   The main window controls all other windows. You can minimize the window
  351. so that it can't be seen however if you close the main window you will exit
  352. the program (and thereby close all other open windows).
  353.  
  354.  
  355. Display Sections
  356. ----------------
  357.  
  358.   There are several preset display lists in the configuration/display tab
  359. that contain named presets, plus one custom list for your own use.
  360.  
  361. )) Toolbar:
  362.     Contains buttons for the most common program features/options. The
  363.     toolbar is divided into 5 functional groups;
  364.     1> Configuration, Help, and Window toggles
  365.        - Config, Help, Edit, Sync, Lyrics, Cover, Catalog, Remote
  366.     2> Display option    
  367.        - Side Buttons, Change Area, Rotate Area, Next Display preset
  368.     3> Mode options
  369.          Play Mode, Repeat, Set A, Set B, Continue
  370.     3> Playback options
  371.        - Eject, Stop, Pause, Play, Previous Track, Next Track
  372.     4> Shuttle options
  373.        - Intro, Single Track Play, Rew*2, Rew, Fwd, Fwd*2
  374.  
  375. A) Display Area:
  376.     Displays various information that you choose. Can have from
  377.     one to four areas arranged in the following layouts:
  378.         - One; Fills entire area.
  379.         - Two; split horizontally.
  380.         - Two; split vertically.
  381.         - Three; one top, two bottom.
  382.         - Three; two left side, one right side.
  383.         - Four.
  384.     When more than one area is displayed the areas can be sized
  385.     using the mouse and dragging the divider bar or by entering
  386.     a split percentage in the configuration/display tab.
  387.  
  388.     The following can be displayed in the display area:
  389.         - Info. Listing of all Tracks in the album
  390.         - Karaoke. The current lyric line.
  391.         - Preview. The next lyric line.
  392.         - Lyrics Page. All the lyrics in a list.
  393.         - Cover Picture. Digitized CD cover.
  394.         - Track Time. Elapsed or remaining time.
  395.         - Video. Prevents separate video window from appearing.
  396.  
  397.     In the config you can specify which appears in each area. If
  398.     you specify the same thing in two or more sections only one
  399.     will appear.
  400.  
  401. B) Controls:
  402.     Contain the main controls for playback. The following is displayed
  403.     from left to right:
  404.     - Track number. Two digits. If the track number is greater
  405.       than 99 there will be a yellow bar underneath the number.
  406.       Clicking on the track number will bring up the edit window.
  407.     - Track time. Can display elapsed or remaining time in either
  408.       mm:ss or frames. Clicking on the time will cycle through
  409.       the various modes.
  410.     - Playback controls. From left to right:
  411.          * Eject, Stop, Pause, Play, Prev Trk, Next Trk
  412.         * Intro Play, Single Play, Rev*2, Rev, Fwd, Fwd*2
  413.     - A-B repeat. From top to bottom:
  414.         * SetA, SetB, Cancel
  415.     - Playmode. From top to bottom:
  416.         * Standard Play, Programmed Play, Random Play
  417.     - Display control. From top to bottom:
  418.         * Cycle display Area, Rotate areas, cycle display list
  419.     - CD/Media select drop-down menu.
  420.     - Track Programming drow down menu. Contains the following:
  421.         * Play.....Clicking on trackbutton plays track.
  422.         * Del......Clicking on trackbutton deletes track.
  423.         * Clear....Clears playlist
  424.         * All......Selects all tracks.
  425.         * Jumble...Mixes up order of tracks in playlist.
  426.         * Lyric Tracks. Selects only tracks that have lyrics.
  427.       This menu only appears when programmed playmode is selected.
  428.  
  429. C) Titles:
  430.     Displays pull-down menus for Album and Track.
  431.     - Album menu. Displays album name as default. Other menu options:
  432.         * Edit album info. Brings up the edit window.
  433.         * Eject. Ejects the CD or clears the media album.
  434.         * Lyrics on/off. Toggles the lyrics window.
  435.         * Cover on/off. Toggles the cover window.
  436.         * Catalog on/off. Toggles the catalog window.
  437.         * Config. Brings up the configuration window.
  438.     - Title menu. Displays current track title as default. The other
  439.       tracks are listed in the menu. Selecting a track plays it.
  440.  
  441. D) Track Buttons:    
  442.     Clicking a button plays the selected track. Clicking on a track
  443.     button when the track is playing will stop playback. If program mode
  444.     is enabled then clicking on the track will either play the track or
  445.     delete the track from the playlist depending on the setting of the
  446.     program menu (below the mode menu in the control section).
  447.  
  448.     Each track has it's own button. A maximum of 100 can be displayed
  449.     at any one time and will use as many lines as needed to display all
  450.     buttons. If "1-Line TB" is enabled only one line of buttons will be
  451.     displayed along with a set of paging buttons (if needed) to select
  452.     "pages" of tracks. Button sizes adjust automatically.
  453.  
  454. E) Elapsed track position:
  455.     Displays a bar indicating track progress. You can drag the slider
  456.         box to adjust the playback position. When A-B repeat is enabled a
  457.         grey marker appears indicating the repeat area. You can drag the
  458.     ends of this zone to adjust the A and B positions.
  459.  
  460. F) Messages:
  461.     Displays status messages. Normally displays the current track title
  462.     or the title of the track when the mouse is over top a trackbutton
  463.     (section E).
  464.  
  465. G) Blip:
  466.     A travelling green light that moves from left to right during
  467.     playback. Clicking will pause or resume playback.
  468.  
  469. H) Button Bar:
  470.     Buttons for common program functions. The following are available:
  471.     * Edit. Brings up the edit window.
  472.     * Sync. Brings up the sync window if the track has lyrics.
  473.     * Lyrics. Toggles the lyrics window.
  474.     * Cover. Toggles the cover window.
  475.     * Catalog. Toggles the catalog window.
  476.     * Config. Brings up the configuration window.
  477.     * Remote. Toggles the remote control window.
  478.     * Help. Brings up the help text file.
  479.  
  480. I) Mini controls:
  481.     Small buttons to control playback, plus the track number, time and
  482.     message. The message is the same that is displayed in the LCD
  483.     Panel section.
  484.  
  485. J) LCD Panel:
  486.     Digital display panel. Displays selected information as set in the
  487.     config display tab. The panel can be set to cycle between selected
  488.     text at a preset interval.
  489.  
  490.  
  491. EDIT WINDOW
  492. ===========
  493.  
  494.   The edit window is for editing information for the current CD or for
  495. adding files to a media album. The title bar will indicate the IDNUM for
  496. the current CD or the Album name for media albums. The album field is where
  497. the artist name and album title go, usually like "artist - album" so that
  498. albums are grouped by artist when displayed in the catalog, however you are
  499. free to enter whatever you like. Below the album field is the track number
  500. and name field. Use the cursor up/down keys to select the track number to
  501. edit. When done click on the save button. The cancel button will discard
  502. any changes you have made.
  503.  
  504.   The lyrics button lets you edit the lyrics for the chosen track. When
  505. clicked the track titles will be replaced by a text editing box. The lyrics
  506. button will be replaced by "rev" and "pause" buttons to let you control
  507. playback of the current track. Clicking the pause button pauses playback.
  508. Clicking it again continues playback. The "rev" button reverses a few
  509. seconds so you can listen to the lyrics again. Tip: Rather than using the
  510. mouse to click on these buttons you can use the ALT-R and ALT-P keys so
  511. you don't have to move your hands from the keyboard. The "clean" button
  512. removes all leading and extra spaces in the text. Do not use it if the
  513. track has already been synchronized. Clean is useful when you cut and
  514. paste lyrics from the internet.
  515.  
  516.   When finished editing click on the save button. This returns you to the
  517. normal album edit mode. Clicking Cancel returns you without saving the
  518. lyrics.
  519.  
  520. Media Mode
  521. ----------
  522.  
  523.   When media mode is selected the edit window will contain an extra section
  524. at the bottom that lets you add files to the album. In the top section
  525. two buttons will be added. In the bottom section one button will be added.
  526.  
  527. The "open" button lets you open an MML file (multimedia list) and the "del"
  528. button deletes the selected track from the album. The "use" button lets
  529. you use the tracks on the album without saving them. The "save" button
  530. saves the album to an MML file.
  531.  
  532.   On the left side of the new section is the drive and directory selectors.
  533. On the right is the preset path selector and the file list. Preset paths
  534. are defined in the config screen and allow you to define a path for each
  535. of the different media types supported. This gives you a quick method of
  536. organizing and selecting files. To add a file double-click on the filename
  537. or click once then click on the add button. To add all files in the path
  538. click the "Sel All" button then click "Add". You can also select or
  539. de-select files by holding down the CTRL or the SHIFT key when clicking on
  540. the filename. You can select a maximum of 32,767 files in a single album
  541. (memory permitting). When you add a file the file will appear in the album
  542. list in the format: FILENAME @PATH\FILENAME.EXT
  543.  
  544. By default, the filename (without the EXTension) becomes the track name.
  545. You can change the name of the track by editing it, however do not edit
  546. anything after the @ symbol (this is the complete path to the file).
  547.  
  548.  
  549. LYRICS WINDOW
  550. =============
  551.  
  552.   The lyrics window is similar to the "display area". There are several
  553. configurations for the window. You can display the current line, next line
  554. (preview) or paged list. If you have turned on the control bar there will
  555. be an "M" button that cycles between various arrangements. If the control
  556. bar is on there will also be mini playback buttons and a "done" button to
  557. close the window. If the "traffic light" has been enabled there will be
  558. a bar on the left side of the window that changes from black to red, yellow
  559. or green to indicate when the next lyric line is to be sung.
  560.  
  561.  
  562. CD+G WINDOW
  563. ===========
  564.  
  565.   Opens when a corresponding CDG file is detected. Example:
  566.  
  567.   Media......:    "THEME.MP3"    will display the file "THEME.CDG".
  568.   CD Audio...:     "CD123456.T01"    will display the file "CD123456.G01".
  569.  
  570.   About CDG files: These files are create by extracting the CD+G info from
  571.   the subcode area of a CDG disk. SJGPlay DOES NOT read the CD+G info
  572.   directly from the disc! To find out how to create CDG files please see my
  573.   home page!
  574.  
  575.  
  576. COVER WINDOW
  577. ============
  578.  
  579.   The cover window displays a digitized picture of the CD album cover. The
  580. window can be scaled to any size. If "stretch bitmap" in the configuration
  581. is set then the picture will fill the entire window and may be distorted
  582. depending on the window dimensions, otherwise the bitmap will be square.
  583.  
  584.  
  585. CATALOG WINDOW
  586. ==============
  587.  
  588.   The catalog window lets you list the CD's, Lyrics, albums, album covers,
  589. and multimedia lists in your collection. Select the catalog using the
  590. drop-down menu at the top left. To see the details of the file click on an
  591. entry and click the "View" button. Click "Return" to return to the list.
  592. Click the "Edit" button to edit the selected entry using Notepad.
  593.  
  594. On the right side is a preview window where the album cover of the selected
  595. entry will appear (if available). If "Copy to cover" is checked then the
  596. bitmap will be copied to the main cover window. To manually copy the cover
  597. click on the picture. To close the window click the "Done" button.
  598.  
  599.  
  600. SYNC WINDOW
  601. ===========
  602.  
  603.   The sync window lets you synchronize the lyrics to the playback of the
  604. current track. The sync button in the main window will not be enabled
  605. unless the current track has lyrics. When clicked the main window will
  606. disappear and playback will stop.
  607.  
  608. Initial Synchronization
  609. -----------------------
  610.  
  611.   If you haven't sync'd the track yet then the only choice you will have
  612. is the "Start New" button. When you click this button playback will start.
  613. As each line is sung press the "<- NOW" button. Continue for all the lyric
  614. lines. Click the Pause button to pause or continue playback. If you miss
  615. the start of the line you can click on the "back" button to re-try. If you
  616. clicked too early or too late you can click on the "adjust" button then use
  617. the "<<" and ">>" buttons or the scroll-bar to adjust the start of the
  618. line. When the line has been corrected click the "continue" button.
  619.  
  620. If you don't want to sync the track, click on the "Cancel" button.
  621.  
  622. When (and only when) all lines have been synchronized will you be able to
  623. save. After completing the last line the program will switch to "edit"
  624. mode and the Save button will be available.
  625.  
  626. Editing Sync
  627. ------------
  628.  
  629.   If you have already synced the track you can click on the "edit" button.
  630. When you have completed the initial sync'ing you will also be put in edit
  631. mode. In edit mode you can click the line to adjust then use the "<<" and
  632. ">>" buttons or the scroll-bar to adjust the beginning of the line. To go
  633. to the next line click the "next" button. When everything has been edited
  634. click on the "save" button.
  635.  
  636.  
  637. REMOTE CONTROL WINDOW
  638. =====================
  639.  
  640.   The remote control window works much like a VCR remote except this one
  641. also has the track number and time displayed. On the top right below the
  642. close button is the "v" button that controls the height of the remote. This
  643. lets you select the full complement of buttons or just a minimum set of
  644. playback buttons.
  645.  
  646.  The first two rows are the same as the playback controls in the main
  647. window. The third row corresponds to the buttons on the "button bar"
  648. section. The remaining rows are the numbers to select tracks or to set
  649. options. Here are the rows:
  650.  
  651.     *1> Eject, Stop, Pause, Play, Previous Track, Next Track
  652.     *2> Intro, Single Play, Rev*2, Rev, Fwd, Fwd*2
  653.     *3> Edit, Sync, Lyrics, Cover, Catalog, Config
  654.     *4> 7, 8, 9, Display Area mode, rotate area, cycle display preset
  655.     *5> 4, 5, 6, SetA, SetB, Clear A-B Repeat
  656.     *6> 1, 2, 3, 0, Cycle Play Mode, Cycle Repeat Mode
  657.  
  658.   Clicking the track number will open the edit window.
  659.  
  660.  
  661. HELP WINDOW
  662. ===========
  663.  
  664.   Displays this help file. Double-click on the titlebar to maximize the
  665. window. Click on the top right "X" to close it.
  666.  
  667.  
  668. KEY CONTROL
  669. ===========
  670.  
  671.   The following keys can be used to control the program. Note that when an
  672. element such as a list box or drop-down menu is selected then pressing a
  673. key will choose an item from the list or menu that begins with that letter.
  674. Make sure that no list boxes or menus are currently selected before
  675. pressing a key. The following keys are compatible with SJGPlay for DOS
  676. except where noted with "*". These keys work when either the main, lyric,
  677. cover, or remote window is selected.
  678.  
  679. Key(s)    Function
  680. ------    --------
  681.   0-9    Enter a 2-digit track number to select specific track
  682.   +/-    Select next/previous track
  683.   A/B    Set A/B repeat points
  684. * C    Display Catalog  
  685.   E    Edit CD Info
  686.   F    Toggle Fullscreen
  687.   G    Cycle Program mode
  688.   H/?    Display Help
  689.   I    Toggle Intro
  690.   J    Jumble (Shuffle) programmed tracks
  691. * K    Toggle Karaoke window
  692.   M    Next Display Area Mode (changes mode of lyric window if selected)
  693.   P/S    Play/Stop
  694.   R    Cycle Repeat Mode / Cancel A-B Repeat
  695.   T    Cycle Time Mode
  696. * V    Toggle Cover
  697.   X    Eject CD
  698. * Y    Sync Lyrics
  699. * Z    Pause/Resume Playback
  700. * !    Toggle Configuration window
  701. * /    Rotate Display Area contents
  702. * \    Toggle Remote Control
  703.   ,    Next pre-set display layout
  704.   ~    Re-read CD in CD-ROM drive
  705.   </>    Previous/Next CD-ROM drive unit
  706.   |    Main: Toggle Side buttons / Lyrics: Toggle control bar
  707.   ESC    Toggle Toolbar
  708.  
  709.  
  710. Troubleshooting
  711. ---------------
  712.  
  713. * You get the message "Cannot find VB40016.DLL".
  714.  
  715.      The VisualBasic 4 runtimes are not installed.
  716.      Download the complete release of SJGPlay.
  717.  
  718. * You get the message "Runtime error 31037".
  719.  
  720.      Possibly I messed up when I compiled the program. E-mail me to
  721.      report the problem. Look for an update on my homepage...
  722.  
  723. * You get the message "not a registered MCI device".
  724.  
  725.      You do not have the proper MCI driver to play the specified file.
  726.      For example to play MP3 or MPEG files you need ActiveMovie 2.
  727.      To verify that an MCI driver is correctly installed run
  728.      Microsoft's Media Player and look under the devices menu.
  729.  
  730. * ActiveMovie is installed but doesn't appear in Media Player.
  731.  
  732.      Check your SYSTEM.INI file for the line: ActiveMovie=mciqtz.drv
  733.      If it is missing you must add it to the [MCI] section.
  734.  
  735. * The Control buttons are all garbled.
  736.  
  737.      This is a known problem with Diamond Stealth Video cards.
  738.      Try updating your video driver.
  739.  
  740. * Can't skip to next track or there is a long delay.
  741.  
  742.      This seems to happen on older CD-ROM drives.
  743.      Try finding a newer CD-ROM driver or get a newer drive.
  744.  
  745. <<<END>>>