Imported Debian version 2.4.3~trusty1
[deb_ffmpeg.git] / ffmpeg / libavcodec / audio_frame_queue.h
CommitLineData
2ba45a60
DM
1/*
2 * Audio Frame Queue
3 * Copyright (c) 2012 Justin Ruggles
4 *
5 * This file is part of FFmpeg.
6 *
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
21
22#ifndef AVCODEC_AUDIO_FRAME_QUEUE_H
23#define AVCODEC_AUDIO_FRAME_QUEUE_H
24
25#include "avcodec.h"
26
27typedef struct AudioFrame {
28 int64_t pts;
29 int duration;
30} AudioFrame;
31
32typedef struct AudioFrameQueue {
33 AVCodecContext *avctx;
34 int remaining_delay;
35 int remaining_samples;
36 AudioFrame *frames;
37 unsigned frame_count;
38 unsigned frame_alloc;
39} AudioFrameQueue;
40
41/**
42 * Initialize AudioFrameQueue.
43 *
44 * @param avctx context to use for time_base and av_log
45 * @param afq queue context
46 */
47void ff_af_queue_init(AVCodecContext *avctx, AudioFrameQueue *afq);
48
49/**
50 * Close AudioFrameQueue.
51 *
52 * Frees memory if needed.
53 *
54 * @param afq queue context
55 */
56void ff_af_queue_close(AudioFrameQueue *afq);
57
58/**
59 * Add a frame to the queue.
60 *
61 * @param afq queue context
62 * @param f frame to add to the queue
63 */
64int ff_af_queue_add(AudioFrameQueue *afq, const AVFrame *f);
65
66/**
67 * Remove frame(s) from the queue.
68 *
69 * Retrieves the pts of the next available frame, or a generated pts based on
70 * the last frame duration if there are no frames left in the queue. The number
71 * of requested samples should be the full number of samples represented by the
72 * packet that will be output by the encoder. If fewer samples are available
73 * in the queue, a smaller value will be used for the output duration.
74 *
75 * @param afq queue context
76 * @param nb_samples number of samples to remove from the queue
77 * @param[out] pts output packet pts
78 * @param[out] duration output packet duration
79 */
80void ff_af_queue_remove(AudioFrameQueue *afq, int nb_samples, int64_t *pts,
81 int *duration);
82
83#endif /* AVCODEC_AUDIO_FRAME_QUEUE_H */