47 lines
2.3 KiB
C++
47 lines
2.3 KiB
C++
|
#pragma once
|
||
|
|
#include <SDL3/SDL_rect.h> // 用于 SDL_FRect
|
||
|
|
#include <optional> // 用于 std::optional 表示可选的源矩形
|
||
|
|
#include <string>
|
||
|
|
|
||
|
|
namespace engine::render {
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 表示要绘制的视觉精灵的数据。
|
||
|
|
*
|
||
|
|
* 包含纹理标识符、要绘制的纹理部分（源矩形）以及翻转状态。
|
||
|
|
* 位置、缩放和旋转由外部（例如 SpriteComponent）标识。
|
||
|
|
* 渲染工作由 Renderer 类完成。（传入Sprite作为参数）
|
||
|
|
*/
|
||
|
|
class Sprite final{
|
||
|
|
private:
|
||
|
|
std::string texture_id_; ///< @brief 纹理资源的标识符
|
||
|
|
std::optional<SDL_FRect> source_rect_; ///< @brief 可选：要绘制的纹理部分
|
||
|
|
bool is_flipped_ = false; ///< @brief 是否水平翻转
|
||
|
|
|
||
|
|
public:
|
||
|
|
/**
|
||
|
|
* @brief 构造一个精灵
|
||
|
|
*
|
||
|
|
* @param texture_id 纹理资源的标识符。不应为空。
|
||
|
|
* @param source_rect 可选的源矩形（SDL_FRect），定义要使用的纹理部分。如果为 std::nullopt，则使用整个纹理。
|
||
|
|
* @param is_flipped 是否水平翻转
|
||
|
|
*/
|
||
|
|
Sprite(const std::string& texture_id, const std::optional<SDL_FRect>& source_rect = std::nullopt, bool is_flipped = false)
|
||
|
|
: texture_id_(texture_id),
|
||
|
|
source_rect_(source_rect),
|
||
|
|
is_flipped_(is_flipped)
|
||
|
|
{}
|
||
|
|
|
||
|
|
// --- getters and setters ---
|
||
|
|
const std::string& getTextureId() const { return texture_id_; } ///< @brief 获取纹理 ID
|
||
|
|
const std::optional<SDL_FRect>& getSourceRect() const { return source_rect_; } ///< @brief 获取源矩形 (如果使用整个纹理则为 std::nullopt)
|
||
|
|
bool isFlipped() const { return is_flipped_; } ///< @brief 获取是否水平翻转
|
||
|
|
|
||
|
|
void setTextureId(const std::string& texture_id) { texture_id_ = texture_id; } ///< @brief 设置纹理 ID
|
||
|
|
void setSourceRect(const std::optional<SDL_FRect>& source_rect) { source_rect_ = source_rect; } ///< @brief 设置源矩形 (如果使用整个纹理则为 std::nullopt)
|
||
|
|
void setFlipped(bool flipped) { is_flipped_ = flipped; } ///< @brief 设置是否水平翻转
|
||
|
|
|
||
|
|
};
|
||
|
|
|
||
|
|
} // namespace engine::render
|