ESPHome 2025.5.0
Loading...
Searching...
No Matches
light_call.h
Go to the documentation of this file.
1#pragma once
2
5#include <set>
6
7namespace esphome {
8namespace light {
9
10class LightState;
11
14class LightCall {
15 public:
16 explicit LightCall(LightState *parent) : parent_(parent) {}
17
35 LightCall &set_transition_length(uint32_t transition_length);
37 LightCall &set_transition_length_if_supported(uint32_t transition_length);
41 LightCall &set_flash_length(uint32_t flash_length);
45 LightCall &set_brightness(float brightness);
47 LightCall &set_brightness_if_supported(float brightness);
48
55
59 LightCall &set_color_brightness(float brightness);
71 LightCall &set_red(float red);
83 LightCall &set_green(float green);
95 LightCall &set_blue(float blue);
101 LightCall &set_white(float white);
103 LightCall &set_white_if_supported(float white);
107 LightCall &set_color_temperature(float color_temperature);
109 LightCall &set_color_temperature_if_supported(float color_temperature);
113 LightCall &set_cold_white(float cold_white);
115 LightCall &set_cold_white_if_supported(float cold_white);
119 LightCall &set_warm_white(float warm_white);
121 LightCall &set_warm_white_if_supported(float warm_white);
125 LightCall &set_effect(const std::string &effect);
127 LightCall &set_effect(uint32_t effect_number);
130 LightCall &set_publish(bool publish);
132 LightCall &set_save(bool save);
133
143 LightCall &set_rgb(float red, float green, float blue);
154 LightCall &set_rgbw(float red, float green, float blue, float white);
156
157 void perform();
158
159 protected:
162
165
169 std::set<ColorMode> get_suitable_color_modes_();
172
174 bool has_flash_() { return this->flash_length_.has_value(); }
175 bool has_effect_() { return this->effect_.has_value(); }
176
192 bool publish_{true};
193 bool save_{true};
194};
195
196} // namespace light
197} // namespace esphome
This class represents a requested change in a light state.
Definition light_call.h:14
LightCall & set_color_mode_if_supported(ColorMode color_mode)
Set the color mode of the light, if this mode is supported.
optional< float > brightness_
Definition light_call.h:182
optional< float > red_
Definition light_call.h:184
LightCall & set_color_temperature(optional< float > color_temperature)
Set the color temperature of the light in mireds for CWWW or RGBWW lights.
LightCall & set_publish(bool publish)
Set whether this light call should trigger a publish state.
optional< float > white_
Definition light_call.h:187
optional< ColorMode > color_mode_
Definition light_call.h:181
LightCall & set_color_brightness(optional< float > brightness)
Set the color brightness of the light from 0.0 (no color) to 1.0 (fully on)
optional< float > color_brightness_
Definition light_call.h:183
LightCall & set_rgb(float red, float green, float blue)
Set the RGB color of the light by RGB values.
optional< uint32_t > flash_length_
Definition light_call.h:180
LightCall & set_transition_length_if_supported(uint32_t transition_length)
Set the transition length property if the light supports transitions.
LightCall & set_red_if_supported(float red)
Set the red property if the light supports RGB.
optional< float > cold_white_
Definition light_call.h:189
LightCall & set_effect(optional< std::string > effect)
Set the effect of the light by its name.
std::set< ColorMode > get_suitable_color_modes_()
Get potential color modes for this light call.
LightCall & set_color_brightness_if_supported(float brightness)
Set the color brightness property if the light supports RGBW.
LightCall & set_white(optional< float > white)
Set the white value value of the light from 0.0 to 1.0 for RGBW[W] lights.
optional< float > warm_white_
Definition light_call.h:190
LightCall & set_green(optional< float > green)
Set the green RGB value of the light from 0.0 to 1.0.
LightCall(LightState *parent)
Definition light_call.h:16
LightCall & set_green_if_supported(float green)
Set the green property if the light supports RGB.
LightCall & set_warm_white(optional< float > warm_white)
Set the warm white value of the light from 0.0 to 1.0.
LightCall & set_rgbw(float red, float green, float blue, float white)
Set the RGBW color of the light by RGB values.
LightCall & set_save(bool save)
Set whether this light call should trigger a save state to recover them at startup....
LightCall & set_color_temperature_if_supported(float color_temperature)
Set the color_temperature property if the light supports color temperature.
LightCall & set_blue(optional< float > blue)
Set the blue RGB value of the light from 0.0 to 1.0.
LightCall & set_flash_length(optional< uint32_t > flash_length)
Start and set the flash length of this call in milliseconds.
optional< float > blue_
Definition light_call.h:186
LightCall & set_cold_white(optional< float > cold_white)
Set the cold white value of the light from 0.0 to 1.0.
LightCall & set_red(optional< float > red)
Set the red RGB value of the light from 0.0 to 1.0.
ColorMode get_active_color_mode_()
Get the currently targeted, or active if none set, color mode.
optional< float > color_temperature_
Definition light_call.h:188
optional< uint32_t > effect_
Definition light_call.h:191
LightCall & set_white_if_supported(float white)
Set the white property if the light supports RGB.
LightCall & set_cold_white_if_supported(float cold_white)
Set the cold white property if the light supports cold white output.
LightCall & set_warm_white_if_supported(float warm_white)
Set the warm white property if the light supports cold white output.
LightCall & set_brightness_if_supported(float brightness)
Set the brightness property if the light supports brightness.
LightColorValues validate_()
Validate all properties and return the target light color values.
optional< float > green_
Definition light_call.h:185
LightCall & set_brightness(optional< float > brightness)
Set the target brightness of the light from 0.0 (fully off) to 1.0 (fully on)
LightCall & set_blue_if_supported(float blue)
Set the blue property if the light supports RGB.
void transform_parameters_()
Some color modes also can be set using non-native parameters, transform those calls.
LightCall & from_light_color_values(const LightColorValues &values)
LightCall & set_state(optional< bool > state)
Set the binary ON/OFF state of the light.
LightCall & set_color_mode(optional< ColorMode > color_mode)
Set the color mode of the light.
optional< bool > state_
Definition light_call.h:178
optional< uint32_t > transition_length_
Definition light_call.h:179
LightCall & set_transition_length(optional< uint32_t > transition_length)
Set the transition length of this call in milliseconds.
This class represents the color state for a light object.
This class represents the communication layer between the front-end MQTT layer and the hardware outpu...
Definition light_state.h:63
bool has_value() const
Definition optional.h:87
bool state
Definition fan.h:0
ColorMode
Color modes are a combination of color capabilities that can be used at the same time.
Definition color_mode.h:49
Providing packet encoding functions for exchanging data with a remote host.
Definition a01nyub.cpp:7