参数的更改和预览

在 项目的创建和在Cue上注册波形文件 教程中介绍了如何使用CRI Atom Craft Robot创建一系列数据，例如项目和Cue。
本教程将编写脚本来通过更改已创建的Cue的音量来预览Cue。

本教程使用在 项目的创建和在Cue上注册波形文件 教程中创建的项目。
尚未完成以上项目时，请参照 项目的创建和在Cue上注册波形文件 后开始此教程。

脚本文件的准备

选择脚本菜单上的“脚本列表...”显示脚本列表窗口。
按脚本列表窗口的“新建”按钮，使用以下名称创建脚本文件。

脚本的保存目标	脚本文件名
tutorials [CRI]	tutorial03-1_edit_and_preview.py

脚本说明

双击已创建的脚本，用 从脚本编辑器运行脚本 打开。
要通过脚本列表窗口确认脚本概要，按照以下脚本说明来编写。

# --Description:[教程]参数的更改和预览

模块的导入

编写脚本说明后，导入以下模块来用脚本操作CRI Atom Craft。

import cri.atomcraft.project as acproject
import cri.atomcraft.preview as acpreview

除了可以操作CRI Atom Craft的项目数据的 Project模块 ，还可以导入 preview模块 进行预览。

获取要编辑的Cue

需要获取目标Cue的对象以对Cue进行参数编辑。
获取对象有以下两种主要方法：

• 通过搜索获取
• 通过查找层次结构获取

本节将同时包含层次结构的回顾并将展示如何使用以下函数来获取Cue以按每个级别查找工作单元对象。
了解如何查找Cue的层次结构有用于获取查找层次的方法。
关于如何通过搜索获取，请参照 对象获取和列表操作 教程。
使用以下函数顺序获取工作单元、Cue Sheet文件夹、Cue Sheet和Cue。

函数名	说明
get_workunit	获取工作单元
get_cuesheet_rootfolder	获取工作单元的Cue Sheet根文件夹
get_child_object	指定父对象后获取子对象

使用以上函数获取Cue可以如下编写脚本。

# 获取工作单元
workunit = acproject.get_workunit("WorkUnit_Tutorial")["data"]
 
# Cue Sheet根文件夹
cuesheet_rootfolder = acproject.get_cuesheet_rootfolder(workunit)["data"]
 
# 获取Cue Sheet文件夹“WorkUnit_Tutorial”
cuesheet_folder = acproject.get_child_object(cuesheet_rootfolder, "CueSheetFolder", "WorkUnit_Tutorial")["data"]
 
# 获取Cue Sheet
cuesheet = acproject.get_child_object(cuesheet_folder, "CueSheet", "Tutorial")["data"]
 
# 获取Cue
cue = acproject.get_child_object(cuesheet, "Cue", "gun1_High")["data"]

获取Cue的解说

要通过查找层级结构来获取对象，首先需要获取一个名为根对象的起始对象。
包含Cue对象的对象结构的根对象是工作单元对象。
在 get_workunit 函数上指定“工作单元名”来获取工作单元对象。
本节是通过在工作单元名上指定 "WorkUnit_Tutorial" 来获取工作单元。

然后，从工作单元使用 get_cuesheet_rootfolder 函数获取工作单元的Cue Sheet根文件夹。
从Cue Sheet根文件夹使用 get_child_object 函数查找Cue Sheet文件夹、Cue Sheet、Cue和层级来获取对象。

Cue的参数更改

以上介绍了如何获取Cue，以下将介绍如何更改参数。
使用下述函数来更改Cue的音量参数。

函数名	说明
set_value	设置指定对象的参数

使用以上函数“将Cue的音量更改为0.5”可以如下编写脚本。

# 更改Cue的音量
acproject.set_value(cue, "Volume", 0.5)

Cue的参数更改的解说

参数的更改是使用属于通用函数的 set_value 函数。
要使用 set_value 函数，请先指定“目标对象信息”、“参数字段名”和“参数值”。

关于各对象中对应每个参数项目的参数字段名，请参照 参照型参数 。

运行脚本之前，请确认 "gun1_High" Cue的音量为1.0。
确认后，单击"执行"按钮运行脚本。
此时您可以确认 "gun1_High" Cue的音量已变成0.5。

Cue的预览

最后，使用 preview模块 的下述函数来执行Cue预览。

函数名	说明
start_playback_cue	开始已指定的Cue的预览播放

start_playback_cue 函数是简易的预览函数，仅需指定Cue就可进行预览播放。
要预览刚才更改音量的Cue“gun1_High”的脚本的显示如下。

# 播放Cue
acpreview.start_playback_cue(cue)

脚本的保存和执行

本教程的脚本编写到此为止。
请保存并执行脚本。
成功执行脚本时，会将“gun1_High”Cue的音量更改为0.5并播放预览。