| /* |
| * Copyright (c) 2021, Alliance for Open Media. All rights reserved |
| * |
| * This source code is subject to the terms of the BSD 2 Clause License and |
| * the Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License |
| * was not distributed with this source code in the LICENSE file, you can |
| * obtain it at www.aomedia.org/license/software. If the Alliance for Open |
| * Media Patent License 1.0 was not distributed with this source code in the |
| * PATENTS file, you can obtain it at www.aomedia.org/license/patent. |
| */ |
| |
| #ifndef AOM_AV1_ENCODER_TXB_RDOPT_H_ |
| #define AOM_AV1_ENCODER_TXB_RDOPT_H_ |
| |
| #include "av1/common/blockd.h" |
| #include "av1/common/txb_common.h" |
| #include "av1/encoder/encoder.h" |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /*!\brief Adjust the magnitude of quantized coefficients to achieve better |
| * rate-distortion (RD) trade-off. |
| * |
| * \ingroup coefficient_coding |
| * |
| * This function goes through each coefficient and greedily choose to lower |
| * the coefficient magnitude by 1 or not based on the RD score. |
| * |
| * The coefficients are processing in reversed scan order. |
| * |
| * Note that, the end of block position (eob) may change if the original last |
| * coefficient is lowered to zero. |
| * |
| * \param[in] cpi Top-level encoder structure |
| * \param[in] x Pointer to structure holding the data for the |
| current encoding macroblock |
| * \param[in] plane The index of the current plane |
| * \param[in] block The index of the current transform block in the |
| * \param[in] tx_size The transform size |
| * \param[in] tx_type The transform type |
| * \param[in] txb_ctx Context info for entropy coding transform block |
| * skip flag (tx_skip) and the sign of DC coefficient (dc_sign). |
| * \param[out] rate_cost The entropy cost of coding the transform block |
| * after adjustment of coefficients. |
| * \param[in] sharpness When sharpness > 0, the function will be less |
| * aggressive towards lowering the magnitude of coefficients. |
| * In this way, the transform block will contain more high-frequency |
| * coefficients and therefore will preserve the sharpness of the reconstructed |
| * block. |
| */ |
| int av1_optimize_txb(const struct AV1_COMP *cpi, MACROBLOCK *x, int plane, |
| int block, TX_SIZE tx_size, TX_TYPE tx_type, |
| const TXB_CTX *const txb_ctx, int *rate_cost, |
| int sharpness); |
| |
| /*!\brief Compute the entropy cost of coding coefficients in a transform block. |
| * |
| * \ingroup coefficient_coding |
| * |
| * \param[in] x Pointer to structure holding the data for |
| the current encoding macroblock. |
| * \param[in] plane The index of the current plane. |
| * \param[in] block The index of the current transform block |
| in the |
| * macroblock. It's defined by number of 4x4 units that have been coded before |
| * the currernt transform block. |
| * \param[in] tx_size The transform size. |
| * \param[in] tx_type The transform type. |
| * \param[in] txb_ctx Context info for entropy coding transform |
| block |
| * skip flag (tx_skip) and the sign of DC coefficient (dc_sign). |
| * \param[in] reduced_tx_set_used Whether the transform type is chosen from |
| * a reduced set. |
| */ |
| int av1_cost_coeffs_txb(const MACROBLOCK *x, const int plane, const int block, |
| const TX_SIZE tx_size, const TX_TYPE tx_type, |
| const TXB_CTX *const txb_ctx, int reduced_tx_set_used); |
| |
| /*!\brief Estimate the entropy cost of coding a transform block using Laplacian |
| * distribution. |
| * |
| * \ingroup coefficient_coding |
| * |
| * This function compute the entropy costs of the end of block position (eob) |
| * and the transform type (tx_type) precisely. |
| * |
| * Then using \ref av1_cost_coeffs_txb_estimate to estimate the entropy costs |
| * of coefficients in the transform block. |
| * |
| * In the end, the function returns the sum of entropy costs of end of block |
| * position (eob), transform type (tx_type) and coefficients. |
| * |
| * Compared to \ref av1_cost_coeffs_txb, this function is much faster but less |
| * accurate. |
| * |
| * \param[in] x Pointer to structure holding the data for the |
| current encoding macroblock |
| * \param[in] plane The index of the current plane |
| * \param[in] block The index of the current transform block in the |
| * macroblock. It's defined by number of 4x4 units that have been coded before |
| * the currernt transform block |
| * \param[in] tx_size The transform size |
| * \param[in] tx_type The transform type |
| * \param[in] txb_ctx Context info for entropy coding transform block |
| * skip flag (tx_skip) and the sign of DC coefficient (dc_sign). |
| * \param[in] reduced_tx_set_used Whether the transform type is chosen from |
| * a reduced set. |
| * \param[in] adjust_eob Whether to adjust the end of block position |
| (eob) |
| * or not. |
| * \return int Estimated entropy cost of coding the transform |
| block. |
| */ |
| int av1_cost_coeffs_txb_laplacian(const MACROBLOCK *x, const int plane, |
| const int block, const TX_SIZE tx_size, |
| const TX_TYPE tx_type, |
| const TXB_CTX *const txb_ctx, |
| const int reduced_tx_set_used, |
| const int adjust_eob); |
| |
| /*!\brief Estimate the entropy cost of transform coefficients using Laplacian |
| * distribution. |
| * |
| * \ingroup coefficient_coding |
| * |
| * This function assumes each transform coefficient is of its own Laplacian |
| * distribution and the coefficient is the only observation of the Laplacian |
| * distribution. |
| * |
| * Based on that, each coefficient's coding cost can be estimated by computing |
| * the entropy of the corresponding Laplacian distribution. |
| * |
| * This function then return the sum of the estimated entropy cost for all |
| * coefficients in the transform block. |
| * |
| * Note that the entropy cost of end of block (eob) and transform type (tx_type) |
| * are not included. |
| * |
| * \param[in] x Pointer to structure holding the data for the |
| current encoding macroblock |
| * \param[in] plane The index of the current plane |
| * \param[in] block The index of the current transform block in the |
| * macroblock. It's defined by number of 4x4 units that have been coded before |
| * the currernt transform block |
| * \param[in] tx_size The transform size |
| * \param[in] tx_type The transform type |
| * \return int Estimated entropy cost of coefficients in the |
| * transform block. |
| */ |
| int av1_cost_coeffs_txb_estimate(const MACROBLOCK *x, const int plane, |
| const int block, const TX_SIZE tx_size, |
| const TX_TYPE tx_type); |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif // AOM_AV1_ENCODER_TXB_RDOPT_H_ |
