class PacketView

Extracts a slice of this packet.

REQUIRED: 0

<

= start_offset

<

end_offset

<

= frame_count

Reports the format of audio frames in this packet.

Reports the position of the packet's first frame.

Intersects this packet with the given range, returning a packet that overlaps the given range,

or std::nullopt if there is no overlap. The intersection is guaranteed to start and end on a

frame boundary and the intersection is never larger than the packet or the range.

That is, for every non-nullopt result:

result.start_frame = this.start_frame + k * frame_size, for some non-negative integer k, and

frame_count

<

= min(packet.frame_count, range_length)

For example:

IntersectionWith(this = {.start_frame = 0.0, .frame_count = 10},

range_start = 1,

range_length = 2)

returns:

.start_frame = 1.0

.frame_count = 2

.payload = packet.payload + 1 frame

When the range starts or ends on a fractional frame, the intersection is shifted to include

complete frames. The intersection starts with the first frame in the packet that overlaps the

range. For example:

IntersectionWith(this = {.start_frame = 0.0, .frame_count = 10},

range_start = 1.5,

range_length = 2);

returns:

.start_frame = 1.0

.frame_count = 2

.payload = packet.payload + 1 frame

The packet may start on a fractional frame position. For example:

IntersectionWith(this = {.start = 0.9, .frame_count = 10},

range_start = 2.5,

range_length = 3);

returns:

.start_frame = 1.9

.frame_count = 3

.payload = packet.payload + 1 frame

Reports the position just after the packet's last frame.

Reports the number of frames in this packet.

Returns the payload of this packet.