FFmpeg
Data Structures | Macros | Enumerations | Functions
sync_queue.h File Reference
#include <stdint.h>
#include "libavcodec/packet.h"
#include "libavutil/frame.h"

Go to the source code of this file.

Data Structures

union  SyncQueueFrame
 

Macros

#define SQFRAME(frame)   ((SyncQueueFrame){ .f = (frame) })
 
#define SQPKT(pkt)   ((SyncQueueFrame){ .p = (pkt) })
 

Enumerations

enum  SyncQueueType { SYNC_QUEUE_PACKETS, SYNC_QUEUE_FRAMES }
 

Functions

SyncQueuesq_alloc (enum SyncQueueType type, int64_t buf_size_us, void *logctx)
 Allocate a sync queue of the given type. More...
 
void sq_free (SyncQueue **sq)
 
int sq_add_stream (SyncQueue *sq, int limiting)
 Add a new stream to the sync queue. More...
 
void sq_limit_frames (SyncQueue *sq, unsigned int stream_idx, uint64_t max_frames)
 Limit the number of output frames for stream with index stream_idx to max_frames. More...
 
void sq_frame_samples (SyncQueue *sq, unsigned int stream_idx, int frame_samples)
 Set a constant output audio frame size, in samples. More...
 
int sq_send (SyncQueue *sq, unsigned int stream_idx, SyncQueueFrame frame)
 Submit a frame for the stream with index stream_idx. More...
 
int sq_receive (SyncQueue *sq, int stream_idx, SyncQueueFrame frame)
 Read a frame from the queue. More...
 

Macro Definition Documentation

◆ SQFRAME

#define SQFRAME (   frame)    ((SyncQueueFrame){ .f = (frame) })

Definition at line 38 of file sync_queue.h.

◆ SQPKT

#define SQPKT (   pkt)    ((SyncQueueFrame){ .p = (pkt) })

Definition at line 39 of file sync_queue.h.

Enumeration Type Documentation

◆ SyncQueueType

Enumerator
SYNC_QUEUE_PACKETS 
SYNC_QUEUE_FRAMES 

Definition at line 28 of file sync_queue.h.

Function Documentation

◆ sq_alloc()

SyncQueue* sq_alloc ( enum SyncQueueType  type,
int64_t  buf_size_us,
void *  logctx 
)

Allocate a sync queue of the given type.

Parameters
buf_size_usmaximum duration that will be buffered in microseconds

Definition at line 675 of file sync_queue.c.

Referenced by sch_add_sq_enc(), and setup_sync_queues().

◆ sq_free()

void sq_free ( SyncQueue **  sq)

Definition at line 699 of file sync_queue.c.

Referenced by of_free(), and sch_free().

◆ sq_add_stream()

int sq_add_stream ( SyncQueue sq,
int  limiting 
)

Add a new stream to the sync queue.

Parameters
limitingwhether the stream is limiting, i.e. no other stream can be longer than this one
Returns
  • a non-negative stream index on success
  • a negative error code on error

Definition at line 620 of file sync_queue.c.

Referenced by sch_sq_add_enc(), and setup_sync_queues().

◆ sq_limit_frames()

void sq_limit_frames ( SyncQueue sq,
unsigned int  stream_idx,
uint64_t  max_frames 
)

Limit the number of output frames for stream with index stream_idx to max_frames.

Definition at line 649 of file sync_queue.c.

Referenced by sch_sq_add_enc(), and setup_sync_queues().

◆ sq_frame_samples()

void sq_frame_samples ( SyncQueue sq,
unsigned int  stream_idx,
int  frame_samples 
)

Set a constant output audio frame size, in samples.

Can only be used with SYNC_QUEUE_FRAMES queues and audio streams.

All output frames will have exactly frame_samples audio samples, except possibly for the last one, which may have fewer.

Definition at line 661 of file sync_queue.c.

Referenced by enc_open().

◆ sq_send()

int sq_send ( SyncQueue sq,
unsigned int  stream_idx,
SyncQueueFrame  frame 
)

Submit a frame for the stream with index stream_idx.

On success, the sync queue takes ownership of the frame and will reset the contents of the supplied frame. On failure, the frame remains owned by the caller.

Sending a frame with NULL contents marks the stream as finished.

Returns
  • 0 on success
  • AVERROR_EOF when no more frames should be submitted for this stream
  • another a negative error code on failure

Definition at line 343 of file sync_queue.c.

Referenced by send_to_enc_sq(), and sync_queue_process().

◆ sq_receive()

int sq_receive ( SyncQueue sq,
int  stream_idx,
SyncQueueFrame  frame 
)

Read a frame from the queue.

Parameters
stream_idxindex of the stream to read a frame for. May be -1, then try to read a frame from any stream that is ready for output.
frameoutput frame will be written here on success. The frame is owned by the caller.
Returns
  • a non-negative index of the stream to which the returned frame belongs
  • AVERROR(EAGAIN) when more frames need to be submitted to the queue
  • AVERROR_EOF when no more frames will be available for this stream (for any stream if stream_idx is -1)
  • another negative error code on failure

Definition at line 608 of file sync_queue.c.

Referenced by send_to_enc_sq(), and sync_queue_process().