add() [1/9]

FL_MAYBE_UNUSED fl::shared_ptr< fl::audio::Processor > CFastLED::add ( const fl::audio::Config & config )

static

Add an audio input and return an auto-pumped Processor.

Creates an audio input from the given config and sets up a scheduler task that automatically reads samples and feeds them to the Processor during FastLED.show(). The returned processor can be used to register event callbacks (onBeat, onVocalStart, etc.) without manual update() calls.

On platforms without audio hardware support, returns a no-op Processor (callbacks will never fire but the returned pointer is valid).

Parameters

config

Audio hardware configuration (e.g., Config::CreateInmp441(...))

Returns

shared_ptr to Processor, or nullptr on failure

Example:

auto config = fl::audio::Config::CreateInmp441(WS, SD, CLK, fl::Both);
auto audio = FastLED.add(config);
audio->setGain(2.0f);  // Optional: amplify input
audio->onBeat([]{ /* pulse leds */ });

Definition at line 948 of file FastLED.cpp.hpp.

                                                                                     {
    return fl::audio::AudioManager::instance().add(config);
}

References fl::audio::AudioManager::add(), FL_NO_EXCEPT, and fl::audio::AudioManager::instance().

Here is the call graph for this function: