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
34 typedef 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
74 typedef 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 */
82 typedef 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 */
93 int 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 */
110 int 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 */
117 void ff_h2645_packet_uninit(H2645Packet *pkt);
118
get_nalsize(int nal_length_size,const uint8_t * buf,int buf_size,int * buf_index,void * logctx)119 static 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