Tonatiuh-Script functions

8. Script functions (脚本函数)

8.1 脚本使用方法

打开脚本编辑器后，通过输入 tonatiuh 然后跟上函数名来调用函数：

javascript

tonatiuh.New(); // 创建新文件
tonatiuh.CreateShape("Cone"); // 创建圆锥体

点击 运行(Run) 按钮执行脚本。

8.2 主要脚本函数分类

文件操作函数

• New(): 打开空的Tonatiuh场景
• Open(QString fileName): 打开指定文件
• Save(): 保存当前系统
• SaveAs(QString fileName): 另存为指定文件名

节点构建和管理函数

节点创建函数：

• CreateGroupNode(): 创建分组节点
• CreateSurfaceNode(): 创建表面节点
• CreateShape(QString shapeType): 创建指定类型的形状节点
• CreateMaterial(QString materialType): 创建指定类型的材料节点
• CreateTracker(QString trackerType): 创建指定类型的跟踪器

节点管理函数：

• SelectNode(QString nodeURL): 选择指定节点
• SetNodeName(QString nodeName): 设置节点名称
• SetValue(QString nodeURL, QString parameter, QString value): 设置节点参数值
• Copy() / Cut() / Delete(): 复制/剪切/删除节点
• PasteCopy() / PasteLink(): 粘贴副本/粘贴链接

环境设置函数

• ChangeSunPosition(double azimuth, double elevation): 设置太阳位置
• SetSunshape(QString sunshapeType): 设置太阳形状类型
• SetTransmissivity(QString transmissivityType): 设置透射率模型
• SetRaysPerIteration(unsigned int rays): 设置光线数量

仿真配置函数

• SetRayCastingGrid(int widthDivisions, int heightDivisions): 设置太阳分割
• SetRandomDeviateType(QString typeName): 设置随机数生成器
• SetPhotonMapBufferSize(unsigned int nPhotons): 设置光子图缓冲区
• SetExportPhotonMapType(QString exportModeType): 设置导出类型

运行和分析函数

• Run(): 运行光线追踪仿真
• RunFluxAnalysis(...): 运行通量分布分析
• AddExportSurfaceURL(QString nodeURL): 添加导出表面