
PVQ replaces the scalar quantizer and coefficient coding with a new
design originally developed in Daala. It currently depends on the
Daala entropy coder although it could be adapted to work with another
entropy coder if needed:
./configure --enable-experimental --enable-daala_ec --enable-pvq
The version of PVQ in this commit is adapted from the following
revision of Daala:
fb51c1ade6
More information about PVQ:
- https://people.xiph.org/~jm/daala/pvq_demo/
- https://jmvalin.ca/papers/spie_pvq.pdf
The following files are copied as-is from Daala with minimal
adaptations, therefore we disable clang-format on those files
to make it easier to synchronize the AV1 and Daala codebases in the future:
av1/common/generic_code.c
av1/common/generic_code.h
av1/common/laplace_tables.c
av1/common/partition.c
av1/common/partition.h
av1/common/pvq.c
av1/common/pvq.h
av1/common/state.c
av1/common/state.h
av1/common/zigzag.h
av1/common/zigzag16.c
av1/common/zigzag32.c
av1/common/zigzag4.c
av1/common/zigzag64.c
av1/common/zigzag8.c
av1/decoder/decint.h
av1/decoder/generic_decoder.c
av1/decoder/laplace_decoder.c
av1/decoder/pvq_decoder.c
av1/decoder/pvq_decoder.h
av1/encoder/daala_compat_enc.c
av1/encoder/encint.h
av1/encoder/generic_encoder.c
av1/encoder/laplace_encoder.c
av1/encoder/pvq_encoder.c
av1/encoder/pvq_encoder.h
Known issues:
- Lossless mode is not supported, '--lossless=1' will give the same result as
'--end-usage=q --cq-level=1'.
- High bit depth is not supported by PVQ.
Change-Id: I1ae0d6517b87f4c1ccea944b2e12dc906979f25e
102 lines
3.7 KiB
C
102 lines
3.7 KiB
C
/*
|
|
* Copyright (c) 2001-2016, 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.
|
|
*/
|
|
|
|
#if !defined(_entdec_H)
|
|
#define _entdec_H (1)
|
|
#include <limits.h>
|
|
#include "aom_dsp/entcode.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct od_ec_dec od_ec_dec;
|
|
|
|
#if OD_ACCOUNTING
|
|
#define OD_ACC_STR , char *acc_str
|
|
#define od_ec_dec_bits(dec, ftb, str) od_ec_dec_bits_(dec, ftb, str)
|
|
#else
|
|
#define OD_ACC_STR
|
|
#define od_ec_dec_bits(dec, ftb, str) od_ec_dec_bits_(dec, ftb)
|
|
#endif
|
|
|
|
/*The entropy decoder context.*/
|
|
struct od_ec_dec {
|
|
/*The start of the current input buffer.*/
|
|
const unsigned char *buf;
|
|
/*The read pointer for the raw bits.*/
|
|
const unsigned char *eptr;
|
|
/*Bits that will be read from/written at the end.*/
|
|
od_ec_window end_window;
|
|
/*Number of valid bits in end_window.*/
|
|
int nend_bits;
|
|
/*An offset used to keep track of tell after reaching the end of the stream.
|
|
This is constant throughout most of the decoding process, but becomes
|
|
important once we hit the end of the buffer and stop incrementing pointers
|
|
(and instead pretend cnt/nend_bits have lots of bits).*/
|
|
int32_t tell_offs;
|
|
/*The end of the current input buffer.*/
|
|
const unsigned char *end;
|
|
/*The read pointer for the entropy-coded bits.*/
|
|
const unsigned char *bptr;
|
|
/*The difference between the coded value and the low end of the current
|
|
range.*/
|
|
od_ec_window dif;
|
|
/*The number of values in the current range.*/
|
|
uint16_t rng;
|
|
/*The number of bits of data in the current value.*/
|
|
int16_t cnt;
|
|
/*Nonzero if an error occurred.*/
|
|
int error;
|
|
};
|
|
|
|
/*See entdec.c for further documentation.*/
|
|
|
|
void od_ec_dec_init(od_ec_dec *dec, const unsigned char *buf, uint32_t storage)
|
|
OD_ARG_NONNULL(1) OD_ARG_NONNULL(2);
|
|
|
|
OD_WARN_UNUSED_RESULT int od_ec_decode_bool(od_ec_dec *dec, unsigned fz,
|
|
unsigned ft) OD_ARG_NONNULL(1);
|
|
OD_WARN_UNUSED_RESULT int od_ec_decode_bool_q15(od_ec_dec *dec, unsigned fz)
|
|
OD_ARG_NONNULL(1);
|
|
OD_WARN_UNUSED_RESULT int od_ec_decode_cdf(od_ec_dec *dec, const uint16_t *cdf,
|
|
int nsyms) OD_ARG_NONNULL(1)
|
|
OD_ARG_NONNULL(2);
|
|
OD_WARN_UNUSED_RESULT int od_ec_decode_cdf_q15(od_ec_dec *dec,
|
|
const uint16_t *cdf, int nsyms)
|
|
OD_ARG_NONNULL(1) OD_ARG_NONNULL(2);
|
|
OD_WARN_UNUSED_RESULT int od_ec_decode_cdf_unscaled(od_ec_dec *dec,
|
|
const uint16_t *cdf,
|
|
int nsyms) OD_ARG_NONNULL(1)
|
|
OD_ARG_NONNULL(2);
|
|
OD_WARN_UNUSED_RESULT int od_ec_decode_cdf_unscaled_dyadic(od_ec_dec *dec,
|
|
const uint16_t *cdf,
|
|
int nsyms,
|
|
unsigned _ftb)
|
|
OD_ARG_NONNULL(1) OD_ARG_NONNULL(2);
|
|
|
|
OD_WARN_UNUSED_RESULT uint32_t od_ec_dec_uint(od_ec_dec *dec, uint32_t ft)
|
|
OD_ARG_NONNULL(1);
|
|
|
|
OD_WARN_UNUSED_RESULT uint32_t od_ec_dec_bits_(od_ec_dec *dec, unsigned ftb)
|
|
OD_ARG_NONNULL(1);
|
|
|
|
OD_WARN_UNUSED_RESULT int od_ec_dec_tell(const od_ec_dec *dec)
|
|
OD_ARG_NONNULL(1);
|
|
OD_WARN_UNUSED_RESULT uint32_t od_ec_dec_tell_frac(const od_ec_dec *dec)
|
|
OD_ARG_NONNULL(1);
|
|
|
|
#ifdef __cplusplus
|
|
} // extern "C"
|
|
#endif
|
|
|
|
#endif
|