Python 脚本界面用法

如何在 CityEngine 中使用 Python 控制台和编辑器。

Python 控制台

可以在 Python 控制台中或从 Python 编辑器执行 Python 脚本。

要打开 Python 控制台,请显示控制台(窗口 > 显示控制台),然后从工具条中小三角形下方的下拉列表中选择 Python 控制台

打开 Python 控制台
打开 Python 控制台

在控制台中,可以键入特定的 CityEngine 脚本命令以及常规的 Python 命令。 要执行命令行,请按 Enter 键。 使用 Ctrl + 空格键显示命令完成弹出窗口,该窗口可根据您的键入显示可能的命令。 可通过按上箭头键来调用最后使用的命令。

注:

有关可用 CityEngine 方法的列表,请参阅按类别的命令命令参考

Python 控制台中的命令完成(
Python 控制台中的命令完成(Ctrl + 空格键

Python 编辑器

Python 编辑器提供了一种更为方便的脚本编辑和执行方式。 通过文件 > 新建... > 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 模块
导入自定义 Python 模块

脚本快捷菜单

要快速启动 Python 脚本,可以将其放在脚本菜单脚本 > 添加脚本...中。

另请参阅