设置帧范围

与 Shotgun 同步帧范围

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

请注意:本文档介绍仅当控制 Toolkit 配置时可用的功能。有关更多详细信息,请参见 Shotgun 集成用户手册

这是一个简单但有用的应用,用于在 Shotgun 中针对关联的镜头同步当前文件与最新帧范围。如果剪辑中对剪辑镜头进行了更改,可使用此应用快速安全地更新正在处理的场景。结束时,它将显示包含有关更改内容的信息的 UI。

文档

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

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

Shotgun

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

Nuke

多个 Shotgun 字段同步选项

您可以通过设置 menu_name 属性在 Shotgun 菜单中定义此应用的多个实例。这样,您可以定义多个菜单动作,以便同步不同的 Shotgun 字段。

要执行此操作,请为每个实例设置不同的应用实例名称 menu_name 以及输入帧和输出帧字段:

tk-multi-setframerange_cuts:
  menu_name: Sync frame range using cut fields
  sg_in_frame_field: sg_cut_in
  sg_out_frame_field: sg_cut_out
  location: "@apps.tk-multi-setframerange.location"
tk-multi-setframerange_handles:
  menu_name: Sync frame range using handle fields
  sg_in_frame_field: sg_handle_in
  sg_out_frame_field: sg_handle_out
  location: "@apps.tk-multi-setframerange.location"

这些内容应该在 Shotgun 菜单中显示为单独的选项:

多个实例

注意:这是 v0.4.0 版应用的新功能。

操作挂钩

在帧操作挂钩中处理用于获取当前场景帧范围或设置帧范围的软件特定逻辑。如果想要添加对新插件的支持或更改行为的实现方式,可以通过设置 hook_frame_operation 应用属性并实施自己的获取和设置逻辑来接管帧操作挂钩。

注意:这是 v0.4.0 版应用的新功能。

安装和更新

将此应用添加到 Shotgun Pipeline Toolkit

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

> tank Project XYZ install_app asset tk-maya 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.18.0 或更高版本才能使用此功能。

配置

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

menu_name

类型:str

默认值:Sync Frame Range with Shotgun

说明:Shotgun 菜单中将显示的名称。

sg_in_frame_field

类型:str

默认值:sg_cut_in

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

sg_out_frame_field

类型:str

默认值:sg_cut_out

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

hook_frame_operation

类型:hook

默认值:{self}/frame_operations_{engine_name}.py

说明:包含设置/获取帧范围的所有方法的挂钩。

关注