FFmpeg
atsc_a53.h
Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 
19 #ifndef AVCODEC_ATSC_A53_H
20 #define AVCODEC_ATSC_A53_H
21 
22 #include <stddef.h>
23 #include <stdint.h>
24 
25 #include "libavutil/buffer.h"
26 #include "libavutil/frame.h"
27 
28 /**
29  * Check AVFrame for A53 side data and allocate and fill SEI message with A53 info
30  *
31  * @param frame Raw frame to get A53 side data from
32  * @param prefix_len Number of bytes to allocate before SEI message
33  * @param data Pointer to a variable to store allocated memory
34  * Upon return the variable will hold NULL on error or if frame has no A53 info.
35  * Otherwise it will point to prefix_len uninitialized bytes followed by
36  * *sei_size SEI message
37  * @param sei_size Pointer to a variable to store generated SEI message length
38  * @return Zero on success, negative error code on failure
39  */
40 int ff_alloc_a53_sei(const AVFrame *frame, size_t prefix_len,
41  void **data, size_t *sei_size);
42 
43 /**
44  * Parse a data array for ATSC A53 Part 4 Closed Captions and store them in an AVBufferRef.
45  *
46  * @param pbuf Pointer to an AVBufferRef to append the closed captions. *pbuf may be NULL, in
47  * which case a new buffer will be allocated and put in it.
48  * @param data The data array containing the raw A53 data.
49  * @param size Size of the data array in bytes.
50  *
51  * @return Number of closed captions parsed on success, negative error code on failure.
52  * If no Closed Captions are parsed, *pbuf is untouched.
53  */
54 int ff_parse_a53_cc(AVBufferRef **pbuf, const uint8_t *data, int size);
55 
56 #endif /* AVCODEC_ATSC_A53_H */
This structure describes decoded (raw) audio or video data.
Definition: frame.h:314
ptrdiff_t const GLvoid * data
Definition: opengl_enc.c:100
uint8_t
ptrdiff_t size
Definition: opengl_enc.c:100
reference-counted frame API
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
int ff_alloc_a53_sei(const AVFrame *frame, size_t prefix_len, void **data, size_t *sei_size)
Check AVFrame for A53 side data and allocate and fill SEI message with A53 info.
Definition: atsc_a53.c:25
int ff_parse_a53_cc(AVBufferRef **pbuf, const uint8_t *data, int size)
Parse a data array for ATSC A53 Part 4 Closed Captions and store them in an AVBufferRef.
Definition: atsc_a53.c:68
refcounted data buffer API
A reference to a data buffer.
Definition: buffer.h:81