add() [8/9]

fl::vector< fl::ChannelPtr > CFastLED::add ( fl::span< const fl::ChannelConfig > configs )

static

Add multiple LED channels from a config array.

Creates and registers multiple Channel-based LED controllers from an array of configurations. Returns handles for later inspection, reconfiguration, or removal. FastLED retains its own references until remove(channel) is called for each channel.

Parameters

configs

Span of ChannelConfig objects

Returns

Vector of ChannelPtrs (one per config), or empty elements if unsupported

Note

Supported platforms: ESP32, ESP32-S2, ESP32-S3, ESP32-C3, ESP32-C6, ESP32-P4

Example:

auto timing = fl::makeTimingConfig<fl::TIMING_WS2812_800KHZ>();
fl::ChannelConfig configs[] = {
    fl::ChannelConfig(PIN1, timing, leds1, RGB),
    fl::ChannelConfig(PIN2, timing, leds2, RGB)
};
auto channels = FastLED.add(fl::span<const fl::ChannelConfig>(configs, 2));

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

                                                                                       {
    fl::vector<fl::ChannelPtr> channels;
    channels.reserve(configs.size());
 
    for (const auto& config : configs) {
        channels.push_back(add(config));
    }
 
    return channels;
}

References add(), channels(), and FL_NO_EXCEPT.

Here is the call graph for this function: