Chesto::Button Class Reference

Inheritance diagram for Chesto::Button:

Collaboration diagram for Chesto::Button:

Public Member Functions
	Button (std::string text, int button, bool dark=false, int size=20, int width=0)
void	render (Element *parent)
	display the current state of the display More...
bool	process (InputEvents *event)
	process any input that is received for this element More...
void	updateBounds ()
void	updateText (const std::string &inc_text)
const std::string	getText ()
Public Member Functions inherited from Chesto::Element
virtual bool	process (InputEvents *event)
	process any input that is received for this element More...
virtual void	render (Element *parent)
	display the current state of the display More...
bool	onTouchDown (InputEvents *event)
bool	onTouchDrag (InputEvents *event)
bool	onTouchUp (InputEvents *event)
void	hide ()
void	unhide ()
void	renderBackground (bool fill=true)
void	addNode (std::unique_ptr< Element > node)
void	remove (Element *element)
void	removeAll ()
void	position (int x, int y)
	position the element More...
void	recalcPosition (Element *parent)
float	getEffectiveScale () const
CST_Rect	getBounds ()
CST_Renderer *	getRenderer ()
Element *	setPosition (int x, int y)
Element *	setAction (std::function< void()> func)
Element *	setAbsolute (bool isAbs)
template<typename T , typename... Args>
T *	createNode (Args &&... args)
Element *	constrain (int flags, int padding=0)
Element *	constrainToTarget (Element *target, int flags, int padding=0)
Element *	animate (int durationIn, std::function< void(float)> onStep, std::function< void()> onFinish)
Element *	moveToFront ()
Element *	setTouchable (bool touchable)
void	screenshot (std::string path)
	Take a screenshot of this element and its children, and save it to the given path. More...

Static Public Member Functions
static std::string	getControllerButtonImageForPlatform (int button, bool isGray, bool isOutline)

Public Attributes
std::string	myLastSeenGamepad = ""
TextElement	text
int	fixedWidth = 0
bool	dark = false
Public Attributes inherited from Chesto::Element
std::function< void()>	action = NULL
	the action to call (from binded callback) on touch or button selection https://stackoverflow.com/questions/14189440/c-class-member-callback-simple-examples More...
std::function< void(InputEvents *event)>	actionWithEvents = NULL
std::vector< std::unique_ptr< Element, std::function< void(Element *)> > >	elements
	visible GUI child elements of this element More...
float	scale = 1.0f
bool	touchable = false
	whether or not this element can be touched (highlights bounds) More...
bool	dragging = false
	whether or not this element is currently being dragged More...
bool	needsRedraw = false
	whether or not this element needs the screen redrawn next time it's processed More...
int	futureRedrawCounter = 0
	whether this element needs a redraw for the next X redraws (decreases each time) (0 is no redraws) More...
int	lastMouseY = 0
	the last Y, X coordinate of the mouse (from a drag probably) More...
int	lastMouseX = 0
bool	hasBackground = false
rgb	backgroundColor = {0, 0, 0}
int	backgroundOpacity = 0xff
bool	isAbsolute = false
Element *	parent = nullptr
	the parent element (reference only, not owned) More...
bool	hidden = false
	whether this element should skip rendering or not More...
bool	isProtected = false
int	elasticCounter = 0
	how much time is left in an elastic-type flick/scroll set by the last distance traveled in a scroll, and counts down every frame More...
int	width = 0
	width and height of this element (must be manually set, isn't usually calculated (but is in some cases, like text or images)) More...
int	height = 0
int	x = 0
int	y = 0
int	xAbs = 0
int	yAbs = 0
double	angle = 0
	rotation angle in degrees More...
int	cornerRadius = 0
int	tag = 0
std::vector< std::unique_ptr< Constraint > >	constraints
std::vector< std::unique_ptr< Animation > >	animations
bool	useColorMask = false
	whether or not to overlay a color mask on top of this element More...
CST_Color	maskColor = {0,0,0,0}
	The color to overlay on top. More...

Additional Inherited Members
Public Types inherited from Chesto::Element
typedef Element	super
Protected Member Functions inherited from Chesto::Element
void	addStackMember (Element *element)

Detailed Description

Definition at line 8 of file Button.hpp.

Constructor & Destructor Documentation

Button()

Chesto::Button::Button	(	std::string	text,
		int	button,
		bool	dark = false,
		int	size = 20,
		int	width = 0
	)

Definition at line 11 of file Button.cpp.

    : text(message, size, &colors[dark])
    , dark(dark)
    , physical(button)
    , icon(getControllerButtonImageForPlatform(button, !dark, false))
{
 
    super::addStackMember(&text);
    super::addStackMember(&icon);
 
    // on initialization, store the last gamepad info
    myLastSeenGamepad = "";
 
    icon.resize(text.height*1.5, text.height*1.5);
    
    if (shouldRenderGlossy()) {
        icon.hide();
    }
 
    fixedWidth = width;
 
    updateBounds();
 
    this->touchable = true;
    this->hasBackground = true;
}

Member Function Documentation

getControllerButtonImageForPlatform()

std::string Chesto::Button::getControllerButtonImageForPlatform ( int  button, bool  isGray, bool  isOutline  )

static

Definition at line 83 of file Button.cpp.

{
    // grab the current gamepad info
    GamepadInfo& gamepad = InputEvents::getLastGamepadInfo();
 
    // find the button index in the gamepad.buttons array
    // TODO: use a hashmap instead of an array
    unsigned int button = buttonInc;
    if (gamepad.buttons != nullptr) {
        for (int i = 0; i < TOTAL_BUTTONS; i++)
        {
            if (gamepad.buttons[i] == button)
            {
                auto outlineSuffix = isOutline ? "_outline" : "";
                auto graySuffix = isGray ? "_gray" : "";
                auto retVal = RAMFS "res/controllers/buttons/" + gamepad.prefix + "_" + gamepad.names[i] + outlineSuffix + graySuffix + ".svg";
                return retVal;
            }
        }
    }
    // if we didn't find it, return an empty string
    printf("Button %d not found in gamepad, returning empty string\n", button);
    return "";
}

getText()

const std::string Chesto::Button::getText

(

)

Definition at line 188 of file Button.cpp.

{
    return this->text.text;
}

process()

bool Chesto::Button::process ( InputEvents *  event )

virtual

process any input that is received for this element

Reimplemented from Chesto::Element.

Reimplemented in Chesto::DropDown.

Definition at line 155 of file Button.cpp.

{
    if (event->isKeyDown() && this->physical != 0 && event->held(this->physical))
    {
        // invoke our action, since we saw a physical button press that matches!
        this->action();
        return true;
    }
 
    bool ret = false;
 
    // if the last gamepad is different from the current one, update the button image
    if (myLastSeenGamepad != InputEvents::lastGamepadKey || needsRedraw)
    {
        needsRedraw = false;
        if (shouldRenderGlossy()) {
            icon.hide();
            hasBackground = false; // we'll handle our own two-toned and outlined background drawing
            cornerRadius = fmin(25, height / 4); // bound the corner radius to the height of our darker highlight
        } else {
            auto newPath = getControllerButtonImageForPlatform(this->physical, !dark, false);
            icon.unhide();
            hasBackground = true;
            icon.loadPath(newPath);
            icon.resize(text.height*1.5, text.height*1.5);
        }
        myLastSeenGamepad = InputEvents::lastGamepadKey;
    }
 
    bool parentHandled = super::process(event);
    return parentHandled || ret;
}

References Chesto::InputEvents::held().

render()

void Chesto::Button::render ( Element *  parent )

virtual

display the current state of the display

Reimplemented from Chesto::Element.

Definition at line 108 of file Button.cpp.

{
    if (hidden) return;
 
    CST_SetDrawBlend(RootDisplay::renderer, true);
 
    this->recalcPosition(parent);
 
    if (shouldRenderGlossy()) {
        // draw a glossy button
        auto r = backgroundColor.r * 0xff;
        auto g = backgroundColor.g * 0xff;
        auto b = backgroundColor.b * 0xff;
 
        CST_roundedBoxRGBA(
            RootDisplay::renderer,
            xAbs, yAbs, xAbs + width, yAbs + height, cornerRadius,
            r, g, b, 0xff
        );
        // slightly darker overlay for the second half of the button
        auto darkenOffset = dark ? 0x10 : 0x00; // use a deeper color for dark buttons
        CST_roundedBoxRGBA(
            RootDisplay::renderer,
            xAbs, yAbs + height / 2, xAbs + width, yAbs + height, cornerRadius,
            0x00, 0x00, 0x00, 0x15 + darkenOffset
        );
        // inner white outline around the whole thing
        auto p = 0.5;
        CST_roundedRectangleRGBA(
            RootDisplay::renderer,
            xAbs+2*p, yAbs+2*p, xAbs + width - p, yAbs + height - p, cornerRadius,
            0xff, 0xff, 0xff, 0x40
        );
        // thicker outer gray outline
        CST_roundedRectangleRGBA(
            RootDisplay::renderer,
            xAbs, yAbs, xAbs + width, yAbs + height, cornerRadius,
            0x00, 0x00, 0x00, 0x80
        );
    }
 
    // render text/icon and bg if needed
    super::render(parent);
 
    CST_SetDrawBlend(RootDisplay::renderer, false);
}

updateBounds()

void Chesto::Button::updateBounds

(

)

Definition at line 38 of file Button.cpp.

{
    float effectiveScale = getEffectiveScale();
    int PADDING = (int)(10 * effectiveScale);
 
    int bWidth = PADDING * 0.5 * (icon.width != 0); // gap space between button
    
    if (shouldRenderGlossy()) {
        icon.position(0, 0); // the icon is the overlay, same size as the button
    } else {
        // make room for the button label, if we have a button
        text.position(PADDING * 2 + bWidth + icon.width, PADDING);
        icon.position(PADDING * 1.7, PADDING + (text.height - icon.height) / 2);
    }
 
    this->width = (fixedWidth > 0) ? fixedWidth : text.width + PADDING * 4 + bWidth + (icon.hidden ? 0 : icon.width);
    this->height = text.height + PADDING * 2;
 
    if (shouldRenderGlossy()) {
        text.position(width / 2 - text.width / 2, PADDING); // y is already centered
    }
 
    // update the bg color here too
    if (dark)
    {
        backgroundColor = RootDisplay::mainDisplay->backgroundColor;
        backgroundColor.r += 0x25/255.0;
        backgroundColor.g += 0x25/255.0;
        backgroundColor.b += 0x25/255.0;
        // backgroundColor.r = fmin(backgroundColor.r, 1.0);
    }
    else
        backgroundColor = (rgb){ 0xee/255.0, 0xee/255.0, 0xee/255.0 };
    
    text.setColor(colors[dark]);
    text.update();
}

updateText()

void Chesto::Button::updateText

(

const std::string &

inc_text

)

Definition at line 76 of file Button.cpp.

{
    this->text.setText(inc_text);
    this->text.update();
    updateBounds();
}

Member Data Documentation

dark

bool Chesto::Button::dark = false

Definition at line 29 of file Button.hpp.

fixedWidth

int Chesto::Button::fixedWidth = 0

Definition at line 26 of file Button.hpp.

myLastSeenGamepad

std::string Chesto::Button::myLastSeenGamepad = ""

Definition at line 20 of file Button.hpp.

text

TextElement Chesto::Button::text

Definition at line 22 of file Button.hpp.

---

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

• src/Button.hpp
• src/Button.cpp