home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / playpm10.zip / playpm2.inf (.txt) < prev    next >
OS/2 Help File  |  1996-07-04  |  15KB  |  374 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. About PlayPm/2 ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5. PlayPm/2 is written by Gerard Gerritsen. 
  6. it does not need MMOS/2, instead it communicates directly with the cdrom device 
  7. driver 
  8.  
  9. Requirements: 
  10.   CDROM drive supported by OS/2 
  11.   An audio cd 
  12.   OS/2 2.X or Warp 
  13.  
  14. Tools used: 
  15.  
  16.   Virtual Pascal/2 1.01 
  17.   Link386 
  18.   OS/2 Warp with FP 17 applied 
  19.   Program Commander/2 
  20.   LxLite 1.15 
  21.   486DX2-66 with 8Mb of memory 
  22.   Mitsume quad speed cdrom 
  23.   Panasonic double speed cdrom 
  24.  
  25. Its features: 
  26.  
  27.  - AutoShuffle 
  28.  - Capable of programming up to 99 tracks 
  29.  - Skip forward or backwards 
  30.  - Stereo sliders for volume control 
  31.  - Can show time in four different ways 
  32.  - Close and open the door of the drive 
  33.  - Menus and dialogs can be modified manually or with a resource editor 
  34.  - Repeat Program 
  35.  - Play Only One Track 
  36.  - Support of SB Pro's or SB 16 ( and AWE ) 
  37.  - Fade in 
  38.  
  39.   On some drive models it seems to be impossible to get the door 
  40.   closed by using software 
  41.  
  42.  
  43. ΓòÉΓòÉΓòÉ 1.1. Contacting the Author ΓòÉΓòÉΓòÉ
  44.  
  45.  
  46.   Gerard Gerritsen can be reached at: 
  47.  
  48.   Internet 
  49.       School:    1000521@et.fnt.hvu.nl 
  50.       Home:     Gerritse@bos.nl 
  51.        checked from monday till thursday 
  52.  
  53.       FidoNet      2:283/203.18 
  54.        checked almost the whole week 
  55.  
  56.  
  57. ΓòÉΓòÉΓòÉ 1.2. Registering ΓòÉΓòÉΓòÉ
  58.  
  59.  
  60.   When registering, you will get a special key that will enable the registered 
  61.   version. You will need to send register.frm by mail or email 
  62.   ( fido is also good ) As soon as the money arrives the key will be sent. 
  63.   I will try to acknowledge the receipt of the form as soon as possible if 
  64.   an Email/Fido address has been specified. 
  65.  
  66.   The Netherlands: 
  67.  
  68.   Om PlayPm/2 te registeren, maak 25,-- over op bankrekening 93.55.63.636 t.n.v 
  69.   Gerard Gerritsen. Omdat de bank nogal traag is met het versturen van 
  70. overzichten 
  71.   ( tot 14 dagen, kan er helaas ook niets aan doen ) is het handiger om een 
  72.   mailtje te sturen, dan kan ik de key vast klaarmaken voor verzending. 
  73.  
  74.   Outside of the Netherlands 
  75.  
  76.   When registering from somewhere else than the Netherlands... 
  77.  
  78.   Send 20 U.S. Dollars or 25 DM to 
  79.  
  80.   Gerard Gerritsen 
  81.   Kraatsweg 18 
  82.   6712 DB Ede 
  83.   The Netherlands 
  84.  
  85.  
  86. ΓòÉΓòÉΓòÉ 1.3. What do I get when I register ? ΓòÉΓòÉΓòÉ
  87.  
  88.  
  89.   When you have received your personal key, you will get access to new 
  90. features. 
  91.   Soon after I have finished work on them, they will become available. 
  92.  
  93.   Under development 
  94.  
  95.   - 'Power' icon 
  96.  
  97.   - If there is enough demand for a certain feature I will try to add that 
  98.    feature. 
  99.  
  100.   Already available 
  101.  
  102.   - A&B play 
  103.   - Recognition of track names ( though it is a little bit rough, 
  104.                  I'm working on it.. ) 
  105.   - Remote Control of the player by means of a network. 
  106.  
  107.   Access to beta versions ( you'll need freq or internet email capabilities ) 
  108.  
  109.  
  110. ΓòÉΓòÉΓòÉ 1.4. Thanks ΓòÉΓòÉΓòÉ
  111.  
  112.  
  113.   Many thanks go to ( in no particular order ) 
  114.  
  115.   Peter Lindeman     'Als je 't maar laat !' 
  116.  
  117.   Jan Hoolwerf      'Tja, tegen mijn vakmanschap kun jij toch niet op. 
  118.              'Desnoods maak ik luizen.' 
  119.  
  120.   Eelco Dolstra     'WinDlg' 
  121.  
  122.   Matthijs Wachtmeester 'Van de icons is niet 1 diagonale lijn normaal recht, 
  123.              'allemaal lijken ze getrokken te zijn door een dronken 
  124.              'gek met een potlood.' 
  125.  
  126.   Frans Roordink     'Dan zal 26 je wel weer aardig opfleuren, of niet?' 
  127.  
  128.   Allen Mertner      For support of Virtual Pascal 
  129.   fPrint UK        For Virtual Pascal 
  130.  
  131.  
  132. ΓòÉΓòÉΓòÉ 1.5. License ΓòÉΓòÉΓòÉ
  133.  
  134.  
  135.   Copyright 1996 Gerard Gerritsen. All rights reserved 
  136.  
  137.   License Agreement 
  138.  
  139.   INSTALLATION OF PLAYPM/2 ON YOUR COMPUTER SYSTEM IMPLIES AGREEMENT 
  140.   WITH THE TERMS AND CONDITIONS BELOW. 
  141.  
  142.   DISTRUBTION OF PLAYPM/2, ITS ACCOMPANYING PROGRAMS AND DOCUMENTATION IS 
  143.   CONSIDERD AS IS. Gerard Gerritsen OFFERS NO WARRANTIES OF ANY KIND, EXPRESSED 
  144.   OR IMPLIED. THIS INCLUDES, BUT IS IN NO WAY LIMITED TO, WARRENTIES OF PLAYPM2 
  145.   MERCHNATABILITY OR FITNESS FOR A PARTICULAR PURPOSE. UNDER NO CIRCUMSTANCES 
  146.   WILL Gerard Gerritsen BE LIABLE FOR ANY DAMAGES WHICH RESULT FROM THE USE OF 
  147.   THIS PROGRAM OR THE INABILITY TO USE IT. EXCLSION FROM LIABILTY INCLUDES, 
  148.   BUT IS NOT LIMITED TO, LOST PROFITS, LOST SAVINGS, A DEAD CAT, OR ANY OTHER 
  149.   INCIDENTAL OR CONSEQUENTIAL DAMAGES. 
  150.  
  151.   PlayPM/2 is distribited as Shareware. It is not free, freeware or in the 
  152. public 
  153.   domain. You may use PLayPM/2 for a trial period of thirty days, at no cost 
  154. too 
  155.   you, to determine if it fits your needs. If you decided to use PlayPM/2 
  156. regulary 
  157.   you are expected to register it and pay the applicable registration fee. 
  158.   Individual copies of the unregistered version of PlayPM/2 may be given 
  159.   to your friends and associates for the same thirty day free trial period. You 
  160. may 
  161.   also upload unregistered version to a BBS or internet site. 
  162.  
  163.   You may not modify or dis-assemble PLayPM/2, nor distribute any modified 
  164.   or dis-assembled version of PlayPM/2. Playpm/2 may not be included with any 
  165.   other product without written permission from Gerard Gerritsen. 
  166.  
  167.   Registered copies of PlayPM/2 can be used on more than one computer at a 
  168.   time, as long as no more than one of these computers is running PlayPM/2 
  169.   at the same time. Though PlayCom ( the utility for controlling PlayPm/2 from 
  170.   another computer ) may be run on more than one computer at the 
  171.   same time. You may make backup copies of PlayPM/2 as necesarry for archival 
  172.   purposes only. 
  173.  
  174.   U.S. government RESTRICTED RIGHTS: Use, duplication, or disclosure by the 
  175.   Government is subject to restrictions as set forth in subdivsion [b][3][ii] 
  176.   of the Rights in Technical Data and Computer software clause at 252.227-70133 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 1.6. Copyright ΓòÉΓòÉΓòÉ
  180.  
  181.  
  182.   PlayPm2 (C) 1996 by Gerard Gerritsen 
  183.   OS/2 and Link386 (C) IBM 
  184.   Virtual Pascal (C) Fprint UK Ltd 
  185.   LxLite (C) Andrew Zabolotny 
  186.   PC/2 (C) Roman Stangl 
  187.  
  188.  
  189. ΓòÉΓòÉΓòÉ 2. Changes ΓòÉΓòÉΓòÉ
  190.  
  191.  
  192.   - Track names can be shown now ( registered version only ) 
  193.   - Format of the names file has changed, a conversion program (convert.exe) 
  194.    has been included 
  195.  
  196.  
  197. ΓòÉΓòÉΓòÉ 3. Using PlayPm/2 ΓòÉΓòÉΓòÉ
  198.  
  199.  
  200.    Operating PlayPm/2 should not be very difficult, though in some cases 
  201.    it might be easy to know a bit more about certain procedures. 
  202.  
  203.  
  204. ΓòÉΓòÉΓòÉ 3.1. Programming the player ΓòÉΓòÉΓòÉ
  205.  
  206.  
  207.   Programming is quite simple, open the menu with the right mouse button 
  208.   and select 'Program Player', then you can click on the buttons in the order 
  209. you 
  210.   want them played. The buttons will disapear in order to show they 
  211.   are selected.  To start playing your selection, press the play 
  212.   button. To remove your selection, press the stop button 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 3.2. The Settings Dialog ΓòÉΓòÉΓòÉ
  216.  
  217.  
  218.   The Settings dialog can be used to set a few options 
  219.  
  220.   - What time to show on the Track Window 
  221.    Time from the begin of the CD 
  222.    Time to the end of the CD 
  223.    Time from the begin of the track that is currently being played 
  224.    Time to the end of the currently played track 
  225.  
  226.   - Choose if cd's should be recognized 
  227.  
  228.   - Choose to use a soundblaster mixer for mixing the music. 
  229.  
  230.   - AutoShuffle, when a cd has been inserted, PlayPm2 will automaticly start 
  231.    to shuffle. 
  232.  
  233.  
  234. ΓòÉΓòÉΓòÉ 3.3. The Sound Dialog ΓòÉΓòÉΓòÉ
  235.  
  236.  
  237.   Here you can set the volume using the sliders, 
  238.   If you want to use the mixer chip on your soundblaster in addition the volume 
  239.   control in the drive, make sure you  have enabled the Use SoundBlaster 
  240. checkbox 
  241.   in the setting dialog. 
  242.   To use the SB 16 features, make sure you have selected Use SoundBlaster and 
  243.   Use SB 16 Features. 
  244.  
  245.  
  246. ΓòÉΓòÉΓòÉ 3.4. Using the Environment Variable ΓòÉΓòÉΓòÉ
  247.  
  248.  
  249.   The variable PLAYPM2 has been assigned to let the user specify where 
  250.   the database file with the descriptions of the discs is located 
  251.   If the variable PlayPm2 does not exist, PlayPm2 will default to names.ini 
  252.   in the current directory. 
  253.  
  254.   Example 
  255.  
  256.   Set Playpm2=F:\vp\out\names.ini 
  257.  
  258.  
  259. ΓòÉΓòÉΓòÉ 3.5. The menu ΓòÉΓòÉΓòÉ
  260.  
  261.  
  262.   The user menu can be accesed by clicking with the right mouse button on one 
  263.   of the windows of playpm2. 
  264.  
  265.   - Settings       -> Open the settings window 
  266.  
  267.   - Sound        -> Open the sound window 
  268.  
  269.   - Lock L&R       -> Keep left and right volume the same 
  270.  
  271.   - Edit Title      -> Change the current name of the disc 
  272.  
  273.   - Play only one track -> Play only the last chosen track 
  274.  
  275.   - Repeat Program    -> Repeat the loaded program 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 3.6. Command line options ΓòÉΓòÉΓòÉ
  279.  
  280.  
  281.   The behaviour of PlayPm2 can be altered using three command line options 
  282.  
  283.   K -> kill copy of playpm2 that is currently in memory 
  284.  
  285.   C -> clean start, when playpm2 behaves erraticly use this option to force 
  286.     PlayPm2 to use its default instead of the settings chosen by the user 
  287.  
  288.   L -> Will run the WatchCd thread on idle priority instead of user priority 
  289.     Normally you do not need this switch 
  290.  
  291.  
  292. ΓòÉΓòÉΓòÉ 4. Work arounds for some situations ΓòÉΓòÉΓòÉ
  293.  
  294.  
  295.   - I cannot find my track window anymore 
  296.  
  297.    A_ Select the track window in the window and another window and select 
  298.     cascade in the window menu 
  299.  
  300.    B_ Start PlayPm/2 with C, it will force a clean start with every user 
  301.     definable setting set to its default ( save state ) 
  302.  
  303.  
  304. ΓòÉΓòÉΓòÉ 5. About changing the dialogs and icons ΓòÉΓòÉΓòÉ
  305.  
  306.  
  307.   If you have got a Resource Editor like DlgEdit you can make changes to the 
  308.   appearence of the player ( relocate buttons, use different icons whatever 
  309.   you want ) 
  310.  
  311.   Of course you can also edit the resource manually, I have done it for a long 
  312.   time, but as the resource file is growing, its getting more difficult 
  313.  
  314.  
  315. ΓòÉΓòÉΓòÉ 5.1. Recompiling the resource file ΓòÉΓòÉΓòÉ
  316.  
  317.  
  318.   To recompile the resources 
  319.    RC PLAYPM2 
  320.   To recompile the resources and compress them 
  321.    RC -P -X1 PLAYPM2 
  322.   To recompile the resources with maximum compression ( you'll need WARP or 
  323. better ) 
  324.    RC -P -X2 PLAYPM2 
  325.  
  326.  
  327. ΓòÉΓòÉΓòÉ 5.2. Examples ΓòÉΓòÉΓòÉ
  328.  
  329.  
  330.    Keep the sound dialog from getting registered with the tasklist 
  331.  
  332.    Find the entry that belongs to the sound dialog in playpm2.dlg 
  333.    ( Dialog 103 or 102 ) 
  334.    Then change 
  335.  
  336.    DIALOG  "Volume Setting", 102, 72, 16, 116, 84, , FCF_TITLEBAR | 
  337. FCF_TASKLIST 
  338.  
  339.    to 
  340.  
  341.    DIALOG  "Volume Setting", 102, 72, 16, 116, 84 , FCF_TITLEBAR 
  342.  
  343.    Change PlayPm/2 to accept your unlisted sound blaster base port 
  344.  
  345.    Find entry 101 and look for an AUTORADIOBUTTON line you want to change 
  346.    Then edit the number between "" and the number after the , to reflect 
  347.    your baseport 
  348.  
  349.    Example, your sound blaster super ultra etc is located on port 312h 
  350.  
  351.    before 
  352.    AUTORADIOBUTTON "210h", 528, 24, 40, 39, 10, WS_TABSTOP 
  353.  
  354.    after 
  355.    AUTORADIONBUTTON "312h",0x312,24,40,39,10,WS_TABSTOP 
  356.  
  357.    Find the AccelTable in playpm2.rc then change 
  358.  
  359.    VK_F3, IDM_EJECT,  VIRTUALKEY 
  360.  
  361.    to 
  362.  
  363.    VK_F9, IDM_EJECT,  VIRTUALKEY 
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ 6. Using the source code ΓòÉΓòÉΓòÉ
  367.  
  368.  
  369.   In the archive there is also the source code for the basic part of the 
  370.   player.  PlayPm/2 in fact uses the same routines. 
  371.  
  372.   B.t.w. The included sources can be used for own projects, as long as you 
  373.   give me visible credit. 
  374.