OpenAL-1.3.1.1: A binding to the OpenAL cross-platform 3D audio APISource codeContentsIndex
Sound.OpenAL.AL.BasicTypes
Portabilityportable
Stabilityprovisional
Maintainersven.panne@aedion.de
Contents
Primitive Types
Floating-Point Computation
Description
This module corresponds to section 2.2 (Primitive Types) of the OpenAL Specification and Reference (version 1.1).
Synopsis
type ALboolean = Int8
type ALchar = Int8
type ALbyte = Int8
type ALubyte = Word8
type ALshort = Int16
type ALushort = Word16
type ALint = Int32
type ALuint = Word32
type ALsizei = Int32
type ALenum = Int32
type ALfloat = Float
type ALdouble = Double
Primitive Types
As OpenAL is meant to allow for seamless integration with OpenGL code if needed, the OpenAL library primitive (scalar) data types mimic the OpenGL data types. Guaranteed minimum sizes are stated for OpenGL data types, but the actual choice of C data type is left to the implementation. All implementations on a given binary architecture, however, must use a common definition of these data types.
Floating-Point Computation
Any representable floating-point value is legal as input to an OpenAL command that requires floating point data. The result of providing a value that is not a floating point number to such a command is unspecified, but must not lead to OpenAL being interrupted or terminated. In IEEE arithmetic, for example, providing a negative zero or a denormalized number to an OpenAL command yields predictable results, while providing a NaN or infinity yields unspecified results. Some calculations require division. In such cases (including implied divisions required by vector normalizations), a division by zero produces an unspecified result but must not lead to OpenAL interruption or termination.
type ALboolean = Int8Source
8-bit boolean
type ALchar = Int8Source
Character
type ALbyte = Int8Source
Signed 8-bit 2's complement integer
type ALubyte = Word8Source
Unsigned 8-bit integer
type ALshort = Int16Source
Signed 16-bit 2's complement integer
type ALushort = Word16Source
Unsigned 16-bit integer
type ALint = Int32Source
Signed 32-bit 2's complement integer
type ALuint = Word32Source
Unsigned 32-bit integer
type ALsizei = Int32Source
Non-negatitve 32-bit binary integer size
type ALenum = Int32Source
Enumerated 32-bit value
type ALfloat = FloatSource
32-bit IEEE754 floating-point
type ALdouble = DoubleSource
64-bit IEEE754 floating-point
Produced by Haddock version 0.9