aboutsummaryrefslogtreecommitdiffstats
path: root/src/dsd2pcm/noiseshape.h
blob: bb6b5bf5d2da93122fe1a51857de6cc03a2873b0 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
#ifndef NOISE_SHAPE_H_INCLUDED
#define NOISE_SHAPE_H_INCLUDED

#ifdef __cpluspluc
extern "C" {
#endif

typedef struct noise_shape_ctx_s {
	int sos_count;      /* number of second order sections */
	const float *bbaa;  /* filter coefficients, owned by user */
	float *t1, *t2;     /* filter state, owned by ns library */
} noise_shape_ctx;

/**
 * initializes a noise_shaper context
 * returns an error code or 0
 */
extern int noise_shape_init(
	noise_shape_ctx *ctx,
	int sos_count,
	const float *coeffs);

/**
 * destroys a noise_shaper context
 */
extern void noise_shape_destroy(
	noise_shape_ctx *ctx);

/**
 * initializes a noise_shaper context so that its state
 * is a copy of a given context
 * returns an error code or 0
 */
extern int noise_shape_clone(
	const noise_shape_ctx *from, noise_shape_ctx *to);

/**
 * computes the next "noise shaping sample". Note: This call
 * alters the internal state. xxx_get and xxx_update must be
 * called in an alternating manner.
 */
extern float noise_shape_get(
	noise_shape_ctx *ctx);

/**
 * updates the noise shaper's state with the
 * last quantization error
 */
extern void noise_shape_update(
	noise_shape_ctx *ctx, float qerror);

#ifdef __cpluspluc
} /* extern "C" */
#endif

#endif /* NOISE_SHAPE_H_INCLUDED */