home *** CD-ROM | disk | FTP | other *** search
/ The Games Machine 33 / XENIATGM33.iso / e-mail / illo / ntfy_cd.doc < prev    next >
Text File  |  1997-09-04  |  12KB  |  342 lines
  1.  
  2.  
  3.                     
  4.  
  5.                              Notify CD Player
  6.                                                 
  7.                     for Windows 95 and Windows NT 4.0
  8.  
  9.                                     
  10.                                Version 1.20
  11.  
  12.                     
  13.                   Copyright (c) 1996-1997, Mats Ljungqvist
  14.  
  15.                             mlt@cyberdude.com
  16.  
  17.                 http://www.artech.se/~mlt/software/index.html
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  --- Contents ---------------------------------------------------------------
  25.  
  26.     1. Introduction
  27.     
  28.     2. Legal stuff
  29.  
  30.     3. How to install
  31.     
  32.     4. How to use
  33.         - The fast left-click functions
  34.         - The right-click context menu
  35.         - CD Info/Program
  36.         - Options
  37.         - CD Database Editor
  38.     
  39.     5. DB plug-ins
  40.  
  41.     6. Feedback, suggestions, bug-reports
  42.  
  43.     7. Credits
  44.  
  45.     
  46.  --- 1. Introduction --------------------------------------------------------
  47.  
  48.     Notify CD Player is a CD player for regular audio CD's (including mixed
  49.     data/audio) and resides in the systray (Also called Notify Tray). 
  50.  
  51.     It works on Windows 95 and Windows NT 4.0.
  52.  
  53.     Fast operation of the most commonly used actions by left-clicking a 
  54.     configurable number of times on the icon.
  55.  
  56.     It has an extensive amount of functionality in the context menu shown by
  57.     right-clicking the icon.
  58.  
  59.     Tray displays current "play" status.
  60.  
  61.     Other features include:
  62.  
  63.     - Compatible with the CD database used by the standard CD Player.
  64.     - Configurable tooltip disc/track information display.
  65.     - Configurable track menu that shows the actual track names.
  66.     - Programmed play.
  67.     - Random/Repeat (Whole or Track).
  68.     - Skip function to change position inside a track.
  69.     - CD DB Editor with Export/Import functions.
  70.     - Responds to different Windows requests to allow autoplay etc.
  71.     - Database plug-in. Currently features the XMCD CDDB (local and remote) 
  72.       and ODBC. (Note: These have to be downloaded separatly and installed 
  73.       using the instructions provided with them)
  74.     - Can be set to exit when the CD is removed for seamless operation. 
  75.  
  76.  
  77.  --- 2. Legal stuff ---------------------------------------------------------
  78.  
  79.     Notify CD Player is *FREEWARE*. That means, You don't have to pay me 
  80.     anything and I'm not forced to give You support. Deal? :)
  81.  
  82.     I do give support when I have time, but I can't guarantee You anything
  83.     and it might take a while before You get an answer.
  84.  
  85.     No *REGISTRATION* is needed, but I always apreciate e-mail's telling me 
  86.     that You use the program.
  87.  
  88.     I take no responsibility by *ANY* damages caused by this program! 
  89.  
  90.  
  91.  --- 3. How to install ------------------------------------------------------
  92.  
  93.     Installation is done by copying the NTFY_CD.EXE to a choosen location. 
  94.     (Preferably the WINDOWS directory or You will have to change the 
  95.      reg file described below)
  96.  
  97.     Thats it if You don't want to replace the standard CD Players actions.
  98.  
  99.     To replace default Autoplay program and to map the .CDA extension to 
  100.     Notify CD Player import the NTFY_CD.REG file by double-clicking the icon
  101.     in the Explorer.
  102.  
  103.     You can also just copy NTFY_CD.EXE over the existing CDPLAYER.EXE in
  104.     Your Windows directory.
  105.  
  106.  
  107.  --- 4. How to use ----------------------------------------------------------
  108.  
  109.     - The fast left-click functions
  110.     -------------------------------
  111.  
  112.         The fast left-click functions include the five most commonly used 
  113.         functions on a CD player. I.e. Play, Pause, Next, Prev, Stop.
  114.  
  115.         These functions is accessable by clicking a configurable number of 
  116.         times on the icon in the tray.
  117.  
  118.         The default settings are:
  119.  
  120.         Play/Next        1 click
  121.         Pause/Resume    2 clicks
  122.         Prev            3 clicks
  123.         Stop            4 clicks
  124.  
  125.         So to start playing Your disc, if it's not already playing due to 
  126.         Windows autoplay, You can click once on the icon.
  127.  
  128.         Note how the icon change from the "stop" icon to the "play" icon!
  129.  
  130.         To pause, click two times on the icon. The icon changes to a "pause"
  131.         icon.
  132.  
  133.         To resume click one or two times (in this case Play/Next is the same
  134.         as resume). The disc starts to play again.
  135.  
  136.         Change to the next track by clicking one time on the icon.
  137.  
  138.         Stop the disc by clicking four times. The icon changes back to the 
  139.         "stop" icon.
  140.  
  141.  
  142.         The number of clicks are configurable in the Options dialog found 
  143.         under the Options command in the context menu.
  144.  
  145.  
  146.     - The right-click context menu
  147.     ------------------------------
  148.  
  149.         The right-click context menu contains everything Notify CD Player can 
  150.         do besides the fast left-click functions.
  151.  
  152.         The common Play/Stop/Next/Prev etc are all there, so are a Tracks 
  153.         menu, open and close options, repeat, random etc.
  154.  
  155.         Tracks
  156.         ------
  157.         Choose the Tracks submenu and You'll see the names of the tracks (if 
  158.         You have any DB with data in it) or the default "Track 1" names along 
  159.         with track lengths. You can choose which track to play by selecting 
  160.         it in the tracks menu. 
  161.         The tracks menu can also be configured to be a separate column in the 
  162.         context menu and then the Tracks submenu will dissapear. 
  163.         The tracks menu can also be divided into submenys if the disc You 
  164.         currently have in the player has more than 25 tracks. 
  165.         This function can be disabled in the options dialog if You have a 
  166.         high screen resolution and therefore doesn't need to break up the 
  167.         tracks.
  168.  
  169.         Other
  170.         -----
  171.         The Other submenu contains less used commands. 
  172.         
  173.         The functions found here are:
  174.         
  175.         - Play whole which causes the player to bypass any playlist You might 
  176.           have set up in the CD Info/Program dialog, but it doesn't remove 
  177.           the playlist from the configuration for this disc.
  178.         - Repeat Track causes the current track to be repeated.
  179.         - Set absolute position can be used to move to a specified track and 
  180.           a specified position on that track. For example if there is 
  181.           some interesting sound at a specific position on a certain track 
  182.           this can be used to find it again.
  183.         - Skip lets You cue inside the current track.
  184.         - CD Database Editor brings up the database editor described below.
  185.  
  186.  
  187.     - CD Info/Program
  188.     -----------------
  189.         
  190.         The CD Info/Program dialog plays a central role in Notify CD Player
  191.         since it's the place where You enter information about the disc 
  192.         playing, like Artist, tracks etc. This is also where You set up
  193.         a playlist where You can program tracks in a certain order or play
  194.         the same track many times etc.
  195.  
  196.         The buttons are pretty straight forward I think, but the Internet DB
  197.         can be worth mentioning. This button is only shown when the CDDB 
  198.         database plug-in is used. 
  199.         
  200.         The options on this button is:
  201.         - Get from Internet. This option queries the remote server for info 
  202.           about the current disc.
  203.         - Send to Internet. This option send this disc information to the 
  204.           central CDDB repository by e-mail.
  205.         
  206.         The CDDB database has a number of remote servers on the Internet which 
  207.         You can query for disc information. The database is quite large so 
  208.         it can be inconvinient to store it on the local disc. This database 
  209.         currently consist of more than 13,000 discs!
  210.  
  211.  
  212.     - Options
  213.     ---------
  214.  
  215.         The options dialog is where You configure the fast left-click 
  216.         functions, as well as specifying what information to show in
  217.         the ToolTip.
  218.  
  219.         Time display in tooltip
  220.         -----------------------
  221.         Specifies what time information to show in the tooltip.
  222.  
  223.         CD Info display in tooltip
  224.         --------------------------
  225.         Specifies what disc information to show in the tooltip.
  226.  
  227.         Default CD Device
  228.         -----------------
  229.         Specifies which CD device to use by default when starting up and no    
  230.         other device is specified on the command line. Only used by users 
  231.         with multiple CD devices.
  232.  
  233.         Misc options
  234.         ------------
  235.         - Stop CD on exit. Causes Notify CD Player to stop playing before
  236.           exiting.
  237.         - Stop CD on start. Causes Notify CD Player to stop playing when 
  238.           starting.
  239.         - Exit on CD remove. Cause Notify CD Player to exit when the disc is
  240.           removed. This can be pretty nice when used together with Windows
  241.           autoplay since the Autoplay function will start Notify CD Player
  242.           again when a disc is inserted.
  243.         - Prev always prev track. By default Notify CD Player restarts the 
  244.           current track if prev is choosen and more than five seconds have
  245.           been played of the track instead of selecting the prev track. This
  246.           option causes the player to always choose the prev track and never
  247.           restart the track when prev i choosen.
  248.         - Remember status. Causes the player to remember certain status flags
  249.           such as repeat and random between runs.
  250.         - Full status check. Can be used on older CD devices or devices with 
  251.           bad drivers that doesn't send notification messages when a disc is
  252.           available etc.
  253.         - Tracks menu as column. Causes the tracks menu to dissapear and 
  254.           appear as a second column in the context menu. Check it out! It's 
  255.           pretty cool!
  256.         - No bitmap in menu. Turns of the bitmap shown in the context menu.
  257.         - No menu break. By default Notify CD Player breaks up the tracks menu
  258.           into submenus when a disc with more than 25 tracks is used. This 
  259.           option prevents this.
  260.  
  261.         Left button number of clicks
  262.         ----------------------------
  263.         This is where You configure the number of clicks to use for the fast
  264.         left-click operations. A value of 0 disables that function.
  265.  
  266.         Poll status every
  267.         -----------------
  268.         Is used when no disc is in the drive or when the full status check
  269.         option is used. A value of 1 is ok.
  270.  
  271.  
  272.         Categories
  273.         ----------
  274.         Choose this to alter the default set of categories. Note! Do not do 
  275.         this if You use the XMCD CDDB plug-in!
  276.  
  277.         DB Options
  278.         ----------
  279.         Is only available if You use a DB plug-in that has an additional 
  280.         options dialog. See the plug-in documentation for information on 
  281.         how to use the dialog that shows up when selecting this button.
  282.  
  283.  
  284.     - CD Database Editor
  285.     --------------------
  286.  
  287.     The CD Database Editor is used to alter disc information or to export or 
  288.     import disc information.
  289.  
  290.     The discs have a right-click context menu where You make an alias, change
  291.     the category of that disc or delete that disc from the DB.
  292.  
  293.  
  294.  --- 5. DB plug-ins ---------------------------------------------------------
  295.  
  296.     There is currently two DB plug-ins available.
  297.  
  298.     - ODBC plug-in uses an ODBC datasource residing in a MS Access database
  299.       or an SQL Server database.
  300.     - CDDB for use with the XMCD CDDB format. This plug-in can handle both
  301.       local file versions as well as the remote server query function.
  302.  
  303.     Check out the homepage for more info on these plug-ins.
  304.  
  305.  
  306.  --- 6. Feedback, suggestions, bug-reports ----------------------------------
  307.  
  308.     All feedback, suggestions and bug-reports to mlt@cyberdude.com
  309.  
  310.     Please include "Notify CD Player" as well as "BUG, SUGGESTION or FEEDBACK"
  311.     in the subject line.
  312.  
  313.     There is an option that can be set in the CDPLAYER.INI file under the 
  314.     [NTFY_CD] section that causes the app to generate a logfile on 
  315.     C:\NTFY_CD.LOG
  316.  
  317.     It is:
  318.     
  319.     [NTFY_CD]
  320.     LOGFILE=1
  321.  
  322.     Set this and mail me the results if You have any problems!
  323.     
  324.     Also don't forget to include the version You are using. This is found in 
  325.     the about box. Also include any DB plug-ins You are running.
  326.  
  327.  
  328.  --- 7. Credits -------------------------------------------------------------
  329.  
  330.     I would like to thank everyone that have supplied me with valuble 
  331.     feedback and suggestions for new features as well as the beta testers
  332.     which at times have gotten their hands on more or less useless version 
  333.     of this program. Thanks for Your patience! :-)
  334.  
  335.     Thanks to vginkel@idirect.com for the bitmap used in the context menu.
  336.  
  337.     Notify CD Player is written in plain C with plain Win32 and MCI API calls
  338.     using Microsoft Developer Studio.
  339.  
  340.     Well, thats about it, happy playing!
  341.  
  342.