home *** CD-ROM | disk | FTP | other *** search
/ Chip 2003 April / Chip_2003-04_cd1.bin / zkuste / digifoto / where / download / WhereIsIt / setup.exe / %MAINDIR% / Plugins / CDDAPlugin.txt < prev    next >
Encoding:
Text File  |  2002-08-11  |  10.4 KB  |  211 lines
  1. WhereIsIt? version 3.26
  2. Copyright (c) 1997-2002 Robert Galle
  3. All Rights Reserved
  4.  
  5.  
  6. CDDA PLUGINS MODULE
  7. ===================
  8.  
  9. This module contains three plugins related to handling CDDA audio CD disks,
  10. including extracting description details based on CD-TEXT information,
  11. querying a CDDB server locally or over the Internet for audio CD details,
  12. and extracting disk information from either CDPlayer.ini file, or .CDA audio
  13. track files themselves.
  14.  
  15. Installing The Module
  16. ---------------------
  17. Copy the "CDDAPlugin.dll" file in subfolder "Plugins" in WhereIsIt's main
  18. folder, for example, "C:\Program Files\WhereIsIt\Plugins". When WhereIsIt is
  19. run the next time, it will recognize and include the new plugin module. You
  20. can further setup or adjust settings for each individual plugin through their
  21. own setup dialogs.
  22.  
  23. ------------------------------------------------------------------------------
  24.  
  25. AUDIO CD-TEXT DESCRIPTION PLUGIN
  26. ================================
  27.  
  28. This plugin can import the CD-Text details, available on many Audio CDs today,
  29. especially those issued by Sony Music over the last few years. CD Text details
  30. most often include disk name and artist, disk ID, and title/performer info
  31. for each track on the CD. Less common details are lyrics authors, composers,
  32. arrangers, custom messages from either of those, etc. If available, this
  33. plugin will import those as well.
  34.  
  35.  
  36. Limitations And System Requirements
  37. -----------------------------------
  38. Of course, you need a CD-ROM/CD-R/CD-RW/DVD drive capable of reading CD-Text
  39. information. Not all drives are capable of that, although most of newer drives
  40. shouldn't have any problems.
  41.  
  42. You also need to have a valid ASPI driver (wnaspi32.dll) available on your 
  43. system, if you are using Windows 9x/ME. It is very likely you have it in place 
  44. already, Windows 9x/Me provides one by default. If you don't have it, you can 
  45. download it from Adaptec (http://www.adaptec.com), or use a link on WhereIsIt's 
  46. download page. Note that certain third-party ASPI drivers, commonly shipping 
  47. with CDR software are not standard and can cause problems in WhereIsIt and other 
  48. applications using ASPI layer. If you are experiencing problems accessing CD-ROM 
  49. or removable drives in WhereIsIt, re- installing the original Adaptec ASPI 
  50. drivers may often help to resolve the issue.
  51. Windows NT/2000/XP users do not need to have ASPI available, as SPTI is used 
  52. instead on those systems.
  53.  
  54. The Audio CD plugin currently comes with some limitations as well. There is
  55. very little documentation available on CD-Text implementation, and basically
  56. none of it from official sources.
  57. The plugin does not handle CD-Text stored in Double Byte Character Code (DBCC)
  58. format, nor does it support CD-Text info stored in multiple languages (the
  59. first language is used in this case). Plugin will only import CD-Text stored
  60. in the TOC of audio CDs - some rare implementations store CD-Text in the data
  61. area of audio CD, those are not supported by this plugin.
  62.  
  63. How To Use It
  64. -------------
  65. There are no specific actions necessary to active or use the CD-TEXT plugin.
  66. As with all plugins, make sure that plugin's priority is set accordingly
  67. compared to other plugins that can also try to import details about audio CDs.
  68.  
  69. In order to setup the available settings of Audio CD Text plugin, select
  70. "Description Settings" option in program's "Settings" menu, select to view
  71. available plugins, highlight the "Audio CD Text" plugin on the list, and
  72. click the "Configure" button. This will bring up plugin's own setup dialog.
  73.  
  74. ------------------------------------------------------------------------------
  75.  
  76. CDDB AUDIO CD PLUGIN
  77. ====================
  78.  
  79. In order to use this plugin for remote CDDB queries, you must have an
  80. active Internet connection at the time this plugin is being used, and the
  81. Wininet.dll library available on your system. The latter shouldn't be a
  82. problem unless you are using one of the earliest version of Windows 95
  83. (pre-OSR2). In order to use a local CDDB database, you need to have it
  84. downloaded and installed on your disk, and CDDB plugin must be configured
  85. by specifying the path where local CDDB database is available, and the
  86. format of CDDB database (Windows / Unix type). Additional options are
  87. available in plugin's setup dialog.
  88.  
  89. Installed and functioning ASPI driver is highly recommended, although not
  90. necessary. Please note that if your Audio CD is being used by some other
  91. application at the time WhereIsIt scans it (for example, it is being played
  92. by a CD Player software), chances are that WhereIsIt may not be able to
  93. access the CD and retrieve the necessary CDDB details to be used with
  94. queries. Options related to CDDB queries are not available for CDs missing
  95. this information.
  96.  
  97. As there is more than one plugin in the package capable of handling audio
  98. CD disks, take care how do you set plugins priority. As all other plugins,
  99. audio plugins are executing one by one based on their assigned priority,
  100. until one of them can provide a description. If you want to import CDDB data,
  101. make sure the CDDB plugin has higher priority than Audio CD Tracks plugin,
  102. otherwise a generic audio track data will be imported by Audio CD plugin
  103. instead. Similary, if CD-Text plugin has higher priority than CDDB plugin,
  104. CDDB plugin will only get to be used if audio CD does not contain CD-Text,
  105. or the CD-Text plugin wasn't able to retrieve it for some reason.
  106.  
  107. The CDDB plugin is set to use the free freedb.org servers instead of the
  108. commercial CDDB.com database. The CDDB server address to be used is user-
  109. configurable and can be set in plugin's config dialog (you can retrieve
  110. the list of all available freedb mirrors from the http://freedb.freedb.org
  111. server, or by visiting the http://www.freedb.org web site.
  112.  
  113. In some cases CDDB server can return inexact hits, or multiple hits. This
  114. plugin will by default ignore them both and rather leave the description
  115. empty than taking chances to import details for the wrong CD. Alternatively,
  116. you can also setup the CDDB plugin in its config dialog to stop in such
  117. cases and present to user a dialog where he can select appropriate entry
  118. out of possible ones as presented by CDDB server. Please note that enabling
  119. such options may interfere with scanning the media, and may cause problems
  120. if program is expected to work on its own, for example with scheduled auto-
  121. matic updates.
  122. Cases of multiple hits are fairly rare to encounter though, large majority
  123. of entries in CDDB database are unique.
  124.  
  125. The CDDB plugin can also use a local CDDB database, available on your hard
  126. drive. If you want to enable local CDDB database, you need to enter a path
  127. to where a local CDDB database is located in plugin's settings. Both Windows
  128. and Unix formats of local CDDB database are supported. The CDDB plugin can
  129. optionally use local CDDB database for queries (therefore it is not necessary
  130. to be connected to the Internet), or it can store successfully retrieved
  131. remote CDDB queries to the local database as well, making them available
  132. offline the next time they are needed. Please note that local CDDB queries
  133. are more basic that remote queries - close (fuzzy) matches are not supported
  134. with local CDDB queries.
  135.  
  136. You can download the whole CDDB database from the http://www.freedb.org, in
  137. either of the two formats available and supported. The Windows format
  138. database is recommended for most cases.
  139.  
  140. Notes
  141. -----
  142.  
  143. The CDDB plugin returns CDDB revision level as a part of disk's description.
  144. While this detail is not of much use to users, it is needed when posting
  145. updated disk details back to CDDB server. Entries missing revision level info
  146. are automatically submitted with revision level 0, meaning they can not be
  147. used to replace existing disk data in CDDB database. If you plan to be
  148. submitting updated disk details to CDDB database, please leave the revision
  149. level detail in place for best results.
  150.  
  151. ------------------------------------------------------------------------------
  152.  
  153. AUDIO CD TRACK FILES
  154. ====================
  155.  
  156. This is a simple plugin that can just about always provide a description,
  157. therefore it should have the lowest priority out of the three. It will first
  158. try to locate a matching audio CD details in the CDPlayer.ini, and if one
  159. available, it will import track details from there. Otherwise, the simulated
  160. Trackxx.cda file is parsed, retrieving its track number on the CD, and play
  161. time for that track as a description.
  162.  
  163. ------------------------------------------------------------------------------
  164.  
  165. 1.20 (17. October 2002)
  166. -----------------------
  167. + All three plugins now have the option of custom formatted descriptions.
  168.  
  169. 1.14 (1. January 2002)
  170. ----------------------
  171. + Added SPTI support for the CD Text plugin. ASPI is now no longer used or
  172.   required when running on Windows NT, 2000, or XP. ASPI layer is still used
  173.   and required for the CD Text plugin when running on Windows 9x/ME.
  174.  
  175. 1.13 (21. October 2001)
  176. -----------------------
  177. + Added an option to include audio track number in alias names for the generic
  178.   Audio CD plugin.
  179.  
  180. 1.12 (18. September 2001)
  181. -------------------------
  182. + Updated the MP3 and WAV Audio Files plugin, certain small WAV files with no 
  183.   data information were confirmed to cause problems when handled by this plugin 
  184.   and could cause scanning to abort. 
  185.  
  186. 1.11 (12. July 2001)
  187. --------------------
  188. + Improved the CDDB plugin to handle the new level 5 protocol, introducing
  189.   genre and year information to CDDB entries.
  190.  
  191. 1.10 (23. June 2001)
  192. --------------------
  193. + Lots of changes, buxfixes and improvements to the new CDDB plugin, to
  194.   ensure proper compatibility with the freedb.org database and other programs
  195.   that may be using it locally. The CDDB plugin is now officially certified
  196.   by freedb.org for freedb compatibility.
  197.  
  198. 1.00 (11. June 2001)
  199. --------------------
  200. + initial release in current form, combining all three audio CD plugins
  201.   together as a standalone module. The CDDB plugin has gone through a major
  202.   rewrite in this release, and the CD-TEXT plugin is fairly new as well,
  203.   just out of beta.
  204.  
  205.  
  206. ---------------------------------------------------------------------------
  207. The DescAPI and CDDAPlugin.dll module are an integral part of the WhereIsIt
  208. software package and as such a copyrighted material. Using or distributing
  209. these librarires for any purpose other than running them as a part of
  210. WhereIsIt is prohibited and in violation of copyright laws.
  211. ---------------------------------------------------------------------------