xref: /aosp_15_r20/external/mesa3d/src/util/vl_bitstream.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1*61046927SAndroid Build Coastguard Worker /*
2*61046927SAndroid Build Coastguard Worker  * Copyright 2023 Red Hat
3*61046927SAndroid Build Coastguard Worker  * SPDX-License-Identifier: MIT
4*61046927SAndroid Build Coastguard Worker  *
5*61046927SAndroid Build Coastguard Worker  * This is a C rewrite of pieces of the d3d12 frontend which is:
6*61046927SAndroid Build Coastguard Worker  * Copyright © Microsoft Corporation
7*61046927SAndroid Build Coastguard Worker  */
8*61046927SAndroid Build Coastguard Worker #ifndef VL_BITSTREAM_H
9*61046927SAndroid Build Coastguard Worker #define VL_BITSTREAM_H
10*61046927SAndroid Build Coastguard Worker 
11*61046927SAndroid Build Coastguard Worker struct vl_bitstream_encoder {
12*61046927SAndroid Build Coastguard Worker    uint8_t *bits;
13*61046927SAndroid Build Coastguard Worker    uint32_t bits_buffer_size;
14*61046927SAndroid Build Coastguard Worker    uint32_t offset;
15*61046927SAndroid Build Coastguard Worker 
16*61046927SAndroid Build Coastguard Worker    uint32_t enc_buffer;
17*61046927SAndroid Build Coastguard Worker 
18*61046927SAndroid Build Coastguard Worker    int32_t bits_to_go;
19*61046927SAndroid Build Coastguard Worker    bool prevent_start_code;
20*61046927SAndroid Build Coastguard Worker 
21*61046927SAndroid Build Coastguard Worker    bool internal_buffer;
22*61046927SAndroid Build Coastguard Worker    bool overflow;
23*61046927SAndroid Build Coastguard Worker };
24*61046927SAndroid Build Coastguard Worker 
25*61046927SAndroid Build Coastguard Worker #define VL_BITSTREAM_MAX_BUFFER 256
26*61046927SAndroid Build Coastguard Worker 
27*61046927SAndroid Build Coastguard Worker static inline void
vl_bitstream_encoder_clear(struct vl_bitstream_encoder * enc,void * buffer_base,size_t buffer_offset,size_t buffer_limit)28*61046927SAndroid Build Coastguard Worker vl_bitstream_encoder_clear(struct vl_bitstream_encoder *enc,
29*61046927SAndroid Build Coastguard Worker                            void *buffer_base,
30*61046927SAndroid Build Coastguard Worker                            size_t buffer_offset,
31*61046927SAndroid Build Coastguard Worker                            size_t buffer_limit)
32*61046927SAndroid Build Coastguard Worker {
33*61046927SAndroid Build Coastguard Worker    memset(enc, 0, sizeof(*enc));
34*61046927SAndroid Build Coastguard Worker    enc->bits_to_go = 32;
35*61046927SAndroid Build Coastguard Worker 
36*61046927SAndroid Build Coastguard Worker    if (!buffer_base) {
37*61046927SAndroid Build Coastguard Worker       enc->bits = malloc(VL_BITSTREAM_MAX_BUFFER);
38*61046927SAndroid Build Coastguard Worker       enc->bits_buffer_size = VL_BITSTREAM_MAX_BUFFER;
39*61046927SAndroid Build Coastguard Worker       enc->internal_buffer = true;
40*61046927SAndroid Build Coastguard Worker    } else {
41*61046927SAndroid Build Coastguard Worker       enc->bits = (uint8_t *)buffer_base + buffer_offset;
42*61046927SAndroid Build Coastguard Worker       enc->bits_buffer_size = buffer_limit;
43*61046927SAndroid Build Coastguard Worker    }
44*61046927SAndroid Build Coastguard Worker }
45*61046927SAndroid Build Coastguard Worker 
46*61046927SAndroid Build Coastguard Worker static inline void
vl_bitstream_encoder_free(struct vl_bitstream_encoder * enc)47*61046927SAndroid Build Coastguard Worker vl_bitstream_encoder_free(struct vl_bitstream_encoder *enc)
48*61046927SAndroid Build Coastguard Worker {
49*61046927SAndroid Build Coastguard Worker    if (enc->internal_buffer)
50*61046927SAndroid Build Coastguard Worker       free(enc->bits);
51*61046927SAndroid Build Coastguard Worker }
52*61046927SAndroid Build Coastguard Worker 
53*61046927SAndroid Build Coastguard Worker static inline int
vl_bitstream_get_num_bits_for_byte_align(struct vl_bitstream_encoder * enc)54*61046927SAndroid Build Coastguard Worker vl_bitstream_get_num_bits_for_byte_align(struct vl_bitstream_encoder *enc)
55*61046927SAndroid Build Coastguard Worker {
56*61046927SAndroid Build Coastguard Worker    return enc->bits_to_go & 7;
57*61046927SAndroid Build Coastguard Worker }
58*61046927SAndroid Build Coastguard Worker 
59*61046927SAndroid Build Coastguard Worker static inline int
vl_bitstream_get_byte_count(struct vl_bitstream_encoder * enc)60*61046927SAndroid Build Coastguard Worker vl_bitstream_get_byte_count(struct vl_bitstream_encoder *enc)
61*61046927SAndroid Build Coastguard Worker {
62*61046927SAndroid Build Coastguard Worker    return enc->offset + ((32 - enc->bits_to_go) >> 3);
63*61046927SAndroid Build Coastguard Worker }
64*61046927SAndroid Build Coastguard Worker 
65*61046927SAndroid Build Coastguard Worker static inline bool
vl_bitstream_is_byte_aligned(struct vl_bitstream_encoder * enc)66*61046927SAndroid Build Coastguard Worker vl_bitstream_is_byte_aligned(struct vl_bitstream_encoder *enc)
67*61046927SAndroid Build Coastguard Worker {
68*61046927SAndroid Build Coastguard Worker    if (enc->overflow)
69*61046927SAndroid Build Coastguard Worker       enc->bits_to_go = 32;
70*61046927SAndroid Build Coastguard Worker    return !(enc->bits_to_go & 7);
71*61046927SAndroid Build Coastguard Worker }
72*61046927SAndroid Build Coastguard Worker 
73*61046927SAndroid Build Coastguard Worker static inline void
vl_bitstream_write_byte_start_code(struct vl_bitstream_encoder * enc,uint8_t val)74*61046927SAndroid Build Coastguard Worker vl_bitstream_write_byte_start_code(struct vl_bitstream_encoder *enc, uint8_t val)
75*61046927SAndroid Build Coastguard Worker {
76*61046927SAndroid Build Coastguard Worker    int offset = enc->offset;
77*61046927SAndroid Build Coastguard Worker    uint8_t *buffer = enc->bits + enc->offset;
78*61046927SAndroid Build Coastguard Worker    if (enc->prevent_start_code && enc->offset > 1) {
79*61046927SAndroid Build Coastguard Worker       if (((val & 0xfc) | buffer[-2] | buffer[-1]) == 0) {
80*61046927SAndroid Build Coastguard Worker          *buffer++ = 3;
81*61046927SAndroid Build Coastguard Worker          offset++;
82*61046927SAndroid Build Coastguard Worker       }
83*61046927SAndroid Build Coastguard Worker    }
84*61046927SAndroid Build Coastguard Worker 
85*61046927SAndroid Build Coastguard Worker    *buffer = val;
86*61046927SAndroid Build Coastguard Worker    offset++;
87*61046927SAndroid Build Coastguard Worker    enc->offset = offset;
88*61046927SAndroid Build Coastguard Worker }
89*61046927SAndroid Build Coastguard Worker 
90*61046927SAndroid Build Coastguard Worker static inline bool
vl_bitstream_verify_buffer(struct vl_bitstream_encoder * enc,uint32_t bytes_to_write)91*61046927SAndroid Build Coastguard Worker vl_bitstream_verify_buffer(struct vl_bitstream_encoder *enc, uint32_t bytes_to_write)
92*61046927SAndroid Build Coastguard Worker {
93*61046927SAndroid Build Coastguard Worker    if (enc->overflow)
94*61046927SAndroid Build Coastguard Worker       return false;
95*61046927SAndroid Build Coastguard Worker 
96*61046927SAndroid Build Coastguard Worker    if (enc->offset + bytes_to_write > enc->bits_buffer_size) {
97*61046927SAndroid Build Coastguard Worker       enc->overflow = true;
98*61046927SAndroid Build Coastguard Worker       return false;
99*61046927SAndroid Build Coastguard Worker    }
100*61046927SAndroid Build Coastguard Worker    return true;
101*61046927SAndroid Build Coastguard Worker }
102*61046927SAndroid Build Coastguard Worker 
103*61046927SAndroid Build Coastguard Worker static inline void
vl_bitstream_flush(struct vl_bitstream_encoder * enc)104*61046927SAndroid Build Coastguard Worker vl_bitstream_flush(struct vl_bitstream_encoder *enc)
105*61046927SAndroid Build Coastguard Worker {
106*61046927SAndroid Build Coastguard Worker    ASSERTED bool is_aligned = vl_bitstream_is_byte_aligned(enc);
107*61046927SAndroid Build Coastguard Worker    assert (is_aligned);
108*61046927SAndroid Build Coastguard Worker 
109*61046927SAndroid Build Coastguard Worker    uint32_t temp = (uint32_t)(32 - enc->bits_to_go);
110*61046927SAndroid Build Coastguard Worker 
111*61046927SAndroid Build Coastguard Worker    if (!vl_bitstream_verify_buffer(enc, temp >> 3)) {
112*61046927SAndroid Build Coastguard Worker       return;
113*61046927SAndroid Build Coastguard Worker    }
114*61046927SAndroid Build Coastguard Worker 
115*61046927SAndroid Build Coastguard Worker    while (temp > 0) {
116*61046927SAndroid Build Coastguard Worker       vl_bitstream_write_byte_start_code(enc, (uint8_t)(enc->enc_buffer >> 24));
117*61046927SAndroid Build Coastguard Worker       enc->enc_buffer <<= 8;
118*61046927SAndroid Build Coastguard Worker       temp -= 8;
119*61046927SAndroid Build Coastguard Worker    }
120*61046927SAndroid Build Coastguard Worker 
121*61046927SAndroid Build Coastguard Worker    enc->bits_to_go = 32;
122*61046927SAndroid Build Coastguard Worker    enc->enc_buffer = 0;
123*61046927SAndroid Build Coastguard Worker }
124*61046927SAndroid Build Coastguard Worker 
125*61046927SAndroid Build Coastguard Worker static inline void
vl_bitstream_put_bits(struct vl_bitstream_encoder * enc,int bits_count,uint32_t bits_val)126*61046927SAndroid Build Coastguard Worker vl_bitstream_put_bits(struct vl_bitstream_encoder *enc, int bits_count, uint32_t bits_val)
127*61046927SAndroid Build Coastguard Worker {
128*61046927SAndroid Build Coastguard Worker    if (bits_count < enc->bits_to_go) {
129*61046927SAndroid Build Coastguard Worker       enc->enc_buffer |= (bits_val << (enc->bits_to_go - bits_count));
130*61046927SAndroid Build Coastguard Worker       enc->bits_to_go -= bits_count;
131*61046927SAndroid Build Coastguard Worker    } else if (vl_bitstream_verify_buffer(enc, 4)) {
132*61046927SAndroid Build Coastguard Worker       int left_over_bits = bits_count - enc->bits_to_go;
133*61046927SAndroid Build Coastguard Worker       enc->enc_buffer |= (bits_val >> left_over_bits);
134*61046927SAndroid Build Coastguard Worker 
135*61046927SAndroid Build Coastguard Worker       {
136*61046927SAndroid Build Coastguard Worker          uint8_t *temp = (uint8_t *)&enc->enc_buffer;
137*61046927SAndroid Build Coastguard Worker          vl_bitstream_write_byte_start_code(enc, *(temp + 3));
138*61046927SAndroid Build Coastguard Worker          vl_bitstream_write_byte_start_code(enc, *(temp + 2));
139*61046927SAndroid Build Coastguard Worker          vl_bitstream_write_byte_start_code(enc, *(temp + 1));
140*61046927SAndroid Build Coastguard Worker          vl_bitstream_write_byte_start_code(enc, *temp);
141*61046927SAndroid Build Coastguard Worker       }
142*61046927SAndroid Build Coastguard Worker 
143*61046927SAndroid Build Coastguard Worker       enc->enc_buffer = 0;
144*61046927SAndroid Build Coastguard Worker       enc->bits_to_go = 32 - left_over_bits;
145*61046927SAndroid Build Coastguard Worker 
146*61046927SAndroid Build Coastguard Worker       if (left_over_bits > 0)
147*61046927SAndroid Build Coastguard Worker          enc->enc_buffer = (bits_val << (32 - left_over_bits));
148*61046927SAndroid Build Coastguard Worker    }
149*61046927SAndroid Build Coastguard Worker }
150*61046927SAndroid Build Coastguard Worker 
151*61046927SAndroid Build Coastguard Worker static inline int
vl_bitstream_get_exp_golomb0_code_len(uint32_t val)152*61046927SAndroid Build Coastguard Worker vl_bitstream_get_exp_golomb0_code_len(uint32_t val)
153*61046927SAndroid Build Coastguard Worker {
154*61046927SAndroid Build Coastguard Worker    int len = 0;
155*61046927SAndroid Build Coastguard Worker    val++;
156*61046927SAndroid Build Coastguard Worker 
157*61046927SAndroid Build Coastguard Worker    if (val >= 0x10000) {
158*61046927SAndroid Build Coastguard Worker       val >>= 16;
159*61046927SAndroid Build Coastguard Worker       len += 16;
160*61046927SAndroid Build Coastguard Worker    }
161*61046927SAndroid Build Coastguard Worker    if (val >= 0x100) {
162*61046927SAndroid Build Coastguard Worker       val >>= 8;
163*61046927SAndroid Build Coastguard Worker       len += 8;
164*61046927SAndroid Build Coastguard Worker    }
165*61046927SAndroid Build Coastguard Worker    assert(val < 256);
166*61046927SAndroid Build Coastguard Worker 
167*61046927SAndroid Build Coastguard Worker    return len + util_logbase2(val);
168*61046927SAndroid Build Coastguard Worker }
169*61046927SAndroid Build Coastguard Worker 
170*61046927SAndroid Build Coastguard Worker static inline void
vl_bitstream_exp_golomb_ue(struct vl_bitstream_encoder * enc,uint32_t val)171*61046927SAndroid Build Coastguard Worker vl_bitstream_exp_golomb_ue(struct vl_bitstream_encoder *enc, uint32_t val)
172*61046927SAndroid Build Coastguard Worker {
173*61046927SAndroid Build Coastguard Worker    if (val != UINT32_MAX) {
174*61046927SAndroid Build Coastguard Worker       int len = vl_bitstream_get_exp_golomb0_code_len(val);
175*61046927SAndroid Build Coastguard Worker       vl_bitstream_put_bits(enc, (len << 1) + 1, val + 1);
176*61046927SAndroid Build Coastguard Worker    } else {
177*61046927SAndroid Build Coastguard Worker       vl_bitstream_put_bits(enc, 32, 0);
178*61046927SAndroid Build Coastguard Worker       vl_bitstream_put_bits(enc, 1, 1);
179*61046927SAndroid Build Coastguard Worker       vl_bitstream_put_bits(enc, 32, 1);
180*61046927SAndroid Build Coastguard Worker    }
181*61046927SAndroid Build Coastguard Worker }
182*61046927SAndroid Build Coastguard Worker 
183*61046927SAndroid Build Coastguard Worker static inline void
vl_bitstream_exp_golomb_se(struct vl_bitstream_encoder * enc,int32_t val)184*61046927SAndroid Build Coastguard Worker vl_bitstream_exp_golomb_se(struct vl_bitstream_encoder *enc, int32_t val)
185*61046927SAndroid Build Coastguard Worker {
186*61046927SAndroid Build Coastguard Worker    if (val > 0)
187*61046927SAndroid Build Coastguard Worker       vl_bitstream_exp_golomb_ue(enc, (val << 1) - 1);
188*61046927SAndroid Build Coastguard Worker    else
189*61046927SAndroid Build Coastguard Worker       vl_bitstream_exp_golomb_ue(enc, ((-val) << 1) - (val == INT_MIN));
190*61046927SAndroid Build Coastguard Worker }
191*61046927SAndroid Build Coastguard Worker 
192*61046927SAndroid Build Coastguard Worker static inline void
vl_bitstream_rbsp_trailing(struct vl_bitstream_encoder * enc)193*61046927SAndroid Build Coastguard Worker vl_bitstream_rbsp_trailing(struct vl_bitstream_encoder *enc)
194*61046927SAndroid Build Coastguard Worker {
195*61046927SAndroid Build Coastguard Worker    vl_bitstream_put_bits(enc, 1, 1);
196*61046927SAndroid Build Coastguard Worker    int left = vl_bitstream_get_num_bits_for_byte_align(enc);
197*61046927SAndroid Build Coastguard Worker 
198*61046927SAndroid Build Coastguard Worker    if (left)
199*61046927SAndroid Build Coastguard Worker       vl_bitstream_put_bits(enc, left, 0);
200*61046927SAndroid Build Coastguard Worker 
201*61046927SAndroid Build Coastguard Worker    ASSERTED bool is_aligned = vl_bitstream_is_byte_aligned(enc);
202*61046927SAndroid Build Coastguard Worker    assert(is_aligned);
203*61046927SAndroid Build Coastguard Worker }
204*61046927SAndroid Build Coastguard Worker #endif
205