audio_frame_queue.h
Go to the documentation of this file.
1 /*
2  * Audio Frame Queue
3  * Copyright (c) 2012 Justin Ruggles
4  *
5  * This file is part of Libav.
6  *
7  * Libav 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  * Libav 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 Libav; 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 
27 typedef struct AudioFrame {
28  int64_t pts;
29  int duration;
30 } AudioFrame;
31 
32 typedef struct AudioFrameQueue {
37  unsigned frame_count;
38  unsigned frame_alloc;
40 
41 /**
42  * Initialize AudioFrameQueue.
43  *
44  * @param avctx context to use for time_base and av_log
45  * @param afq queue context
46  */
48 
49 /**
50  * Close AudioFrameQueue.
51  *
52  * Frees memory if needed.
53  *
54  * @param afq queue context
55  */
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  */
64 int 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  */
80 void ff_af_queue_remove(AudioFrameQueue *afq, int nb_samples, int64_t *pts,
81  int *duration);
82 
83 #endif /* AVCODEC_AUDIO_FRAME_QUEUE_H */
This structure describes decoded (raw) audio or video data.
Definition: frame.h:76
AudioFrame * frames
Sinusoidal phase f
struct AudioFrame AudioFrame
external API header
void ff_af_queue_remove(AudioFrameQueue *afq, int nb_samples, int64_t *pts, int *duration)
Remove frame(s) from the queue.
AVCodecContext * avctx
void ff_af_queue_close(AudioFrameQueue *afq)
Close AudioFrameQueue.
struct AudioFrameQueue AudioFrameQueue
void ff_af_queue_init(AVCodecContext *avctx, AudioFrameQueue *afq)
Initialize AudioFrameQueue.
main external API structure.
int ff_af_queue_add(AudioFrameQueue *afq, const AVFrame *f)
Add a frame to the queue.