2
* Copyright (c) 2010 The WebM project authors. All Rights Reserved.
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.
11
#ifndef VP9_COMMON_VP9_TREECODER_H_
12
#define VP9_COMMON_VP9_TREECODER_H_
14
#include "./vpx_config.h"
15
#include "vpx/vpx_integer.h"
16
#include "vp9/common/vp9_common.h"
18
typedef uint8_t vp9_prob;
20
#define vp9_prob_half ((vp9_prob) 128)
22
typedef int8_t vp9_tree_index;
24
#define TREE_SIZE(leaf_count) (2 * (leaf_count) - 2)
26
#define vp9_complement(x) (255 - x)
28
/* We build coding trees compactly in arrays.
29
Each node of the tree is a pair of vp9_tree_indices.
30
Array index often references a corresponding probability table.
31
Index <= 0 means done encoding/decoding and value = -Index,
32
Index > 0 means need another bit, specification at index.
33
Nonnegative indices are always even; processing begins at node 0. */
35
typedef const vp9_tree_index vp9_tree[];
42
/* Construct encoding array from tree. */
44
void vp9_tokens_from_tree(struct vp9_token*, vp9_tree);
46
/* Convert array of token occurrence counts into a table of probabilities
47
for the associated binary encoding tree. Also writes count of branches
48
taken for each node on the tree; this facilitiates decisions as to
49
probability updates. */
51
void vp9_tree_probs_from_distribution(vp9_tree tree,
52
unsigned int branch_ct[ /* n - 1 */ ][2],
53
const unsigned int num_events[ /* n */ ]);
56
static INLINE vp9_prob clip_prob(int p) {
57
return (p > 255) ? 255u : (p < 1) ? 1u : p;
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.
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);
68
static INLINE vp9_prob get_prob(int num, int den) {
69
return (den == 0) ? 128u : clip_prob((num * 256 + (den >> 1)) / den);
73
static INLINE vp9_prob get_binary_prob(int n0, int n1) {
74
return get_prob(n0, n0 + n1);
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);
82
static INLINE vp9_prob merge_probs(vp9_prob pre_prob,
83
const unsigned int ct[2],
84
unsigned int count_sat,
85
unsigned int max_update_factor) {
86
const vp9_prob prob = get_binary_prob(ct[0], ct[1]);
87
const unsigned int count = MIN(ct[0] + ct[1], count_sat);
88
const unsigned int factor = max_update_factor * count / count_sat;
89
return weighted_prob(pre_prob, prob, factor);
92
static unsigned int tree_merge_probs_impl(unsigned int i,
93
const vp9_tree_index *tree,
94
const vp9_prob *pre_probs,
95
const unsigned int *counts,
96
unsigned int count_sat,
97
unsigned int max_update_factor,
99
const int l = tree[i];
100
const unsigned int left_count = (l <= 0)
102
: tree_merge_probs_impl(l, tree, pre_probs, counts,
103
count_sat, max_update_factor, probs);
104
const int r = tree[i + 1];
105
const unsigned int right_count = (r <= 0)
107
: tree_merge_probs_impl(r, tree, pre_probs, counts,
108
count_sat, max_update_factor, probs);
109
const unsigned int ct[2] = { left_count, right_count };
110
probs[i >> 1] = merge_probs(pre_probs[i >> 1], ct,
111
count_sat, max_update_factor);
112
return left_count + right_count;
115
static void tree_merge_probs(const vp9_tree_index *tree,
116
const vp9_prob *pre_probs,
117
const unsigned int *counts,
118
unsigned int count_sat,
119
unsigned int max_update_factor, vp9_prob *probs) {
120
tree_merge_probs_impl(0, tree, pre_probs, counts,
121
count_sat, max_update_factor, probs);
125
#endif // VP9_COMMON_VP9_TREECODER_H_