模块

功能说明:本程序是基于易语言（E-Language）开发的一款二维物理引擎功能演示与应用示例。程序的核心在于调用第三方组件“尼古 2D 物理引擎”，通过易语言的原生语法实现对物理世界的模拟、刚体的创建、约束关系的设定以及实时的画面渲染。以下是对该程序功能的详细总结与分析：

一、程序整体架构与目的

该程序的主要目的是展示如何在易语言环境下集成和使用 2D 物理引擎组件。它不仅仅是一个简单的图形绘制程序，更是一个包含物理计算、碰撞检测（隐含在引擎内）、运动求解的综合仿真系统。程序界面主要由一个主窗口和一个画板（画板 1）组成，画板用于显示物理模拟的动态过程。

二、核心子程序功能分析

根据易语言代码规范，程序的逻辑主要分布在以 `.子程序` 开头的模块中，以下是关键子程序的功能拆解：

1. __启动窗口_创建完毕 (初始化阶段)

   这是程序启动时首先运行的子程序，负责构建初始的物理场景。

   - 物理引擎实例化：创建了 `物理引擎` 变量，并传入重力参数（NG2D 向量 (0, -10)），设定了世界重力方向。

   - 多边形刚体创建：定义了一个五点坐标的多边形，并将其作为静态或动态刚体加入世界。

   - 约束链构建：通过计次循环创建了 10 个黄色矩形刚体，并使用 `创建弹性焊接约束` 将它们依次连接，形成类似链条的结构。第一个黄色矩形还与多边形刚体相连，以此固定链条的一端。

   - 障碍物设置：创建了 6 个白色矩形刚体，作为场景中的静止障碍。

   - 特殊约束演示：创建了一组矩形和圆形，并使用 `创建旋转约束` 连接它们，演示刚体绕定点旋转的物理特性。

2. _按钮 1_被单击 (交互控制阶段)

   该子程序响应界面上的按钮点击事件，实现人机交互。

   - 动态生成物体：在点击时于指定坐标创建一个带有质量和摩擦系数（4, 0.3）的新圆形刚体。

   - 随机运动赋予：利用 `取随机数` 函数为新生成的圆设定随机的线速度（移动方向）和角速度（自转速度），模拟抛射物体的效果。

   - 循环控制：维护一个布尔变量 `继续`，确保渲染循环仅启动一次，避免重复开启。

3. 渲染 (核心逻辑与动画循环)

   这是程序运行时持续执行的主循环，负责画面的更新和物理状态的迭代。

   - 界面重绘：每次循环清空画板背景，并绘制静态说明文字，标注不同区域代表的物理对象类型（如“多边形刚体”、“旋转约束”等）。

   - 动态对象绘制：

     - 遍历 `刚体句柄` 数组，调用 `画球` 子程序渲染用户点击生成的红色圆球。

     - 遍历预定义的黄色和白色矩形数组，调用 `画矩形` 子程序渲染预设物体。

     - 绘制特殊的多边形和旋转对，并画出约束连接线，直观展示物理关联。

   - 物理同步：在绘制完成后，调用 `物理引擎。更新 (0.05)`，推进物理世界的时间步长（0.05 秒），使物体的位置、速度、受力状态发生真实变化。

   - 帧率控制：使用 `延时 (5)` 毫秒防止 CPU 占用过高，大致控制在每帧约 100Hz 以上的刷新频率。

4. 画球与画矩形 (辅助绘图工具)

   这两个子程序是私有的绘图封装，处理了从物理数据到屏幕显示的转换。

   - 坐标转换：物理引擎的坐标通常原点在中心且 Y 轴向上，而 Windows GDI 绘图原点在左上角且 Y 轴向下。代码中通过 `392 - 位置 2.y` 实现了 Y 轴的镜像翻转。

   - 角度计算：利用 `求余弦 `、` 求正弦` 等数学函数，结合刚体的角度数据，计算出图形旋转后的顶点位置，从而实现视觉上的正确旋转。

三、关键变量与数据结构

- `物理引擎`：全局单例对象，管理所有的刚体和约束。

- `刚体句柄 `：动态数组，存储用户临时创建的圆球 ID，支持无限添加物体而不影响预设场景。

- `NG2D 向量`：尼古引擎专用的数据结构，用于表示位置、速度、力等二维向量数据。

- `整数型` 变量（如 `黄色矩形`）：存储刚体在引擎内部的唯一标识符（Handle），用于后续操作。

四、程序运行流程总结

1. 启动 -> 初始化物理世界与静态场景。

2. 待机 -> 等待用户点击按钮。

3. 点击 -> 生成新物体，激活渲染循环。

4. 循环 -> 更新物理状态 -> 获取位置角度 -> 绘制到画板 -> 休眠片刻 -> 重复直到关闭。

5. 退出 -> 释放资源。

五、总结

综上所述，该程序是一个典型的易语言组件应用案例。它清晰地展示了物理引擎编程的基本范式：初始化世界 -> 添加实体与约束 -> 输入力/速度 -> 步进更新 -> 渲染显示。对于学习者而言，该代码提供了关于向量运算、坐标系变换、循环控制以及组件调用的完整参考范本，特别适用于理解 2D 动作类软件背后的物理逻辑实现。

======窗口程序集1

           |  |

           |  |------ __启动窗口_创建完毕

           |  |

           |  |------ _按钮1_被单击

           |  |

           |  |------ 渲染

           |  |

           |  |------ 画球

           |  |

           |  |------ 画矩形

           |  |

           |  |------ _按钮2_被单击

           |  |

           |  |------ __启动窗口_将被销毁

           |  |

           |  |------ _按钮3_被单击