Memory-managed wrapper type.

Construct a AudioBuffer struct initialized to zero.

Clip the buffer to the given GstSegment.

After calling this function the caller does not own a reference to buffer anymore.

Maps an audio gstbuffer so that it can be read or written and stores the result of the map operation in buffer.

This is especially useful when the gstbuffer is in non-interleaved (planar) layout, in which case this function will use the information in the gstbuffer's attached AudioMeta in order to map each channel in a separate "plane" in AudioBuffer. If a AudioMeta is not attached on the gstbuffer, then it must be in interleaved layout.

If a AudioMeta is attached, then the AudioInfo on the meta is checked against info. Normally, they should be equal, but in case they are not, a g_critical will be printed and the AudioInfo from the meta will be used.

In non-interleaved buffers, it is possible to have each channel on a separate Memory. In this case, each memory will be mapped separately to avoid copying their contents in a larger memory area. Do note though that it is not supported to have a single channel spanning over two or more different Memory objects. Although the map operation will likely succeed in this case, it will be highly sub-optimal and it is recommended to merge all the memories in the buffer before calling this function.

Note: The actual Buffer is not ref'ed, but it is required to stay valid as long as it's mapped.

Since: 1.16

Reorders buffer from the channel positions from to the channel positions to. from and to must contain the same number of positions and the same positions, only in a different order. buffer must be writable.

Truncate the buffer to finally have samples number of samples, removing the necessary amount of samples from the end and trim number of samples from the beginning.

This function does not know the audio rate, therefore the caller is responsible for re-setting the correct timestamp and duration to the buffer. However, timestamp will be preserved if trim == 0, and duration will also be preserved if there is no trimming to be done. Offset and offset end will be preserved / updated.

After calling this function the caller does not own a reference to buffer anymore.

Since: 1.16

Unmaps an audio buffer that was previously mapped with audioBufferMap.

Since: 1.16

Set the value of the “buffer” field to Nothing. When overloading is enabled, this is equivalent to

clear #buffer

Get the value of the “buffer” field. When overloading is enabled, this is equivalent to

get audioBuffer #buffer

Set the value of the “buffer” field. When overloading is enabled, this is equivalent to

set audioBuffer [ #buffer := value ]

Get the value of the “info” field. When overloading is enabled, this is equivalent to

get audioBuffer #info

Get the value of the “n_planes” field. When overloading is enabled, this is equivalent to

get audioBuffer #nPlanes

Set the value of the “n_planes” field. When overloading is enabled, this is equivalent to

set audioBuffer [ #nPlanes := value ]

Get the value of the “n_samples” field. When overloading is enabled, this is equivalent to

get audioBuffer #nSamples

Set the value of the “n_samples” field. When overloading is enabled, this is equivalent to

set audioBuffer [ #nSamples := value ]

Set the value of the “planes” field to Nothing. When overloading is enabled, this is equivalent to

clear #planes

Get the value of the “planes” field. When overloading is enabled, this is equivalent to

get audioBuffer #planes

Set the value of the “planes” field. When overloading is enabled, this is equivalent to

set audioBuffer [ #planes := value ]