1**************************
2*  zita-convolver 4.0.0  *
3*  Released 2018-06-06   *
4**************************
5
6API changes between 3.x.x and  4.x.x
7------------------------------------
8
91. Version 4 now uses int types from <stdint.h>
10   internally and for the arguments of all member
11   funcions.
12
132. The set_density() function has been removed, and the
14   matrix density hint is now an additional argument to
15   configure().
16
17If your application does not use impdata_update(),
18then (1) and (2) are the only relevant changes.
19
203. The way impdata_update() works has changed.
21
22This function is used to modify IR data while the convolver
23is actually running. It does not use any memory allocation
24nor modify internal data structures, and only data in already
25existing partitions can be modified this way.
26In versions <= 3, this function would *overwrite* any existing
27data. From version 4, impdata_update() *adds* to existing IR
28data, just as impdata_create() does. So in order to replace an
29existing IR, you first need to clear it using the new function
30impdata_clear(). This will clear (but not delete) all IR data
31for a given input, output pair.
32
33
34Version test macro and function
35-------------------------------
36
37If your application depends on this version of zita-convolver,
38insert the following two code fragments, normally in your main
39program source file:
40
41This will test for zita-convolver-4.x.x at compile time.
42-----
43#include <zita-convolver.h>
44
45#if ZITA_CONVOLVER_MAJOR_VERSION != 4
46#error "This program requires zita-convolver 4.x.x"
47#endif
48-----
49
50This will check that the compile time and run time libraries
51are compatible.
52-----
53if (zita_convolver_major_version () != ZITA_CONVOLVER_MAJOR_VERSION)
54{
55    fprintf (stderr, "Zita-convolver version does not match.\n");
56    return 1;
57}
58-----
59
60