            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.
