Coverage Report

Created: 2025-07-23 08:18

/src/x265/source/encoder/entropy.h
Line
Count
Source (jump to first uncovered line)
1
/*****************************************************************************
2
* Copyright (C) 2013-2020 MulticoreWare, Inc
3
*
4
* Authors: Steve Borho <steve@borho.org>
5
*          Min Chen <chenm003@163.com>
6
*
7
* This program is free software; you can redistribute it and/or modify
8
* it under the terms of the GNU General Public License as published by
9
* the Free Software Foundation; either version 2 of the License, or
10
* (at your option) any later version.
11
*
12
* This program is distributed in the hope that it will be useful,
13
* but WITHOUT ANY WARRANTY; without even the implied warranty of
14
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15
* GNU General Public License for more details.
16
*
17
* You should have received a copy of the GNU General Public License
18
* along with this program; if not, write to the Free Software
19
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111, USA.
20
*
21
* This program is also available under a commercial proprietary license.
22
* For more information, contact us at license @ x265.com.
23
*****************************************************************************/
24
25
#ifndef X265_ENTROPY_H
26
#define X265_ENTROPY_H
27
28
#include "common.h"
29
#include "bitstream.h"
30
#include "frame.h"
31
#include "cudata.h"
32
#include "contexts.h"
33
#include "slice.h"
34
35
namespace X265_NS {
36
// private namespace
37
38
struct SaoCtuParam;
39
struct EstBitsSbac;
40
class ScalingList;
41
42
enum SplitType
43
{
44
    DONT_SPLIT            = 0,
45
    VERTICAL_SPLIT        = 1,
46
    QUAD_SPLIT            = 2,
47
    NUMBER_OF_SPLIT_MODES = 3
48
};
49
50
struct TURecurse
51
{
52
    uint32_t section;
53
    uint32_t splitMode;
54
    uint32_t absPartIdxTURelCU;
55
    uint32_t absPartIdxStep;
56
57
    TURecurse(SplitType splitType, uint32_t _absPartIdxStep, uint32_t _absPartIdxTU)
58
0
    {
59
0
        static const uint32_t partIdxStepShift[NUMBER_OF_SPLIT_MODES] = { 0, 1, 2 };
60
0
        section           = 0;
61
0
        absPartIdxTURelCU = _absPartIdxTU;
62
0
        splitMode         = (uint32_t)splitType;
63
0
        absPartIdxStep    = _absPartIdxStep >> partIdxStepShift[splitMode];
64
0
    }
65
66
    bool isNextSection()
67
0
    {
68
0
        if (splitMode == DONT_SPLIT)
69
0
        {
70
0
            section++;
71
0
            return false;
72
0
        }
73
0
        else
74
0
        {
75
0
            absPartIdxTURelCU += absPartIdxStep;
76
77
0
            section++;
78
0
            return section < (uint32_t)(1 << splitMode);
79
0
        }
80
0
    }
81
82
    bool isLastSection() const
83
0
    {
84
0
        return (section + 1) >= (uint32_t)(1 << splitMode);
85
0
    }
86
};
87
88
struct EstBitsSbac
89
{
90
    int significantCoeffGroupBits[NUM_SIG_CG_FLAG_CTX][2];
91
    int significantBits[2][NUM_SIG_FLAG_CTX];
92
    int lastBits[2][10];
93
    int greaterOneBits[NUM_ONE_FLAG_CTX][2];
94
    int levelAbsBits[NUM_ABS_FLAG_CTX][2];
95
    int blockCbpBits[NUM_QT_CBF_CTX][2];
96
    int blockRootCbpBits[2];
97
};
98
99
class Entropy : public SyntaxElementWriter
100
{
101
public:
102
103
    uint64_t      m_pad;
104
    uint8_t       m_contextState[160]; // MAX_OFF_CTX_MOD + padding
105
106
    /* CABAC state */
107
    uint32_t      m_low;
108
    uint32_t      m_range;
109
    uint32_t      m_bufferedByte;
110
    int           m_numBufferedBytes;
111
    int           m_bitsLeft;
112
    uint64_t      m_fracBits;
113
    EstBitsSbac   m_estBitsSbac;
114
    double        m_meanQP;
115
116
    Entropy();
117
118
0
    void setBitstream(Bitstream* p)    { m_bitIf = p; }
119
120
    uint32_t getNumberOfWrittenBits()
121
0
    {
122
0
        X265_CHECK(!m_bitIf, "bit counting mode expected\n");
123
0
        return (uint32_t)(m_fracBits >> 15);
124
0
    }
125
126
#if CHECKED_BUILD || _DEBUG
127
    bool m_valid;
128
    void markInvalid()                 { m_valid = false; }
129
    void markValid()                   { m_valid = true; }
130
#else
131
0
    void markValid()                   { }
132
#endif
133
0
    void zeroFract()                   { m_fracBits = 0; }
134
    void resetBits();
135
    void resetEntropy(const Slice& slice);
136
137
    // SBAC RD
138
0
    void load(const Entropy& src)            { copyFrom(src); }
139
0
    void store(Entropy& dest) const          { dest.copyFrom(*this); }
140
0
    void loadContexts(const Entropy& src)    { copyContextsFrom(src); }
141
    void loadIntraDirModeLuma(const Entropy& src);
142
    void copyState(const Entropy& other);
143
144
#if ENABLE_ALPHA || ENABLE_MULTIVIEW
145
    void codeVPS(const VPS& vps, const SPS& sps);
146
#else
147
    void codeVPS(const VPS& vps);
148
#endif
149
    void codeSPS(const SPS& sps, const ScalingList& scalingList, const ProfileTierLevel& ptl, int layer = 0);
150
    void codePPS( const PPS& pps, bool filerAcross, int iPPSInitQpMinus26, int layer = 0);
151
    void codeVUI(const VUI& vui, int maxSubTLayers, bool bEmitVUITimingInfo, bool bEmitVUIHRDInfo, int layer = 0);
152
    void codeAUD(const Slice& slice);
153
    void codeHrdParameters(const HRDInfo& hrd, int maxSubTLayers);
154
155
    void codeSliceHeader(const Slice& slice, FrameData& encData, uint32_t slice_addr, uint32_t slice_addr_bits, int sliceQp, int layer = 0);
156
    void codeSliceHeaderWPPEntryPoints(const uint32_t *substreamSizes, uint32_t numSubStreams, uint32_t maxOffset);
157
    void codeShortTermRefPicSet(const RPS& rps, int idx);
158
0
    void finishSlice()                 { encodeBinTrm(1); finish(); dynamic_cast<Bitstream*>(m_bitIf)->writeByteAlignment(); }
159
160
    void encodeCTU(const CUData& cu, const CUGeom& cuGeom);
161
162
    void codeIntraDirLumaAng(const CUData& cu, uint32_t absPartIdx, bool isMultiple);
163
    void codeIntraDirChroma(const CUData& cu, uint32_t absPartIdx, uint32_t *chromaDirMode);
164
165
    void codeMergeIndex(const CUData& cu, uint32_t absPartIdx);
166
    void codeMvd(const CUData& cu, uint32_t absPartIdx, int list);
167
168
    void codePartSize(const CUData& cu, uint32_t absPartIdx, uint32_t depth);
169
    void codePredInfo(const CUData& cu, uint32_t absPartIdx);
170
171
    void codeQtCbfChroma(const CUData& cu, uint32_t absPartIdx, TextType ttype, uint32_t tuDepth, bool lowestLevel);
172
    void codeCoeff(const CUData& cu, uint32_t absPartIdx, bool& bCodeDQP, const uint32_t depthRange[2]);
173
    void codeCoeffNxN(const CUData& cu, const coeff_t* coef, uint32_t absPartIdx, uint32_t log2TrSize, TextType ttype);
174
175
0
    inline void codeSaoMerge(uint32_t code)                          { encodeBin(code, m_contextState[OFF_SAO_MERGE_FLAG_CTX]); }
176
0
    inline void codeSaoType(uint32_t code)                           { encodeBin(code, m_contextState[OFF_SAO_TYPE_IDX_CTX]); }
177
0
    inline void codeMVPIdx(uint32_t symbol)                          { encodeBin(symbol, m_contextState[OFF_MVP_IDX_CTX]); }
178
0
    inline void codeMergeFlag(const CUData& cu, uint32_t absPartIdx) { encodeBin(cu.m_mergeFlag[absPartIdx], m_contextState[OFF_MERGE_FLAG_EXT_CTX]); }
179
0
    inline void codeSkipFlag(const CUData& cu, uint32_t absPartIdx)  { encodeBin(cu.isSkipped(absPartIdx), m_contextState[OFF_SKIP_FLAG_CTX + cu.getCtxSkipFlag(absPartIdx)]); }
180
0
    inline void codeSplitFlag(const CUData& cu, uint32_t absPartIdx, uint32_t depth) { encodeBin(cu.m_cuDepth[absPartIdx] > depth, m_contextState[OFF_SPLIT_FLAG_CTX + cu.getCtxSplitFlag(absPartIdx, depth)]); }
181
0
    inline void codeTransformSubdivFlag(uint32_t symbol, uint32_t ctx)    { encodeBin(symbol, m_contextState[OFF_TRANS_SUBDIV_FLAG_CTX + ctx]); }
182
0
    inline void codePredMode(int predMode)                                { encodeBin(predMode == MODE_INTRA ? 1 : 0, m_contextState[OFF_PRED_MODE_CTX]); }
183
0
    inline void codeCUTransquantBypassFlag(uint32_t symbol)               { encodeBin(symbol, m_contextState[OFF_TQUANT_BYPASS_FLAG_CTX]); }
184
0
    inline void codeQtCbfLuma(uint32_t cbf, uint32_t tuDepth)             { encodeBin(cbf, m_contextState[OFF_QT_CBF_CTX + !tuDepth]); }
185
0
    inline void codeQtCbfChroma(uint32_t cbf, uint32_t tuDepth)           { encodeBin(cbf, m_contextState[OFF_QT_CBF_CTX + 2 + tuDepth]); }
186
0
    inline void codeQtRootCbf(uint32_t cbf)                               { encodeBin(cbf, m_contextState[OFF_QT_ROOT_CBF_CTX]); }
187
0
    inline void codeTransformSkipFlags(uint32_t transformSkip, TextType ttype) { encodeBin(transformSkip, m_contextState[OFF_TRANSFORMSKIP_FLAG_CTX + (ttype ? NUM_TRANSFORMSKIP_FLAG_CTX : 0)]); }
188
    void codeDeltaQP(const CUData& cu, uint32_t absPartIdx);
189
    void codeSaoOffset(const SaoCtuParam& ctuParam, int plane);
190
    void codeSaoOffsetEO(int *offset, int typeIdx, int plane);
191
    void codeSaoOffsetBO(int *offset, int bandPos, int plane);
192
193
    /* RDO functions */
194
    void estBit(EstBitsSbac& estBitsSbac, uint32_t log2TrSize, bool bIsLuma) const;
195
    void estCBFBit(EstBitsSbac& estBitsSbac) const;
196
    void estSignificantCoeffGroupMapBit(EstBitsSbac& estBitsSbac, bool bIsLuma) const;
197
    void estSignificantMapBit(EstBitsSbac& estBitsSbac, uint32_t log2TrSize, bool bIsLuma) const;
198
    void estSignificantCoefficientsBit(EstBitsSbac& estBitsSbac, bool bIsLuma) const;
199
200
0
    inline uint32_t bitsIntraModeNonMPM() const { return bitsCodeBin(0, m_contextState[OFF_ADI_CTX]) + 5; }
201
0
    inline uint32_t bitsIntraModeMPM(const uint32_t preds[3], uint32_t dir) const { return bitsCodeBin(1, m_contextState[OFF_ADI_CTX]) + (dir == preds[0] ? 1 : 2); }
202
0
    inline uint32_t estimateCbfBits(uint32_t cbf, TextType ttype, uint32_t tuDepth) const { return bitsCodeBin(cbf, m_contextState[OFF_QT_CBF_CTX + ctxCbf[ttype][tuDepth]]); }
203
    uint32_t bitsInterMode(const CUData& cu, uint32_t absPartIdx, uint32_t depth) const;
204
    uint32_t bitsIntraMode(const CUData& cu, uint32_t absPartIdx) const
205
0
    {
206
0
        return bitsCodeBin(0, m_contextState[OFF_SKIP_FLAG_CTX + cu.getCtxSkipFlag(absPartIdx)]) + /* not skip */
207
0
               bitsCodeBin(1, m_contextState[OFF_PRED_MODE_CTX]); /* intra */
208
0
    }
209
210
    /* these functions are only used to estimate the bits when cbf is 0 and will never be called when writing the bistream. */
211
0
    inline void codeQtRootCbfZero() { encodeBin(0, m_contextState[OFF_QT_ROOT_CBF_CTX]); }
212
213
private:
214
215
    /* CABAC private methods */
216
    void start();
217
    void finish();
218
219
    void encodeBin(uint32_t binValue, uint8_t& ctxModel);
220
    void encodeBinEP(uint32_t binValue);
221
    void encodeBinsEP(uint32_t binValues, int numBins);
222
    void encodeBinTrm(uint32_t binValue);
223
224
    /* return the bits of encoding the context bin without updating */
225
    inline uint32_t bitsCodeBin(uint32_t binValue, uint32_t ctxModel) const
226
0
    {
227
0
        uint64_t fracBits = (m_fracBits & 32767) + sbacGetEntropyBits(ctxModel, binValue);
228
0
        return (uint32_t)(fracBits >> 15);
229
0
    }
230
231
    void encodeCU(const CUData& ctu, const CUGeom &cuGeom, uint32_t absPartIdx, uint32_t depth, bool& bEncodeDQP);
232
    void finishCU(const CUData& ctu, uint32_t absPartIdx, uint32_t depth, bool bEncodeDQP);
233
234
    void writeOut();
235
236
    /* SBac private methods */
237
    void writeUnaryMaxSymbol(uint32_t symbol, uint8_t* scmModel, int offset, uint32_t maxSymbol);
238
    void writeEpExGolomb(uint32_t symbol, uint32_t count);
239
    void writeCoefRemainExGolomb(uint32_t symbol, const uint32_t absGoRice);
240
241
    void codeProfileTier(const ProfileTierLevel& ptl, int maxTempSubLayers, int layer = 0);
242
    void codeScalingList(const ScalingList&);
243
    void codeScalingList(const ScalingList& scalingList, uint32_t sizeId, uint32_t listId);
244
245
    void codePredWeightTable(const Slice& slice);
246
    void codeInterDir(const CUData& cu, uint32_t absPartIdx);
247
    void codePUWise(const CUData& cu, uint32_t absPartIdx);
248
    void codeRefFrmIdxPU(const CUData& cu, uint32_t absPartIdx, int list);
249
    void codeRefFrmIdx(const CUData& cu, uint32_t absPartIdx, int list);
250
251
    void codeSaoMaxUvlc(uint32_t code, uint32_t maxSymbol);
252
253
    void codeLastSignificantXY(uint32_t posx, uint32_t posy, uint32_t log2TrSize, bool bIsLuma, uint32_t scanIdx);
254
255
    void encodeTransform(const CUData& cu, uint32_t absPartIdx, uint32_t tuDepth, uint32_t log2TrSize,
256
                         bool& bCodeDQP, const uint32_t depthRange[2]);
257
    void encodeTransformLuma(const CUData& cu, uint32_t absPartIdx, uint32_t tuDepth, uint32_t log2TrSize,
258
                         bool& bCodeDQP, const uint32_t depthRange[2]);
259
260
    void copyFrom(const Entropy& src);
261
    void copyContextsFrom(const Entropy& src);
262
};
263
}
264
265
#endif // ifndef X265_ENTROPY_H