Creative Openal Programmer's Reference

Total Page:16

File Type:pdf, Size:1020Kb

Creative Openal Programmer's Reference Creative OpenAL Programmer’s Reference Version 1.0 Table of Contents ABOUT THIS DOCUMENT....................................................................................................................... 4 INTRODUCTION............................................................................................................................................ 4 INTENDED AUDIENCE.................................................................................................................................. 4 OTHER OPENAL RESOURCES ...................................................................................................................... 4 INTRODUCTION TO OPENAL................................................................................................................ 5 INITIALIZING/EXITING................................................................................................................................. 5 LISTENER PROPERTIES ................................................................................................................................6 BUFFER PROPERTIES ................................................................................................................................... 7 SOURCE PROPERTIES ................................................................................................................................... 7 QUEUING BUFFERS ON A SOURCE ............................................................................................................... 9 DOPPLER SHIFT ......................................................................................................................................... 10 ERROR HANDLING..................................................................................................................................... 11 CORE OPENAL FUNCTIONS ................................................................................................................ 12 BUFFER-RELATED ..................................................................................................................................... 12 alGenBuffers......................................................................................................................................... 12 alDeleteBuffers..................................................................................................................................... 12 alIsBuffer.............................................................................................................................................. 13 alBufferData......................................................................................................................................... 13 alGetBufferf.......................................................................................................................................... 14 alGetBufferi.......................................................................................................................................... 14 SOURCE-RELATED..................................................................................................................................... 15 alGenSources........................................................................................................................................ 15 alDeleteSources.................................................................................................................................... 15 alIsSource............................................................................................................................................. 16 alSourcef............................................................................................................................................... 16 alSourcefv............................................................................................................................................. 17 alSource3f............................................................................................................................................. 17 alSourcei............................................................................................................................................... 18 alGetSourcef......................................................................................................................................... 19 alGetSourcefv ....................................................................................................................................... 19 alGetSourcei......................................................................................................................................... 20 alSourcePlay ........................................................................................................................................ 20 alSourcePlayv....................................................................................................................................... 21 alSourcePause...................................................................................................................................... 21 alSourcePausev .................................................................................................................................... 22 alSourceStop......................................................................................................................................... 22 alSourceStopv....................................................................................................................................... 23 alSourceRewind.................................................................................................................................... 23 alSourceRewindv .................................................................................................................................. 24 alSourceQueueBuffers.......................................................................................................................... 24 alSourceUnqueueBuffers...................................................................................................................... 25 LISTENER-RELATED .................................................................................................................................. 25 alListenerf............................................................................................................................................. 25 alListener3f........................................................................................................................................... 26 alListenerfv........................................................................................................................................... 26 - 1 - alListeneri............................................................................................................................................. 27 alGetListenerf....................................................................................................................................... 27 alGetListener3f..................................................................................................................................... 28 alGetListenerfv ..................................................................................................................................... 28 alGetListeneri....................................................................................................................................... 29 STATE-RELATED ....................................................................................................................................... 29 alEnable................................................................................................................................................ 29 alDisable .............................................................................................................................................. 30 alIsEnabled........................................................................................................................................... 30 alGetBoolean........................................................................................................................................ 30 alGetDouble ......................................................................................................................................... 31 alGetFloat ............................................................................................................................................ 31 alGetInteger.......................................................................................................................................... 32 alGetBooleanv...................................................................................................................................... 32 alGetDoublev........................................................................................................................................ 33 alGetFloatv........................................................................................................................................... 33 alGetIntegerv........................................................................................................................................ 34 alGetString ..........................................................................................................................................
Recommended publications
  • You Door Know Vvhor You've
    The Independent l _. NewsletterNewslefter for Ensoniq Users r T You Don'tDoor Know vvhorWhat You've In This Issue .. Got Till It's Gone: Got Till l’r's Gone: Articles:Articles. : The MRD-lMRD-101 a1 MR Disk from Ensoniq ZR-76ZR-76 Specifications Pat FFinniganinnigan Ensoniq ................................................................................................. ........... 3 ~14-f-1'1-I-' :1.‘-:1.’-:i":!.'-2117:‘. :» ~ ~ _ _ August. Mac owners need Stuffitt to unun-binhex-binhex NNAMMAMM News: Ensoniq Makes Keyboards! ~¢. the file; PC’ersPC'ers need WinZip or other unZIP Sam Mims ....................................................... ............................................. 5 app to decompress these filesfiles.. Go to w3.en-w3.en­ soniq.com,soniq.corn, click on the "Download"“Download” link, The X Sounds select the "Musical“Musical Instrument Files"Files” link, and Garth HHjeltejelte .............................................................................................. 6 select the "MR61171"“MR6l/71” link. Click on the 1 MRDMRD-101-IOI link and specify a folder to save it'it in. Once you'veyou’ve pulled it down, decodeldecode/ decompress it, copy to a 1.4 Mb floppy, stuffsniff ReviewsRGVIGWSZ: it into your MR-61176MR-61/76 and press that load buttonbutton... ... Ensoniq MRDMRD-101-IO 1 For: MR-6I,MR-61, MRMR-76,-76, MR Rack. Pat FFinniganinnigan .............................................................................. cover Product: MRDMRD--l101 0 I Sound & Sequence Disk. The Roses Price: FreeFree.. This is
    [Show full text]
  • Game Audio Via Openal
    Game Audio via OpenAL Summary In the Graphics For Games module, you learnt how to use OpenGL to create complex graphical scenes, improving your programming skills along the way, and learning about data structures such as scene graphs. In this workshop, you'll see how to add sounds to your game worlds using the OpenAL sound library. New Concepts Sound in games, OpenAL, PCM audio, binary file formats, FourCC codes, WAV files, limited resource management Introduction Audio has played an important part in gaming almost as long as there have been games to play - even Pong back in 1972 had simple sound effects. We've moved a long way from then; the 80s brought dedicated audio hardware such as the Commodore 64's SID chip that could play 3 simultaneous syn- thesised sounds, and later the Amiga brought the ability to play audio samples to the home gaming market. In modern gaming hardware, we can expect to hear many simultaneous sounds and music tracks, often in surround sound. Game developers now employ dedicated sound engineers that will carefully adjust the sounds in each game release to create an immersive aural experience - making sure that each individual sound is uniquely identifiable and correctly equalised, and that every music track suits the situation they will be played in. At the heart of a game's audio experience is the code that plays back the game sounds, and cal- culates which speakers they should use - the sound system. Although we can't hope to compete with the complex sound systems of AAA games, we should still be able to make a robust, simple system for the addition of sound in our 3D games, and that's what this workshop will assist you in creating.
    [Show full text]
  • Soundfont Player™ 1.0 Operation Manual
    SoundFont Player™ 1.0 Operation Manual E-MU World Headquarters E-MU / ENSONIQ P.O. Box 660015 Scotts Valley, CA 95067-0015 Telephone: (+1) 831-438-1921 Fax: (+1) 831-438-8612 www.soundfont.com www.emu.com SoundFont Player™ 1.0 Operation Manual E-MU World Headquarters E-MU / ENSONIQ P.O. Box 660015 Scotts Valley, CA 95067-0015 Telephone: (+1) 831-438-1921 Fax: (+1) 831-438-8612 Internet: www.soundfont.com www.emu.com SoundFont Player Operation Manual Page 1 This manual is © 2001 E-MU / ENSONIQ. All Rights Reserved Legal Information The following are worldwide trademarks, owned or exclusively licensed by E-mu Systems, Inc, dba E-MU / ENSONIQ, registered in the United States of America as indicated by ®, and in various other countries of the world: E-mu®, E-mu Systems®, the E-mu logo, Ensoniq®, the Ensoniq logo, the E-MU / ENSONIQ logo, Orbit The Dance Planet, Planet Phatt The Swing System, Proteus®, SoundFont®, the SoundFont logo, SoundFont Player,. Sound Blaster and Creative are registered trademarks of Creative Technology Ltd. Audigy, Environmental Audio, the Environmental Audio logo, and Environmental Audio Extensions are trademarks of Creative Technology Ltd. in the United States and/or other countries. Windows is a trademark of Microsoft Corporation in the United States and/or other countries. All other brand and product names are trademarks or registered trademarks of their respective holders. SoundFont Player Operation Manual Page 2 Table of Introduction ...................................................................................6
    [Show full text]
  • Creative® Sound Blaster® Audiopci TM
    ® ® TM Creative Sound Blaster AudioPCI 128 MODEL CT5801 Creative’s Industry-Standard 1373-Based Sound Card Delivers High Quality Digital Audio The model CT5801 Sound Blaster® AudioPCITM 128 for Hewlett-Packard, is an outstanding sound card solution that delivers excellent audio quality and features at an affordable price. The Sound Blaster AudioPCI 128 is driven by Creative’s industry-standard ES1373 DSP engine, coupled with AC97 version 2.1 CODEC, providing the next generation of audio performance while maintaining full Sound Blaster 16 legacy compatibility. Audio - Primary Features The Sound Blaster AudioPCI 128 is a complete digital audio recording and playback system, capable of 16- bit/48KHz fidelity. The Sound Blaster AudioPCI 128 delivers 128-voice polyphony for wavetable audio, real- time DSP effects including reverb, chorus and spatialization, plus real-time bass and treble equalization control. In addition, the Sound Blaster AudioPCI 128 supports 3D Positional Audio, Microsoft’s DirectSound, DirectSound 3D, Environmental Audio Extensions (EAX) for DirectSound3D, and support for the Aureal A3D API, which allows applications written to the A3D API to run on the Sound Blaster AudioPCI 128. A stereo 2w/channel amplifier is also included. Compatibility The Sound Blaster AudioPCI 128 is fully Plug and Play compliant for ease of use in either genuine DOS, DOS Box, Windows Millenium, Windows 95/98/98SE, Windows NT, and Windows 2000 applications, and is fully Sound Blaster 16 compatible in MS-DOS utilizing a patented method of Sound Blaster emulation developed by Creative. In addition, the AudioPCI 128 offers full General MIDI capability, and also supports Microsoft’s PC98, PC99, and Multimedia PC Level II and III specifications.
    [Show full text]
  • Foundations for Music-Based Games
    Die approbierte Originalversion dieser Diplom-/Masterarbeit ist an der Hauptbibliothek der Technischen Universität Wien aufgestellt (http://www.ub.tuwien.ac.at). The approved original version of this diploma or master thesis is available at the main library of the Vienna University of Technology (http://www.ub.tuwien.ac.at/englweb/). MASTERARBEIT Foundations for Music-Based Games Ausgeführt am Institut für Gestaltungs- und Wirkungsforschung der Technischen Universität Wien unter der Anleitung von Ao.Univ.Prof. Dipl.-Ing. Dr.techn. Peter Purgathofer und Univ.Ass. Dipl.-Ing. Dr.techn. Martin Pichlmair durch Marc-Oliver Marschner Arndtstrasse 60/5a, A-1120 WIEN 01.02.2008 Abstract The goal of this document is to establish a foundation for the creation of music-based computer and video games. The first part is intended to give an overview of sound in video and computer games. It starts with a summary of the history of game sound, beginning with the arguably first documented game, Tennis for Two, and leading up to current developments in the field. Next I present a short introduction to audio, including descriptions of the basic properties of sound waves, as well as of the special characteristics of digital audio. I continue with a presentation of the possibilities of storing digital audio and a summary of the methods used to play back sound with an emphasis on the recreation of realistic environments and the positioning of sound sources in three dimensional space. The chapter is concluded with an overview of possible categorizations of game audio including a method to differentiate between music-based games.
    [Show full text]
  • Surround Sound in Linux
    SURROUND SOUND IN LINUX 1. Introduction Getting applications in Linux to play surround sound can involve some work, especially when you want the highest quality. Don't think you're done just because you can hear sound, surround or otherwise. It's possible you still need to do some fine-tuning and calibration to get the most out of it. In this article, I will show you what you need to do get surround sound working properly, in both games and other applications. When you're done, there's no reason to boot Windows to watch movies anymore. In fact, the sound quality is possibly higher than you were used to in windows. Read on to find out why. Note that I'm not talking about duplicating the audio of the front speakers to the rear speakers. Two channel sources are to be played back on two speakers. Anybody who tells you otherwise doesn't know what stereo-imaging and soundstages are. What I mean by surround sound, is playing four or more channels of source audio, like surround sound in games and DVD movies. What you first need to do, get Alsa to work. For most people, this is no issue, and is already done. Note: there is actually a mistake in this article. The 10 dB boost with which the LFE channel is supposed to be played back is not included. I'm working on a correction. 2. Setting up a custom Alsa device Most applications output in 5.1. If you only have a 4.0 soundcard, like me, you have to make a custom sound device for the applications that don't provide downmixing themselves, or if you don't trust applications to downmix properly (like me...).
    [Show full text]
  • 仮想の “音の部屋” によるコミュニケーション・メディア Voiscape の JMF と Java 3D を使用した実装
    情報処理学会 DPS/CSEC 研究会 2004-3-5 (改訂版) 仮想の “音の部屋” によるコミュニケーション・メディア voiscape の JMF と Java 3D を使用した実装 金田 泰 日立製作所 中央研究所 〒185-8601 東京都国分寺市東恋ヶ窪1-280 E-mail: [email protected] 電話にかわるべき音声コミュニケーション・メディア voiscape の確立をめざして研究をおこなっている. Vois- cape においては 3 次元オーディオ技術によってつくられた仮想的な “音の部屋” を使用するが,音声通信と 3 次元音声にくわえて 3 次元グラフィクスを使用するプロトタイプを PC 上に開発した. このプロトタイプにお いては音声のキャプチャと通信のために JMF (Java Media Framework),3 次元音声 / グラフィクスのために Java 3D を使用した. 開発前はこれらの API をつなげば必要な基本機能がほぼ実現できるとかんがえてい たが,実際にはこれらを直接つなぐことはできず,3 次元音声のためには Java 3D のインタフェースをとおし て OpenAL を使用した. また,プロトタイプにおいては音質劣化や遅延などの問題を容易に解決することが できなかったが,試行をかさねてこれらの問題をほぼ解決した. An Implementation of a Virtual “Sound Room” Based Communication-Medium Called Voiscape Using JMF and Java 3D Yasusi Kanada Hitachi Ltd., Central Research Laboratory Higashi-Koigakubo 1-280, Kokubunji, Tokyo 185-8601, Japan E-mail: [email protected] The author researches toward establishing voice communication media called voiscape which shall replace telephone. A virtual “sound room” that is created by spatial audio technology is used in voiscape. We devel- oped a prototype on PCs, in which 3-D graphic is used for supplementing spatial autio. In this prototype, JMF (Java Media Framework) was used for voice capturing and communication, and Java 3D was used for spatial audio and 3-D graphics. Before the development, the author had believed that the basic functions required for the prototype would be realized by connecting these APIs. However, in fact, they cannot be connected di- rectly, so we used OpenAL through the interface of Java 3D. We also encountered problems of sound quality degradation and delay, but they have been almost solved by refining the program by trial and error. 1.
    [Show full text]
  • Creative Portable Audio & Video Users Guide
    User’s Guide Model No.: GH0260 Congratulations! Thank you for choosing the Sound Blaster EVO USB entertainment headset. Connect it to your computer and you are about to experience the legendary audio quality of Sound Blaster. The EVO USB enhances the quality of all your audio content, even from online streaming sources such as YouTube. Its beamforming dual microphone array guarantees crystal clear communication in any environment. Beyond that, it allows you to connect to your mobile devices and enjoy high quality audio on the go! Package Checklist Your Sound Blaster EVO USB package comes with the following: l The Sound Blaster EVO USB l MicroUSB-to-USB cable - Length: 1.8m (5.91ft) l 4-pole analog cable - Length: 1.2m (3.94ft) l Quick Start leaflet Minimum System Requirements l Intel Core™2 Duo processor 2.2 GHz, AMD Athlon 64x2 Dual Core or equivalent processor l Microsoft® Windows® 8 64-bit or 32-bit, Windows 7 64-bit or 32-bit, Windows Vista 64-bit or 32-bit; Macintosh OS X 10.5.8 and above l 1GB RAM l Powered USB 2.0/3.0 port Note: Due to programming changes, the recommended system requirements for the software and applications may change over time. Overview 1 2 3 5 4 OR 1 - Adjustable Headband 2 - Volume Control Multifunction Button 3 - (for calls and playback) 4 - 4-Pole Analog Jack 5 - MicroUSB Port Flexible Connection Options 4-pole Analog Cable to your Smart Devices USB Cable to your PC/Mac Splitter Cable* to your Soundcard * Cable not included Using Your Sound Blaster EVO USB Set up your headset in three simple steps: 1.
    [Show full text]
  • C-Media Xear 3D Sound Solution CMI8738 4/6-Channel PCI Audio Single Chip
    C-Media XeaR 3D Sound Solution CMI8738 4/6-Channel PCI Audio Single Chip User Manual C-Media CMI8738 XeaR 3D Technology Sound Solution User Manual Rev. 2.1 Table of Contents Preface………………………..………………………………………………………2 1. C-Media CMI8738 Audio Chip Advantages………………………………….3 1.1 C3D HRTF Positional Sound Solution..……………………………………..3 1.2 EnvironmentFX Sound Effects……………………………………………….5 1.3 XeaR Technology………………………………………………………………6 2. Product Specification………………………………………………………….10 3. Installation/Uninstallation P rocedure ...……………………………………..11 4. C-Media Power Mixer…………………….…………………………………….16 5. Windows Applications--Audio Rack………………………………….……..22 6. Multi-Channel Audio Demo……………………………….…………………..28 Appendix A —Connectors and Jumpers ……………………………………….35 Appendix B —The 4 Speakers System …………………………………………37 Appendix C —SPDIF I/O Function ……………………………………………….39 Appendix D —Solution For Mini Disc Players …………………………………40 Appendix E —Recording From SPDIF-In ……………………………………….43 2 C-Media CMI8738 XeaR 3D Technology Sound Solution User Manual Rev. 2.1 Preface The manual is a user guide for using C-Media CMI8738 PCI multi-channel audio device correctly and it also provides the overview of the versatile product features and value-added advance audio technology such as 3D, EAXTM , XeaR, etc.. The document is protected by copyright and all rights are reserved. No part of this manual can be reproduced by any form without prior permission of C-Media Inc.. This PCI Audio Adapter offers a new generation PCI audio solution: it utilizes the state-of-the- art CRL® 3D Audio technology (HRTF 3D positional audio), and supports Microsoft® DirectSound ® 3D and Aureal®’s A3D® interfaces. Better yet, it supports 2/4/6 speakers and DLS based (Downloadable Sound) wave table music synthesizer which supports the DirectMusic®.
    [Show full text]
  • Mac OS X Server
    Mac OS X Server Version 10.4 Technology Overview August 2006 Technology Overview 2 Mac OS X Server Contents Page 3 Introduction Page 5 New in Version 10.4 Page 7 Operating System Fundamentals UNIX-Based Foundation 64-Bit Computing Advanced BSD Networking Architecture Robust Security Directory Integration High Availability Page 10 Integrated Management Tools Server Admin Workgroup Manager Page 14 Service Deployment and Administration Open Directory Server File and Print Services Mail Services Web Hosting Enterprise Applications Media Streaming iChat Server Software Update Server NetBoot and NetInstall Networking and VPN Distributed Computing Page 29 Product Details Page 31 Open Source Projects Page 35 Additional Resources Technology Overview 3 Mac OS X Server Introduction Mac OS X Server version 10.4 Tiger gives you everything you need to manage servers in a mixed-platform environment and to con gure, deploy, and manage powerful network services. Featuring the renowned Mac OS X interface, Mac OS X Server streamlines your management tasks with applications and utilities that are robust yet easy to use. Apple’s award-winning server software brings people and data together in innovative ways. Whether you want to empower users with instant messaging and blogging, gain greater control over email, reduce the cost and hassle of updating software, or build your own distributed supercomputer, Mac OS X Server v10.4 has the tools you need. The Universal release of Mac OS X Server runs on both Intel- and PowerPC-based The power and simplicity of Mac OS X Server are a re ection of Apple’s operating sys- Mac desktop and Xserve systems.
    [Show full text]
  • The Linux Gamers' HOWTO
    The Linux Gamers’ HOWTO Peter Jay Salzman Frédéric Delanoy Copyright © 2001, 2002 Peter Jay Salzman Copyright © 2003, 2004 Peter Jay SalzmanFrédéric Delanoy 2004-11-13 v.1.0.6 Abstract The same questions get asked repeatedly on Linux related mailing lists and news groups. Many of them arise because people don’t know as much as they should about how things "work" on Linux, at least, as far as games go. Gaming can be a tough pursuit; it requires knowledge from an incredibly vast range of topics from compilers to libraries to system administration to networking to XFree86 administration ... you get the picture. Every aspect of your computer plays a role in gaming. It’s a demanding topic, but this fact is shadowed by the primary goal of gaming: to have fun and blow off some steam. This document is a stepping stone to get the most common problems resolved and to give people the knowledge to begin thinking intelligently about what is going on with their games. Just as with anything else on Linux, you need to know a little more about what’s going on behind the scenes with your system to be able to keep your games healthy or to diagnose and fix them when they’re not. 1. Administra If you have ideas, corrections or questions relating to this HOWTO, please email me. By receiving feedback on this howto (even if I don’t have the time to answer), you make me feel like I’m doing something useful. In turn, it motivates me to write more and add to this document.
    [Show full text]
  • PDE Printed Guide.Fm
    1 ( ) 2 15 ( ) 3 ( ) 4 ( ) 14 13 5 12 6 7 8 11 9 10 1 Congratulations ZEN Vision:M™ is the new digital player from Creative. Read on to learn how to get started with your new player! Contents About Your Player ................................................................................... 2 Using the Navigation Controls ............................................................... 3 Getting Started ....................................................................................... 4 Managing Music and Data .................................................................... 10 Understanding Your Player .................................................................. 11 Managing Your Player .......................................................................... 12 Personalizing Your Player .................................................................... 21 Connecting Your Player to a TV ............................................................ 24 FAQ ....................................................................................................... 25 Information Diagrams .......................................................................... 26 General Specifications ........................................................................ 28 Copyright and License .......................................................................... 30 2 About Your Player About Your Player Unfold the last page of this booklet, and reference the image there against the names and descriptions below. 1Power switch 10 Dock
    [Show full text]