set_power_scaling_exponent()

void set_power_scaling_exponent

(

float

exponent

)

Set a non-linear brightness-to-power response exponent.

Parameters

exponent

1.0 = linear (default), values below 1.0 model higher-than-linear power draw at mid brightness, values above 1.0 model lower-than-linear draw

Note

Convenience wrapper: equivalent to setting model.exponent and calling set_power_model. Prefer set_power_model(PowerModelRGB{..., e}) to configure channel weights and response in one step.

This only affects power estimation and limiting, not rendered LED brightness.

exponent <= 0 or values within 1e-4 of 1.0 fall back to linear (identity tables) rather than rebuilding with a degenerate curve.

Only enabled on platforms where SKETCH_HAS_LARGE_MEMORY==1. Smaller-memory targets keep the legacy linear behavior and ignore this setting.

Definition at line 999 of file power_mgt.cpp.hpp.

                                                             {
    PowerModelRGB model = gPowerModel();
    model.exponent = exponent;
    // Not `set_power_model`: the exponent is a property of the response
    // curve, and changing it is not a statement about how many emitters the
    // strip has.
    apply_rgb_power_model(model);
}

References apply_rgb_power_model(), PowerModelRGB::exponent, FL_NO_EXCEPT, and gPowerModel().

Referenced by CFastLED::setPowerScalingExponent().

Here is the call graph for this function:

Here is the caller graph for this function: