屏幕绘制模块总览 - Overview

本分类做什么

在 叠加层 上绘制图形界面（DrawGui*）：矩形、圆、线、文本、图片；以及 窗口/面板/按钮 等控件，支持 穿透、置顶、透明度、回调。用于 调试可视化 或 悬浮控制面板；与 窗口 原生 HWND 的创建方式不同。

---

一、生命周期与全局

接口	差异
DrawGuiCleanup	释放 全部 绘制资源。
DrawGuiSetGuiActive / DrawGuiIsGuiActive	启用/查询 绘制层。
DrawGuiSetGuiClickThrough / DrawGuiIsGuiClickThrough	鼠标穿透（点击落到下层窗口）。
DrawGuiClearAll、DrawGuiDeleteObject	清空或删单个对象。

---

二、基础图元

接口	内容
DrawGuiRectangle、DrawGuiCircle、DrawGuiLine	矢量图形。
DrawGuiText、DrawGuiImage、DrawGuiImagePtr	文本与 路径图 / 内存图。

差异：Image vs ImagePtr = 文件路径 vs OLAImage 句柄（与 图像处理 一致）。

---

三、样式与布局

接口	用途
DrawGuiSetPosition、DrawGuiSetSize、DrawGuiGetPosition、DrawGuiGetSize	位置与尺寸。
DrawGuiSetColor、DrawGuiSetAlpha、DrawGuiSetDrawMode、DrawGuiSetLineThickness	颜色、透明、模式、线宽。
DrawGuiSetFont、DrawGuiSetTextAlign、DrawGuiSetText	字体与对齐。
DrawGuiSetVisible	显示/隐藏。
DrawGuiSetZOrder、DrawGuiSetParent	叠放与父子关系。

---

四、窗口与控件

接口	差异
DrawGuiWindow	顶层窗口 容器。
DrawGuiPanel	面板 分组。
DrawGuiButton	按钮，常配合回调。
DrawGuiSetWindowTitle、DrawGuiSetWindowStyle、DrawGuiSetWindowTopMost、DrawGuiSetWindowTransparency	窗口属性。

---

五、回调

接口	说明
DrawGuiSetButtonCallback	按钮点击。
DrawGuiSetMouseCallback	鼠标消息（移动/点击等，见详情页）。

---

六、查询

接口	用途
DrawGuiGetDrawObjectType	对象类型。
DrawGuiIsPointInObject	命中测试。

---

七、快速选型

需求	建议
调试找图结果框	DrawGuiRectangle + 坐标来自识别 JSON
不挡点击	DrawGuiSetGuiClickThrough
简易悬浮面板	DrawGuiWindow + Panel + Button

---

八、注意

• 多显示器 DPI 与坐标系以详情页为准。
• 与 窗口全屏独占 时叠加可能失败，需切换模式或绑定策略。