ColorTemperatureStrategy.h 3.21 KB
/**
    \file ColorTemperatureStrategy.h
    Copyright Notice\n
    Copyright (C) 2017  Jan Rogall		- developer\n
    Copyright (C) 2017  Moritz Wirger	- developer\n

    This file is part of hueplusplus.

    hueplusplus is free software: you can redistribute it and/or modify
    it under the terms of the GNU Lesser General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    hueplusplus is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public License
    along with hueplusplus.  If not, see <http://www.gnu.org/licenses/>.
**/

#ifndef _COLOR_TEMPERATURE_STRATEGY_H
#define _COLOR_TEMPERATURE_STRATEGY_H

#include <stdint.h>

namespace hueplusplus
{
    class HueLight;

    //! Virtual base class for all ColorTemperatureStrategies
    class ColorTemperatureStrategy
    {
    public:
        //! \brief Virtual function for changing a lights color temperature in mired
        //! with a specified transition.
        //!
        //! The color temperature in mired ranges from 153 to 500 whereas 153 is cold
        //! and 500 is warm. \param mired The color temperature in mired \param
        //! transition The time it takes to fade to the new color in multiples of
        //! 100ms, 4 = 400ms and should be seen as the default \param light A
        //! reference of the light
        virtual bool setColorTemperature(unsigned int mired, uint8_t transition, HueLight& light) const = 0;
        //! \brief Virtual function that lets the light perform one breath cycle in
        //! the specified color.
        //!
        //! The color temperature in mired ranges from 153 to 500 whereas 153 is cold
        //! and 500 is warm. \param mired The color temperature in mired \param light
        //! A reference of the light
        virtual bool alertTemperature(unsigned int mired, HueLight& light) const = 0;
        //! \brief Virtual function that returns the current color temperature of the
        //! light
        //!
        //! Should update the lights state by calling refreshState()
        //! The color temperature in mired ranges from 153 to 500 whereas 153 is cold
        //! and 500 is warm. \param light A reference of the light \return Unsigned
        //! int representing the color temperature in mired
        virtual unsigned int getColorTemperature(HueLight& light) const = 0;
        //! \brief Virtual function that returns the current color temperature of the
        //! light
        //!
        //! The color temperature in mired ranges from 153 to 500 whereas 153 is cold
        //! and 500 is warm. \note This should not update the lights state \param
        //! light A const reference of the light \return Unsigned int representing the
        //! color temperature in mired
        virtual unsigned int getColorTemperature(const HueLight& light) const = 0;
        //! \brief Virtual dtor
        virtual ~ColorTemperatureStrategy() = default;
    };
} // namespace hueplusplus

#endif