libavcodec/golomb.h
0da71265
 /*
  * exp golomb vlc stuff
  * Copyright (c) 2003 Michael Niedermayer <michaelni@gmx.at>
4579adb0
  * Copyright (c) 2004 Alex Beregszaszi
0da71265
  *
b78e7197
  * This file is part of FFmpeg.
  *
  * FFmpeg is free software; you can redistribute it and/or
0da71265
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
b78e7197
  * version 2.1 of the License, or (at your option) any later version.
0da71265
  *
b78e7197
  * FFmpeg is distributed in the hope that it will be useful,
0da71265
  * 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
b78e7197
  * License along with FFmpeg; if not, write to the Free Software
5509bffa
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
0da71265
  */
115329f1
 
0da71265
 /**
ba87f080
  * @file
115329f1
  * @brief
0da71265
  *     exp golomb vlc stuff
4579adb0
  * @author Michael Niedermayer <michaelni@gmx.at> and Alex Beregszaszi
0da71265
  */
 
98790382
 #ifndef AVCODEC_GOLOMB_H
 #define AVCODEC_GOLOMB_H
699b3f99
 
99545457
 #include <stdint.h>
2c993e8b
 
9106a698
 #include "get_bits.h"
b2755007
 #include "put_bits.h"
99545457
 
8b82a956
 #define INVALID_VLC           0x80000000
 
0da71265
 extern const uint8_t ff_golomb_vlc_len[512];
 extern const uint8_t ff_ue_golomb_vlc_code[512];
 extern const  int8_t ff_se_golomb_vlc_code[512];
 extern const uint8_t ff_ue_golomb_len[256];
 
4704097a
 extern const uint8_t ff_interleaved_golomb_vlc_len[256];
 extern const uint8_t ff_interleaved_ue_golomb_vlc_code[256];
 extern const  int8_t ff_interleaved_se_golomb_vlc_code[256];
9df4ce5e
 extern const uint8_t ff_interleaved_dirac_golomb_vlc_code[256];
4704097a
 
2c993e8b
 /**
0da71265
  * read unsigned exp golomb code.
  */
2c993e8b
 static inline int get_ue_golomb(GetBitContext *gb)
 {
0da71265
     unsigned int buf;
115329f1
 
0da71265
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
2c993e8b
     buf = GET_CACHE(re, gb);
115329f1
 
2c993e8b
     if (buf >= (1 << 27)) {
0da71265
         buf >>= 32 - 9;
         LAST_SKIP_BITS(re, gb, ff_golomb_vlc_len[buf]);
         CLOSE_READER(re, gb);
115329f1
 
0da71265
         return ff_ue_golomb_vlc_code[buf];
2c993e8b
     } else {
fb13fe83
         int log = 2 * av_log2(buf) - 31;
0da71265
         LAST_SKIP_BITS(re, gb, 32 - log);
         CLOSE_READER(re, gb);
fd165ace
         if (CONFIG_FTRAPV && log < 0) {
             av_log(0, AV_LOG_ERROR, "Invalid UE golomb code\n");
             return AVERROR_INVALIDDATA;
         }
02a31f6a
         buf >>= log;
fd165ace
         buf--;
115329f1
 
0da71265
         return buf;
     }
 }
 
fdba370f
 /**
  * Read an unsigned Exp-Golomb code in the range 0 to UINT32_MAX-1.
  */
 static inline unsigned get_ue_golomb_long(GetBitContext *gb)
 {
     unsigned buf, log;
 
     buf = show_bits_long(gb, 32);
     log = 31 - av_log2(buf);
     skip_bits_long(gb, log);
 
     return get_bits_long(gb, log + 1) - 1;
 }
 
2c993e8b
 /**
9392863d
  * read unsigned exp golomb code, constraint to a max of 31.
  * the return value is undefined if the stored value exceeds 31.
0e921e97
  */
2c993e8b
 static inline int get_ue_golomb_31(GetBitContext *gb)
 {
0e921e97
     unsigned int buf;
 
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
2c993e8b
     buf = GET_CACHE(re, gb);
0e921e97
 
     buf >>= 32 - 9;
     LAST_SKIP_BITS(re, gb, ff_golomb_vlc_len[buf]);
     CLOSE_READER(re, gb);
 
     return ff_ue_golomb_vlc_code[buf];
 }
 
9a2e7911
 static inline unsigned svq3_get_ue_golomb(GetBitContext *gb)
 {
4704097a
     uint32_t buf;
8b82a956
 
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
2c993e8b
     buf = GET_CACHE(re, gb);
115329f1
 
2c993e8b
     if (buf & 0xAA800000) {
4704097a
         buf >>= 32 - 8;
         LAST_SKIP_BITS(re, gb, ff_interleaved_golomb_vlc_len[buf]);
         CLOSE_READER(re, gb);
115329f1
 
4704097a
         return ff_interleaved_ue_golomb_vlc_code[buf];
2c993e8b
     } else {
9a2e7911
         unsigned ret = 1;
9df4ce5e
 
964506bb
         do {
9df4ce5e
             buf >>= 32 - 8;
2c993e8b
             LAST_SKIP_BITS(re, gb,
                            FFMIN(ff_interleaved_golomb_vlc_len[buf], 8));
9df4ce5e
 
2c993e8b
             if (ff_interleaved_golomb_vlc_len[buf] != 9) {
9df4ce5e
                 ret <<= (ff_interleaved_golomb_vlc_len[buf] - 1) >> 1;
2c993e8b
                 ret  |= ff_interleaved_dirac_golomb_vlc_code[buf];
9df4ce5e
                 break;
             }
             ret = (ret << 4) | ff_interleaved_dirac_golomb_vlc_code[buf];
             UPDATE_CACHE(re, gb);
             buf = GET_CACHE(re, gb);
b008ac18
         } while (ret<0x8000000U && HAVE_BITS_REMAINING(re, gb));
8b82a956
 
4704097a
         CLOSE_READER(re, gb);
9df4ce5e
         return ret - 1;
4704097a
     }
8b82a956
 }
 
0da71265
 /**
  * read unsigned truncated exp golomb code.
  */
2c993e8b
 static inline int get_te0_golomb(GetBitContext *gb, int range)
 {
28e4f906
     av_assert2(range >= 1);
115329f1
 
2c993e8b
     if (range == 1)
         return 0;
     else if (range == 2)
         return get_bits1(gb) ^ 1;
     else
         return get_ue_golomb(gb);
0da71265
 }
 
 /**
  * read unsigned truncated exp golomb code.
  */
2c993e8b
 static inline int get_te_golomb(GetBitContext *gb, int range)
 {
28e4f906
     av_assert2(range >= 1);
115329f1
 
2c993e8b
     if (range == 2)
         return get_bits1(gb) ^ 1;
     else
         return get_ue_golomb(gb);
0da71265
 }
 
 /**
  * read signed exp golomb code.
  */
2c993e8b
 static inline int get_se_golomb(GetBitContext *gb)
 {
0da71265
     unsigned int buf;
115329f1
 
0da71265
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
2c993e8b
     buf = GET_CACHE(re, gb);
115329f1
 
2c993e8b
     if (buf >= (1 << 27)) {
0da71265
         buf >>= 32 - 9;
         LAST_SKIP_BITS(re, gb, ff_golomb_vlc_len[buf]);
         CLOSE_READER(re, gb);
115329f1
 
0da71265
         return ff_se_golomb_vlc_code[buf];
2c993e8b
     } else {
caac12bd
         int log = av_log2(buf);
a92816c4
         LAST_SKIP_BITS(re, gb, 31 - log);
         UPDATE_CACHE(re, gb);
         buf = GET_CACHE(re, gb);
 
2c993e8b
         buf >>= log;
115329f1
 
0da71265
         LAST_SKIP_BITS(re, gb, 32 - log);
         CLOSE_READER(re, gb);
115329f1
 
2c993e8b
         if (buf & 1)
             buf = -(buf >> 1);
         else
             buf = (buf >> 1);
0da71265
 
         return buf;
     }
 }
 
6d7ab097
 static inline int get_se_golomb_long(GetBitContext *gb)
 {
     unsigned int buf = get_ue_golomb_long(gb);
 
     if (buf & 1)
e0aa76d3
         buf = (buf + 1) >> 1;
6d7ab097
     else
e0aa76d3
         buf = -(buf >> 1);
6d7ab097
 
     return buf;
 }
 
2c993e8b
 static inline int svq3_get_se_golomb(GetBitContext *gb)
 {
8b82a956
     unsigned int buf;
 
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
2c993e8b
     buf = GET_CACHE(re, gb);
8b82a956
 
2c993e8b
     if (buf & 0xAA800000) {
4704097a
         buf >>= 32 - 8;
         LAST_SKIP_BITS(re, gb, ff_interleaved_golomb_vlc_len[buf]);
         CLOSE_READER(re, gb);
115329f1
 
4704097a
         return ff_interleaved_se_golomb_vlc_code[buf];
2c993e8b
     } else {
fb13fe83
         int log;
895345da
         LAST_SKIP_BITS(re, gb, 8);
         UPDATE_CACHE(re, gb);
         buf |= 1 | (GET_CACHE(re, gb) >> 8);
 
2c993e8b
         if ((buf & 0xAAAAAAAA) == 0)
4704097a
             return INVALID_VLC;
8b82a956
 
2c993e8b
         for (log = 31; (buf & 0x80000000) == 0; log--)
4704097a
             buf = (buf << 2) - ((buf << log) >> (log - 1)) + (buf >> 30);
8b82a956
 
2c993e8b
         LAST_SKIP_BITS(re, gb, 63 - 2 * log - 8);
4704097a
         CLOSE_READER(re, gb);
8b82a956
 
4704097a
         return (signed) (((((buf << log) >> log) - 1) ^ -(buf & 0x1)) + 1) >> 1;
     }
8b82a956
 }
 
2c993e8b
 static inline int dirac_get_se_golomb(GetBitContext *gb)
 {
fb13fe83
     uint32_t ret = svq3_get_ue_golomb(gb);
9df4ce5e
 
     if (ret) {
fb13fe83
         uint32_t buf;
9df4ce5e
         OPEN_READER(re, gb);
         UPDATE_CACHE(re, gb);
         buf = SHOW_SBITS(re, gb, 1);
         LAST_SKIP_BITS(re, gb, 1);
         ret = (ret ^ buf) - buf;
         CLOSE_READER(re, gb);
     }
 
     return ret;
 }
 
11e659c2
 /**
d9e6a6c6
  * read unsigned golomb rice code (ffv1).
11e659c2
  */
2c993e8b
 static inline int get_ur_golomb(GetBitContext *gb, int k, int limit,
                                 int esc_len)
 {
11e659c2
     unsigned int buf;
     int log;
115329f1
 
11e659c2
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
2c993e8b
     buf = GET_CACHE(re, gb);
11e659c2
 
2c993e8b
     log = av_log2(buf);
d9e6a6c6
 
2c993e8b
     if (log > 31 - limit) {
11e659c2
         buf >>= log - k;
2c993e8b
         buf  += (30 - log) << k;
11e659c2
         LAST_SKIP_BITS(re, gb, 32 + k - log);
         CLOSE_READER(re, gb);
115329f1
 
11e659c2
         return buf;
2c993e8b
     } else {
6fa6c481
         LAST_SKIP_BITS(re, gb, limit);
         UPDATE_CACHE(re, gb);
 
         buf = SHOW_UBITS(re, gb, esc_len);
 
         LAST_SKIP_BITS(re, gb, esc_len);
11e659c2
         CLOSE_READER(re, gb);
115329f1
 
d9e6a6c6
         return buf + limit - 1;
     }
 }
 
 /**
  * read unsigned golomb rice code (jpegls).
  */
2c993e8b
 static inline int get_ur_golomb_jpegls(GetBitContext *gb, int k, int limit,
                                        int esc_len)
 {
d9e6a6c6
     unsigned int buf;
     int log;
115329f1
 
d9e6a6c6
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
2c993e8b
     buf = GET_CACHE(re, gb);
d9e6a6c6
 
2c993e8b
     log = av_log2(buf);
115329f1
 
2c993e8b
     if (log - k >= 32 - MIN_CACHE_BITS + (MIN_CACHE_BITS == 32) &&
         32 - log < limit) {
d9e6a6c6
         buf >>= log - k;
2c993e8b
         buf  += (30 - log) << k;
d9e6a6c6
         LAST_SKIP_BITS(re, gb, 32 + k - log);
         CLOSE_READER(re, gb);
115329f1
 
d9e6a6c6
         return buf;
2c993e8b
     } else {
d9e6a6c6
         int i;
52e4018b
         for (i = 0; i < limit && SHOW_UBITS(re, gb, 1) == 0; i++) {
fc739b79
             if (gb->size_in_bits <= re_index)
083d9ba4
                 return -1;
d9e6a6c6
             LAST_SKIP_BITS(re, gb, 1);
             UPDATE_CACHE(re, gb);
         }
         SKIP_BITS(re, gb, 1);
 
2c993e8b
         if (i < limit - 1) {
             if (k) {
d9e6a6c6
                 buf = SHOW_UBITS(re, gb, k);
                 LAST_SKIP_BITS(re, gb, k);
2c993e8b
             } else {
                 buf = 0;
d9e6a6c6
             }
 
             CLOSE_READER(re, gb);
2c993e8b
             return buf + (i << k);
         } else if (i == limit - 1) {
d9e6a6c6
             buf = SHOW_UBITS(re, gb, esc_len);
             LAST_SKIP_BITS(re, gb, esc_len);
             CLOSE_READER(re, gb);
115329f1
 
d9e6a6c6
             return buf + 1;
2c993e8b
         } else
d9e6a6c6
             return -1;
     }
11e659c2
 }
 
ac2570a8
 /**
4579adb0
  * read signed golomb rice code (ffv1).
  */
2c993e8b
 static inline int get_sr_golomb(GetBitContext *gb, int k, int limit,
                                 int esc_len)
 {
     int v = get_ur_golomb(gb, k, limit, esc_len);
115329f1
 
4579adb0
     v++;
2c993e8b
     if (v & 1)
         return v >> 1;
     else
         return -(v >> 1);
115329f1
 
4579adb0
 //    return (v>>1) ^ -(v&1);
 }
 
a6c01275
 /**
4579adb0
  * read signed golomb rice code (flac).
ac2570a8
  */
2c993e8b
 static inline int get_sr_golomb_flac(GetBitContext *gb, int k, int limit,
                                      int esc_len)
 {
     int v = get_ur_golomb_jpegls(gb, k, limit, esc_len);
     return (v >> 1) ^ -(v & 1);
ac2570a8
 }
 
85ad5695
 /**
  * read unsigned golomb rice code (shorten).
  */
2c993e8b
 static inline unsigned int get_ur_golomb_shorten(GetBitContext *gb, int k)
 {
     return get_ur_golomb_jpegls(gb, k, INT_MAX, 0);
85ad5695
 }
 
 /**
  * read signed golomb rice code (shorten).
  */
2c993e8b
 static inline int get_sr_golomb_shorten(GetBitContext *gb, int k)
85ad5695
 {
     int uvar = get_ur_golomb_jpegls(gb, k + 1, INT_MAX, 0);
     if (uvar & 1)
         return ~(uvar >> 1);
     else
         return uvar >> 1;
 }
 
0da71265
 #ifdef TRACE
 
80412997
 static inline int get_ue(GetBitContext *s, const char *file, const char *func,
                          int line)
 {
2c993e8b
     int show = show_bits(s, 24);
     int pos  = get_bits_count(s);
     int i    = get_ue_golomb(s);
     int len  = get_bits_count(s) - pos;
     int bits = show >> (24 - len);
115329f1
 
0da71265
     print_bin(bits, len);
115329f1
 
2c993e8b
     av_log(NULL, AV_LOG_DEBUG, "%5d %2d %3d ue  @%5d in %s %s:%d\n",
            bits, len, i, pos, file, func, line);
115329f1
 
0da71265
     return i;
 }
 
80412997
 static inline int get_se(GetBitContext *s, const char *file, const char *func,
                          int line)
 {
2c993e8b
     int show = show_bits(s, 24);
     int pos  = get_bits_count(s);
     int i    = get_se_golomb(s);
     int len  = get_bits_count(s) - pos;
     int bits = show >> (24 - len);
115329f1
 
0da71265
     print_bin(bits, len);
115329f1
 
2c993e8b
     av_log(NULL, AV_LOG_DEBUG, "%5d %2d %3d se  @%5d in %s %s:%d\n",
            bits, len, i, pos, file, func, line);
115329f1
 
0da71265
     return i;
 }
 
2c993e8b
 static inline int get_te(GetBitContext *s, int r, char *file, const char *func,
                          int line)
 {
     int show = show_bits(s, 24);
     int pos  = get_bits_count(s);
     int i    = get_te0_golomb(s, r);
     int len  = get_bits_count(s) - pos;
     int bits = show >> (24 - len);
115329f1
 
0da71265
     print_bin(bits, len);
115329f1
 
2c993e8b
     av_log(NULL, AV_LOG_DEBUG, "%5d %2d %3d te  @%5d in %s %s:%d\n",
            bits, len, i, pos, file, func, line);
115329f1
 
0da71265
     return i;
 }
 
 #define get_ue_golomb(a) get_ue(a, __FILE__, __PRETTY_FUNCTION__, __LINE__)
 #define get_se_golomb(a) get_se(a, __FILE__, __PRETTY_FUNCTION__, __LINE__)
2c993e8b
 #define get_te_golomb(a, r)  get_te(a, r, __FILE__, __PRETTY_FUNCTION__, __LINE__)
0da71265
 #define get_te0_golomb(a, r) get_te(a, r, __FILE__, __PRETTY_FUNCTION__, __LINE__)
 
2c993e8b
 #endif /* TRACE */
0da71265
 
 /**
  * write unsigned exp golomb code.
  */
2c993e8b
 static inline void set_ue_golomb(PutBitContext *pb, int i)
 {
02a31f6a
     av_assert2(i >= 0);
0da71265
 
 #if 0
2c993e8b
     if (i = 0) {
0da71265
         put_bits(pb, 1, 1);
         return;
     }
 #endif
2c993e8b
     if (i < 256)
         put_bits(pb, ff_ue_golomb_len[i], i + 1);
     else {
fb13fe83
         int e = av_log2(i + 1);
2c993e8b
         put_bits(pb, 2 * e + 1, i + 1);
0da71265
     }
 }
 
 /**
  * write truncated unsigned exp golomb code.
  */
2c993e8b
 static inline void set_te_golomb(PutBitContext *pb, int i, int range)
 {
28e4f906
     av_assert2(range >= 1);
02a31f6a
     av_assert2(i <= range);
0da71265
 
2c993e8b
     if (range == 2)
         put_bits(pb, 1, i ^ 1);
     else
         set_ue_golomb(pb, i);
0da71265
 }
 
 /**
e134e10f
  * write signed exp golomb code. 16 bits at most.
0da71265
  */
2c993e8b
 static inline void set_se_golomb(PutBitContext *pb, int i)
 {
115329f1
 #if 0
2c993e8b
     if (i <= 0)
         i = -2 * i;
     else
         i = 2 * i - 1;
0da71265
 #elif 1
2c993e8b
     i = 2 * i - 1;
     if (i < 0)
         i ^= -1;    //FIXME check if gcc does the right thing
0da71265
 #else
2c993e8b
     i  = 2 * i - 1;
     i ^= (i >> 31);
0da71265
 #endif
     set_ue_golomb(pb, i);
 }
11e659c2
 
 /**
d9e6a6c6
  * write unsigned golomb rice code (ffv1).
11e659c2
  */
2c993e8b
 static inline void set_ur_golomb(PutBitContext *pb, int i, int k, int limit,
                                  int esc_len)
 {
11e659c2
     int e;
115329f1
 
02a31f6a
     av_assert2(i >= 0);
115329f1
 
2c993e8b
     e = i >> k;
     if (e < limit)
         put_bits(pb, e + k + 1, (1 << k) + (i & ((1 << k) - 1)));
     else
d9e6a6c6
         put_bits(pb, limit + esc_len, i - limit + 1);
 }
 
 /**
  * write unsigned golomb rice code (jpegls).
  */
2c993e8b
 static inline void set_ur_golomb_jpegls(PutBitContext *pb, int i, int k,
                                         int limit, int esc_len)
 {
d9e6a6c6
     int e;
115329f1
 
02a31f6a
     av_assert2(i >= 0);
115329f1
 
2c993e8b
     e = (i >> k) + 1;
     if (e < limit) {
         while (e > 31) {
9e96ab03
             put_bits(pb, 31, 0);
             e -= 31;
         }
d9e6a6c6
         put_bits(pb, e, 1);
2c993e8b
         if (k)
6647ab80
             put_sbits(pb, k, i);
2c993e8b
     } else {
         while (limit > 31) {
76aca7a8
             put_bits(pb, 31, 0);
             limit -= 31;
         }
2c993e8b
         put_bits(pb, limit, 1);
d9e6a6c6
         put_bits(pb, esc_len, i - 1);
11e659c2
     }
 }
4579adb0
 
 /**
  * write signed golomb rice code (ffv1).
  */
2c993e8b
 static inline void set_sr_golomb(PutBitContext *pb, int i, int k, int limit,
                                  int esc_len)
 {
4579adb0
     int v;
 
2c993e8b
     v  = -2 * i - 1;
     v ^= (v >> 31);
4579adb0
 
     set_ur_golomb(pb, v, k, limit, esc_len);
 }
 
 /**
  * write signed golomb rice code (flac).
  */
2c993e8b
 static inline void set_sr_golomb_flac(PutBitContext *pb, int i, int k,
                                       int limit, int esc_len)
 {
4579adb0
     int v;
 
2c993e8b
     v  = -2 * i - 1;
     v ^= (v >> 31);
4579adb0
 
     set_ur_golomb_jpegls(pb, v, k, limit, esc_len);
 }
699b3f99
 
98790382
 #endif /* AVCODEC_GOLOMB_H */