OpenAL Specification and Reference
<<< Previous	Extensions	Next >>>

Compatibility Extensions

The extensions described have at one point been in use for experimental purposes, proof of concept, or short term needs. They are preserved for backwards compatibility. Use is not recommended, avialability not guaranteed. Most of these will be officially dropped by the time API revision 2.0 is released.

Loki BufferAppendData

Experimental implementation to append data to an existing buffer. Obsoleted by Buffer Queueing. TBA.

Loki Decoding Callback

Experimental implementation to allow the application to specify a decoding callback for compression formats and codecs not supported by OpenAL. This is supposed to be used if full uncompression by the application is prohibited by memory footprint, but streaming (by queueing) is not desired as the compressed data can be kept in memory in its entirety.

If mixing can be done from the compressed data directly, several sources can use the sample without having to be synchronized. For compression formats not supported by AL, however, partial decompression has to be done by the application. This extension allows for the implementation to "pull" data, using apllication provided decompression code.

The use of this callback by the OpenAL implementation makes sense only if late decompression (incremerntal, on demand, as needed for mixing) is done, as full early compression (ahead-of-time) inside the implementation would exact a similar memory footprint.

TBA.

This extension forces execution of third party code during (possibly threaded) driver operation, and might also require state management with global variables for decoder state, which raises issues of thread safety and use for multiple buffers. This extension should be obsolete as soon as OpenAL supports a reasonable set of state of the art compression and encoding schemes.

Loki Infinite Loop Extension

To support infinite looping, a boolean LOOP was introduced. With the introduction of buffer queueing and the request for support for a limited number of repetitions, this mechanism was redundant. This extension is not supported for buffer queue operations, attempts to use it will cause an ILLEGAL_OPERATION error. For backwards compatibility it is supported as the equivalent to

Source( sName, LOOP_COUNT, MAX_INTEGER )

For the query LOOP==TRUE, the comparison LOOP_COUNT!=MAX_INTEGER has to be executed on the queue, not the current value which is decremented for a PLAYING Source.

Table 12. Source LOOP_LOKI Attribute

Name	Signature	Values	Default
LOOP_LOKI	b	TRUE FALSE	FALSE

Description: TRUE indicates that the Source will perform an inifinite loop over the content of the current Buffer it refers to.

Loki Byte Offset Extension

The following has been obsoleted by explicit Source State query. hack.

Table 13. Buffer BYTE Offset attribute

Name	Signature	Values	Default
BYTE_LOKI	ui	n/a	n/a

Current byte for the buffer bound to the source interpreted as an offset from the beginning of the buffer.

<<< Previous	Home	Next >>>
Other Extension	Up	Loop Point Extension