与 Shotgun 同步帧范围 将场景的帧范围与 Shotgun 中存储的帧范围同步。 开发者：Shotgun Software 最新版本：v0.3.0 (Prod) 我们的版本号遵循语义化版本标准。 系统名称：tk-multi-setframerange

概述

本文档介绍仅当控制 Toolkit 配置时可用的功能。有关详细信息，请参见 Shotgun 集成用户手册。这是一个简单但有用的应用，用于在 Shotgun 中针对关联的镜头同步当前文件与最新帧范围。如果剪辑中对镜头进行了更改，可使用此应用快速安全地更新正在处理的场景。结束时，它将显示包含有关更改内容的信息的 UI。

文档

此应用可帮助您管理当前打开的场景中的帧范围。您可以从 Shotgun 菜单中单击“Sync Frame Range with Shotgun”菜单选项访问它。

当您单击它时，Shotgun Toolkit 会检查与当前工作区关联的 Shotgun 实体（通常是镜头），并查找包含镜头入点帧和镜头出点帧信息的镜头入点和镜头出点字段。这些信息通常与镜头结合使用，在这种情况下，应用会使用 Shotgun 默认配置中定义的标准镜头入点和镜头出点字段。但是，我们完全可以配置应用，让它从其他字段提取帧范围。

当您运行此应用时，它会使用这些入点和出点信息更新当前场景，最后显示一条摘要消息：

安装和更新

将此应用添加到 Shotgun Pipeline Toolkit

如果您想将此应用添加到 Project XYZ 中名为 asset 的环境中，请执行以下命令：

> tank Project XYZ install_app asset tk-nuke tk-multi-setframerange

更新至最新版本

如果您已在某个项目中安装了此应用，要获取最新版本，可运行 update 命令。您可以导航到该特定项目随附的 tank 命令，并在该项目中运行它：

> cd /my_tank_configs/project_xyz
> ./tank updates

或者，也可以运行您的工作室的 tank 命令并指定项目名称，指示该命令要对哪个项目运行更新检查：

> tank Project XYZ updates

协作和代码演进

如果您可以获取 Shotgun Pipeline Toolkit，意味着也可以获取我们在 GitHub 中存储和管理的所有应用、插件和框架的源代码。欢迎根据实际需要演进和完善这些内容，以它们为基础做进一步的独立开发，修改它们（以及向我们提交 Pull 请求！），或者只是随手玩一玩，简单了解它们的构建方式和 Toolkit 的工作原理。您可以通过以下网址访问此代码库：https://github.com/shotgunsoftware/tk-multi-setframerange。

特殊要求

• 需要安装 Shotgun Pipeline Toolkit 核心 API 版本 v0.12.5 或更高版本才能使用此功能。

配置

下面是使用的所有配置设置的摘要。您需要在要启用此应用或插件的环境文件中定义这些设置。

sg_in_frame_field

类型：str

默认值：sg_cut_in

说明：用来检索入点帧的 Shotgun 字段。应用将在与当前上下文（例如当前镜头、当前资产等）关联的实体上查找此字段。

sg_out_frame_field

类型：str

默认值：sg_cut_out

说明：用来检索出点帧的 Shotgun 字段。应用将在与当前上下文（例如当前镜头、当前资产等）关联的实体上查找此字段。