1/*
2 * H.264/HEVC common parsing code
3 *
4 * This file is part of FFmpeg.
5 *
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * FFmpeg is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21#ifndef AVCODEC_H2645_PARSE_H
22#define AVCODEC_H2645_PARSE_H
23
24#include <stdint.h>
25
26#include "libavutil/buffer.h"
27#include "libavutil/error.h"
28#include "libavutil/log.h"
29#include "codec_id.h"
30#include "get_bits.h"
31
32#define MAX_MBPAIR_SIZE (256*1024) // a tighter bound could be calculated if someone cares about a few bytes
33
34typedef struct H2645NAL {
35    const uint8_t *data;
36    int size;
37
38    /**
39     * Size, in bits, of just the data, excluding the stop bit and any trailing
40     * padding. I.e. what HEVC calls SODB.
41     */
42    int size_bits;
43
44    int raw_size;
45    const uint8_t *raw_data;
46
47    GetBitContext gb;
48
49    /**
50     * NAL unit type
51     */
52    int type;
53
54    /**
55     * H.264 only, nal_ref_idc
56     */
57    int ref_idc;
58
59    /**
60     * HEVC only, nuh_temporal_id_plus_1 - 1
61     */
62    int temporal_id;
63
64    /*
65     * HEVC only, identifier of layer to which nal unit belongs
66     */
67    int nuh_layer_id;
68
69    int skipped_bytes;
70    int skipped_bytes_pos_size;
71    int *skipped_bytes_pos;
72} H2645NAL;
73
74typedef struct H2645RBSP {
75    uint8_t *rbsp_buffer;
76    AVBufferRef *rbsp_buffer_ref;
77    int rbsp_buffer_alloc_size;
78    int rbsp_buffer_size;
79} H2645RBSP;
80
81/* an input packet split into unescaped NAL units */
82typedef struct H2645Packet {
83    H2645NAL *nals;
84    H2645RBSP rbsp;
85    int nb_nals;
86    int nals_allocated;
87    unsigned nal_buffer_size;
88} H2645Packet;
89
90/**
91 * Extract the raw (unescaped) bitstream.
92 */
93int ff_h2645_extract_rbsp(const uint8_t *src, int length, H2645RBSP *rbsp,
94                          H2645NAL *nal, int small_padding);
95
96/**
97 * Split an input packet into NAL units.
98 *
99 * If data == raw_data holds true for a NAL unit of the returned pkt, then
100 * said NAL unit does not contain any emulation_prevention_three_byte and
101 * the data is contained in the input buffer pointed to by buf.
102 * Otherwise, the unescaped data is part of the rbsp_buffer described by the
103 * packet's H2645RBSP.
104 *
105 * If the packet's rbsp_buffer_ref is not NULL, the underlying AVBuffer must
106 * own rbsp_buffer. If not and rbsp_buffer is not NULL, use_ref must be 0.
107 * If use_ref is set, rbsp_buffer will be reference-counted and owned by
108 * the underlying AVBuffer of rbsp_buffer_ref.
109 */
110int ff_h2645_packet_split(H2645Packet *pkt, const uint8_t *buf, int length,
111                          void *logctx, int is_nalff, int nal_length_size,
112                          enum AVCodecID codec_id, int small_padding, int use_ref);
113
114/**
115 * Free all the allocated memory in the packet.
116 */
117void ff_h2645_packet_uninit(H2645Packet *pkt);
118
119static inline int get_nalsize(int nal_length_size, const uint8_t *buf,
120                              int buf_size, int *buf_index, void *logctx)
121{
122    int i, nalsize = 0;
123
124    if (*buf_index >= buf_size - nal_length_size) {
125        // the end of the buffer is reached, refill it
126        return AVERROR_INVALIDDATA;
127    }
128
129    for (i = 0; i < nal_length_size; i++)
130        nalsize = ((unsigned)nalsize << 8) | buf[(*buf_index)++];
131    if (nalsize <= 0 || nalsize > buf_size - *buf_index) {
132        av_log(logctx, AV_LOG_ERROR,
133               "Invalid NAL unit size (%d > %d).\n", nalsize, buf_size - *buf_index);
134        return AVERROR_INVALIDDATA;
135    }
136    return nalsize;
137}
138
139#endif /* AVCODEC_H2645_PARSE_H */
140