HOpenAL Libraries (OpenAL package)ContentsIndex
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 = Int8
8-bit boolean
type ALchar = Int8
Character
type ALbyte = Int8
Signed 8-bit 2's complement integer
type ALubyte = Word8
Unsigned 8-bit integer
type ALshort = Int16
Signed 16-bit 2's complement integer
type ALushort = Word16
Unsigned 16-bit integer
type ALint = Int32
Signed 32-bit 2's complement integer
type ALuint = Word32
Unsigned 32-bit integer
type ALsizei = Int32
Non-negatitve 32-bit binary integer size
type ALenum = Int32
Enumerated 32-bit value
type ALfloat = Float
32-bit IEEE754 floating-point
type ALdouble = Double
64-bit IEEE754 floating-point
Produced by Haddock version 0.7