PECD Plugin 1.2 Manual

PECD Plugin 1.2 ©1999 Purple E Software Web: <http://www.norcom2000.com/users/ejt/purplee.html> Email: <ejt@norcom2000.com> About PECD Plugin 1.2 is a plugin for REALbasic 1.x and 2.x. It is 68K and PPC compatible. To use it, simply drop this plugin in a folder called "Plugins" that resides in the same folder as the REALbasic application. Start REALbasic and you will now be able to use the PECD Plugin methods in your own REALbasic application. Features PECD Plugin 1.2 gives you the opportunity to quickly and easily add CD-Rom audio to your REALbasic application. No more messy system calls! No need to spend hours searching for source. With PECD, you can build a fully functional CD player in minutes. It also works great for playing audio in other applications like games and multimedia presentations. For a complete list of the functions read on. Registration PECD Plugin 1.2 comes in two forms. A demo version and the full version. The demo version is free, but only gives you three methods. They are indicated by an asterisk (*) in the documentation below. The full version enables all of the listed commands. Furthermore, all future upgrades are FREE for registered users. To register, please send your name, email address, and $10.00 (Cash or Check in US Dollars) to: Erick Tejkowski 2661 N. Illinois PMB #170 Swansea, IL 62226 USA Methods The following is a list of the methods that PECD Plugin 1.0 adds to REALbasic. If you would like to see a sample, projects for REALbasic 1 and 2 are included with the plugin. Although the code is incomplete, it gives you a good foundation for adapting PECD Plugin to your own needs. Methods preceded by an asterisk are available to PECD Plugin Demo users. All functions are available to registered users. *** 1.) GetRefNum() as integer Make sure to call this before any other calls. It identifies the Apple CD-Rom hardware in your machine. All other methods in this plugin require this number, so it is ABSOLUTELY necessary! Throughout the rest of the documentation, this number will be referred to as the “drvrRefNum”. *** 2.) GetNumberOfTracks(drvrRefNum as integer) as integer This returns the number of audio tracks on the currently inserted CD. 3.) GetCurrentTrack(drvrRefNum as integer) as integer This returns the number of the currently-playing track. 4.) GetCurrentState(drvrRefNum as integer) as integer This returns the current state of the CD player. The following return values are possible: Value State 0 CD is playing. 5 CD is stopped. 1 CD is paused. 5.) GetCurrentTrackMin(drvrRefNum as integer) as integer This returns the elapsed number of minutes of the currently-playing track. 6. ) GetCurrentTrackSec(drvrRefNum as integer) as integer This returns the elapsed number of seconds of the currently-playing track. 7.) GetCurrentTrackFrame(drvrRefNum as integer) as integer This returns the elaps…