Thu, 22 Jan 2015 13:21:57 +0100
Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6
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 */
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[];
37 struct vp9_token {
38 int value;
39 int len;
40 };
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;
58 }
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
73 static INLINE vp9_prob get_binary_prob(int n0, int n1) {
74 return get_prob(n0, n0 + n1);
75 }
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 }
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);
90 }
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,
98 vp9_prob *probs) {
99 const int l = tree[i];
100 const unsigned int left_count = (l <= 0)
101 ? counts[-l]
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)
106 ? counts[-r]
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;
113 }
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);
122 }
125 #endif // VP9_COMMON_VP9_TREECODER_H_