aboutsummaryrefslogtreecommitdiffstats
path: root/libavcodec/atsc_a53.h
blob: 0622a5554937cf6e27e6d64b7c090c708f2cab03 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
/*
 * This file is part of FFmpeg.
 *
 * FFmpeg is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * FFmpeg is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with FFmpeg; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

#ifndef AVCODEC_ATSC_A53_H
#define AVCODEC_ATSC_A53_H

#include <stddef.h>
#include <stdint.h>

#include "libavutil/buffer.h"
#include "libavutil/frame.h"

/**
 * Check AVFrame for A53 side data and allocate and fill SEI message with A53 info
 *
 * @param frame      Raw frame to get A53 side data from
 * @param prefix_len Number of bytes to allocate before SEI message
 * @param data       Pointer to a variable to store allocated memory
 *                   Upon return the variable will hold NULL on error or if frame has no A53 info.
 *                   Otherwise it will point to prefix_len uninitialized bytes followed by
 *                   *sei_size SEI message
 * @param sei_size   Pointer to a variable to store generated SEI message length
 * @return           Zero on success, negative error code on failure
 */
int ff_alloc_a53_sei(const AVFrame *frame, size_t prefix_len,
                     void **data, size_t *sei_size);

/**
 * Parse a data array for ATSC A53 Part 4 Closed Captions and store them in an AVBufferRef.
 *
 * @param pbuf Pointer to an AVBufferRef to append the closed captions. *pbuf may be NULL, in
 *             which case a new buffer will be allocated and put in it.
 * @param data The data array containing the raw A53 data.
 * @param size Size of the data array in bytes.
 *
 * @return Number of closed captions parsed on success, negative error code on failure.
 *         If no Closed Captions are parsed, *pbuf is untouched.
 */
int ff_parse_a53_cc(AVBufferRef **pbuf, const uint8_t *data, int size);

#endif /* AVCODEC_ATSC_A53_H */