File: Randomizer.h

package info (click to toggle)
lsp-plugins 1.2.5-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 91,856 kB
  • sloc: cpp: 427,831; xml: 57,779; makefile: 9,961; php: 1,005; sh: 18
file content (108 lines) | stat: -rw-r--r-- 3,430 bytes parent folder | download
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
/*
 * Copyright (C) 2020 Linux Studio Plugins Project <https://lsp-plug.in/>
 *           (C) 2020 Vladimir Sadovnikov <sadko4u@gmail.com>
 *
 * This file is part of lsp-dsp-units
 * Created on: 23 марта 2016 г.
 *
 * lsp-dsp-units is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * any later version.
 *
 * lsp-dsp-units is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with lsp-dsp-units. If not, see <https://www.gnu.org/licenses/>.
 */

#ifndef LSP_PLUG_IN_DSP_UNITS_UTIL_RANDOMIZER_H_
#define LSP_PLUG_IN_DSP_UNITS_UTIL_RANDOMIZER_H_

#include <lsp-plug.in/dsp-units/version.h>
#include <lsp-plug.in/dsp-units/iface/IStateDumper.h>

namespace lsp
{
    namespace dspu
    {
        enum random_function_t
        {
            RND_LINEAR,     // Uniform over [0, 1)
            RND_EXP,        // Decaying exponential over [0, 1]
            RND_TRIANGLE,   // Triangle over [0, 1]
            RND_GAUSSIAN,   // Gaussian of mean 0 and standard deviation 1 (has negative values)
            RND_MAX
        };

        class LSP_DSP_UNITS_PUBLIC Randomizer
        {
            private:
                Randomizer &operator = (const Randomizer &);
                Randomizer(const Randomizer &);

            private:
                static const uint32_t vMul1[];
                static const uint32_t vMul2[];
                static const uint32_t vAdders[];

                typedef struct randgen_t
                {
                    uint32_t    vLast;
                    uint32_t    vMul1;
                    uint32_t    vMul2;
                    uint32_t    vAdd;
                } randgen_t;

                randgen_t   vRandom[4];
                size_t      nBufID;
                
			protected:
                float generate_linear();

            public:
                explicit Randomizer();
                ~Randomizer();

                /**
                 * Construct the randomizer
                 */
                void construct();

                /**
                 * Destroy the randomizer
                 */
                void destroy();

                /** Initialize random generator
                 *
                 * @param seed seed
                 */
                void init(uint32_t seed);

                /** Initialize random generator, take current time as seed
                 */
                void init();

            public:
                /** Generate float random number in range of [0..1) - excluding 1.0f
                 * The guaranteed tolerance is 1e-6 or 0.000001
                 *
                 * @param func function
                 * @return random number
                 */
                float random(random_function_t func = RND_LINEAR);

                /**
                 * Dump the state
                 * @param dumper dumper
                 */
                void dump(IStateDumper *v) const;
        };
    }
} /* namespace lsp */

#endif /* LSP_PLUG_IN_DSP_UNITS_UTIL_RANDOMIZER_H_ */