create() [1/3]

ChannelPtr fl::Channel::create ( const ChannelConfig & config )

static

Create a new channel with optional mBus driver pinning.

Parameters

config

Channel configuration. If config.options.mBus is not Bus::AUTO, the channel pins itself to the driver named by busName(mBus) via ChannelManager::findDriverByName(). On a miss, showPixels() falls back to AUTO/priority dispatch and emits a one-shot FL_ERROR (see channel.cpp.hpp).

Returns

Shared pointer to channel (auto-cleanup when out of scope)

Note

Channels always use ChannelManager by default.

Definition at line 289 of file channel.cpp.hpp.

                                                                   {
    // Late binding strategy: Always create with empty driver
    // Engine binding happens on first showPixels() call:
    // - Affinity channels: Look up by name and cache
    // - Non-affinity channels: Select dynamically each frame
 
    auto channel = fl::make_shared<Channel>(config.chipset, config.mLeds,
                                              config.rgb_order, config.options);
    auto& events = ChannelEvents::instance();
#if FL_COLOR_PROFILE_RUNTIME
    if (channel->reconcileColorProfile(config.options)) {
        events.onColorProfileFallback(
            ColorProfileEvent{channel->id(), channel->colorProfileStatus(), {}});
    }
#endif
    channel->mName = makeName(channel->mId, config.mName);
    events.onChannelCreated(*channel);
    return channel;
}

References fl::FL_NO_EXCEPT, fl::ChannelEvents::instance(), fl::adl_barrier::make_shared(), and makeName().

Referenced by create().

Here is the call graph for this function:

Here is the caller graph for this function: