特殊脚本

在启动时运行脚本

要指定在启动时执行的脚本,打开编辑 > 首选项 > Python > 启动。 启用 Run python script on startup 复选框并指定需要在 Workspace Path 字段中运行的脚本。 脚本在此工程指定的环境中运行,支持 Python 3 和 Jython 环境。

startup.py(仅限 Jython)

注:
startup.py 仅在 Run python script on startup 复选框

(见上文)禁用时运行。

如果当前 CityEngine 工作空间根目录中存在文件 startup.py,则该文件将在 CityEngine 启动期间自动执行。 启动脚本的典型用例是使用 CityEngine 运行自动化任务。 在下面的示例中,用于定义自动化作业的 Python 脚本将在启动后自动执行。

if __name__ == '__startup__':
    sys.path.append(ce.toFSPath("automationProject/scripts"))
    import automationJob
    automationJob.run()
注:

请确保 startup.py 具有良好的格式且没有错误。 错误的 startup.py 可能会阻止系统对主脚本模块进行解析,并可能阻止脚本界面的正确执行。

交互式控制台中的初始命令

要简化使用交互式控制台,可以指定要在每个新交互式控制台中执行的初始命令。 这些命令可以在编辑 > 首选项 > Python > 交互式控制台 > 初始命令中进行更改。

CityEngine 随附的默认初始命令用于加载 cityengine 包并以名称 ce 创建 CE 对象的实例。

注:

这些初始命令将在任何环境的交互式控制台中运行。 确保代码与 Jython 和 Python 3 兼容。 可通过评估 sys.platform.startswith('java') 检查是否激活 Jython。

scripting.py(仅限 Jython)

如果文件 scripting.py 位于当前 CityEngine 工作空间根目录中,则其内容将以相同的名称追加到主 CityEngine 脚本模块的末尾。 当打开新的 Python 控制台并将其添加到在 CityEngine 中创建的每个新 Python 文件中时,系统将自动执行自脚本导入 * 命令。 典型用例包括将脚本目录添加到系统路径,或将自定义模块加载到脚本环境。

注:

需要重新启动 CityEngine 才能将更改加载到文件 scripting.py 中。 请确保 scripting.py 具有良好的格式且没有错误。 错误的 scripting.py 可能会阻止系统对主脚本模块进行解析,并可能阻止脚本界面的正确执行。

另请参阅