PlayBoy v1.2 Documentation By Igor Divjak August 1995 This document is divided into the following categories: Introduction Requirements Running PlayBoy Adding and Removing albums Keyboard commands Using the Pop-up menu Setting Up Your Mixer Feedback Registration Distribution Conditions Note To Users of CompuServe Credits Disclaimer Acknowledgments Introduction PlayBoy is a graphical CD player for OS/2, and was created largely because I could not find the CD player I wanted out there. The Player that is included with OS/2 is usable, but hardly feature-filled. I wanted something that would remember the song titles of my CD's, skip the songs I wish did not get recorded, and still remain easy to use, simple, and functional rather than flashy. PlayBoy is all these things and more. Requirements You need OS/2 2.1 or greater with the Multimedia extensions installed. If you wish to use your sound card as the output device, it must be attached to your CD player via a cable. If you have analog output jacks on your CD player, you don't need a sound card. A CD-ROM device is of course, required as well. Running PlayBoy PlayBoy has been designed with simplicity in mind, so no special command line parameters are required. Simply run the executable and you are on your way. Adding and Removing Albums When a CD is in the drive, you may edit album information. Do this by pressing the open book button on the main window. Here you can enter in the name of the artist, album, and if you are registered, specify play order. The middle button brings up the song list menu, where you can enter the names of individual songs on the album. There are also four checkboxes on the album dialog, Repeat, AutoPlay, Shuffle Play and Auto Eject. Here is a brief explanation of their function: Repeat: The play list is repeated when it is finished. The CD will play until the program exits, the stop button is pressed, or this mode is shut off. AutoPlay: CD's will begin to play automatically when they are inserted, and when the program is first loaded. Shuffle Play: Songs are played in random order. Auto Eject: The cd is automatically ejected from the drive when the last track in the playlist is done playing. Note that Auto Eject overrides repeat mode. Keyboard Commands The main window accepts keyboard commands as well as mouse clicks. The following is a list of commands and their keyboard equivalents. Play/Pause ALT-P Stop/Eject ALT-S Forward ALT-F Backward ALT-B Settings ALT-E The song list dialog also accepts the following keyboard equivalents: Add a song ALT-A Delete a song ALT-D Ok ALT-O Cancel ALT-X Using the Pop-up Menu You can play specific tracks on the CD by pressing the right mouse button on top of the main window (or if in icon form, its icon). This will bring up a menu list of the tracks on the CD. If you have added the album to your database, the song names will also be on the pop-up menu. An option on the menu is 'open mixer'. This will launch your predefined audio mixer. Setting Up Your Mixer There are many fine shareware Mixers out there that let you fine tune your sound card. Modern sound cards have many features like stereo expand, bass and treble controls, etc. You set up PlayBoy to use your favorite mixer by going into the settings dialog and hitting the button with a picture of loudspeaker on it. A new dialog will appear here, and you type in the complete path and executable name. For example: d:\sound\pas\promix2.exe Or, if you don't have any special mixers yet, you might want to use the volume control that came with MMOS2, such as: AMPM.EXE If your mixer does not launch from the pop up menu, then it may not be in your path. You mixer may need some configuration file or dll that is found in its directory. Adding it to your path might solve the problem. Feedback If you have problems, suggestions, or requests, please feel free to email me about them. I will try to answer your questions in a timely fashion. You can reach me at the following email addresses: Internet (preferred): igor@flexnet.com C$erve: 75027,21 Registration The program is quite usable in unregistered mode, but if you wish to have the ability to specify your PLAY ORDER LISTS, you must register PlayBoy with the author. Registration costs $20 Canadian if you reside in Canada, and $20 US anywhere else. Please send registrations to: Igor Divjak 494 Park Ave Shelburne, ON L0N 1S2 Canada If you have an email address that is reachable from the Internet or CompuServe, please include that as well. That will insure the quickest possible reply, and you will receive your registration code via email soon after I get your registration. DISTRIBUTION CONDITIONS The REGISTERED VERSION of PLAYBOY (with PLAY ORDER LISTS enabled; see above) is not to be distributed in any way. The author grants a single user licence TO THE INDIVIDUAL who's name is matched to the code number which enabled PLAY ORDER LISTS (hereafter called the 'authorized user'). The authorized user may install the software on any machine which they personally use, but only the authorized user may operate the software. The REGISTERED VERSION is NOT TO BE MODIFIED in any way. You are free to distribute the SHAREWARE VERSION of PlayBoy as long as the following conditions are met: 1) The contents of this documentation and the PlayBoy executable are NOT MODIFIED in any way. 2) This version is not to be sold. However, a reasonable disk copying fee is permitted. 3) This version is not to be bundled with a commercially sold package without permission from the author. Registration of PLAYBOY is based on "personal usage." Corporate or organizational users must register all copies used on an individual basis; a specific person (name) must be explicitly assigned to each registrant who will be provided with a personalized copy of PLAYBOY. Registration grants a specific person (not an organization or corporate entity) the right to use PLAYBOY. Note to Users of CompuServe You can register this program online in the SWREG forum (GO SWREG), Reg.ID 4959. Registration is $20.00 US and is billed to you automatically. I will receive notice and send you your code via CompuServe email. If you have any questions or comments about PlayBoy, feel free to email me at one of: Internet: igor@flexnet.com CompuServe: 75027,21 Credits Special thanks to Dave Minogue and James Guitard of Sudbury ON, for their help in testing out PlayBoy. Users of Noel Dillabough's excellent 'CDAudio for Windows' will note that PlayBoy looks virtually the same. This was intentional, as I found his program quite good and wanted something like it for OS/2. I asked him to make it, but as he is still stuck running Windows, I had to do it myself. DISCLAIMER The author of this program accepts no responsibility for damages that are caused by this program and make NO WARRANTY or representation, either express or implied, with respect to this software. This software is provided "AS IS," and you, its user, assume the entire risk when you use it. ACKNOWLEDGMENTS OS/2 is a trademark of International Business Machines Corporation. Windows is a trademark of Microsoft Corporation. CompuServe is a trademark of Compuserve Corporation.