mirror of
https://github.com/vcmi/vcmi.git
synced 2024-12-14 10:12:59 +02:00
123 lines
4.2 KiB
C++
123 lines
4.2 KiB
C++
/*
|
|
* Canvas.h, part of VCMI engine
|
|
*
|
|
* Authors: listed in file AUTHORS in main folder
|
|
*
|
|
* License: GNU General Public License v2.0 or later
|
|
* Full text of license available in license.txt file, in main folder
|
|
*
|
|
*/
|
|
#pragma once
|
|
|
|
#include "../gui/TextAlignment.h"
|
|
#include "../../lib/Rect.h"
|
|
#include "../../lib/Color.h"
|
|
|
|
struct SDL_Surface;
|
|
class IImage;
|
|
enum EFonts : int8_t;
|
|
|
|
enum class CanvasScalingPolicy
|
|
{
|
|
AUTO, // automatically scale canvas operations by global scaling factor
|
|
IGNORE // disable any scaling processing. Scaling factor will be set to 1
|
|
|
|
};
|
|
|
|
/// Class that represents surface for drawing on
|
|
class Canvas
|
|
{
|
|
/// Upscaler awareness. Must be first member for initialization
|
|
CanvasScalingPolicy scalingPolicy;
|
|
|
|
/// Target surface
|
|
SDL_Surface * surface;
|
|
|
|
/// Current rendering area, all rendering operations will be moved into selected area
|
|
Rect renderArea;
|
|
|
|
/// constructs canvas using existing surface. Caller maintains ownership on the surface
|
|
explicit Canvas(SDL_Surface * surface, CanvasScalingPolicy scalingPolicy);
|
|
|
|
/// copy constructor
|
|
Canvas(const Canvas & other);
|
|
|
|
Point transformPos(const Point & input);
|
|
Point transformSize(const Point & input);
|
|
|
|
public:
|
|
Canvas & operator = (const Canvas & other) = delete;
|
|
Canvas & operator = (Canvas && other) = delete;
|
|
|
|
/// move constructor
|
|
Canvas(Canvas && other);
|
|
|
|
/// creates canvas that only covers specified subsection of a surface
|
|
Canvas(const Canvas & other, const Rect & clipRect);
|
|
|
|
/// constructs canvas of specified size
|
|
explicit Canvas(const Point & size, CanvasScalingPolicy scalingPolicy);
|
|
|
|
/// constructs canvas using existing surface. Caller maintains ownership on the surface
|
|
/// Compatibility method. AVOID USAGE. To be removed once SDL abstraction layer is finished.
|
|
static Canvas createFromSurface(SDL_Surface * surface, CanvasScalingPolicy scalingPolicy);
|
|
|
|
~Canvas();
|
|
|
|
/// if set to true, drawing this canvas onto another canvas will use alpha channel information
|
|
void applyTransparency(bool on);
|
|
|
|
/// applies grayscale filter onto current image
|
|
void applyGrayscale();
|
|
|
|
/// renders image onto this canvas at specified position
|
|
void draw(const std::shared_ptr<IImage>& image, const Point & pos);
|
|
|
|
/// renders section of image bounded by sourceRect at specified position
|
|
void draw(const std::shared_ptr<IImage>& image, const Point & pos, const Rect & sourceRect);
|
|
|
|
/// renders another canvas onto this canvas
|
|
void draw(const Canvas &image, const Point & pos);
|
|
|
|
/// renders another canvas onto this canvas with transparency
|
|
void drawTransparent(const Canvas & image, const Point & pos, double transparency);
|
|
|
|
/// renders another canvas onto this canvas with scaling
|
|
void drawScaled(const Canvas &image, const Point & pos, const Point & targetSize);
|
|
|
|
/// renders single pixels with specified color
|
|
void drawPoint(const Point & dest, const ColorRGBA & color);
|
|
|
|
/// renders continuous, 1-pixel wide line with color gradient
|
|
void drawLine(const Point & from, const Point & dest, const ColorRGBA & colorFrom, const ColorRGBA & colorDest);
|
|
|
|
/// renders rectangular, solid-color border in specified location
|
|
void drawBorder(const Rect & target, const ColorRGBA & color, int width = 1);
|
|
|
|
/// renders rectangular, dashed border in specified location
|
|
void drawBorderDashed(const Rect & target, const ColorRGBA & color);
|
|
|
|
/// renders single line of text with specified parameters
|
|
void drawText(const Point & position, const EFonts & font, const ColorRGBA & colorDest, ETextAlignment alignment, const std::string & text );
|
|
|
|
/// renders multiple lines of text with specified parameters
|
|
void drawText(const Point & position, const EFonts & font, const ColorRGBA & colorDest, ETextAlignment alignment, const std::vector<std::string> & text );
|
|
|
|
/// fills selected area with solid color
|
|
void drawColor(const Rect & target, const ColorRGBA & color);
|
|
|
|
/// fills selected area with blended color
|
|
void drawColorBlended(const Rect & target, const ColorRGBA & color);
|
|
|
|
/// fills canvas with texture
|
|
void fillTexture(const std::shared_ptr<IImage>& image);
|
|
|
|
int getScalingFactor() const;
|
|
|
|
/// Compatibility method. AVOID USAGE. To be removed once SDL abstraction layer is finished.
|
|
SDL_Surface * getInternalSurface();
|
|
|
|
/// get the render area
|
|
Rect getRenderArea() const;
|
|
};
|