Loading [MathJax]/extensions/tex2jax.js
CTRE Phoenix 6 C++ 25.4.0
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
ctre::phoenix6::controls::RainbowAnimation Class Reference

Animation that creates a rainbow throughout all the LEDs. More...

#include <ctre/phoenix6/controls/RainbowAnimation.hpp>

Inheritance diagram for ctre::phoenix6::controls::RainbowAnimation:
ctre::phoenix6::controls::ControlRequest

Public Member Functions

 RainbowAnimation (int LEDStartIndex, int LEDEndIndex)
 Animation that creates a rainbow throughout all the LEDs.
 
RainbowAnimationWithLEDStartIndex (int newLEDStartIndex)
 Modifies this Control Request's LEDStartIndex parameter and returns itself for method-chaining and easier to use request API.
 
RainbowAnimationWithLEDEndIndex (int newLEDEndIndex)
 Modifies this Control Request's LEDEndIndex parameter and returns itself for method-chaining and easier to use request API.
 
RainbowAnimationWithSlot (int newSlot)
 Modifies this Control Request's Slot parameter and returns itself for method-chaining and easier to use request API.
 
RainbowAnimationWithBrightness (units::dimensionless::scalar_t newBrightness)
 Modifies this Control Request's Brightness parameter and returns itself for method-chaining and easier to use request API.
 
RainbowAnimationWithDirection (signals::AnimationDirectionValue newDirection)
 Modifies this Control Request's Direction parameter and returns itself for method-chaining and easier to use request API.
 
RainbowAnimationWithFrameRate (units::frequency::hertz_t newFrameRate)
 Modifies this Control Request's FrameRate parameter and returns itself for method-chaining and easier to use request API.
 
RainbowAnimationWithUpdateFreqHz (units::frequency::hertz_t newUpdateFreqHz)
 Sets the period at which this control will update at.
 
std::string ToString () const override
 Returns a string representation of the object.
 
std::map< std::string, std::string > GetControlInfo () const override
 Gets information about this control request.
 
- Public Member Functions inherited from ctre::phoenix6::controls::ControlRequest
 ControlRequest (std::string name)
 Constructs a new Control Request with the given name.
 
std::string const & GetName () const
 
virtual ~ControlRequest ()=default
 

Public Attributes

int LEDStartIndex
 The index of the first LED this animation controls (inclusive).
 
int LEDEndIndex
 The index of the last LED this animation controls (inclusive).
 
int Slot = 0
 The slot of this animation, within [0, 7].
 
units::dimensionless::scalar_t Brightness = 1.0
 The brightness of the animation, as a scalar from 0.0 to 1.0.
 
signals::AnimationDirectionValue Direction = signals::AnimationDirectionValue::Forward
 The direction of the animation.
 
units::frequency::hertz_t FrameRate = 100_Hz
 The frame rate of the animation, from [2, 1000] Hz.
 
units::frequency::hertz_t UpdateFreqHz {20_Hz}
 The period at which this control will update at.
 

Additional Inherited Members

- Protected Member Functions inherited from ctre::phoenix6::controls::ControlRequest
 ControlRequest (ControlRequest const &)=default
 
 ControlRequest (ControlRequest &&)=default
 
ControlRequestoperator= (ControlRequest const &)=default
 
ControlRequestoperator= (ControlRequest &&)=default
 
- Protected Attributes inherited from ctre::phoenix6::controls::ControlRequest
std::string name
 

Detailed Description

Animation that creates a rainbow throughout all the LEDs.

Constructor & Destructor Documentation

◆ RainbowAnimation()

ctre::phoenix6::controls::RainbowAnimation::RainbowAnimation ( int LEDStartIndex,
int LEDEndIndex )
inline

Animation that creates a rainbow throughout all the LEDs.

Parameters
LEDStartIndexThe index of the first LED this animation controls (inclusive). Indices 0-7 control the onboard LEDs, and 8-399 control an attached LED strip

If the start index is greater than the end index, the direction will be reversed. The direction can also be changed using the Direction parameter.

Parameters
LEDEndIndexThe index of the last LED this animation controls (inclusive). Indices 0-7 control the onboard LEDs, and 8-399 control an attached LED strip.

If the end index is less than the start index, the direction will be reversed. The direction can also be changed using the Direction parameter.

Member Function Documentation

◆ GetControlInfo()

std::map< std::string, std::string > ctre::phoenix6::controls::RainbowAnimation::GetControlInfo ( ) const
inlineoverridevirtual

Gets information about this control request.

Returns
Map of control parameter names and corresponding applied values

Implements ctre::phoenix6::controls::ControlRequest.

◆ ToString()

std::string ctre::phoenix6::controls::RainbowAnimation::ToString ( ) const
inlineoverridevirtual

Returns a string representation of the object.

Returns
a string representation of the object.

Implements ctre::phoenix6::controls::ControlRequest.

◆ WithBrightness()

RainbowAnimation & ctre::phoenix6::controls::RainbowAnimation::WithBrightness ( units::dimensionless::scalar_t newBrightness)
inline

Modifies this Control Request's Brightness parameter and returns itself for method-chaining and easier to use request API.

The brightness of the animation, as a scalar from 0.0 to 1.0.

Parameters
newBrightnessParameter to modify
Returns
Itself

◆ WithDirection()

RainbowAnimation & ctre::phoenix6::controls::RainbowAnimation::WithDirection ( signals::AnimationDirectionValue newDirection)
inline

Modifies this Control Request's Direction parameter and returns itself for method-chaining and easier to use request API.

The direction of the animation.

Parameters
newDirectionParameter to modify
Returns
Itself

◆ WithFrameRate()

RainbowAnimation & ctre::phoenix6::controls::RainbowAnimation::WithFrameRate ( units::frequency::hertz_t newFrameRate)
inline

Modifies this Control Request's FrameRate parameter and returns itself for method-chaining and easier to use request API.

The frame rate of the animation, from [2, 1000] Hz. This determines the speed of the animation.

A frame is defined as a transition in the state of the LEDs, advancing the rainbow by about 3 degrees of hue (out of 360 degrees).

  • Units: Hz
Parameters
newFrameRateParameter to modify
Returns
Itself

◆ WithLEDEndIndex()

RainbowAnimation & ctre::phoenix6::controls::RainbowAnimation::WithLEDEndIndex ( int newLEDEndIndex)
inline

Modifies this Control Request's LEDEndIndex parameter and returns itself for method-chaining and easier to use request API.

The index of the last LED this animation controls (inclusive). Indices 0-7 control the onboard LEDs, and 8-399 control an attached LED strip.

If the end index is less than the start index, the direction will be reversed. The direction can also be changed using the Direction parameter.

Parameters
newLEDEndIndexParameter to modify
Returns
Itself

◆ WithLEDStartIndex()

RainbowAnimation & ctre::phoenix6::controls::RainbowAnimation::WithLEDStartIndex ( int newLEDStartIndex)
inline

Modifies this Control Request's LEDStartIndex parameter and returns itself for method-chaining and easier to use request API.

The index of the first LED this animation controls (inclusive). Indices 0-7 control the onboard LEDs, and 8-399 control an attached LED strip

If the start index is greater than the end index, the direction will be reversed. The direction can also be changed using the Direction parameter.

Parameters
newLEDStartIndexParameter to modify
Returns
Itself

◆ WithSlot()

RainbowAnimation & ctre::phoenix6::controls::RainbowAnimation::WithSlot ( int newSlot)
inline

Modifies this Control Request's Slot parameter and returns itself for method-chaining and easier to use request API.

The slot of this animation, within [0, 7]. Each slot on the CANdle can store and run one animation.

Parameters
newSlotParameter to modify
Returns
Itself

◆ WithUpdateFreqHz()

RainbowAnimation & ctre::phoenix6::controls::RainbowAnimation::WithUpdateFreqHz ( units::frequency::hertz_t newUpdateFreqHz)
inline

Sets the period at which this control will update at.

This is designated in Hertz, with a minimum of 20 Hz (every 50 ms) and a maximum of 1000 Hz (every 1 ms).

If this field is set to 0 Hz, the control request will be sent immediately as a one-shot frame. This may be useful for advanced applications that require outputs to be synchronized with data acquisition. In this case, we recommend not exceeding 50 ms between control calls.

Parameters
newUpdateFreqHzParameter to modify
Returns
Itself

Member Data Documentation

◆ Brightness

units::dimensionless::scalar_t ctre::phoenix6::controls::RainbowAnimation::Brightness = 1.0

The brightness of the animation, as a scalar from 0.0 to 1.0.

◆ Direction

signals::AnimationDirectionValue ctre::phoenix6::controls::RainbowAnimation::Direction = signals::AnimationDirectionValue::Forward

The direction of the animation.

◆ FrameRate

units::frequency::hertz_t ctre::phoenix6::controls::RainbowAnimation::FrameRate = 100_Hz

The frame rate of the animation, from [2, 1000] Hz.

This determines the speed of the animation.

A frame is defined as a transition in the state of the LEDs, advancing the rainbow by about 3 degrees of hue (out of 360 degrees).

  • Units: Hz

◆ LEDEndIndex

int ctre::phoenix6::controls::RainbowAnimation::LEDEndIndex

The index of the last LED this animation controls (inclusive).

Indices 0-7 control the onboard LEDs, and 8-399 control an attached LED strip.

If the end index is less than the start index, the direction will be reversed. The direction can also be changed using the Direction parameter.

◆ LEDStartIndex

int ctre::phoenix6::controls::RainbowAnimation::LEDStartIndex

The index of the first LED this animation controls (inclusive).

Indices 0-7 control the onboard LEDs, and 8-399 control an attached LED strip

If the start index is greater than the end index, the direction will be reversed. The direction can also be changed using the Direction parameter.

◆ Slot

int ctre::phoenix6::controls::RainbowAnimation::Slot = 0

The slot of this animation, within [0, 7].

Each slot on the CANdle can store and run one animation.

◆ UpdateFreqHz

units::frequency::hertz_t ctre::phoenix6::controls::RainbowAnimation::UpdateFreqHz {20_Hz}

The period at which this control will update at.

This is designated in Hertz, with a minimum of 20 Hz (every 50 ms) and a maximum of 1000 Hz (every 1 ms).

If this field is set to 0 Hz, the control request will be sent immediately as a one-shot frame. This may be useful for advanced applications that require outputs to be synchronized with data acquisition. In this case, we recommend not exceeding 50 ms between control calls.


The documentation for this class was generated from the following file: