您的工作文件

Shotgun 工作文件

使用此应用,您可以浏览、打开和保存您的工作文件和发布。


开发者:Shotgun Software
最新版本:v0.9.7 (Prod)
我们的版本号遵循语义版本控制标准。
系统名称:tk-multi-workfiles2

目录:

概述

文档

            “File Open”对话框

                  在工作区中导航

                  查找文件

                  访问先前版本

                  用户沙盒

                  缩小结果

            “File Save”对话框

                  在不同上下文中保存文件

                  添加文件扩展名下拉列表

            已知问题

安装、更新和开发

配置选项

概述

本文档介绍仅当控制 Toolkit 配置时可用的功能。有关详细信息,请参见 Shotgun 集成用户手册。此应用程序构成了在 Shotgun Pipeline Toolkit 中进行文件管理的基础。它允许您在各种 Shotgun 实体之间快速跳转,并让您快速开始工作。由于该应用程序在后台管理路径,因此无需指定路径。该应用程序会帮助您管理工作区中的工作文件,这样,您可以轻松地与其他人共享您的工作内容。

文档

“File Open”对话框

在工作区中导航

主对话框分为两个部分。左侧是一系列选项卡。第一个选项卡名为“My Tasks”,显示分配给当前用户的所有任务。这个选项卡非常像 Shotgun 网站上的“My Tasks”页面。

另外,用户也可以使用实体选项卡浏览 Shotgun 实体。默认情况下,工作文件应用程序让用户可通过查看相应的选项卡,浏览与镜头或素材关联的任何任务。

整套选项卡全部可通过环境文件中的 entities 设置进行配置。

查找文件

在右侧,您将看到与左侧选择的内容关联的工作文件和发布。使用“All”、“Working”和“Publishes”选项卡,可以一起或单独查看工作文件和发布。

访问先前版本

有两种方式可以访问先前版本。首先,用户可单击浏览器顶部的“All Versions”方框,这将展开版本并在浏览器中单独列出所有版本。另一个方法是在文件上单击鼠标右键,这样可以访问前 10 个版本。

用户沙盒

如果您的工作流配置使用了用户沙盒,默认情况下将只会看到当前用户的文件。如果用户想查看其他用户沙盒中的文件,可以使用顶部的按钮选取要显示哪个沙盒中的文件。

缩小结果

您可以通过键入文字来缩小任何视图中的结果。搜索将匹配任意项的名称。

“File Save”对话框

默认情况下,“File Save”对话框让用户可在当前上下文中保存文件。应用程序将提示用户输入场景名称、版本号以及可选的文件扩展名(如果有的话),此时“Save”按钮将灰显。仅当应用程序确认了场景名称的下一个可用版本号时,右下角的“Save”按钮才会启用。

在不同的上下文中保存文件

要在不同的上下文中保存文件,用户可单击对话框左上角的展开按钮,这将展开“File Save”对话框,让用户选择另一个要保存文件的上下文。

添加文件扩展名下拉列表

使用新的“File Save”对话框,可以选取保存文件的扩展名。要启用此功能,您需要调整工作流配置的 templates.yml 文件。首先,需要在 templates.yml 内的标记列表中定义一个标记。

maya_extension:
    type: str
    choices:
        ma: Maya Ascii (.ma)
        mb: Maya Binary (.mb)
    default: ma
    alias: extension

maya_extension 是标记的名称。choices 是下拉列表中将会显示的文件类型的词典。键(mamb)是此模板标记可以具有的值。值(Maya Ascii (.ma)Maya Binary (.mb)) 是可供 Toolkit 应用程序使用的用户界面友好的描述。alias 是工作文件应用程序需要的提示。它将告诉应用程序此标记是一个扩展名,应显示在下拉列表控件中。

然后,可以将此标记添加到任何 Maya 特定的模板中。

maya_shot_work:
    definition: '@shot_root/work/maya/{name}.v{version}.{maya_extension}'
    root_name: 'primary'

已知问题

  • 3ds Max 和 MotionBuilder 支持 - 在 Windows 上,这些 DCC 中的文件性能比 Maya 和 Nuke 中速度更慢。
  • Perforce/Versionless 文件 - 应用程序仍需经过 Perforce 工作流的测试,很有可能无法正常工作。

相关应用和文档

加载器

本文档介绍仅当控制 Toolkit 配置时可用的功能。有关详细信息,请参见 Shotgun 集成用户手册。使用 Shotgun 加载器可以快速简要了解和浏览已发布到 Shotgun 的文件。通过一个可搜索的树视图导航系统可以轻松快速地到达您要查找的任务、镜头或素材,之后,加载器显示相应项目的所有发布的缩略图式概况。通过可配置的挂钩,您便可以轻松地在您的当前场景中引用或导入发布。

发布

本文档介绍仅当控制 Toolkit 配置时可用的功能。有关详细信息,请参见 Shotgun 集成用户手册。多发布是一个工作流应用,美工人员可以使用它向 Shotgun 发布文件。该应用提供了一个建立在高度可自定义核心上的简单 UI,可轻松对其进行配置以发布工作场景及其从属项(例如 Maya 场景、Nuke 脚本、OBJ、Alembic 缓存、摄影机、纹理等)中的文件或数据的任何组合。多发布应用用于所有默认配置中,可以轻松进行配置以支持以下各种工作流:在 Maya 中生成 Alembic 缓存、在 Nuke 中渲染发布、在 Photoshop 中进行美术参照管理或在 Shotgun 和 Shell 环境中进行图版插入。

发布

通过发布应用,美工人员可以发布他们的作品,以便其可供下游的美工人员使用。它支持在美工人员的内容创建软件中以传统方式发布工作流,以及在磁盘上单独发布任何文件。在内容创建软件中操作并使用基本 Shotgun 集成时,该应用将自动发现并显示项目以供美工人员发布。对于较复杂的生产需求,工作室可以编写自定义发布插件来推动美工人员工作流。

场景快照

本文档介绍仅当控制 Toolkit 配置时可用的功能。有关详细信息,请参见 Shotgun 集成用户手册。Shotgun 快照是快速增量备份,让您可以对您工作中的增加部分进行版本控制和管理,而不会与其他人共享。可创建快照、添加说明和缩略图,并创建一个时间点,您可以在以后随时回到该时间点并进行恢复。如果您要进行重大更改并要确保具有先前版本的场景的备份,这很有用。

Toolkit Pipeline 教程

此文档提供了分步教程,指导技术总监 (TD) 使用 Toolkit 以高级方式设置简单的端到端工作流。完成本教程的新 Toolkit 用户将了解平台的基本方面,以及如何根据其工作室的特定需求对平台进行自定义。该教程还介绍了现有 Toolkit 应用,以及如何在美工人员工作流中将它们配合使用。
请注意,本文档介绍仅当控制 Toolkit 配置时可用的功能。有关详细信息,请参见 Shotgun 集成用户手册

安装和更新

将此应用添加到 Shotgun Pipeline Toolkit

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

> tank Project XYZ install_app asset tk-maya tk-multi-workfiles2

更新至最新版本

如果您已在某个项目中安装了此应用,要获取最新版本,可运行 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-workfiles2

特殊要求

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

配置

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

my_tasks_filters

类型:list

默认值:[[u'task_assignees', u'is', u'{context.user}']]

说明:要应用于“My Tasks”选项卡中任务的过滤器列表。

template_publish

类型:template

说明:引用一个模板,该模板将在磁盘上定位发布文件。

launch_at_startup

类型:bool

说明:一个标志,表示是否在应用程序启动时启动用户界面。因为某些平台的启动方式存在差异,所以并非所有的插件都支持此选项。目前,只有 Maya、Nuke 和 3ds Max 支持此选项。

show_my_tasks

类型:bool

默认值:True

说明:定义“My Tasks”视图是否可见。

saveas_default_name

类型:str

默认值:scene

说明:使用 save-as 命令保存工作文件时使用的默认名称。

template_publish_area

类型:template

说明:引用一个模板,该模板将在磁盘上定位发布目录。

file_extensions

类型:list

说明:工作文件视图中显示的文件扩展名列表。如果为空,将显示所有与模板匹配的文件。

saveas_prefer_version_up

类型:bool

说明:控制 save-as 命令如何确定要使用的初始名称。如果设置为 True,将使用当前场景的名称,同时版本号将递增。如果为 False,则使用具有唯一性的新名称,并且版本号将重置。

hook_filter_work_files

类型:hook

默认值:{self}/filter_work_files.py

说明:指定一个挂钩,当需要时,可过滤出找到的当前工作区的工作文件原始列表。

create_new_task_hook

类型:hook

默认值:{self}/create_new_task.py

说明:指定一个挂钩,该挂钩将创建任务并执行任何需要的输入验证。

hook_copy_file

类型:hook

默认值:{self}/copy_file.py

说明:指定一个挂钩,该挂钩将用于将文件“source_path”复制到“target_path”。

allow_task_creation

类型:bool

默认值:True

说明:控制是否可以从应用创建新任务。

entities

类型:list

默认值:[{u'hierarchy': [u'entity.Asset.sg_asset_type', u'entity', u'step', u'content'], u'caption': u'Assets', u'filters': [[u'entity', u'type_is', u'Asset']], u'entity_type': u'Task'}, {u'hierarchy': [u'entity.Shot.sg_sequence', u'entity', u'step', u'content'], u'caption': u'Shots', u'filters': [[u'entity', u'type_is', u'Shot']], u'entity_type': u'Task'}]

说明:此设置定义左侧将会显示的不同选项卡。每个选项卡代表一个 Shotgun 查询,它们按某些 Shotgun 字段分组形成一个树结构。此设置是一个词典列表。列表中的每个词典定义一个选项卡,并具有以下键:caption 指定选项卡的名称,entity_type 指定要显示的 Shotgun 实体类型。filters 是标准 API Shotgun 过滤器(包括标准格式和复杂格式)的列表。hierarchy 是一系列与实体类型相关的 Sotgun 字段的列表,用来定义树结构的分组。

template_work

类型:template

说明:引用一个模板,在磁盘上定位工作文件。

template_work_area

类型:template

说明:引用一个模板,该模板将在磁盘上定位工作目录。

my_tasks_extra_display_fields

类型:list

说明:在“My Tasks”列表中与任务一起显示的其他字段的列表。

version_compare_ignore_fields

类型:list

说明:在比较文件以确定它们是否为同一文件的不同版本时应忽略的一系列字段的列表。如果保留为空,将只忽略 version 字段。指定要忽略的字段时应特别小心,因为 Toolkit 会认为这些字段值不同的文件的版本应该是唯一的,如果发现情况不是这样,将会报错。

hook_scene_operation

类型:hook

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

说明:应用需要执行的所有特定于应用程序的场景操作(打开、保存等)都集合在此挂钩中。

hook_filter_publishes

类型:hook

默认值:{self}/filter_publishes.py

说明:指定一个挂钩,当需要时,可过滤出 Shotgun 返回的当前工作区的原始发布列表。

custom_actions_hook

类型:hook

默认值:{self}/custom_actions.py

说明:此挂钩包含所有自定义的动作方法。

auto_expand_tree

类型:bool

说明:自动展开树视图的根级目录。

关注

0 评论

登录写评论。