Button.h

Go to the documentation of this file.

// Copyright (c) 2025 Dave R. Smith.
// Malena Framework — Licensed under PolyForm Noncommercial 1.0.0; commercial use requires a paid license. See LICENSE.
 
#ifndef MALENA_BUTTON_H
#define MALENA_BUTTON_H
 
#pragma once
 
#include <Malena/Core/malena_export.h>
#include <SFML/Graphics/Text.hpp>
#include <Malena/Core/Core.h>
#include <Malena/Resources/FontManager.h>
#include <Malena/Traits/Theme/Themeable.h>
#include <Malena/Traits/Theme/ButtonTheme.h>
#include <string>
#include <optional>
namespace ml
{
    template<typename T, typename S>
    class Button : public T, public Themeable
    {
        static_assert(std::is_base_of_v<Core, T>,
            "Button<T, S>: T must be derived from ml::Core.");
 
        sf::Text _text;
 
    public:
        Button(const sf::Font& font = FontManager<>::getDefault(),
               std::optional<S> buttonSize = std::nullopt,
               const std::string& text = "",
               unsigned int charSize = 30);

        void setPosition(const sf::Vector2f& position) override;
 
        // ── Label text ───────────────────────────────────────────────────────

        void setString(const sf::String& text);

        [[nodiscard]] const sf::String& getString() const;

        void setCharacterSize(unsigned int size);

        [[nodiscard]] unsigned int getCharacterSize() const;

        void setFont(const sf::Font& font);

        void setFont(const sf::Font&& font) = delete;

        [[nodiscard]] const sf::Font& getFont() const;
 
        // ── Label styling ─────────────────────────────────────────────────────

        void setTextColor(const sf::Color& color);

        [[nodiscard]] sf::Color getTextColor() const;

        void setTextOutlineColor(const sf::Color& color);

        [[nodiscard]] sf::Color getTextOutlineColor() const;

        void setTextOutlineThickness(float thickness);

        [[nodiscard]] float getTextOutlineThickness() const;

        void setLetterSpacing(float spacingFactor);

        [[nodiscard]] float getLetterSpacing() const;

        void setLineSpacing(float spacingFactor);

        [[nodiscard]] float getLineSpacing() const;

        void setStyle(std::uint32_t style);

        [[nodiscard]] std::uint32_t getStyle() const;

        [[nodiscard]] sf::Vector2f findCharacterPos(std::size_t index) const;
 
        // ── Transform ────────────────────────────────────────────────────────

        void setScale(sf::Vector2f scale);

        void scale(sf::Vector2f scale);

        void move(sf::Vector2f offset);

        void rotate(sf::Angle angle);

        void setRotation(sf::Angle angle);
 
        // ── Themeable ─────────────────────────────────────────────────────────

        void onThemeApplied(const Theme& theme) override;
 
        // ── Draw ─────────────────────────────────────────────────────────────

        void draw(sf::RenderTarget& target, sf::RenderStates states) const override;
 
        // ── Forwarded from T ─────────────────────────────────────────────────
        using T::getPosition;
        using T::setFillColor;
        using T::setOutlineColor;
        using T::setOutlineThickness;
        using T::getGlobalBounds;
        using T::getLocalBounds;
        using T::getOrigin;
        using T::getTransform;
        using T::getInverseTransform;
        using T::setOrigin;
        using T::getGeometricCenter;
        using T::getPoint;
        using T::getPointCount;
    };
 
} // namespace ml
 
#include "../../../../src/Graphics/Base/Button.tpp"
#endif // MALENA_BUTTON_H