完成渲染器相机与精灵

src/engine/render/sprite.h

@@ -0,0 +1,46 @@
+#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