feat: initial DX12 foundation framework

Engine/Platform/Window.h

@@ -0,0 +1,99 @@
+/**
+ * @file Window.h
+ * @brief 跨模块窗口句柄对象与基础窗口操作接口。
+ * @details
+ * window 是平台层窗口对象的轻量包装，向上层提供：
+ * - 全屏切换、标题设置、尺寸调整；
+ * - 原生窗口句柄访问；
+ * - 关闭状态与尺寸查询。
+ * 具体平台行为由 PlatformWin32.cpp 等实现体完成。
+ */
+#pragma once
+#include "CommonHeader.h"
+
+
+namespace XEngine::platform {
+/**
+ * @brief 窗口强类型标识符。
+ */
+DEFINE_TYPED_ID(window_id);
+
+/**
+ * @brief 平台窗口句柄对象。
+ */
+class window
+{
+public:
+	/**
+	 * @brief 由窗口 ID 构造句柄。
+	 * @param id 窗口 ID。
+	 */
+	constexpr explicit window(window_id id) : _id{ id } {}
+	/**
+	 * @brief 构造无效窗口句柄。
+	 */
+	constexpr window() = default;
+	/**
+	 * @brief 获取窗口 ID。
+	 * @return 窗口 ID。
+	 */
+	constexpr window_id get_id() const { return _id; }
+	/**
+	 * @brief 判断窗口句柄是否有效。
+	 * @return 有效返回 true。
+	 */
+	constexpr bool is_valid() const { return id::is_valid(_id); }
+
+
+	/**
+	 * @brief 设置全屏状态。
+	 * @param is_fullscreen true 表示全屏。
+	 */
+	void set_fullscreen(bool is_fullscreen) const;
+	/**
+	 * @brief 查询是否全屏。
+	 * @return 全屏返回 true。
+	 */
+	bool is_fullscreen() const;
+	/**
+	 * @brief 获取原生窗口句柄。
+	 * @return 平台句柄指针。
+	 */
+	void* handle() const;
+	/**
+	 * @brief 设置窗口标题文本。
+	 * @param caption 标题字符串。
+	 */
+	void set_caption(const wchar_t* caption) const;
+	/**
+	 * @brief 获取窗口矩形坐标。
+	 * @return 左上右下坐标向量。
+	 */
+	math::u32v4 size() const;
+	/**
+	 * @brief 调整窗口大小。
+	 * @param width 目标宽度。
+	 * @param height 目标高度。
+	 */
+	void resize(u32 width, u32 height)const;
+	/**
+	 * @brief 获取窗口宽度。
+	 * @return 宽度像素值。
+	 */
+	u32 width()const;
+	/**
+	 * @brief 获取窗口高度。
+	 * @return 高度像素值。
+	 */
+	u32 height()const;
+	/**
+	 * @brief 查询窗口是否已关闭。
+	 * @return 已关闭返回 true。
+	 */
+	bool is_closed()const;
+
+private:
+	window_id _id{ id::invalid_id };
+
+};
+}