Video frame structure. More...

#include <include/ascii-chat/video/rgba/video_frame.h>

Data Fields
Frame Data
void *	data
	Frame data pointer (points to pre-allocated buffer)

size_t	size
	Size of frame data in bytes.

Frame Dimensions
uint32_t	width
	Frame width in pixels.

uint32_t	height
	Frame height in pixels.

Timing Information
uint64_t	capture_timestamp_ns
	Timestamp when frame was captured (nanoseconds)

uint64_t	receive_timestamp_ns
	Timestamp when frame was received (nanoseconds)

uint64_t	sequence_number
	Frame sequence number (for drop detection)

Quality Metrics
uint64_t	encoding_time_ns
	Time taken to encode/decode frame (nanoseconds)

bool	is_keyframe
	True if this is a keyframe (important frame)

Detailed Description

Video frame structure.

Represents a single video frame with data, dimensions, timing, and quality metrics. Frame data points to pre-allocated buffers managed by the frame buffer system.

Note: Frame data is not owned by this structure - it points to pre-allocated buffers that are reused across frames.; Sequence numbers are used to detect dropped frames (gaps in sequence).; Timestamps are in microseconds for high precision timing.

Definition at line 116 of file video_frame.h.

Field Documentation

◆ capture_timestamp_ns

uint64_t video_frame_t::capture_timestamp_ns

Timestamp when frame was captured (nanoseconds)

Definition at line 134 of file video_frame.h.

Referenced by client_video_render_thread(), and simple_frame_swap_update().

◆ data

void* video_frame_t::data

Frame data pointer (points to pre-allocated buffer)

Definition at line 120 of file video_frame.h.

Referenced by client_video_render_thread(), simple_frame_swap_create(), simple_frame_swap_destroy(), simple_frame_swap_update(), video_frame_buffer_create(), and video_frame_buffer_destroy().

◆ encoding_time_ns

uint64_t video_frame_t::encoding_time_ns

Time taken to encode/decode frame (nanoseconds)

Definition at line 142 of file video_frame.h.

◆ height

uint32_t video_frame_t::height

Frame height in pixels.

Definition at line 128 of file video_frame.h.

Referenced by client_video_render_thread().

◆ is_keyframe

bool video_frame_t::is_keyframe

True if this is a keyframe (important frame)

Definition at line 143 of file video_frame.h.

◆ receive_timestamp_ns

uint64_t video_frame_t::receive_timestamp_ns

Timestamp when frame was received (nanoseconds)

Definition at line 135 of file video_frame.h.

◆ sequence_number

uint64_t video_frame_t::sequence_number

Frame sequence number (for drop detection)

Definition at line 136 of file video_frame.h.

◆ size

size_t video_frame_t::size

Size of frame data in bytes.

Definition at line 121 of file video_frame.h.

Referenced by client_send_thread_func(), client_video_render_thread(), simple_frame_swap_update(), video_frame_buffer_create(), video_frame_commit(), and video_frame_peek_latest().

◆ width

uint32_t video_frame_t::width

Frame width in pixels.

Definition at line 127 of file video_frame.h.