home *** CD-ROM | disk | FTP | other *** search
/ In'side Shareware 1995 March / ish0395.iso / os2 / dmp / dmplayer.hlp (.txt) < prev    next >
OS/2 Help File  |  1994-12-26  |  42KB  |  833 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4.                               Digital Music Player
  5.                              Copyright (c) 1994 Aria
  6.                                All rights reserved
  7.  
  8. Digital Music Player is a multi-threaded digital media player.  DMPlayer 
  9. supports the playback of any media directly supported by the MMPM/2 system as 
  10. well as MOD format music modules.  All that is required is that the MMPM/2 
  11. multimedia extensions must be installed.  A digital capable audio adapter is 
  12. required.  DMPlayer has been designed to work well with you.  It is capable of 
  13. playing songs in the background while you get real work done with a minimum of 
  14. interruption (aside from the wonderful music of course).  You will be able to 
  15. listen to your favorite modules and still have a responsive system at your 
  16. fingertips.  DMPlayer will play modules compressed with your favorite archiver, 
  17. such as zip, zoo or gzip.  Multi-file archives are not supported.  DMPlayer 
  18. only supports the playback of compressed MOD files, the MMPM/s system does not 
  19. support playback of compressed files at the time of this writing.  You can 
  20. create and save list of your favorite media elements.  You can mix MOD, WAVE, 
  21. MIDI and AVI files all in one SongList!  These SongLists can be saved to be 
  22. loaded at a later date.  DMPlayer even (optionally) cooperates with the system 
  23. sounds provided by MMPM/2. 
  24.  
  25. Digital Music Player remembers a lot of things between sessions.  Such as which 
  26. windows were open and where they were positioned as well as all of the settings 
  27. and even the last SongList that was opened!  This makes using the program 
  28. easier each time you run it.  You even have the option of starting DMPlayer 
  29. minimized as well as automatically starting to play the loaded SongList. 
  30.  
  31. Digital Music Player is currently capable of playing the following formats: 
  32.  
  33.      4 track, 31 and 15 instrument Protracker/Noisetracker modules 
  34.      4 and 8 track Startrekker modules 
  35.      6 and 8 track Fasttracker modules 
  36.  
  37.  The following formats are also supported through MMPM/2: 
  38.  
  39.      .WAV audio sample files. 
  40.      .MID MIDI song files. 
  41.      .AVI Audio-Video Interleave video animation files. 
  42.      Any other format supported by MMPM/2 in the future. 
  43.  
  44.  
  45. ΓòÉΓòÉΓòÉ 2. Ariaware ΓòÉΓòÉΓòÉ
  46.  
  47. This software product is provided to you for the sole purpose of evaluation 
  48. prior to purchase.  DMPlayer is not free.  You are granted license to a trial 
  49. evaluation period of 30 days in which to determine if you wish to continue 
  50. using the program.  If you decide to use DMPlayer after the 30 day trial 
  51. period, you must pay the registration fee of $25  (US).  Any use beyond the 30 
  52. day trial period is prohibited by law.  Please go to Registration for more 
  53. information on how to register. 
  54.  
  55. Digital Music Player is (c) 1994 Aria. All rights reserved. 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 2.1. Limitations ΓòÉΓòÉΓòÉ
  59.  
  60. If you have not registered DMPlayer, then you will have to face up to a few 
  61. limitations.  These limitations are critical, however, they do not interfere 
  62. with the evaluation of the program. 
  63.  
  64. The current limitations are as follows: 
  65.  
  66.    1. Inability to save settings between sessions.  Normally, DMPlayer would 
  67.       remember window positions, audio settings, playback settings and 
  68.       directories accessed. 
  69.  
  70.    2. Inability to load or save SongLists.  All other aspects of the SongList 
  71.       window are fully functional. 
  72.  
  73.  I hope that you do not find that these limitations are too restrictive.  You 
  74.  should still be able to determine whether or not you wish to use the program 
  75.  even with these restrictions. 
  76.  
  77.  Due to these limitations, many people may quickly dub this software as 
  78.  'Crippleware' or the like.  Be that as it may, I have made a serious 
  79.  investment in the development of DMPlayer and I must protect that investment. 
  80.  I have tried to do so in the most benign manner possible. 
  81.  
  82.  
  83. ΓòÉΓòÉΓòÉ 2.2. Registration ΓòÉΓòÉΓòÉ
  84.  
  85. When you register DMPlayer, you will receive a keyfile unlocking the full 
  86. functionality of the program.  The one time registration fee will provide you 
  87. with free upgrades for the life of this program.  Both minor and major upgrades 
  88. will be made available via your favorite OS/2 shareware distribution site.  All 
  89. future versions of this program will automatically be unlocked by the keyfile 
  90. you will receive. 
  91.  
  92. There are two ways to receive your keyfile: 
  93.  
  94.    1. Slooooow, snail mail 
  95.  
  96.    2. Faaaaast, electronic mail to your internet or CompuServe address 
  97.  
  98.  The default action for me is to return your keyfile through the mail system. 
  99.  You and I both would probably rather I returned your keyfile through email if 
  100.  at all possible.  I will do this on the condition that I receive some form of 
  101.  proof of address of the mailing address you send to me.  Here are some 
  102.  examples of this proof: 
  103.  
  104.    1. Personal check.  If you write me a check, then it probably has your 
  105.       address on it and that is proof enough for me. 
  106.  
  107.    2. Address label (or photocopy) of some piece of mail addressed to you at 
  108.       the given address.  Such as a power bill or something. 
  109.  
  110.    3. Photocopy of some ID card with your name and address on it. 
  111.  
  112.    4. Several other things that I can't think of.  As long as your name and 
  113.       address appear on something official, it will do. 
  114.  
  115.  Pretty simple, eh?  If you provide one of the above, then I will get the 
  116.  keyfile emailed out to you the day I receive your registration (Or shortly 
  117.  thereafter).  If you don't, then I'll put the keyfile on a disk and mail it to 
  118.  you as soon as I can.  You just can't beat that! 
  119.  
  120.  Print the REGISTRATION FORM to order your copy of Digital Music Player. 
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ 2.3. REGISTRATION FORM ΓòÉΓòÉΓòÉ
  124.  
  125. Send this form to:
  126.  
  127.      Aria
  128.      P.O. Box 1889
  129.      Corvallis, OR  97339-1889
  130.  
  131. Price             $ 25.00 (US)
  132.  
  133. Free upgrades for the life of the program!
  134.  
  135.  o  Please send a Check or Money Order to the address above.
  136.  o  Make Checks and Money Orders out to Aria.
  137.  o  Credit cards are not accepted at this time.
  138.  o  All orders must be in US Dollars.
  139.  o  No COD's.
  140.  
  141. The following information will be encoded in the keyfile sent to you.
  142. Please print or type. Failure to provide complete and accurate information
  143. will result in your order being delayed or possibly not processed.
  144.  
  145. Name   ________________________________________
  146.  
  147.  
  148. Mailing  ________________________________________
  149. Address
  150.      ________________________________________
  151.  
  152.      ________________________________________
  153.  
  154.      ________________________________________
  155.  
  156.  
  157. Email   ________________________________________
  158.       (Internet address or Compuserve ID)
  159.  
  160. Phone   ________________________________________
  161.     (Optional. May help if there is a problem.)
  162.  
  163. Disk   ___ 3.5"  ___ 5.25"
  164.  
  165. Comments:  (Where did you find DMPlayer?)
  166.  
  167.  
  168. ΓòÉΓòÉΓòÉ 2.4. Contacting the author ΓòÉΓòÉΓòÉ
  169.  
  170. DMPlayer is an evolving product.  Support for other module formats may become 
  171. available in the future.  More functionality may be added at some later date. 
  172. All of which is free to registered users.  Support is made available via the 
  173. internet.  CompuServe users can send mail to the following addresses also by 
  174. specifying the internet mail option. 
  175.  
  176. Mail questions and/or comments to: 
  177.  
  178. dodger@kira.csos.orst.edu
  179.  
  180. You can always find the newest version of Digital Music Player via ftp at: 
  181.  
  182. ftp.cdrom.com
  183. hobbes.nmsu.edu
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 2.5. Distribution ΓòÉΓòÉΓòÉ
  187.  
  188. Digital Music Player may be freely distributed provided that the entire archive 
  189. remains intact.  Shareware distributors may not charge more than $5 (including 
  190. shipping) for this software package. 
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 2.6. Warranty ΓòÉΓòÉΓòÉ
  194.  
  195. No warranty of any kind is implicitly or explicitly granted through use of this 
  196. program.  Aria will not be held liable for any damages resulting form the use 
  197. of this product. 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 3. Installation ΓòÉΓòÉΓòÉ
  201.  
  202. Digital Music Player needs no special setup.  Simply copy the program file 
  203. 'DMPlayer.EXE' into a directory and create a program object if you desire.  You 
  204. should copy the help file 'DMPlayer.HLP' into a directory that is in your help 
  205. path.  DMPlayer can be placed anywhere.  It will search for, or create any 
  206. files that it needs in the directory where the executable is.  This will allow 
  207. DMPlayer to be run from the command line without cluttering your file system 
  208. with DMPlayer.INI files. 
  209.  
  210. When you register you will receive the keyfile 'DMPlayer.KEY'.  This file 
  211. should be placed in the same directory as 'DMPlayer.EXE'. 
  212.  
  213.  
  214. ΓòÉΓòÉΓòÉ 4. Running DMPlayer ΓòÉΓòÉΓòÉ
  215.  
  216. DMPlayer will accept MOD files from the command line.  DMPlayer understands the 
  217. standard OS/2 wildcard system for selecting files.  You can specify as many 
  218. files as you like on the command line: 
  219.  
  220.       DMPlayer CoolSong.mod
  221.       DMPlayer mod.* *.mod
  222.       DMPlayer chicken.wav CoolSong.mod "Even Cooler Video.AVI"
  223.  
  224. DMPlayer will create a new songlist containing all the files specified on the 
  225. command line. 
  226.  
  227. DMPlayer may also be associated with all of your MOD files for even better 
  228. integration with the WPS. 
  229.  
  230.  
  231. ΓòÉΓòÉΓòÉ 5. Using DMPlayer ΓòÉΓòÉΓòÉ
  232.  
  233. The functionality of Digital Music Player is spread throughout several 
  234. different dialogs and windows.  This allows DMPlayer to take up as little or as 
  235. much screen space as you desire. 
  236.  
  237.                                  The Main Dialog
  238.                               The Settings Notebook
  239.                                The SongList Window
  240.                                 The Mixer Dialog
  241.                               The Song Info Dialog
  242.  
  243.  
  244. ΓòÉΓòÉΓòÉ 5.1. The Main Dialog ΓòÉΓòÉΓòÉ
  245.  
  246. Select a control on the DMPlayer main dialog and Double-Click (or press Enter) 
  247. to see more information about that control. 
  248.  
  249. Digital Music Player has been designed to be as useful as possible and yet to 
  250. be as unobtrusive as possible at the same time.  Needless to say, it was also 
  251. designed with good looks in mind.  The main dialog, pictured above, displays a 
  252. lot of information about what is happening at any time.  The dialog was 
  253. designed to somewhat resemble a CD player just so you would be vaguely familiar 
  254. with the interface from the start.  The controls will act very similarly to 
  255. their real-world counterparts.  You should be set to go! 
  256.  
  257. If you have not done so yet, you may want to take the time to double-click on 
  258. all the controls on the dialog shown above.  You will see control specific 
  259. information in a window with more details about what is happening and why it 
  260. may be happening. 
  261.  
  262.  
  263. ΓòÉΓòÉΓòÉ 5.2. The Settings Notebook ΓòÉΓòÉΓòÉ
  264.  
  265. The Settings Notebook contains all of the options relative to the loading and 
  266. playing of music modules.  Most of these settings will have no effect on the 
  267. playback of file formats directly supported by MMPM/2 such as .WAV files. The 
  268. notebook is an elegant way to combine multiple, diverse settings in one, simple 
  269. and easy to use control.  The notebook is sizable, and will remember size and 
  270. position (in the registered version) as will the rest of the windows. 
  271.  
  272. There are 4 pages in the notebook: 
  273.  
  274.    1. The Audio Quality page has settings relating to the quality of the 
  275.       playback of the module. 
  276.  
  277.    2. The Load Control page has settings relating to keeping the system 
  278.       responsive while still providing flawless, continuous playback. 
  279.  
  280.    3. The Decompression Methods page has settings relating to the decompression 
  281.       of compressed module files. 
  282.  
  283.    4. The Other page has other settings relating to how DMPlayer acts. 
  284.  
  285.  
  286. ΓòÉΓòÉΓòÉ 5.2.1. Page 1 - Audio Quality ΓòÉΓòÉΓòÉ
  287.  
  288. There are three settings that directly affect the quality of the audio data 
  289. that is played: 
  290.  
  291. Frequency 
  292.  
  293. This slider controls the output frequency of the audio.  Values range from 
  294. 11025hz up to CD quality 44100hz.  Some audio adapters may not be able to 
  295. handle some frequency values.  DMPlayer will notify you if you attempt to play 
  296. a song at a frequency that is not supported by your audio adapter.  The higher 
  297. the frequency is set, the better the song will sound as higher frequencies can 
  298. be reproduced.  Also, the higher the frequency, the more processor time 
  299. DMPlayer needs to create the data.  So there is a tradeoff to be made between 
  300. the quality of the sound and the responsiveness of the system. 
  301.  
  302. Bits per sample 
  303.  
  304. You can select either 8 or 16 bits per sample playback.  16 bits per sample 
  305. will result in better output quality.  8 bits per sample will result in poorer 
  306. output quality due to the scaling required to adjust the audio data to 8 bit. 
  307. This setting will have a negligible effect on the processor load. 
  308.  
  309. Note:  Not all audio adapters support 16 bits per sample. 
  310.  
  311. Number of channels 
  312.  
  313. You can select either mono or stereo playback.  Stereo playback sounds vastly 
  314. better than mono playback.  This setting will have a negligible effect on the 
  315. processor load. 
  316.  
  317. Note:  Not all audio adapters support stereo playback. 
  318.  
  319.  
  320. ΓòÉΓòÉΓòÉ 5.2.2. Page 2 - Load Control ΓòÉΓòÉΓòÉ
  321.  
  322. Thresholds 
  323.  
  324. Digital Music Player (optionally) uses a dynamic priority adjustment scheme to 
  325. integrate smoothly with other running applications.  The Play thread of 
  326. DMPlayer normally runs at the default OS/2 priority.  That means that it's 
  327. execution is no more important than any other application running at the same 
  328. time.  This means that other applications are free to work and respond as if 
  329. DMPlayer does not exist. If there are other applications running with a higher 
  330. priority, then DMPlayer's Play thread will begin to slow down as OS/2 gives 
  331. more and more processor time to the higher priority task.  DMPlayer will allow 
  332. this to happen only until it reaches a user-definable point, called the Lower 
  333. Threshold.  Once this point is reached, DMPlayer will raise the priority of the 
  334. Play thread in order to allow it to catch back up.  As DMPlayer receives more 
  335. of the processor time, the Play thread will eventually reach another 
  336. user-definable point, called the Upper Threshold.  At this point, DMPlayer will 
  337. once again lower the priority of the Play thread back to the OS/2 default. 
  338. This process allows DMPlayer to keep playing uninterrupted music while your 
  339. other, often more important tasks, get the processor time to do what they must. 
  340.  
  341. The Upper Threshold is labeled Raise priority at on the notebook page.  This 
  342. value represents a percentage of the buffer that must remain filled with data 
  343. ready to be played.  If the buffer drops below this level, then the priority of 
  344. the play thread will be raised to attempt to refill the buffer. 
  345.  
  346. The Lower Threshold is labeled Lower priority at on the notebook page.  This 
  347. value represents a percentage of the buffer that must be reached before the 
  348. priority of the play thread will be lowered again. 
  349.  
  350. Enable 
  351.  
  352. This enables/disables the dynamic priority adjustment.  If it is disabled, then 
  353. DMPlayer constantly runs at a high priority.  This may be unsuitable for some 
  354. systems. 
  355.  
  356. Number of buffers 
  357.  
  358. The number of buffers selected will determine just how much create-ahead buffer 
  359. space there is.  The more buffers there are, then the more space there is for 
  360. error.  If your system will allow it, then a higher setting is better. This 
  361. will allow a greater range when DMPlayer doesn't care just how full the buffer 
  362. is.  If your system has little memory, then fewer buffers may be selected to 
  363. help a little.  Lower numbers of buffers are more likely to encounter skipping 
  364. problems when under a heavy system load. 
  365.  
  366. The amount of memory used by the selected number of buffers is also displayed. 
  367.  
  368.  
  369. ΓòÉΓòÉΓòÉ 5.2.3. Page 3 - Decompression Methods ΓòÉΓòÉΓòÉ
  370.  
  371. Digital Music Player supports the reading of music modules from a single-entry 
  372. compressed file.  It does not support more than one file in an archive file. 
  373. This means that you can use zip or gzip or whatever your favorite archiver is 
  374. to compress all your modules and possibly save a significant amount of disk 
  375. space.  The decompression program you use MUST be a native OS/2 application. 
  376. DMPlayer does not support the use of DOS decompression programs.  Modules will 
  377. typically compress by about 33% from my experience with both zip and gzip.  The 
  378. decompression is transparent to the user, DMPlayer just matches a method with a 
  379. mask.  DMPlayer supports up to 6 user-definable decompression methods. 
  380.  
  381. Extension 
  382.  
  383. Simply enter the extension that you wish DMPlayer to match with the method 
  384. given in the Execute command field. 
  385.  
  386. .gz
  387. .zip
  388.  
  389. Execute command 
  390.  
  391. Here is where you enter the command you wish to be executed if DMPlayer matches 
  392. the extension specified. 
  393.  
  394. gzip -dcq
  395. unzip -p
  396.  
  397. The command must conform to the following specifications: 
  398.  
  399.      It must emit the decompressed module to standard output (stdout). 
  400.      It must not output any header of any kind. 
  401.  
  402.  
  403. ΓòÉΓòÉΓòÉ 5.2.4. Page 4 - Other ΓòÉΓòÉΓòÉ
  404.  
  405. Share audio device 
  406.  
  407. If this item is checked, then DMPlayer will share the audio device with other 
  408. applications.  This will allow you still hear system sounds when DMPlayer is 
  409. running.  Whenever another application, such as the WPS (for system sounds), 
  410. requests the device, then DMPlayer will halt playing until the device is handed 
  411. back.  This behavior may not be desirable for every configuration, so it is 
  412. optional. 
  413.  
  414. Note:  This setting only takes effect when DMPlayer is started. 
  415.  
  416. Startup minimized 
  417.  
  418. If this item is checked, then DMPlayer will start up minimized.  This option is 
  419. especially useful when used in conjunction with the next option. 
  420.  
  421. Startup playing 
  422.  
  423. If this item is checked, then DMPlayer will begin playing the first song from 
  424. the playlist with it first loads up. 
  425.  
  426. Support old 15 instrument modules 
  427.  
  428. If this item is checked, then DMPlayer will attempt to load the file as an old 
  429. 15 instrument module if all else fails.  You probably won't need to check this 
  430. unless you have some old modules. 
  431.  
  432. Warning: If this item is checked, DMPlayer will probably crash hard if the file 
  433. is not a module at all.  This will happen because there is no way to determine 
  434. if a file is an older module or not.  There is no 'signature' in the file and 
  435. DMPlayer just has to try.  Quite often it will still catch an invalid module, 
  436. but BE CAREFUL. 
  437.  
  438.  
  439. ΓòÉΓòÉΓòÉ 5.3. The SongList Window ΓòÉΓòÉΓòÉ
  440.  
  441. The SongList provides a way to group your favorite media elements together. You 
  442. can add any file that is supported by MMPM/2 as well as .MOD formats that are 
  443. supported by DMPlayer.  You can arrange, sort, and save the lists as you like. 
  444. Multiple copies of a file can be present in a SongList with no adverse affect. 
  445.  
  446. If you have used a folder on the WPS, then you will feel right at home using 
  447. the SongList container.  The SongList allows you to view the list of modules in 
  448. any of the standard formats:  Icon, Text, Name, or Details view.  This way, you 
  449. can see what you want to, the way you want to. 
  450.  
  451. Drag and drop is also fully supported.  Both as a means of re-arranging the 
  452. order of the list and adding files to the list.  You can drag files from any 
  453. WPS folder and drop them in the list where you want them.  DMPlayer will allow 
  454. you to drop ANY type of file, but I do not suggest exploiting that capability. 
  455.  
  456. DMPlayer is smart enough to display the actual song title instead of simply the 
  457. name of the file in most instances.  DMPlayer will not attempt to get the title 
  458. of any of the following: 
  459.  
  460.    1. Compressed modules. 
  461.    2. Files that MMPM/2 recognizes and will play. 
  462.  
  463.  The order of the list is completely left up to you.  If you start dragging a 
  464.  file (or files), then there are several places you can drop them: 
  465.  
  466.    1. Directly on another item.  This will result in the items being inserted 
  467.       before the target item. 
  468.  
  469.    2. Between other items in the Text, Name or Details view.  This will result 
  470.       in the items being inserted between  the target items.  This is not an 
  471.       option in the Icon view. 
  472.  
  473.    3. On the container itself.  This will result in the items being inserted at 
  474.       the end  of the list. 
  475.  
  476.  It's really simple.  Just play with it and you will soon understand. 
  477.  
  478.  There are three different popup menus available.  Each one will appear with 
  479.  you press the context menu button on your mouse.  This defaults to the right 
  480.  mouse button. 
  481.  
  482.      SongList Main Menu 
  483.  
  484.       This menu will popup over the SongList itself.  It contains all of the 
  485.       commands relevant to the entire SongList. 
  486.  
  487.         -  New 
  488.  
  489.            Start a new SongList from scratch. 
  490.  
  491.         -  Open 
  492.  
  493.            Open a SongList.  This will bring up the standard file dialog to 
  494.            select a SongList to load. 
  495.  
  496.         -  Save 
  497.  
  498.            Save the current SongList. 
  499.  
  500.         -  Save as 
  501.  
  502.            Save the current SongList with a new name. 
  503.  
  504.         -  Add songs 
  505.  
  506.            Add songs to the current SongList.  This will bring up the standard 
  507.            file dialog where you can select multiple files to add to the list. 
  508.  
  509.         -  View 
  510.  
  511.            There are several ways in which to view the contents of the 
  512.            SongList. Each view shows the song title, not the file name. 
  513.  
  514.              -- Icon 
  515.  
  516.                 Select the Icon view. 
  517.  
  518.              -- Text 
  519.  
  520.                 Select the Text view.  If the Flowed menu item is checked, then 
  521.                 the view will be Flowed Text. 
  522.  
  523.              -- Name 
  524.  
  525.                 Select the Name view.  If the Flowed menu item is checked, then 
  526.                 the view will be Flowed Name. 
  527.  
  528.              -- Details 
  529.  
  530.                 Select the Details view.  This view also shows the following 
  531.                 information abou the song file: 
  532.  
  533.                   -  Full pathname of the song file. 
  534.  
  535.                   -  Size of the file in bytes. 
  536.  
  537.                   -  Creation date. 
  538.  
  539.                   -  Creation time. 
  540.  
  541.              -- Flowed 
  542.  
  543.                 Check this menu item if you wish the Text and Name views to be 
  544.                 flowed. 
  545.  
  546.         -  Select 
  547.  
  548.              -- Select all 
  549.  
  550.                 Select all the items in the SongList. 
  551.  
  552.              -- Deselect all 
  553.  
  554.                 Deselect all the items in the SongList. 
  555.  
  556.         -  Sort 
  557.  
  558.            The items in the SongList can be sorted several different ways. 
  559.            This menu item is a conditional cascade.  To reorder the list using 
  560.            the previously selected sort method, simply select 'Sort'.  To 
  561.            change the sort method, cascade the menu and select a new method. 
  562.            The selected method is saved between sessions. 
  563.  
  564.              -- None 
  565.  
  566.                 Do not sort the list. 
  567.  
  568.              -- Name 
  569.  
  570.                 Sort by the title of the song. 
  571.  
  572.              -- File size 
  573.  
  574.                 Sort by the size of the file. 
  575.  
  576.              -- Creation date 
  577.  
  578.                 Sort by the creation date of the file. 
  579.  
  580.              -- Simply random 
  581.  
  582.                 Randomize the order of the list. 
  583.  
  584.              -- Maintain sort order 
  585.  
  586.                 Maintain the order of the list.  If this item is checked, the 
  587.                 list will be reordered whenever it is loaded and whenever a new 
  588.                 songs are added. This option goes well with the 'Simply random' 
  589.                 option to keep things unpredictable. 
  590.  
  591.      Single Item Menu 
  592.  
  593.       This menu will popup when only one item is selected. 
  594.  
  595.         -  Play 
  596.  
  597.            Play this song.  A song may also be played simply by double-clicking 
  598.            on it in the list. 
  599.  
  600.         -  Remove 
  601.  
  602.            Remove this song from the list. 
  603.  
  604.         -  Delete file 
  605.  
  606.            Delete this song from the disk as well as removing it from the list. 
  607.            You will be asked to confirm. 
  608.  
  609.      Multiple Items Menu 
  610.  
  611.       This menu will popup when several items are selected. 
  612.  
  613.         -  Remove 
  614.  
  615.            Remove these songs from the list. 
  616.  
  617.         -  Delete file 
  618.  
  619.            Delete these songs from the disk as well as removing it from the 
  620.            list. You will be asked to confirm. 
  621.  
  622.  
  623. ΓòÉΓòÉΓòÉ 5.4. The Mixer Dialog ΓòÉΓòÉΓòÉ
  624.  
  625. This dialog allows you to adjust a few of the mixer settings for your audio 
  626. card.  Some audio cards do not support the modification of these settings, see 
  627. Hardware issues for more information.  The settings will not be disabled if 
  628. even if your audio adapter does not have a software settable mixer.  This is 
  629. due to a limitation in the MMPM/2 API.  These settings only affects DMPlayer's 
  630. output. 
  631.  
  632. You can adjust the Volume, Balance, Bass and Treble if your card supports the 
  633. setting of these values by software. 
  634.  
  635.  
  636. ΓòÉΓòÉΓòÉ 5.5. The Song Info Dialog ΓòÉΓòÉΓòÉ
  637.  
  638. This dialog displays more detailed information about the song currently loaded. 
  639. It displays the song title, type of the song, number of channels (tracks), the 
  640. actual file name, and a list of the samples contained in the file. 
  641.  
  642.  
  643. ΓòÉΓòÉΓòÉ 6. What is a MOD file? ΓòÉΓòÉΓòÉ
  644.  
  645. A MOD file is a digital song file.  The format was developed on the Amiga 
  646. family of computers to take advantage of that machines 4 DACs (Digital to 
  647. Analog Converters).  The file contains blocks of commands for each track.  Each 
  648. command tells what instrument to play and at what note to play it.  Special 
  649. effects are also specified by the commands.  The instruments are stored as 
  650. samples at the end of the track information.  Hence the rather large size of 
  651. MOD files.  The format originally consisted of only 4 tracks and 15 
  652. instruments.  It has since evolved to anywhere from 4 to 8 tracks and 31 
  653. instruments.  A 'standard' MOD file now has 4 tracks and 31 instruments.  Some 
  654. trackers produce 6 and 8 track MOD files with 31 instruments. 
  655.  
  656. One of the best places to find MOD files is at an Aminet site.  There is an 
  657. Aminet mirror at: 
  658.  
  659. ftp.cdrom.com
  660.  
  661. Relevant directories are: 
  662.  
  663. aminet/mods/misc
  664. aminet/mods/pro
  665.  
  666. Another promising site is the new multimedia site at: 
  667.  
  668. hobbes.nmsu.edu
  669.  
  670. This site is chock full of .WAVs, .MIDs, .AVIs, and .MODs. 
  671.  
  672.  
  673. ΓòÉΓòÉΓòÉ 7. Hardware issues ΓòÉΓòÉΓòÉ
  674.  
  675. One might think that the advent of MMPM/2 introduces the age of pure hardware 
  676. independence.  While MMPM/2 goes a LONG way in doing that, there will still be 
  677. problems rising from the fact that SOMEONE has to write device drivers for each 
  678. audio adapter out there.  And while these drivers do exist, there remains a lot 
  679. to be desired.  So, while DMPlayer SHOULD work just fine with any MMPM/2 
  680. supported audio adapter, there may still be some things to look out for. 
  681.  
  682.      Pro Audio Spectrum (Studio) 16 
  683.      Sound Blaster family 
  684.  
  685.  
  686. ΓòÉΓòÉΓòÉ 7.1. Pro-Audio Spectrum (Studio) 16 ΓòÉΓòÉΓòÉ
  687.  
  688. In order to listen to 16 bit audio, you may need to set the DMA channel 5 or 
  689. above. All lower channels only support 8 bit (at a time) DMA and may not work 
  690. with all motherboards. 
  691.  
  692.  
  693. ΓòÉΓòÉΓòÉ 7.2. SoundBlaster family ΓòÉΓòÉΓòÉ
  694.  
  695. There don't seem to be any specific problems with this card, but there have 
  696. been many reports of seeming 'random' crashes that are impossible to track 
  697. down.  My only hope is that Creative Labs will better support these cards in 
  698. the future. 
  699.  
  700. If you are having terrible problems with your SoundBlaster you may want to make 
  701. the following change to the device driver statement in CONFIG.SYS: 
  702.  
  703. DEVICE=SB16D2.SYS 1 5 5 220 8 "$SBAud1"
  704.  
  705. The 8 should be replaced with a 2. 
  706.  
  707.  
  708. ΓòÉΓòÉΓòÉ 8. Thanks ΓòÉΓòÉΓòÉ
  709.  
  710. Thanks go out to the following people for doing some serious late night bug 
  711. hunting: 
  712.  
  713.          Linden deCarmo 
  714.          Adrian Idzik 
  715.          Dave Killian 
  716.          Chance Geurin 
  717.          Glade Diviney 
  718.          and my wife Kelly 
  719.  
  720.  Special thanks to Linden deCarmo for all his support and answered questions 
  721.  about the innermost workings of MMPM/2.  You guys did a great job with MMPM/2 
  722.  Linden!  Thanks for all the help and answered questions and bug reports and 
  723.  moral support and, oh, well, you get the idea... 
  724.  
  725.  Thanks to my other early beta testers. You all helped out! 
  726.  
  727.  Thanks also goes out to Kathleen Panov, Larry Salomon (aka Q) and Arthur Panov 
  728.  for their work on the wonderful 'The Art of OS/2 2.1 C Programming'. It is an 
  729.  absolutely GREAT book and a MUST-HAVE for any OS/2 programmer. 
  730.  
  731.  
  732. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  733.  
  734. Press this button to start playing the currently loaded file.  If no file is 
  735. loaded, then DMPlayer acts as if you pressed the Next button. 
  736.  
  737.  
  738. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  739.  
  740. Press this button to pause the playback of the file.  If the file is currently 
  741. paused, then DMPlayer acts as if you pressed the Play button. 
  742.  
  743.  
  744. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  745.  
  746. Press this button to stop the playback of the file.  The file remains loaded 
  747. into memory at this point. 
  748.  
  749.  
  750. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  751.  
  752. Press this button to move 1 track backward if the current file is a MOD. 
  753. Otherwise DMPlayer will attempt to skip 1 second backwards.  This may not 
  754. always succeed depending upon the media type.  There will be a slight delay 
  755. before the change takes effect.  Rapid pressing of this button will have no 
  756. further effect. 
  757.  
  758.  
  759. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  760.  
  761. Press this button to move 1 track forward if the current file is a MOD. 
  762. Otherwise DMPlayer will attempt to skip 1 second forward.  This may not always 
  763. succeed depending upon the media type.  There will be a slight delay before the 
  764. change takes effect.  Rapid pressing of this button will have no further 
  765. effect. 
  766.  
  767.  
  768. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  769.  
  770. Press this button to load the previous file from the SongList.  If the SongList 
  771. has changed, or a new SongList has been loaded, then the file DMPlayer loads 
  772. may be just about anything in the list. 
  773.  
  774.  
  775. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  776.  
  777. Press this button to load the next file from the SongList.  If the SongList has 
  778. changed, or a new SongList has been loaded, then the file DMPlayer loads may be 
  779. just about anything in the list. 
  780.  
  781.  
  782. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  783.  
  784. The name of the currently loaded SongList is displayed here.  This is also 
  785. where messages from the SongList window will appear. 
  786.  
  787.  
  788. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  789.  
  790. The name of the currently loaded file is displayed here.  If the file is a MOD, 
  791. then this will be the actual song title, otherwise it will be the name of the 
  792. file.  The file will remain loaded in memory even if it is deleted from the 
  793. disk.  Status and error messages related to the loading and playing of the file 
  794. will also be displayed in this window. 
  795.  
  796.  
  797. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  798.  
  799. This control displays a percentage that represents the amount of the total 
  800. buffer space that has been preloaded with song data.  The percentage shown here 
  801. directly relates to the percentages set in the Load Control page of the 
  802. Settings Notebook.  This control will turn red if it has dropped below the 
  803. Lower Threshold.  It will turn green once it reaches the Upper Threshold again. 
  804.  
  805.  
  806. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  807.  
  808. This control displays the currently playing track.  The display is not acutely 
  809. accurate.  It will be close enough for our interests however.  The only 
  810. inaccuracy is a slight time delay between when the track actually changes and 
  811. when the message is sent through MMPM/2 to DMPlayer to get updated. 
  812.  
  813.  
  814. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  815.  
  816. This control displays the total number of tracks to be played in the duration 
  817. of the song. 
  818.  
  819.  
  820. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  821.  
  822. This control displays the total elapsed time that the file has been playing. If 
  823. the file is a MOD, then the time displayed is unaffected by pressing the Fast 
  824. Forward or Rewind buttons.  Therefore, this display may not accurately show the 
  825. time offset into the song if the user has skipped around a bit. 
  826.  
  827.  
  828. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  829.  
  830. Digital Music Player has several threads concurrently running, taking full 
  831. advantage of the multitasking nature of OS/2.  The Play thread is the main data 
  832. creation thread.  It basically does all of the work of interpreting the song 
  833. data and rendering it in an audible form to the buffer for MMPM/2 to read.