graphics.hpp

// SPDX-License-Identifier: LGPL-2.1-or-later OR BSD-3-Clause
// SPDX-FileCopyrightText: 2004 - 2008 Olof Naessén and Per Larsson
// SPDX-FileCopyrightText: 2013 - 2026 Fifengine contributors
 
#ifndef INCLUDE_FIFECHAN_GRAPHICS_HPP_
#define INCLUDE_FIFECHAN_GRAPHICS_HPP_
 
// Standard library includes
#include <cstdint>
#include <iosfwd>
#include <memory>
#include <stack>
#include <string>
 
// Project headers (subdirs before local)
#include "fifechan/cliprectangle.hpp"
#include "fifechan/point.hpp"
 
namespace fcn
{
    class Color;
    class Font;
    class Image;

    class FIFEGUI_API Graphics
    {
        public:
            enum class Alignment : uint8_t
            {
                Left = 0,
                Center,
                Right
            };

            enum class VerticalAlignment : uint8_t
            {
                Top = 0,
                Center,
                Bottom
            };
 
            Graphics() = default;
 
            virtual ~Graphics() = default;
 
            Graphics(Graphics const &)            = delete;
            Graphics& operator=(Graphics const &) = delete;
            Graphics(Graphics&&)                  = delete;
            Graphics& operator=(Graphics&&)       = delete;

            virtual void _beginDraw()
            {
            }

            virtual void _endDraw()
            {
            }

            virtual bool pushClipArea(Rectangle area);

            virtual void popClipArea();

            virtual ClipRectangle const & getCurrentClipArea();

            virtual void drawImage(
                Image const * image, int srcX, int srcY, int dstX, int dstY, int width, int height) = 0;

            virtual void drawImage(Image const * image, int dstX, int dstY);

            virtual void drawPoint(int x, int y) = 0;

            virtual void drawLine(int x1, int y1, int x2, int y2) = 0;

            virtual void drawLine(int x1, int y1, int x2, int y2, unsigned int width) = 0;

            virtual void drawRoundStroke(int x1, int y1, int x2, int y2, unsigned int width)
            {
                drawLine(x1, y1, x2, y2, width);
            }

            virtual void drawPolyLine(PointVector const & points, unsigned int width) = 0;

            virtual void drawBezier(PointVector const & points, int steps, unsigned int width) = 0;

            virtual void drawRectangle(Rectangle const & rectangle) = 0;

            void drawRectangle(int x, int y, int width, int height)
            {
                drawRectangle(Rectangle(x, y, width, height));
            }

            virtual void fillRectangle(Rectangle const & rectangle) = 0;

            void fillRectangle(int x, int y, int width, int height)
            {
                fillRectangle(Rectangle(x, y, width, height));
            }

            virtual void drawCircle(Point const & p, unsigned int radius) = 0;

            virtual void drawFillCircle(Point const & p, unsigned int radius) = 0;

            virtual void drawCircleSegment(Point const & p, unsigned int radius, int sangle, int eangle) = 0;

            virtual void drawFillCircleSegment(Point const & p, unsigned int radius, int sangle, int eangle) = 0;

            virtual void setColor(Color const & color) = 0;

            virtual Color const & getColor() const = 0;

            virtual void setFont(Font* font);

            virtual std::shared_ptr<Font> createFont(std::string const & filename, int size);

            void drawText(std::string const & text, int x, int y)
            {
                drawText(text, x, y, Alignment::Left);
            }

            virtual void drawText(std::string const & text, int x, int y, Alignment alignment);
 
        protected:
            std::stack<ClipRectangle> mClipStack;

            Font* mFont{nullptr};
    };
} // namespace fcn
 
#endif // INCLUDE_FIFECHAN_GRAPHICS_HPP_