What is HART?

HART_TEST_WITH_TAGS ("My Test Name", "[my][test][tags]")

{

    // Create effect automation

    const auto myEnvelopeCurve = SegmentedEnvelope (-10_dB)

        .hold (5_ms)

        .rampTo (0_dB, 25_ms, SegmentedEnvelope::Shape::sCurve)

        .hold (5_ms)

        .rampTo (-10_dB, 35_ms, SegmentedEnvelope::Shape::linear);


    // Play wav file through your effect and test the output

    processAudioWith (MyEffect().withEnvelope (GainLinear::someAutomatedParam, myEnvelopeCurve))

        .withLabel ("Pre-recorded wav test")

        .withInputSignal (WavFile ("my_test_input.wav"))

        .withSampleRate (48000_Hz)

        .withBlockSize (2048)

        .withValue (MyEffect::someOtherParam, -oo_dB)

        .withValue (MyEffect::andAnotherParam, 3.5_kHz)

        .withDuration (75_ms)

        .assertTrue (PeaksBelow (-1_dB))

        .expectTrue (EqualsTo (WavFile ("my_test_reference_output.wav")))

        .process();


    // Create test signal instead of using pre-rendered wav

    const auto myTestSignal = SineWave (2.2_kHz) >> GainDb().withEnvelope (GainDb::gainDb, SegmentedEnvelope) >> HardClip (-3_dB) >> HPF (100_Hz);


    // Play generated signal through your effect, save input and output audio if fails

    processAudioWith (MyEffect())

        .withLabel ("Generated signal test")

        .withValue (MyEffect::someParam, 67_percent)

        .inStereo()

        .withInputSignal (myTestSignal)

        .saveInputTo ("my_failed_test_input.wav")

        .saveOutputTo ("my_failed_test_output.wav")

        .expectTrue (PeaksAt (-3_dB))

        .expectFalse (equalsTo (SineWave (2.2_kHz) >> HardClip (-3_dB) >> GainDb (+1_dB)))

        .process();


    // Traditional unit test assertions are also supported

    HART_ASSERT_TRUE (MyEffect().isAwesome());

    HART_EXPECT_TRUE (someValue == someOtherValue);

}

hart::DSPFunction::process
void process(const AudioBuffer< SampleType > &input, AudioBuffer< SampleType > &output, const EnvelopeBuffers &, ChannelFlags) override
Processes the audio.
Definition hart_dsp_function.hpp:172

hart::DSP::withEnvelope
Derived & withEnvelope(int paramId, Envelope &&envelope) &
Adds envelope to a specific parameter by moving it.
Definition hart_dsp.hpp:352

HART_ASSERT_TRUE
#define HART_ASSERT_TRUE(condition)
Use to check some condition inside a test case. Failing will abort the test runner.
Definition hart.hpp:39

HART_EXPECT_TRUE
#define HART_EXPECT_TRUE(condition)
Use to check some condition inside a test case. Failing will not abort the test runner.
Definition hart.hpp:46

HART_TEST_WITH_TAGS
#define HART_TEST_WITH_TAGS(name, tags)
Declares a test case with tags.
Definition hart.hpp:70

oo_dB
constexpr double oo_dB
Definition hart_units.hpp:13