GstAudio.DsdPlaneOffsetMeta

Fields

Name

Type

Access

Description

meta

Gst.Meta

r/w

parent Gst.Meta

num_bytes_per_channel

int

r/w

the number of valid bytes per channel in the buffer

num_channels

int

r/w

number of channels in the DSD data

offsets

int

r/w

the offsets (in bytes) where each channel plane starts in the buffer

priv_offsets_arr

[int]

r

Methods

class

get_info ()

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.

classmethod get_info()
Return type:

Gst.MetaInfo