如何在 CityEngine 中使用 Python 控制台和编辑器。
Python 控制台
可以在 Python 控制台中或从 Python 编辑器执行 Python 脚本。
要打开 Python 控制台,请显示控制台(窗口 > 显示控制台),然后从工具条中小三角形下方的下拉列表中选择 Python 控制台。
在控制台中,可以键入特定的 CityEngine 脚本命令以及常规的 Python 命令。 要执行命令行,请按 Enter 键。 使用 Ctrl + 空格键显示命令完成弹出窗口,该窗口可根据您的键入显示可能的命令。 可通过按上箭头键来调用最后使用的命令。
Python 编辑器
Python 编辑器提供了一种更为方便的脚本编辑和执行方式。 通过文件 > 新建... > Python 模块来创建新的脚本模块。 选择当前工程的脚本文件夹作为源文件夹,并为模块指定一个名称。
共有四个可用的模块模板:
<空> | 创建空模板 |
模块:类 | 创建空 Python 类 |
模块:导出 | 创建回调调用以便与基于 Python 的导出器搭配使用 |
模块:主 | 创建可执行脚本 |
选择 CityEngine 工程的脚本文件夹作为源文件夹,设置模块的名称并选择一个模板。
通过此对话框创建的新模块将包含以下行。
'''
Created on May 19, 2011
@author: andi
'''
from scripting import *
# get a CityEngine instance
ce = CE()
- 标题
- 一个导入语句,用于导入特定于 CityEngine 的脚本模块
- 系统将根据这个模块创建主实例 ce,该实例允许调用所有 CityEngine Python 命令
运行脚本
要在编辑器中执行脚本,请在菜单中选择 Python > 运行脚本或按 F9 键。 (焦点必须位于编辑器区域中的 Python 脚本上才能启用 Python 菜单)。
可通过从主工具条中选择取消(或按 Esc 键)来取消所有正在运行的 Python 脚本。 在控制台中,可以使用 Ctrl +空格键来显示命令完成。
您将在下方看到主模板的默认部分为黑色,而所添加的代码为红色。 该脚本可将所选模型作为 .obj 文件导出到当前工程的模型文件夹中。
'''
Created on May 19, 2011
@author: andi
'''
from scripting import *
# get a CityEngine instance
ce = CE()
def export(objects):
dir = ce.toFSPath("models/")
name = "pythonTriggeredExport"
settings = OBJExportModelSettings()
settings.setBaseName(name)
settings.setOutputPath(dir)
ce.export(objects, settings)
if __name__ == '__main__':
export(ce.selection())
pass
导入模块
与常规 Python 一样,您也可以导入其他模块。
>>> import random
>>> random.randint(0,100)
69
要加载自定义脚本,请确保在导入模块之前将脚本目录添加到 Python 系统路径。
>>> import sys
>>> sys.path.append($PATH_TO_YOUR_SCRIPTS_DIRECTORY)
>>> import $YOUR_MODULE
脚本快捷菜单
要快速启动 Python 脚本,可以将其放在脚本菜单脚本 > 添加脚本...中。
另请参阅