Home | History | Annotate | Download | only in common
      1 /*
      2  *  Copyright (c) 2010 The WebM project authors. All Rights Reserved.
      3  *
      4  *  Use of this source code is governed by a BSD-style license
      5  *  that can be found in the LICENSE file in the root of the source
      6  *  tree. An additional intellectual property rights grant can be found
      7  *  in the file PATENTS.  All contributing project authors may
      8  *  be found in the AUTHORS file in the root of the source tree.
      9  */
     10 
     11 #ifndef VP9_COMMON_VP9_TREECODER_H_
     12 #define VP9_COMMON_VP9_TREECODER_H_
     13 
     14 #include "./vpx_config.h"
     15 #include "vpx/vpx_integer.h"
     16 #include "vp9/common/vp9_common.h"
     17 
     18 typedef uint8_t vp9_prob;
     19 
     20 #define vp9_prob_half ((vp9_prob) 128)
     21 
     22 typedef int8_t vp9_tree_index;
     23 
     24 #define vp9_complement(x) (255 - x)
     25 
     26 /* We build coding trees compactly in arrays.
     27    Each node of the tree is a pair of vp9_tree_indices.
     28    Array index often references a corresponding probability table.
     29    Index <= 0 means done encoding/decoding and value = -Index,
     30    Index > 0 means need another bit, specification at index.
     31    Nonnegative indices are always even;  processing begins at node 0. */
     32 
     33 typedef const vp9_tree_index vp9_tree[], *vp9_tree_p;
     34 
     35 struct vp9_token {
     36   int value;
     37   int len;
     38 };
     39 
     40 /* Construct encoding array from tree. */
     41 
     42 void vp9_tokens_from_tree(struct vp9_token*, vp9_tree);
     43 void vp9_tokens_from_tree_offset(struct vp9_token*, vp9_tree, int offset);
     44 
     45 /* Convert array of token occurrence counts into a table of probabilities
     46    for the associated binary encoding tree.  Also writes count of branches
     47    taken for each node on the tree; this facilitiates decisions as to
     48    probability updates. */
     49 
     50 void vp9_tree_probs_from_distribution(vp9_tree tree,
     51                                       vp9_prob probs[ /* n - 1 */ ],
     52                                       unsigned int branch_ct[ /* n - 1 */ ][2],
     53                                       const unsigned int num_events[ /* n */ ],
     54                                       unsigned int tok0_offset);
     55 
     56 static INLINE vp9_prob clip_prob(int p) {
     57   return (p > 255) ? 255u : (p < 1) ? 1u : p;
     58 }
     59 
     60 // int64 is not needed for normal frame level calculations.
     61 // However when outputing entropy stats accumulated over many frames
     62 // or even clips we can overflow int math.
     63 #ifdef ENTROPY_STATS
     64 static INLINE vp9_prob get_prob(int num, int den) {
     65   return (den == 0) ? 128u : clip_prob(((int64_t)num * 256 + (den >> 1)) / den);
     66 }
     67 #else
     68 static INLINE vp9_prob get_prob(int num, int den) {
     69   return (den == 0) ? 128u : clip_prob((num * 256 + (den >> 1)) / den);
     70 }
     71 #endif
     72 
     73 static INLINE vp9_prob get_binary_prob(int n0, int n1) {
     74   return get_prob(n0, n0 + n1);
     75 }
     76 
     77 /* this function assumes prob1 and prob2 are already within [1,255] range */
     78 static INLINE vp9_prob weighted_prob(int prob1, int prob2, int factor) {
     79   return ROUND_POWER_OF_TWO(prob1 * (256 - factor) + prob2 * factor, 8);
     80 }
     81 
     82 static INLINE vp9_prob merge_probs(vp9_prob pre_prob, vp9_prob prob,
     83                                    const unsigned int ct[2],
     84                                    unsigned int count_sat,
     85                                    unsigned int max_update_factor) {
     86   const unsigned int count = MIN(ct[0] + ct[1], count_sat);
     87   const unsigned int factor = max_update_factor * count / count_sat;
     88   return weighted_prob(pre_prob, prob, factor);
     89 }
     90 
     91 static INLINE vp9_prob merge_probs2(vp9_prob pre_prob,
     92                                    const unsigned int ct[2],
     93                                    unsigned int count_sat,
     94                                    unsigned int max_update_factor) {
     95   return merge_probs(pre_prob, get_binary_prob(ct[0], ct[1]), ct, count_sat,
     96                      max_update_factor);
     97 }
     98 
     99 
    100 #endif  // VP9_COMMON_VP9_TREECODER_H_
    101