Introduction, Copyright & Licensing

Title page, copyright and licensing terms, and the top-level contents of the toolkit.

This manual is protected by copyright law and may not be reproduced in whole or in part, whether for sale or not, without written consent from Ad Lib Inc. Under the copyright laws, copying includes translation into another language or format.

Ad Lib is a registered trademark of Ad Lib Inc.

Licensing Policy

Developers are authorized to incorporate the example source code provided with the Developper Toolkit into their products.

The no cost right to distribute Ad Lib Gold drivers provided with the Developer's Toolkit must be obtained through the Ad Lib Developer Support Department, at (418) 529-9676.

In order to ensure that third party applications operate in a consistent environment, we strongly recommend that developers contact the Ad Lib Developer Support Department.

Ad Lib Inc.

220 Grande-Allée East, Suite 850

Québec, QC, Canada G1R 2J1

50 Staniford Street, Suite 800 Boston, MA 02114

1st edition

ISBN 2-920858-32-7

Printed in Canada

Introduction
Quick Start and Evaluation Software

Installing the Hardware

Installing the Software

Using the Gold Card Evaluation Software

Adjusting the Volume

Gold Hardware

3.1 Description of the Hardware

3.2 Getting Installed

3.3 Surround Sound Module

Software Applications

4.1 Software Installation and Configuration

4.2 Test Program

4.3 Mixer Panel TSR

4.4 Juke Box Gold Music Playback Program

4.5 Instrument Maker Gold

4.6 Sample Maker

4.7 Surround Sound Editor

4.8 Batch File Utilities

4.9 ROL2 Playback TSR

DOS Software Drivers

5.1 Interfacing DOS Drivers with Applications

5.2 DOS Control Features Driver

5.3 DOS FM Synthesis Driver

5.4 DOS Wave Driver

5.5 DOS Timer Driver

5.6 DOS MIDI Driver (To be released)

5.7 DOS SCSI CD-ROM Driver (To be released)

Windows DLLs

(To be released)

Low-level Programming

7.1 Mixer and Setup Features

7.2 FM Synthesis

7.3 Digital Input and Output (Digital Audio and MIDI)

Appendices

Appendix A: Gold Sound Standard

Appendix B: YM7128 - Surround Processor

Appendix C: Pin Out for Joystick-MIDI Connector

Appendix D: List of Installed Files

The Ad Lib Gold Developer Toolkit is a set of software applications, libraries, documentation and other information that will accelerate application support for the Ad Lib Gold series of cards.

The Developer Toolkit covers the following areas:

Quick Start and Evaluation Software

This section is for developers who want to try the software provided with the Gold Card and get a quick look at all programming possibilities. It summarizes the installation of the Gold card and briefly describes some of the available applications. The evaluation software provides tools for a variety of sound quality tests.

Gold Hardware

This section describes the physical layout of the Gold card, and the procedure for installing the card in your computer. It also provides a short description of the Surround Sound Module.

Software Applications

Describes the applications and TSRs that you can use with the Gold card. Some of these applications can be used to create FM sounds, digitized sounds, and Surround presets, that the developer can use in his/her applications.

Software Drivers

This section explains how your applications can interface with the memory-resident drivers. It also contains a complete function directory for each of the drivers. Sample source code is supplied on diskette to provide a better understanding of the use of the drivers and associated interface libraries. The MIDI driver, SCSI driver and Windows DLLs will be included with the next version.

Low-Level Programming

Details the I/O map of each of the hardware sections of the Gold Card. This section is intended for programmers who want to directly access the hardware, instead of using the software drivers.

Appendices

The appendices provide additional information on the Yamaha Gold Sound Standard, the Surround Processor chip (YM7128), a diagram covering the MIDI / Joystick connector, and a list of files copied to the hard drive during installation.

Please read the README.TXT file on DISK 1 for more information.