一、模块定位

Qt6QuickShapes.dll 是 Qt 6 框架中 QtQuick.Shapes 模块的运行时动态链接库，为 QML 中的 Shape、ShapePath、ShapeGradient 等类型提供底层实现，并负责将矢量路径几何数据接入 Qt Quick 的场景图（Scene Graph）渲染管线。

二、核心功能

• 路径几何构建：解析 QPainterPath 描述的矢量轮廓，完成贝塞尔曲线细分、直线段离散化以及描边（Stroke）轮廓的生成。
• 场景图集成：将几何数据封装为 QSGGeometryNode，交由 RHI 后端（OpenGL、Vulkan、Metal、Direct3D）光栅化，保证跨平台一致渲染。
• 填充与渐变：支持纯色填充、nonzero/evenodd 填充规则，以及线性、径向、锥形渐变的着色处理。
• 抗锯齿与曲线平滑：通过多重采样与距离场近似，抑制曲线边缘锯齿。
• 性能优化：提供几何缓存与脏标记增量更新，避免每帧重复三角化。

三、缺失后的典型影响

• 进程无法启动：系统弹出「由于找不到 Qt6QuickShapes.dll，无法继续执行代码」，程序直接退出。
• QML 加载失败：引擎抛出 module "QtQuick.Shapes" is not installed，Shape 相关组件无法实例化。
• 界面残缺：白屏或局部空白，圆形头像、自定义按钮、矢量图标等图形元素不再绘制。
• 部署隐患：windeployqt 漏拷、杀毒误删、Debug 版与 Release 版混用均会触发该问题。
• 运行崩溃：强行加载版本不匹配的 DLL，可能引发访问冲突或渲染异常。

处理方式：使用 windeployqt 重新部署，或从官方安装包中复制与主程序版本一致的 DLL，放置于可执行文件同级目录或系统 PATH 路径下。