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>
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
 
115329f1
 
0da71265
  /**
  * read unsigned exp golomb code.
  */
 static inline int get_ue_golomb(GetBitContext *gb){
     unsigned int buf;
     int log;
115329f1
 
0da71265
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
     buf=GET_CACHE(re, gb);
115329f1
 
0da71265
     if(buf >= (1<<27)){
         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];
     }else{
         log= 2*av_log2(buf) - 31;
         buf>>= log;
         buf--;
         LAST_SKIP_BITS(re, gb, 32 - log);
         CLOSE_READER(re, gb);
115329f1
 
0da71265
         return buf;
     }
 }
 
1c3d46a9
 /**
  * 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;
 }
 
0e921e97
  /**
9392863d
  * read unsigned exp golomb code, constraint to a max of 31.
  * the return value is undefined if the stored value exceeds 31.
0e921e97
  */
 static inline int get_ue_golomb_31(GetBitContext *gb){
     unsigned int buf;
 
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
     buf=GET_CACHE(re, gb);
 
     buf >>= 32 - 9;
     LAST_SKIP_BITS(re, gb, ff_golomb_vlc_len[buf]);
     CLOSE_READER(re, gb);
 
     return ff_ue_golomb_vlc_code[buf];
 }
 
8b82a956
 static inline int svq3_get_ue_golomb(GetBitContext *gb){
4704097a
     uint32_t buf;
8b82a956
 
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
4704097a
     buf=GET_CACHE(re, gb);
115329f1
 
4704097a
     if(buf&0xAA800000){
         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];
     }else{
9df4ce5e
         int ret = 1;
 
         while (1) {
             buf >>= 32 - 8;
             LAST_SKIP_BITS(re, gb, FFMIN(ff_interleaved_golomb_vlc_len[buf], 8));
 
             if (ff_interleaved_golomb_vlc_len[buf] != 9){
                 ret <<= (ff_interleaved_golomb_vlc_len[buf] - 1) >> 1;
                 ret |= ff_interleaved_dirac_golomb_vlc_code[buf];
                 break;
             }
             ret = (ret << 4) | ff_interleaved_dirac_golomb_vlc_code[buf];
             UPDATE_CACHE(re, gb);
             buf = GET_CACHE(re, gb);
4704097a
         }
8b82a956
 
4704097a
         CLOSE_READER(re, gb);
9df4ce5e
         return ret - 1;
4704097a
     }
8b82a956
 }
 
0da71265
 /**
  * read unsigned truncated exp golomb code.
  */
 static inline int get_te0_golomb(GetBitContext *gb, int range){
     assert(range >= 1);
115329f1
 
0da71265
     if(range==1)      return 0;
1924f3ce
     else if(range==2) return get_bits1(gb)^1;
0da71265
     else              return get_ue_golomb(gb);
 }
 
 /**
  * read unsigned truncated exp golomb code.
  */
 static inline int get_te_golomb(GetBitContext *gb, int range){
     assert(range >= 1);
115329f1
 
1924f3ce
     if(range==2) return get_bits1(gb)^1;
0da71265
     else         return get_ue_golomb(gb);
 }
 
 
 /**
  * read signed exp golomb code.
  */
 static inline int get_se_golomb(GetBitContext *gb){
     unsigned int buf;
     int log;
115329f1
 
0da71265
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
     buf=GET_CACHE(re, gb);
115329f1
 
0da71265
     if(buf >= (1<<27)){
         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];
     }else{
         log= 2*av_log2(buf) - 31;
         buf>>= log;
115329f1
 
0da71265
         LAST_SKIP_BITS(re, gb, 32 - log);
         CLOSE_READER(re, gb);
115329f1
 
0da71265
         if(buf&1) buf= -(buf>>1);
         else      buf=  (buf>>1);
 
         return buf;
     }
 }
 
8b82a956
 static inline int svq3_get_se_golomb(GetBitContext *gb){
     unsigned int buf;
     int log;
 
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
4704097a
     buf=GET_CACHE(re, gb);
8b82a956
 
4704097a
     if(buf&0xAA800000){
         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];
     }else{
895345da
         LAST_SKIP_BITS(re, gb, 8);
         UPDATE_CACHE(re, gb);
         buf |= 1 | (GET_CACHE(re, gb) >> 8);
 
4704097a
         if((buf & 0xAAAAAAAA) == 0)
             return INVALID_VLC;
8b82a956
 
4704097a
         for(log=31; (buf & 0x80000000) == 0; log--){
             buf = (buf << 2) - ((buf << log) >> (log - 1)) + (buf >> 30);
         }
8b82a956
 
895345da
         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
 }
 
9df4ce5e
 static inline int dirac_get_se_golomb(GetBitContext *gb){
     uint32_t buf;
     uint32_t ret;
 
     ret = svq3_get_ue_golomb(gb);
 
     if (ret) {
         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
  */
 static inline int get_ur_golomb(GetBitContext *gb, int k, int limit, int esc_len){
     unsigned int buf;
     int log;
115329f1
 
11e659c2
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
     buf=GET_CACHE(re, gb);
 
     log= av_log2(buf);
d9e6a6c6
 
11e659c2
     if(log > 31-limit){
         buf >>= log - k;
         buf += (30-log)<<k;
         LAST_SKIP_BITS(re, gb, 32 + k - log);
         CLOSE_READER(re, gb);
115329f1
 
11e659c2
         return buf;
d9e6a6c6
     }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).
  */
 static inline int get_ur_golomb_jpegls(GetBitContext *gb, int k, int limit, int esc_len){
     unsigned int buf;
     int log;
115329f1
 
d9e6a6c6
     OPEN_READER(re, gb);
     UPDATE_CACHE(re, gb);
     buf=GET_CACHE(re, gb);
 
     log= av_log2(buf);
115329f1
 
d4f2a625
     if(log - k >= 32-MIN_CACHE_BITS+(MIN_CACHE_BITS==32) && 32-log < limit){
d9e6a6c6
         buf >>= log - k;
         buf += (30-log)<<k;
         LAST_SKIP_BITS(re, gb, 32 + k - log);
         CLOSE_READER(re, gb);
115329f1
 
d9e6a6c6
         return buf;
     }else{
         int i;
         for(i=0; SHOW_UBITS(re, gb, 1) == 0; i++){
             LAST_SKIP_BITS(re, gb, 1);
             UPDATE_CACHE(re, gb);
         }
         SKIP_BITS(re, gb, 1);
 
         if(i < limit - 1){
             if(k){
                 buf = SHOW_UBITS(re, gb, k);
                 LAST_SKIP_BITS(re, gb, k);
             }else{
                 buf=0;
             }
 
             CLOSE_READER(re, gb);
             return buf + (i<<k);
         }else if(i == limit - 1){
             buf = SHOW_UBITS(re, gb, esc_len);
             LAST_SKIP_BITS(re, gb, esc_len);
             CLOSE_READER(re, gb);
115329f1
 
d9e6a6c6
             return buf + 1;
         }else
             return -1;
     }
11e659c2
 }
 
ac2570a8
 /**
4579adb0
  * read signed golomb rice code (ffv1).
  */
a6c01275
 static inline int get_sr_golomb(GetBitContext *gb, int k, int limit, int esc_len){
4579adb0
     int v= get_ur_golomb(gb, k, limit, esc_len);
115329f1
 
4579adb0
     v++;
     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
  */
 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);
 }
 
85ad5695
 /**
  * read unsigned golomb rice code (shorten).
  */
 static inline unsigned int get_ur_golomb_shorten(GetBitContext *gb, int k){
bb270c08
         return get_ur_golomb_jpegls(gb, k, INT_MAX, 0);
85ad5695
 }
 
 /**
  * read signed golomb rice code (shorten).
  */
 static inline int get_sr_golomb_shorten(GetBitContext* gb, int k)
 {
     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
 
61f040dd
 static inline int get_ue(GetBitContext *s, char *file, const char *func, int line){
0da71265
     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
 
4579adb0
     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;
 }
 
61f040dd
 static inline int get_se(GetBitContext *s, char *file, const char *func, int line){
0da71265
     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
 
4579adb0
     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;
 }
 
61f040dd
 static inline int get_te(GetBitContext *s, int r, char *file, const char *func, int line){
0da71265
     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
 
4579adb0
     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__)
 #define get_te_golomb(a, r) get_te(a, r, __FILE__, __PRETTY_FUNCTION__, __LINE__)
 #define get_te0_golomb(a, r) get_te(a, r, __FILE__, __PRETTY_FUNCTION__, __LINE__)
 
 #endif
 
 /**
  * write unsigned exp golomb code.
  */
 static inline void set_ue_golomb(PutBitContext *pb, int i){
     int e;
115329f1
 
0da71265
     assert(i>=0);
 
 #if 0
     if(i=0){
         put_bits(pb, 1, 1);
         return;
     }
 #endif
     if(i<256)
         put_bits(pb, ff_ue_golomb_len[i], i+1);
     else{
         e= av_log2(i+1);
115329f1
 
0da71265
         put_bits(pb, 2*e+1, i+1);
     }
 }
 
 /**
  * write truncated unsigned exp golomb code.
  */
 static inline void set_te_golomb(PutBitContext *pb, int i, int range){
     assert(range >= 1);
     assert(i<=range);
 
1924f3ce
     if(range==2) put_bits(pb, 1, i^1);
0da71265
     else         set_ue_golomb(pb, i);
 }
 
 /**
e134e10f
  * write signed exp golomb code. 16 bits at most.
0da71265
  */
 static inline void set_se_golomb(PutBitContext *pb, int i){
e134e10f
 //    if (i>32767 || i<-32767)
bb270c08
 //        av_log(NULL,AV_LOG_ERROR,"value out of range %d\n", i);
115329f1
 #if 0
0da71265
     if(i<=0) i= -2*i;
     else     i=  2*i-1;
 #elif 1
     i= 2*i-1;
     if(i<0) i^= -1; //FIXME check if gcc does the right thing
 #else
     i= 2*i-1;
     i^= (i>>31);
 #endif
     set_ue_golomb(pb, i);
 }
11e659c2
 
 /**
d9e6a6c6
  * write unsigned golomb rice code (ffv1).
11e659c2
  */
 static inline void set_ur_golomb(PutBitContext *pb, int i, int k, int limit, int esc_len){
     int e;
115329f1
 
11e659c2
     assert(i>=0);
115329f1
 
11e659c2
     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).
  */
 static inline void set_ur_golomb_jpegls(PutBitContext *pb, int i, int k, int limit, int esc_len){
     int e;
115329f1
 
d9e6a6c6
     assert(i>=0);
115329f1
 
d9e6a6c6
     e= (i>>k) + 1;
     if(e<limit){
9e96ab03
         while(e > 31) {
             put_bits(pb, 31, 0);
             e -= 31;
         }
d9e6a6c6
         put_bits(pb, e, 1);
ce329952
         if(k)
6647ab80
             put_sbits(pb, k, i);
d9e6a6c6
     }else{
76aca7a8
         while(limit > 31) {
             put_bits(pb, 31, 0);
             limit -= 31;
         }
d9e6a6c6
         put_bits(pb, limit  , 1);
         put_bits(pb, esc_len, i - 1);
11e659c2
     }
 }
4579adb0
 
 /**
  * write signed golomb rice code (ffv1).
  */
a6c01275
 static inline void set_sr_golomb(PutBitContext *pb, int i, int k, int limit, int esc_len){
4579adb0
     int v;
 
     v = -2*i-1;
     v ^= (v>>31);
 
     set_ur_golomb(pb, v, k, limit, esc_len);
 }
 
 /**
  * write signed golomb rice code (flac).
  */
 static inline void set_sr_golomb_flac(PutBitContext *pb, int i, int k, int limit, int esc_len){
     int v;
 
     v = -2*i-1;
     v ^= (v>>31);
 
     set_ur_golomb_jpegls(pb, v, k, limit, esc_len);
 }
699b3f99
 
98790382
 #endif /* AVCODEC_GOLOMB_H */