OpenAL integration for Python
Project description
PyOpenAL provides OpenAL bindings for python as well as an interface to them.
It even provides a simple way to open OGG Vorbis and OGG Opus files, if used together with PyOgg.
PyOpenAL requires a dynamic OpenAL library (OpenAL32.dll). You can use the official OpenAL library (deprecated) or the much better sounding OpenAL Soft library, which is still actively developed (or any other OpenAL compatible library).
PyOpenAL provides OpenAL bindings, as you would find them in C++, meaning you can follow any OpenAL C++ tutorial with Python. OpenAL’s methods expect C types as arguments, which means you will have to convert Python’s types to C types using ctypes if you want to use them directly. Don’t worry though, PyOpenAL can be used without the need to do that.
I removed the support for ALUT, because it is basically impossible to build nowadays. If you want ALUT support, please use the original PyOpenAL from forrestv
Examples (with PyOgg)
Playing a file
from openal import *
# even though we use PyOgg, we don’t have to import it ourselves, # PyOpenAL does that for us (if it can find it)
import time
# open “test.opus” source = oalLoadFile(“test.opus”)
source.play()
- while source.get_state() == AL_PLAYING:
# wait until the file is done playing time.sleep(1)
# release resources (don’t forget this) oalQuit()
Streaming a file
from openal import *
# it is not required to do this, it’s just to show off it exists pyoggSetStreamBufferSize(4096*4) oalSetStreamBufferCount(4)
sourceStream = oalStreamFile(“test.ogg”)
sourceStream.play()
- while sourceStream.get_state() == AL_PLAYING:
# do stuff sourceStream.update()
oalQuit()
Using OpenAL functions
# here we only import OpenAL’s functions # (in case you don’t need / want PyOpenAL’s functions / classes) from openal._al import * from openal._alc import *
[…]
# it’s as simple as that: alDistanceModel(AL_INVERSE_DISTANCE_CLAMPED)
# or a little more complicated, it really depends: alSourceUnqueueBuffers(source_id, 1, ctypes.pointer(ctypes.c_uint(buffer_ids[id])))
[…]
To get a reference sheet, please visit PyOpenAL’s GitHub page.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for PyOpenAL-0.6a1-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a9a89dee20a7c7caa087252465e71118f5932964eff88b83f4cc8ae685d6af1d |
|
| MD5 | 6b5a386f49f1661be216967a1b163155 |
|
| BLAKE2b-256 | 9301cbe0329e3867c8777d4b08e42a6e1b6e9c221790af794a947bc3b15715d7 |
