GstAudio.DsdPlaneOffsetMeta¶
Fields¶
Name |
Type |
Access |
Description |
|---|---|---|---|
meta |
r/w |
parent |
|
num_bytes_per_channel |
r/w |
the number of valid bytes per channel in the buffer |
|
num_channels |
r/w |
number of channels in the DSD data |
|
offsets |
r/w |
the offsets (in bytes) where each channel plane starts in the buffer |
|
priv_offsets_arr |
[ |
r |
Methods¶
class |
|
Details¶
- class GstAudio.DsdPlaneOffsetMeta¶
Buffer metadata describing planar DSD contents in the buffer. This is not needed for interleaved DSD data, and is required for non-interleaved (= planar) data.
The different channels in offsets are always in the GStreamer channel order. Zero-copy channel reordering can be implemented by swapping the values in offsets.
It is not allowed for channels to overlap in memory, i.e. for each i in [0, channels), the range [offsets[i], offsets[i] + num_bytes_per_channel) must not overlap with any other such range.
It is, however, allowed to have parts of the buffer memory unused, by using offsets and num_bytes_per_channel in such a way that leave gaps on it. This is used to implement zero-copy clipping in non-interleaved buffers.
Obviously, due to the above, it is not safe to infer the number of valid bytes from the size of the buffer. You should always use the num_bytes_per_channel variable of this metadata.
New in version 1.24.