Developer's Information Pack
Total Page:16
File Type:pdf, Size:1020Kb
Version 3.01 Developer's Information Pack Creative Technology Ltd. Creative Technology Ltd. Copyright © Creative Technology Ltd., 1994-96. All rights reserved. Contents PART I Introduction 4 License Agreement/Limitation And Disclaimer Of Warranties................................................... 4 This Package............................................................................................................................... 5 Using This Manual ...................................................................................................................... 6 Document Conventions................................................................................................................ 7 Getting Assistance....................................................................................................................... 8 What You Need To Know........................................................................................................... 8 PART II DOS Real/Protected Mode API 11 Overview.................................................................................................................................. 11 Hardware Detection And Initialization ..................................................................................... 12 awe32Detect............................................................................................................... 12 awe32DetectEx........................................................................................................... 12 awe32InitHardware.................................................................................................... 13 awe32Terminate......................................................................................................... 13 MIDI Services........................................................................................................................... 13 awe32InitMIDI ........................................................................................................... 14 awe32InitNRPN ......................................................................................................... 14 awe32NoteOn............................................................................................................. 14 awe32NoteOff ............................................................................................................ 15 awe32ProgramChange................................................................................................ 15 awe32PitchBend......................................................................................................... 16 awe32Controller......................................................................................................... 16 awe32ChannelPressure............................................................................................... 17 awe32PolyKeyPressure.............................................................................................. 18 awe32Sysex................................................................................................................ 18 __awe32NoteOff ........................................................................................................ 19 __awe32IsPlaying ...................................................................................................... 20 SoundFont Bank And Downloadable DRAM Services............................................................. 20 awe32TotalPatchRam................................................................................................. 21 awe32DefineBankSizes.............................................................................................. 22 awe32SFontLoadRequest ........................................................................................... 22 awe32StreamSample .................................................................................................. 23 awe32SetPresets......................................................................................................... 24 awe32ReleaseBank .................................................................................................... 24 awe32ReleaseAllBanks.............................................................................................. 25 awe32WPLoadRequest............................................................................................... 25 awe32WPLoadWave.................................................................................................. 26 awe32WPStreamWave............................................................................................... 26 awe32WPBuildSFont ................................................................................................. 27 Real and Protected Mode API Programming Guide.................................................................. 27 Using the libraries ...................................................................................................... 28 Initialization................................................................................................................ 28 SB AWE32 Developer's Information Pack Contents • i Copyright Creative Technology Ltd., 1994-1996 Version 3.00 Termination ................................................................................................................ 29 Using embedded GM presets...................................................................................... 29 Loading a SoundFont Bank ......................................................................................... 29 Loading wave data as an instrument ........................................................................... 30 Using awe32DefineBankSizes.................................................................................... 31 Starting and ending addresses..................................................................................... 32 Significance of awe32NumG variable........................................................................ 33 Enable real-time panning using awe32RTimePan variable ........................................ 33 CTPNP.CFG Sample ................................................................................................................ 34 PART III Windows Driver API 35 Overview.................................................................................................................................. 35 Application Programmer Interface.............................................................................. 36 AWE Manager DLL .................................................................................................................. 36 AWE Manager message function ................................................................................ 37 Manager Messages ..................................................................................................... 38 Message Reference..................................................................................................... 40 Error Messages........................................................................................................... 73 Windows Programming Guide .................................................................................................. 75 Opening and closing ................................................................................................... 75 Querying for supports ................................................................................................. 76 Retrieving selections .................................................................................................. 79 Issuing selections........................................................................................................ 80 PART IV MIDI NRPN Implementation 83 What Is MIDI Non-Registered-Parameter-Number? ................................................................. 83 How do I use SBAWE32 NRPN?............................................................................................. 83 The EMU8000 Sound Architecture .......................................................................................... 84 EMU8000 Sound Elements ....................................................................................................... 86 Oscillator.................................................................................................................... 86 Low Pass Filter .......................................................................................................... 86 Amplifier.................................................................................................................... 86 LFO1 .......................................................................................................................... 86 LFO2 .......................................................................................................................... 86 Filter Resonance......................................................................................................... 86 LFO1 to Volume (Tremolo)........................................................................................ 86 LFO1 to Filter Cutoff (Wah-Wah) .............................................................................. 86 LFO1 to Pitch (Vibrato).............................................................................................. 87 LFO2 to Pitch (Vibrato).............................................................................................