xSTUDIO 用户指南

介绍

什么是xSTUDIO？

xSTUDIO 是一款媒体播放和审阅应用程序，专为电影和TV 后期制作行业（尤其是Visual Effects 和Feature Animation 行业）的专业人士而设计。 xSTUDIO focus 致力于提供直观、易于使用的界面，其核心是高性能播放引擎，C++ 和 Python API 用于管道集成和定制，以实现总体灵活性。该应用程序与MacOS（Apple）、MicrosoftWindows和许多流行的Linux桌面发行版兼容。

xSTUDIO 经过优化，可快速导入和处理大量媒体源、加载专用图像格式并以准确的色彩管理显示图像。用户可以快速将媒体导入、组织和分组到playlists和“subsets”中，播放和循环播放媒体项目，并添加评论notes和草图annotations，允许人们以高度交互和协作的方式查看媒体。非线性编辑 (NLE) timeline 界面允许用户快速轻松地创建、导入和导出多轨视频和音频编辑。这使得工作流程对于VFX、动画和其他后期制作活动中的团队来说至关重要，他们需要按需查看他们和他们的同事正在创建的艺术作品，无论是作为谨慎的媒体项目还是在序列编辑的背景下。例如，人们可以在查看的媒体源之间即时跳转、检查像素特写、跨多个媒体源进行逐帧比较、用图画和标题对媒体进行注释或添加反馈notes进行共享。

xSTUDIO v1.X - Over查看

xSTUDIO 是一款强大且高性能的播放和审核解决方案。自 2022 年 9 月起，它已在 DNEG 部署，并被我们全球团队的数千名 VFX 和动画艺术家、主管和制作人日常使用，以进行日常工作和图像审查。该应用程序的开发和扩展得益于 DNEG 庞大而多元化的团队的投入和反馈，因此 xSTUDIO 很大程度上是一款为 VFX 和动画专业人士制作的产品。

以下是 xSTUDIO 功能和性能的一些亮点。

界面

• 应用程序界面高度灵活且可配置。
• 设置其外观和组件以适合您自己的视觉效果 偏好和工作流程。
• 布局允许创建多个界面配置 并在您工作时无缝切换。
• UI 的许多组件都可以打开或关闭：
  • 为应用程序创建“干净”且简约的外观…
  • …或者充满功能和信息的界面…
  • …或介于两者之间的任何东西。

加载媒体

• 显示当今常用的几乎任何图像格式（EXR、TIF、 JPG、MOV、MP4 等）。
• 直接从桌面文件系统浏览器拖放媒体 进入xSTUDIO界面。
• 使用命令行界面将媒体“推送”到正在运行的 终端窗口中的 xSTUDIO 实例。
• 使用 Python API 构建您自己的定制playlists 脚本。

Playlists

• 创建任意数量的playlists、颜色代码并将它们排列在 类别标题。
• 拖放以重新排序和组织媒体和playlists。
• 对各个介质和 playlists 以及“flags”进行颜色编码 特征。
• 将 mini-playlist subsets 嵌套在父级 playlists 下以进一步 构建您的可视内容。
• 在父级playlists下创建contact sheets，进行布局 网格排列中的多个媒体项目以进行比较。

序列

• 通过拖放媒体来创建多轨视频timelines playlists进入timeline界面。
• 使用简单易用的编辑工具编辑您的timelines。
• 使用 OpenTimelineIO 交换导入和导出 timelines 设施。
• 使用审查友好的timeline工具，例如“focus”模式和项目 循环使基于序列的审查快速而简单。

Notes

• Add notes 和 annotations 到各个帧或范围上的媒体 帧数。
• 可以在屏幕上创建annotations，易于使用，高度 响应式绘图工具。 Annotations 当前功能 包括：
  1. 可调节颜色、不透明度和画笔描边的大小。
  2. 用于框、圆、线和箭头等的形状工具。
  3. 橡皮笔提供更大的素描灵活性。
  4. 可编辑的文本标题，位置、比例、颜色均可调整 和不透明度。
  5. “快照”按钮允许您将注释保存到磁盘 jpeg /tiff 等图像。
• 通过 notes 界面浏览您的媒体收藏 直接跳转到已添加书签的帧。

Viewer

• 色彩准确显示（OCIO v2色彩管理）。
• 热键驱动的交互。
• 调整曝光和播放速率。
• 缩放/平移图像工具，RGBA通道显示。
• 多个“Compare Modes”允许比较图像堆栈：
  • Grid 多个源的平铺布局模式
  • A/B & Wipe 比较
  • 合成模式（Over、Screen、Add等）
  • String Out 模式：动态地将多个源串在一起 平面编辑列表
• 可调节的遮罩覆盖层和引导线。
• “弹出”第二个viewer，用于双显示设置。
• 包含嵌入音频流的源的音频播放。

• 其他功能

  • 使用分级工具将创意分级应用于镜头和渲染。
    • 可以使用可编辑的多边形形状来掩盖等级
    • 等级面膜可软化
    • 通过简单的复制/粘贴操作将成绩导出到Nuke
  • QuickView 用于即时检查单个介质项目
    • 当 xSTUDIO 运行时，命令行调用可以弹出 独立的灯光播放器窗口，用于单独查看单个媒体。

API 管道开发人员的功能

C++API

• 写入 plugins 并具有对应用程序内部的完全访问权限 如果需要，组件可以降到最低级别。
• 提供C++基类用于实现常见的plugin 类型：
  • 视频输出 Plugin - 用于将视频传输到外部 应用程序，例如 SDI 显卡，渲染到磁盘或 流媒体视频内容
  • Viewport Overlay Plugin - 用于绘制自定义图形、文本 并将数据直接存入viewport
  • 颜色管道Plugin - 用于实施颜色管理。
  • 媒体阅读器Plugin - 实现特定文件的阅读器 格式
  • 数据源 Plugin - 构建 plugins 与生产交互 要导入到xSTUDIO的数据库和源媒体
  • 元数据挂钩 Plugin - 将管道元数据添加到媒体上 创建
• DNEG强大的Shotgrid浏览器界面的代码，利用 Shotgrid REST API，也包含在内以供参考。这是 为 DNEG 专有的 Shotgrid 表模式编写，不会 “开箱即用”，但开发人员可以调整代码以使其工作 如果需要的话，可以在其他工作室。

PythonAPI

• 创建 python Plugins 可以：
  • 提供菜单和您想要的任何其他GUI元素
  • 通过添加和重新组织与 xSTUDIO session 进行交互 媒体
  • 添加屏幕叠加图形
  • 播放期间接收事件通知
• 从单独的实例透明地连接到 xSTUDIO 实例 通过 Python API 进行处理 - 因此 xSTUDIO 可以在单独的 应用程序的软件环境，通过 API。
• 还可以执行嵌入式 python 解释器 xSTUDIO 中的脚本。这在 UI 的单独线程中运行 因此 python 执行不会影响 GUI 交互或播放。
• 通过简单的 API 创建和构建媒体 playlists 方法。
• 访问’playhead’来控制播放（开始、停止、步进 帧、跳跃位置等）。
• 提供各种演示 python plugins 和脚本 API 帮助开发人员快速入门的文档。

入门

建筑xSTUDIO

请遵循我们全面的build guide documentation build_guides`：有关构建xSTUDIO的说明。

推出xSTUDIO

这在一定程度上取决于您安装xSTUDIO的方式，但通常启动xSTUDIO的方法是：

• • Linux 在大多数 Linux 桌面上 要启动空的 xSTUDIO“Session”，请在 Linux 命令行上键入 xstudio，然后按 Enter。请注意，如果 xstudio 已经在运行，“xstudio”命令本身不会启动新的 xstudio 界面，而是与现有实例进行通信。这就是xSTUDIO的快速媒体推送加载的工作原理。为了确保您获得新的 xSTUDIO GUI session，您可以添加“-n”命令行选项：xstudio -n。
• • Windows 在 Windows 上安装xSTUDIO 应添加到 Windows 开始菜单的快捷方式。
• • MacOS xSTUDIO 作为应用程序包部署在 MacOS 上，只需像任何其他应用程序一样双击应用程序图标即可。

加载媒体（文件系统浏览器）

加载媒体的一种简单方法是将文件或文件夹从文件系统拖放到主窗口中。如果您删除文件夹，系统将在该目录中递归搜索媒体文件，并将它们全部添加。

您可以从文件系统浏览器拖放到 3 个目的地：

• Playlists面板的空白区域：这将创建一个新的 playlist 并添加媒体。
  • 放入的顶级文件夹的子文件夹 xSTUDIO 将创建一个 subset
• Playlists 面板中现有的 playlist 条目：这将添加 将媒体复制到您将文件放入的playlist。
• 媒体列表面板：这会将媒体添加到列表的末尾 playlist 正在媒体列表中检查。

加载媒体（命令行）

可以使用终端窗口中的 xSTUDIO 命令行加载媒体，这对于熟悉 shell 语法的用户来说将非常方便且功能强大。默认情况下，如果xSTUDIO已在运行，文件将添加到现有的session，而不是启动新的session。如果您想启动新的 session，请使用 -n 标志。

xSTUDIO支持多种加载序列的模式。您可以根据需要混合不同的模式

xstudio /path/to/test.mov /path/to/\*.jpg /path/to/frames.####.exr=1-10 /path/to/other_frames.####.exr

在 Windows 上，您的命令可能如下所示，但通过在 Powershell 中使用简单的命令别名可以简化此操作

C:\Program Files\xSTUDIO\bin\xstudio.exe C:\Users\JaneSmith\\Media\test_movie.mp4 C:\Users\JaneSmith\Media\exrs\exr_sequence.####.exr

或者，在 MacOS 上，您将需要 xSTUDIO 应用程序包的路径，可能如下所示

/Applications/xSTUDIO.app/Contents/MacOS/xstudio.bin /Users/joe/Downloads/imported_media

请注意，可以加载特定的 subset 帧，或者通过省略一个范围，将加载与该模式匹配的所有帧。

有关命令行加载的更多详细信息，请参阅附录 Pt.1。

查看媒体

当您拖放到xSTUDIO媒体列表面板时，第一个项目将立即显示在屏幕上。要查看当前 playlist 中的其他媒体，请使用向上/向下箭头键循环浏览 playlist 中的项目。请参阅“媒体列表面板”部分，了解选择您正在查看的媒体的更多方法。如果您拖/放到playlists面板中，媒体不会立即加载到viewport中。 需要双击新建的playlist，将其内容放入viewport

要选择 playlist，请在 Playlist 面板中单击它。要选择 playlist 并开始查看其内容，请双击 Playlist 面板中的 playlist。

如果您选择的playlist与查看的playlist相同，只需单击“媒体列表”面板中的媒体项目即可在viewer中查看它并开始播放/循环播放。向上/向下箭头热键也是循环浏览 playlist 中查看的媒体的简单方法。

如果您选择的playlist不是查看的playlist，则双击媒体列表中的某个项目会将您查看的playlist切换到所选的，并且您单击的媒体将开始播放。

创建序列 (Timeline)

要开始创建多轨编辑，您必须首先拥有一个 Playlist，因为序列只能作为 Playlist 的子项存在（有关更多详细信息，请参阅 Media List Panel）。您可以在选定 Playlist 的情况下单击鼠标右键，或点击“More”按钮（Playlist 面板右上角的三个点）并选择“新序列”。

创建序列后，可以通过从父Playlist拖放媒体来填充它，甚至可以将新媒体直接拖放到媒体列表中，并在Playlists面板中选择序列。

该短视频演示了序列创建。

xSTUDIO 接口

自定义界面布局

xSTUDIO的主窗口提供了3种不同的默认布局（Timeline、回顾、展示），可以从窗口右上角的架子中进行选择。它们还可以使用“F1”、“F2”和“F3”键循环（如果您有超过 3 个布局，则依此类推）

您可以根据需要修改现有布局（当前布局除外），也可以通过xSTUDIO界面右上角的汉堡菜单按钮创建新布局。此菜单还为您提供了重命名、删除或重新排序列表中任何布局（“演示”除外）的选项。

该系统旨在让您完全控制 xSTUDIO GUI 的配置方式，以便您可以根据需要将其设置为简单或复杂，以支持您首选的工作方式、组织媒体和查看 session。

缩放和划分布局中的面板

除了 _Present 之外，每个布局都将 xSTUDIO 窗口分割为水平或垂直面板。每个面板可以包含一个或多个 xSTUDIO 的界面 - 例如，媒体列表、Playlists、Viewport、Timeline 等。这些面板可以通过单击并拖动分隔它们的装订线（细小的空间）来调整大小。当面板包含多个接口时，它们将被选项卡化，以便您可以快速切换给定面板中哪个接口处于活动状态。

可以对面板进行细分以在界面中创建更多面板，并且可以根据需要多次执行此操作。要细分现有面板，请查找面板标题栏右上角的汉堡菜单按钮。此菜单具有水平或垂直分割面板或销毁面板（从而为剩余面板腾出空间）的选项。

要选择填充给定面板的界面，请查找面板区域左上角的选项卡选择器。选项卡标题旁边有一个 V 形按钮，单击此按钮会弹出一个选项，显示可以加载到面板中的界面的选择。要使用多选项卡面板功能，请单击 + 按钮添加新的选项卡式界面。

提示：当您对布局感到满意时，建议使“选项卡”选择器不可见，但包含多个选项卡的面板除外。这样做可以减少界面的混乱并释放一些空间。这可以通过 xSTUDIO 窗口右上角的汉堡菜单按钮来完成。在菜单的“选项卡可见性”部分下选择“隐藏全部”或“隐藏单个选项卡”。

提示：按“Tab”键可在“当前”布局和替代布局之间切换。这默认为预设之前最近使用的布局。

自定义界面演练

这段简短的视频演示了其中一些自定义操作：

其他定制

通过文件->首选项->首选项管理器，您可以启动该工具来设置用户首选项。转到“界面”选项卡，获取一些用于更改 xSTUDIO 界面外观的选项。

您可以修改界面的整体色调，字体/图标亮度和背景级别。关闭扁平主题后，小部件会以微妙的渐变效果绘制，以获得更现代的外观，尽管有些用户可能会发现 UI 中的渐变会下意识地影响viewport中图像内容的感知评估。 UI 缩放选项是

Playlist 面板

Playlists 面板提供了一个通过 Playlists 访问和组织您的 Session 的界面。 playlist 层次结构旨在让您轻松组织从小到大的媒体集合，还可以收集媒体项目的子组以及playlists 中的timeline 编辑。

入门

有多种方法可以开始构建playlists：

• 使用More/上下文菜单按钮（或右键单击 面板）以访问 Playlists 菜单。
• 从文件系统中拖放文件夹将创建名为 Playlists 根据文件夹名称。
• 将各个媒体文件拖放到playlist面板中 使用默认名称创建一个播放列表。
• 使用 + 按钮访问 Playlist 创建菜单。
• 从Media List Panel media_list_panel`你可以复制 通过 context menu 将媒体移至新的 Playlist。

检查 Playlist 介质

要查看 Playlist 中的媒体，只需单击 Playlist 项目即可。它将被设置为检查项目，这意味着Media List Panel media_list_panel`现在将显示Playlist的内容。请注意，检查的 Plalist 项目由突出显示颜色指示。

查看Playlist媒体

要实际开始查看Playlist（或Subset、Contact Sheet、序列）中的媒体，必须将其设置为“屏幕上”项目。只需双击 Playlists 面板中的项目即可完成此操作。屏幕上的项目由面板中项目右侧显示的屏幕图标指示（参见上图）。请注意，屏幕上的项目可能与检查的项目不同，后者的内容显示在媒体列表面板中 - 这是为了允许我们在playlists之间复制/移动媒体，而不会干扰Viewport中正在播放的内容。

组织Playlists

• Playlist 项目可以通过简单的拖/放操作重新排序。
• 可以创建Dividers来帮助组织 - 使用 context menu 或加号按钮创建Dividers。
• context menu 提供重命名Playlists、Dividers 的选项 等等
• 使用垃圾桶图标或context menu删除Playlists， Dividers等
• 要在 *Playlists/Subsets 等之间移动/复制媒体，请选择 通过 Media List Panel media_list_panel` 和 从那里拖/放到 Playlists 面板中的项目中。

PlaylistFlags

您可以通过Context Menu中的设置颜色子菜单将颜色flags添加到Playlists、Subsets、Contact Sheets等。该标志充当简单的指示器，完全是为了用户自己的目的，对 session 中的项目进行颜色编码，以引起他们的注意。

xSTUDIOSubsets

Subset 是给定Playlist 内的媒体集合。这个概念提供了一种在 Playlists 中进一步对媒体进行分类的便捷方法。请注意，Subset 中的任何媒体仅是对父级 Playlist 中媒体项的引用。因此，Subset中的任何媒体将始终存在于父级Playlist中，并且对给定媒体的任何更改（例如添加的书签notes或annotations）都将在subset和父级Playlist中的媒体上看到。

创建和构建Subsets

• 从“+”菜单中选择“Subset”将新的 Subset 添加到 当前选择Playlist。如果没有选择默认播放列表 还为 Subset 创建父级。
• 从 More/Context Menu 选择 Add 新->Subset 选项。
• 在Media List Panel media_list_panel`中选择媒体项 现有的Playlist并使用Add媒体到…->新Subset菜单 选项
• 与一个

如果从父级 Playlist 中删除 Subset 引用的媒体，则该媒体也将从 Subset 中删除。然而，反之则不然，从 Subset 删除媒体不会将其从 Playlist 中删除。

xSTUDIOContact Sheets

Contact Sheet 与 subset 非常相似，不同之处在于 Contact Sheet 中的所有媒体在 Viewport compare mode 中均处于活动状态，无论媒体的选择状态如何。因此，如果Contact Sheet上的compare mode设置为“Grid”，则Contact Sheet中的所有媒体都将使用Grid布局显示在Viewport中。有关更多详细信息，请阅读Compare Modes compare_modes`部分。

Dividers

您可以通过“AddPlaylists”按钮添加分隔线。分隔板只是playlist系列中的一个带标签的栏，可以帮助组织。

媒体列表面板

媒体列表是一个可滚动窗口，显示当前检查 Playlist、Subset、Contact Sheet 或序列中的有序媒体列表。有关检查和查看 playlist 项之间差异的更多详细信息，请参阅Inspecting playlist media inspecting_playlist_media`。

媒体列表提供了两种视图选项，可通过面板右上角的按钮进行切换：列表模式（上图）或缩略图模式（下图）。

媒体选择和观看

单击媒体列表中的任何媒体项目将选择它（如果它还不是多重选择的一部分）。对于Playlists 或Subsets，媒体选择将决定在xSTUDIO Viewport 中播放哪些媒体。但是，对于 Compare Modes 和序列，该选择不会影响正在播放的媒体。如果您查看Playlist/Subset/Contact Sheet/序列与所选的不同，但您想查看媒体列表中的媒体项目，那么双击它将强制查看的playlist/subset切换到您选择的playlist或subset。

也可以选择多个媒体，这是利用播放头 compare modes 所必需的：

• 要设置多项选择，请在按住 CTRL 键或 SHIFT 键。
• 您选择项目的顺序已注册并显示在 媒体视图的最左边的列。
• 当您单击“已选择”的媒体项目时 选择不会改变，但您单击的媒体将会改变 在 viewport 中播放（如果您没有观看不同的 playlist）。
• 要清除您的选择，请单击未选择的媒体项目或使用 “CTRL+D”热键。
• 要选择 playlist 中的所有项目，请使用“CTRL+A”热键。

媒体列表Context Menu

在媒体列表中单击鼠标右键将显示一个弹出菜单，可以访问与所选媒体相关的各种操作。从此菜单中，您可以将媒体选择移动/复制到新的Playlists/子集/Contact Sheets/序列中：

• 将媒体“标志”颜色设置为突出显示具有某些状态的媒体 根据你自己的方案。

• 选择媒体（全选、仅选择离线媒体）

• 将媒体复制/移动到新的Playlists/Subsets等。

• 复制选定的媒体项目

• 在系统文件浏览器中显示磁盘上的媒体位置。

• 将所选媒体的文件名或文件路径复制到剪贴板。

• 打开QuickView quick_view`窗口来播放选定的媒体。

• • 重新加载媒体（丢弃缓存的帧、重新扫描帧范围和 重新加载）。 如果您已加载 CG 渲染或合成，此选项很有用， 说，这仍在进行中。随着磁盘上出现更多帧 您可以点击“重新加载”菜单选项或相关的热键 并且媒体项目将使用新的传入帧进行刷新 已加载。

• 运行Python Snippets python_snippets`（您自己的自定义Python 脚本）

配置媒体列表列

媒体列表的列表模式在完全可配置的列中显示元数据。您可以添加、删除和重新排列这些列，并选择它们显示的元数据。您还可以设置正则表达式来捕获元数据字符串的一部分以供显示。

要配置媒体列表列：

1. 将鼠标悬停在其中一个列标题上。齿轮图标将 显示在列标题中。单击此按钮可以打开 配置对话框。

2. 使用删除/左移/右移按钮删除或移动 柱子。

3. 设置列的标题

4. 从下拉列表中选择该列的指示器类型。 有具有固定用途的“标准”类型或选择 元数据值

5. • 如果您选择 元数据值，现在选择 元数据将来自元数据所有者下拉列表。

     • 媒体 - 媒体项是媒体的容器 来源，并且*仅在您有一些元数据的情况下才会有元数据 添加元数据的自动化脚本设置。这将 通常只有在岗位上工作的用户才会出现这种情况 具有一些管道集成系统的制作工作室 设置。*参见Pipeline Integration pipeline_integration` 了解更多详情。对于在境外工作的个人用户 工作室这里的 Media 选项将为空而不是 有用。
     • 媒体源（图像） - 选择此选项意味着您 可以查找与图像源有关的元数据值 媒体项目的。
     • 媒体源（音频） - 选择此选项意味着您 可以查找与音频源有关的元数据值 媒体项目的。

6. • 现在我们需要设置元数据路径以便选择 元数据字典中的字段。

     • 媒体源元数据本质上是一个字典 从媒体文件中提取的元数据。为了 例如，EXR图像可以在其中存储大量数据 图像头 - xSTUDIO 将读取此数据并将其存储为 媒体源的元数据。
     • 选择元数据字段的最简单方法是单击 右侧的文档放大镜按钮上 相应的框。
     • 将打开一个新窗口，列出所有元数据字段 对于媒体源。
     • 单击元数据字段列表中的任意行 为您的媒体列表列选择它。

7. -（高级）使用正则表达式来匹配元数据 字段值并提取较长字符串的有用部分 例如完整的文件路径

   • 正则表达式功能强大，但使用起来很麻烦！做 如果您是的话，可以进行一些互联网研究以了解更多信息 不熟悉。
   • 例如，您可以选择文件路径元数据 价值。文件路径可以是 /Users/joe/media/ARX/001_prd_0200/renders/comp/C_001_prd_0200_comp_v001.mp4
   • 从视觉上看，显示整个文件路径是没有用的。我们 可能更喜欢 C_001_prd_0200_comp_v001
   • 为此，我们可以将正则表达式设置为： .+/([_a-zA-Z0-9]+_v[0-9]+).mp4
   • 我们将格式表达式设置为 $1 以显示第一个 捕获的字符串。

配置媒体列表演练

该短视频演示了如何使用正则表达式和元数据字段来澄清信息并将其添加到媒体列表中。

Viewport

Viewport是显示图像的面板，自然也是您最常关注的地方\！可以进行一定程度的自定义，这可以通过 Context/More 菜单来完成（在 Viewport 中单击鼠标右键，或单击 viewport 右上角的“More”按钮）。

与Viewport互动

三键鼠标可用于更仔细的图像检查。按住中间按钮并拖动以在viewport内平移图像。按住键盘上的 CTRL 键并用鼠标中键向左/向右拖动可对图像执行居中放大/缩小。

在 Viewport 操作栏中，提供了用于打开/关闭缩放和平移模式的按钮，其中鼠标左键/主键拖动可用于放大/缩小或平移 viewport 内的图像。缩放/平移图像后，适合热键（默认键：F）将恢复适合模式。

在xSTUDIO首选项中，有一个用于设置鼠标滚轮行为的选项 - 如果将其设置为“缩放Viewer”，您可以滚动鼠标滚轮来放大/缩小viewer中的图像。或者，您可以使用鼠标中滚轮在帧中向前/向后移动。

使用鼠标主/左键单击并向左/向右拖动将在帧中向前/向后擦洗playhead。此操作的鼠标灵敏度也可以通过用户首选项进行设置。

Timeline

xSTUDIO 的 Timeline/Sequence 界面允许您加载、创建、导出多轨视频编辑并与之交互。它具有一些专为 VFX 和动画审查工作流程以及通用编辑工具量身定制的功能。

序列创建

要开始使用，您必须首先拥有一个Playlist。选择Playlist，然后使用Playlists Panel playlist_panel右键单击Context/More菜单中的*AddNew-\>Sequence*。然后，您可以选择包含媒体的Playlist，以便媒体显示在Media List Panel media_list_panel中，从媒体列表中选择媒体并拖放到Playlist面板中的序列对象中。或者，您可以从 playlist 选择媒体，然后在媒体列表中选择 Add Media To->New Sequence … 菜单选项。

有一个快速入门视频演示here. creating_a_sequence`

加载和导出Timelines

xSTUDIO使用优秀的OpenTimelineIOPython模块，使其能够以多种格式加载和导出timelines，以便与Premiere和Avid等专业编辑软件兼容。要加载 timeline，请使用 xSTUDIO 界面顶部主菜单栏中的文件->导入->OTIO… 菜单选项。类似地，要从 xSTUDIO 序列导出 timeline 文件，请在 Playlists Panel playlist_panel` 中选择序列并使用 File->Export->Selected Sequence as OTIO… 菜单选项。

与序列交互

timeline 中的基本编辑工具应该很容易找到。 timeline 缩放和平移设置对于编辑导航非常重要，尤其是较长的编辑。默认热键快捷键F将重新focus所有剪辑上的timeline视图 - 即缩放将被调整，以便序列的整个持续时间将适合timeline窗口。您还可以使用“适合全部”按钮来实现此目的。

基本编辑功能

要制作和构建视频轨道：

• 使用 + 按钮创建新的视频或音轨
• 将媒体从 MediaList 拖放到序列中的轨道中 开始将媒体添加到编辑中。

通过左侧工具箱中的按钮激活工具以移动、修剪和剪切剪辑并导航序列：

• 使用选择工具单击选择或拖动选择剪辑 timeline。
• 使用左侧工具箱中的按钮访问移动工具 开始在 timeline 周围拖动剪辑。
• 在移动模式下，当鼠标悬停在剪辑边缘时，手柄会出现 将出现可用于修剪或延长任一端的剪辑（但在底层媒体的可用持续时间内）。
• 滚动工具允许您在剪辑内单击并拖动鼠标
  • 这将在可用范围内滑动剪辑的活动范围 媒体范围。仅当您修剪了剪辑并且它有手柄时，这才有用
• 剪切工具会将鼠标下方的剪辑分成两个剪辑 当您单击鼠标左键时。
• 缩放工具允许您更改图像的视觉缩放比例 通过在 timeline 中单击并拖动来实现 Timeline。请注意，按住 CTRL 键并滚动鼠标中轮（如果有）也可以调整缩放。
• 平移工具允许您将可见窗口滑入 timeline 用鼠标左/右拖动

Focus模式

单击相应按钮（靠近界面中顶部）激活 Focus 模式。这种模式在VFX和动画评论的背景下非常有用。它的作用是确保选定的剪辑或轨道始终可见，即使它们不是堆栈的最顶层。这意味着您可以拥有一堆具有符合 timeline 的各种版本/输出的视频轨道。如果您想查看整个编辑过程，但对于一个镜头您想查看隐藏在较低视频轨道之一中的早期版本，您可以选择该特定剪辑并使用 focus 模式。然后，所选剪辑将在播放过程中可见，并覆盖其他将隐藏它的剪辑。类似的逻辑可以应用于整个视频轨道。

在节上循环

单击相应按钮（Fcous 模式 按钮旁边）激活Loop 模式。播放期间，playhead只会在序列中所选项目的范围内循环。

纹波模式

单击相应的按钮激活波纹模式。现在，当使用“移动”工具滑动剪辑时，同一视频轨道中“跟随”该剪辑的所有剪辑都将滑动相同的量。

Over写入模式

单击相应按钮激活 Overwrite 模式。现在，当使用“移动”工具滑动剪辑时，您可以将剪辑滑动到其他剪辑的顶部 - 当您释放鼠标按钮时，剪辑将被放入该位置，并且下方的剪辑将相应地进行拼接，以适应移动剪辑在视频轨道中的新时序。

Context Menu

选择一个或多个剪辑时，单击鼠标右键将显示“剪辑”context menu，提供一系列操作来移动、禁用、打包、删除剪辑、在选定剪辑上设置自定义突出显示颜色等。

序列标记

可以通过鼠标右键上下文菜单在timeline的空白处，然后选择Add标记将简单标记添加到序列中。新标记将在当前 playhead 位置创建。当指针悬停在标记上时单击鼠标右键，您将看到一个菜单，允许您设置标记的颜色、名称和注释字符串，如果随后单击该标记，注释字符串将可见。

传输控件和工具栏

工具栏和传输控件位于 Viewer 的正下方。工具栏提供用于修改 viewer 的外观和行为的控件：

运输控制

xSTUDIO 传输控件允许您开始/停止播放并按顺序跳转媒体项目。这些按钮对于用户来说应该很熟悉，如下notes：

• 单击时间码/当前帧指示器以获取选项 更改显示。
• “来自 trimecode 的帧”会将时间码显示为 绝对 TC 框架。因此 24fps 的时间码为 00:00:10:10 例如，媒体项目的 TV 帧为 254。
• 单击并拖动timeline栏以设置当前帧。
• 快照工具提供了一种将当前帧导出为 静止图像（包括屏幕上的annotations）。
• 在时间栏区域，绿色块表示已经被删除的帧。 解码并存储在缓存中准备播放。要调整 图像缓存的大小请参阅 xSTUDIO 首选项。
• 当框架不可用时（例如当A/B比较两个 具有不同持续时间的媒体项目，并且您正在查看该项目 持续时间较短）橙色条显示在timeline中。

xSTUDIO 工具栏

xSTUDIO 的工具栏提供了许多按钮，允许与媒体播放和显示的各种设置进行交互。请注意，工具栏中的每个按钮都可以隐藏或显示为用户可配置的设置，以便您可以根据需要仅包含有用的按钮。如果需要，工具栏也可以完全隐藏。请注意，由工具栏按钮控制的某些状态也可以通过 xSTUDIO 热键进行调整。工具栏的元素总结如下：

配置xSTUDIO工具栏

通过ViewportMore/上下文菜单（在viewport中右键单击或点击Viewport面板右上角的More按钮），您可以进入工具栏子菜单来激活或取消激活工具栏项目，以整理或增强您自己的工具栏项目工具栏。

工作流程工具

视频播放

播放头

在xSTUDIO中，每个playlist都有自己的playhead对象，这意味着如果您在playlists之间切换，则会记住playhead设置，例如播放速率、循环模式、compare mode等per playlist。

播放头特定热键

播放头循环模式

通过媒体播放时，使用循环模式按钮可在“播放一次”、“循环”和“乒乓”之间切换。

播放头速率

可以通过单击并左右拖动工具栏中的“速率”按钮来调整playhead速率。请参阅Transport Controls _transport`部分。速率是一个简单的乘数，应用于 playhead 在播放过程中前进的速度。例如，值为 0.5 将以半速播放媒体。双击按钮重置为 1.0。

播放头缓存行为

xSTUDIO 将始终在需要显示之前尝试读取和解码视频数据。图像数据存储在图像缓存中，准备绘制到屏幕上。 xSTUDIO 需要高效地执行此操作，如果用户理解该行为，它会很有用。

如果您没有主动播放媒体：当您选择要查看的新媒体时，或者每当移动playhead的位置时，xSTUDIO将开始从playhead位置向前加载图像，直到耗尽您正在查看的剪辑的帧范围或直到缓存已满。先前加载的图像将从缓存中删除，以便为新图像腾出空间。

缓存状态在 timeline 中用水平绿条指示 - 这应该很明显，因为您可以看到它随着 xSTUDIO 在后台加载帧而增长。因此，如果您想查看从磁盘读取速度较慢的媒体，例如高分辨率 EXR 图像，工作流程是等待 xSTUDIO 缓存帧，然后再开始播放/循环。缓存的大小（通过“首选项”面板设置）将限制可以加载的最大帧数。

在大多数情况下，xSTUDIO应该能够以媒体所需的帧速率通过缓存的帧进行播放。尽管Viewer已经过优化，可以充分利用您的显卡，但如果您尝试查看非常高分辨率的图像并且您的计算机的视频硬件无法匹配所需的数据传输速率，则可能会导致播放速度缓慢。

对于解码速度快于播放速率的媒体，例如许多常见的压缩视频流编解码器或使用 DWA/DWB 压缩的 EXR，您应该能够在很大程度上忽略 xSTUDIO 的缓存活动，因为它将能够从磁盘流式传输数据以便按需播放。

丢失帧行为

当 xSTUDIO 加载基于帧的媒体时（换句话说，每个视频帧都是磁盘上的独立文件，如 EXR 或 JPEG 文件），当与落在预期范围内的某个帧编号对应的文件“不在”磁盘上时，有 3 种行为可供选择。这在查看 CG 渲染时很重要，例如，某些帧尚未渲染但帧范围中的其他帧已完成。要更改首选项，请转到“文件”->“首选项”->“首选项管理器”菜单选项，然后转到“首选项管理器”对话框中的“常规”选项卡。

• 插入空白帧 缺失的帧将替换为空白 帧，因此图像序列的帧范围被保留。请注意，传输条时间滑块中丢失/不可加载的帧由帧缓存指示器中的红色条显示
• 保留帧 丢失的帧将替换为前一帧 可以加载。保留的帧在帧缓存指示器中用橙色条指示
• 跳过丢失的帧 使用此选项，帧范围 有问题的媒体源项目将折叠以忽略丢失的帧。因此，如果您有一个由以下文件序列组成的图像序列：render_v01.1001.exr、render_v01.1004.exr、render_v01.1011.exr、render_v01.1021.exr，那么生成的 Mwedia Source 项目的持续时间将仅为 4 帧。

Compare Modes

标有“比较”的工具栏按钮为当前查看的 Playlist/SubSet/Contact Sheet 或序列的播放头设置 compare mode。了解 xSTUDIO 的简单比较工作流程对于充分利用该应用程序非常重要。

Compare Modes 总结

比较 Playlists 和 Subsets 中的媒体

有关 Playlists、Subsets 和 Contact Sheets 的介绍，请参阅:ref:`Playlists Interface <_playlist_panel>` 部分。

Playlists 和 Subsets 中的图像比较是由内部媒体的选择状态“动态驱动”的。通过Media List Panel _media_list_panel`选择的媒体项目将根据您当前的Compare Mode加载进行比较。选择媒体项目的顺序决定了 Compare Mode 的顺序。因此，例如，如果您使用“Over”模式，并选择第 11 个媒体项目，然后选择媒体列表中的第 10 个媒体项目，则第 11 个项目将合成到 Viewport 中的第 10 个项目上。

比较 Contact Sheets 中的媒体

Contact Sheets 与Playlists 和Subsets 的不同之处仅在于加载Contact Sheet 中的所有媒体进行比较，无论媒体项的选择状态如何。因此，例如，如果您想在网格中布局 viewport 中的多个媒体项目，您可以将这些媒体项目添加到 contact sheet 并将 Compare Mode 设置为“网格”。查看 Contact Sheet 将为您提供网格视图。

比较序列中的媒体 (Timelines)

xSTUDIO的Compare Mode系统在应用于多轨编辑时提供了一些有用的功能：

• 当 Comapare 模式设置为 Off 时，Viewport 只会 显示 timeline 编辑的烘焙结果，使得最上面的 可见轨道将提供视频中任何给定帧的视频 timeline。
• 当 Compare Mode 设置为 Off 以外的设置时 活动视频轨道将单独加载以进行比较。 因此，例如，如果您的 Compare Mode 设置为 Grid，并且您的 序列有 4 个独立的视频轨道，您将看到网格布局 viewport 中的 4 个图像。每个图像都是当前帧 各自的视频轨道。

Compare Modes 演练

该短视频演示了 compare modes 的实际应用（非详尽演示\！）

Notes 和 Annotations

xSTUDIO 的 notes 功能提供了一种快速、简单的方法来使用文本注释和屏幕草图标记媒体。这允许用户记录并与同事分享书面和视觉反馈，或制作annotations供自己使用。

Notes 还可以用作空书签来标记媒体项目上感兴趣的帧或一系列帧。然后，notes 面板可以用作快捷工具，在审阅期间在这些帧之间跳转和循环。

Add记笔记

可通过三种方式在媒体项目的任何框架上创建注释。注释始终添加到屏幕媒体的当前（屏幕上）帧中：

• 点击“;”键立即在当前的注释上创建一个空注释 框架。
• 热键“N”（或单击左上角的notes按钮） Viewer) 显示Notes 界面。点击“Add注意”按钮 在notes界面中。
• 按“D”热键显示注释工具工具箱。开始 在 viewer 中的图像上绘制笔划或形状 - 这将 自动在框架上创建注释。

屏幕上的草图始终附加到给定帧的当前注释。如果开始创建草图时没有注释，则会创建一个空注释。

修改注释

• 将您的notes文本内容直接输入到Notes的注释中 界面。
• 单击“主题”框可更改笔记主题/标题。
• 使用入点/出点上的“设置”按钮来扩展音符 持续时间和/或移动其在媒体帧范围内的位置。
• 可以从下拉列表中选择注释类别。类别 下拉列表中显示的选项是可配置的（请参阅有关首选项的附录部分）。
• 要删除注释，请右键单击它并选择“删除注释”或 点击笔记条目右上角的“X”按钮。

导航Notes

传输栏timeline的下半部分指示注释的存在。指示器的颜色与与节点类别关联的颜色相匹配。的, 和 .键盘上的按键会将playhead跳转到timeline上的上一个或下一个音符。在 notes 窗格中，您可以在 Playlist 或媒体之间切换“范围”。 “playlist”选项将显示当前playlist内的所有notes。 “媒体”选项将仅在当前（屏幕上）媒体项目上显示notes。单击Notes窗格中的注释缩略图可切换到相应的媒体和窗格。单击 Notes 窗格中音符上的“循环”按钮，设置 playhead 循环输入/输出点以匹配音符时长。

绘图Annotations

可以使用“D”热键或单击viewer左上角带有钢笔图标的按钮来显示或隐藏绘图工具框。 xSTUDIO 的绘图工具应该易于掌握 - 只需开始直接在 viewer 上绘制笔划、形状或文本标题即可。如上所述，当您创建新注释时，始终会创建“注释”。

绘图是“基于矢量”的（而不是光栅化像素），并且由显卡“即时”渲染。您可以放大和缩小 viewport，并且画笔描边应始终呈现无像素化的效果。绘图可以延伸到图像边界之外，因此您可以根据需要在图像的侧面或上方和下方自由添加草图。

提供“激光”手绘模式，以便您可以绘制非持久笔划，这些笔划会逐渐消失，直到几秒钟后消失。这对于向参与审阅的同事突出显示图像的某个区域非常有用，而无需不断擦除或撤消笔画。

要输入文本标题，请选择“文本”工具，单击 viewport 放置标题并开始输入。标题框一角的手柄允许您移动和缩放该框。在输入文本期间和之后，可以放置文本标题、调整大小、着色和缩放文本标题。

导出Annotations

要将注释（绘图）导出为单个图像或一组图像，请导航至 文件 -> 导出 菜单并选择 ‘Annotations …’ 选项以打开注释导出向导。您还可以选择将 annotations 导出为蜡笔包，以便导入到 Blender、Maya、3DS-Max 或支持该格式的其他应用程序中。这将允许您将 xSTUDIO 绘图加载到 3D 应用程序中，以在 3D viewport 中可视化动画 notes。

此向导提供了一些选项，可让您轻松导出 annotations：

• 范围： 将鼠标悬停在问号图标上可查看 此处选项的描述。
• 导出模式： 将鼠标悬停在问号图标上 此处选项的描述。
• 文件类型： 选择导出图像的文件类型。这 选项有 PNG、JPG 和 TIFF。
• 输出分辨率： 选择导出的分辨率 图像。
• 图像名称： 设置导出图像的名称或 油笔包（取决于导出模式）。
• 输出文件夹： 设置导出的文件系统目标 一个或多个图像或蜡笔包（取决于导出模式）。

使用 Annotations 导出 Notes CSV

要将 notes 导出为 CSV 文件，请导航至 文件 -> 导出 菜单并选择 ‘Notes …’ 选项。将打开一个文件对话框，您可以在其中选择导出的 CSV 文件的目标位置和名称。导出的 CSV 文件包含笔记主题、文本内容、类别、输入/输出帧范围（作为时间码）、笔记所附加的媒体文件路径、JPEG 图像的路径（相应笔记框架上媒体的屏幕截图）以及 notes 本身的正文文本。作为导出的一部分，还会创建一个文件夹（使用 .csv 文件名的主干） - 每个笔记（包括绘制annotations）的相应媒体框架的 JPEG 图像都会渲染到此文件夹中。

评分工具

xSTUDIO 提供了一个分级工具，允许创建和操作 SOP 等级，可应用于媒体项目或媒体项目总持续时间内的单个帧或某些帧范围。可以非常轻松地创建遮罩形状以遮盖或遮盖图像的某个区域。与 xSTUDIO 的 notes 系统结合使用，您可以通过大量控制来记录和分享想法，从而进行创意分级 notes。如果需要，多个等级也可以“堆叠”在单个媒体项目上。

创建成绩

当屏幕上感兴趣的媒体框架和打开的分级工具（可以是浮动窗口或xSTUDIOinterface layout interface_layouts`中的面板内）时，您可以点击 + 按钮创建新的分级布局，或者开始在分级界面中移动色轮手柄。

编辑成绩

当您想要更改现有成绩时，请单击“评分”面板左侧列表中的成绩图层项目。 * 使用垃圾桶按钮删除选定的成绩 * 使用相应的按钮将成绩设置为单帧或媒体剪辑的完整持续时间

多边形级掩模

• Add 通过点击“多边形”按钮创建遮罩形状
• 添加多边形时，单击viewport放置顶点 多边形边界。单击初始点将闭合形状并形成多边形。
• 可以通过拖动其点来编辑多边形。
• 双击多边形边界以添加新点
• 当鼠标悬停在多边形点上时，SHIFT+单击将 删除它。

椭圆级掩模

• Add 带有“椭圆”按钮的椭圆形面罩形状
• viewport 覆盖层上的手柄

评分演练

该视频演示了对具有多边形和椭圆形的板的区域进行分级，并向整个图像添加分级：

QuickView

VFX 和动画艺术家可能更喜欢能够快速且独立地查看各个媒体项目（例如最新的播放预览渲染等），而无需导航 xSTUDIO Playlists 或媒体列表。为了提供这种工作流程功能，xSTUDIO具有“QuickView”播放器窗口，它是一个独立的轻量级Viewport实例，仅显示单个媒体项目。这些窗口可以从主界面、命令行或PythonAPI快速启动。

来自命令行的QuickView

如果您有用于运行 xstuio 的终端/shell 快捷方式或别名设置，则可以使用 —quick-view 命令行标志轻松将 xSTUDIO 加载到 quickview 窗口中。

xstudio /Users/jane/data/renders/project_001/shot_f0010/renders --quick-view

QuickView 来自 Python API

对于想要使用xSTUDIO的API与自己的工具集成以及将媒体加载到quickview窗口中的用户，可以使用PythonAPI轻松完成。

XSTUDIO = Connection(auto_connect=True)
import glob
renders = glob.glob("/Users/joe/reference/water/*wave*.mp4*")
# load multiple files into a single QuickView using 'Grid' compare
XSTUDIO.api.session.quickview_media(renders, compare_mode="Grid")

界面中的QuickView

如果需要，您还可以从界面访问QuickView媒体。在Media List Panel media_list_panel`中选择一个或多个媒体项目，然后从右键单击上下文/More菜单中选择“QuickView选定”。

QuickView CLI 演示

视频输出（渲染）

xSTUDIO 允许您使用流行的各种视频和音频编解码器将 Playlists、Subsets、Contact Sheets 和 Timeline 渲染到容器化媒体文件（mp4、mov、mkv、webm 等） FFMpeg 应用程序。您可以在Playlists窗格中选择一个或多个项目进行渲染，然后单击鼠标右键以获取context menu（或通过主文件菜单）并选择导出->将所选项目渲染到电影…/

然后，您将看到“渲染视频”对话框，您可以在其中指定输出视频的格式。

渲染什么

渲染的内容取决于您根据以下简单规则选择的项目类型：

• Playlistst 和 Subsets： 中的所有媒体项目 Playlist 或 Subset 以线性顺序“串”在一起 反映Playlist或Subset中介质的顺序。 因此，如果 Playlist 中有 10 个视频文件，则输出渲染 将按顺序显示 10 个剪辑中的每一个，并且每一帧 正在使用的每个视频文件。
• Contact Sheets： contact sheet 将完全按照原样渲染 出现在 xSTUDIO UI 中，具有相同的布局（例如 Grid 模式） 以及与源对应的playhead相同的持续时间 Contact Sheet。
• 序列 (Timelines)： 序列将完全渲染为 它出现在 xSTUDIO Session 中，因此跟踪可见性、剪辑 可见性和Compare Mode compare_modes`也将是 受到尊重。因此，例如，您可以渲染出 4 个视频轨道 通过之前将 compare mode 设置为 ‘Grid’ 进行 2x2 排列 选择渲染序列。

渲染输出设置

执行、监控和检查渲染

一旦您为输出提供了文件系统路径，“渲染”按钮将变为可单击状态，您可以将作业分派到渲染队列。请注意，您可以一次对多个渲染进行排队 - 如果您在 Playlist 面板中选择了多个项目，则当您点击渲染按钮时，渲染对话框将刷新下一个项目。使用“跳过”按钮跳过 Playlist 项目并配置下一个选定项目进行渲染。

点击“渲染”按钮后，Playlists面板的右上角将出现一个渲染状态按钮，如下所示：

现在，您可以单击此按钮来查看渲染队列。 xSTUDIO 将一次渲染一个输出，并按照您调度它们的顺序处理队列。

作业完成后，您可以将鼠标移到绿色勾号图标上以获取“播放”按钮。单击此按钮，将打开一个Quick View quick_view`窗口，其中包含渲染的输出，供您立即检查。渲染失败由红色警告图标指示。单击带有监视器心跳图标的按钮可以在渲染期间和完成时查看完整的 FFMpeg 日志，或者最有用的是，如果渲染失败。可以在渲染开始之前或在渲染过程中使用垃圾桶按钮取消渲染，这也将从队列中清除成功完成的渲染。

输出视频和音频编解码器设置

渲染器如何工作

在进入编解码器之前，了解 xSTUDIO 的渲染器如何工作是很有用的。在渲染过程中，xSTUDIO 使用离屏Viewport 生成图像帧，并将图像数据写入称为“管道”的虚拟文件中。这是在后台进程中完成的，因此 xSTUDIO 接口不会冻结。著名的媒体编码/解码应用程序FFMpeg的实例也由xSTUDIO在后台启动。此 FFMpeg 进程设置为通过管道从 xSTUDIO 接收图像（和音频样本）。用户需要了解的重要一点是，启动时传递给 FFMpeg 的参数可以由用户通过 FFMpeg 的命令行界面进行配置。因此，您可以完全自由地设置视频和音频编解码器及其用于创建输出文件的调整参数 - 您只需指定编码参数，就像在终端中运行 FFMpeg 一样。

配置编码预设

“渲染视频”对话框提供视频和音频编解码器预设的下拉列表。旁边是一个钢笔图标。单击此按钮可访问视频编解码器预设面板。

此面板允许您指定视频和音频编码的确切 FFMpeg 输出参数。如果您希望添加自己的新预设，现有预设（它们是只读的，因此在列表中显示为灰色）可以作为有用的参考。 FFMpeg 具有几乎无限数量的编解码器选项和特殊过滤器，您可以提供它们来调整视频编码，我们在此不提供任何文档。幸运的是，网络上有大量关于如何使用和优化 FFMpeg 以获得特定输出的问题和解答，因此找到您需要的设置并不难。音频编码选项在单独的列中指定，并且适用类似的原则：许多编码设置都是可能的，正确设置这些设置对于成功生成视频至关重要。请注意，如果您不渲染音频（通过取消选中主视频渲染对话框中的“渲染音频”框），则音频编码选项可以留空。

还有一个位深度下拉设置。这设置了xSTUDIO管道到FFMpeg的RGB图像的颜色分辨率 - 16位更准确，如果您输出像ProRes这样具有10位或12位位深度的视频格式，则需要16位。对于输出每通道只有 8 位的许多其他格式，为源图像选择 8 位将导致渲染时间短得多，而不会影响质量。

故障排除

如果您添加新的编码预设并发现使用它们时渲染失败，您将需要调试设置。通过渲染队列界面，您可以通过心跳监视器按钮访问渲染失败的 FFMpeg 输出日志。仔细查看 FFMpeg 的日志 - 有时很难发现，但您应该能够看到错误是什么，以便您可以返回并调整预设，直到渲染完成。

SDI：采用Blackmagic设计的视频输出Decklink

xSTUDIO 支持通过Blackmagic Designs (BMD) Decklink SDI PCI 卡输出。这允许您在使用xSTUDIO工作时，在连接到Decklink设备SDI输出的参考显示器或专业投影仪硬件上查看媒体。为了使该系统正常工作，您自然需要一个正常运行的 Decklink SDI 设备并在系统上安装必要的驱动程序。在尝试与 xSTUDIO 一起使用之前，请使用 BMD 实用软件测试并确保您的 Decklink 设备正常工作。

当xSTUDIO启动时，观察日志输出是否有类似这样的消息，以验证xSTUDIO是否能够找到并初始化您的Decklink卡：

[2026-03-23 11:43:38.676] [xstudio] [info] Decklink Card Initialised

设置SDI输出

如果您安装了Decklink卡并且xSTUDIO能够正确初始化它，那么您将在xSTUDIOviewport的左上角看到一个SDI按钮（这是可以打开和关闭的“操作栏”的一部分，因此请确保该栏可见。单击单击此按钮可访问 SDI 控制栏。

单击齿轮图标可访问 SDI 输出设置对话框。您可以在此处选择SDI输出格式、分辨率和帧速率。下拉列表中的选项取决于您的 Decklink 卡的功能和您已安装的驱动程序。一些较旧或较低规格的 SDI 卡仅提供有限范围的输出格式和分辨率。请注意，只有当 SDI 输出停止时才能更改这些选项。

只需切换 SDI 控制栏中的开/关按钮即可启动和停止 SDI 输出。状态栏中的状态指示器位于最右侧，您可以在此处查看 SDI 输出是否处于活动状态以及启动输出信号是否存在问题。

输出视频的位深度也可以在此处设置。有 8、10 或 12 位输出选项。您必须选择正确的位深度以匹配您的 Decklink 卡和显示信号的视频硬件的功能。请注意，使用较高位深度选项时，主机上的负载没有任何特定的“成本”。

SDI 输出有一个“显示”选项，您可以在其中设置 OpenColour IO (OCIO)“显示”设备，该设备用于在通过 SDI 输出之前对视频信号应用颜色转换。此设置独立于 xSTUDIO GUI 中主viewport 的显示选项。

音频输出

SDI plugin 也通过SDI 输出音频。对于音频严格审查，我们强烈建议在可能的情况下使用 SDI 信号路径来驱动您的 A/V 系统，而不是依赖 PC 音频输出，因为SDI 可以保证音频和视频之间的同步。然而，重要的是要考虑到 SDI 卡本身会在视频帧到达屏幕之前缓冲大约 3 个视频帧。如果您在设置中使用 SDI->HDMI 转换器，这也可能会导致视频输出进一步延迟。因此，xSTUDIOSDIplugin提供了一个选项，可以对音频输出应用轻微的延迟（以毫秒为单位），以便您可以调整与屏幕上视频的同步。带有相应音频点击轨道视觉提示的视频样本非常适合这项必须通过耳朵和视觉完成的任务。

高动态范围 (HDR) 输出

一些专业视频显示器或高端消费类 TV 支持高动态范围 (HDR) 视频。如果您的 Decklink 卡和您使用的显示器支持 HDR，那么您可以通过 HDR 设置选项卡在 SDI 输出设置中启用此功能。在“HDR 模式”下拉菜单中选择“SDR”将禁用 HDR 并输出标准动态范围信号。这里的“PQ”选项指的是感知量化器（PQ）HDR 曲线，它是业界使用最广泛的 HDR 曲线，并且大多数支持 HDR 的显示设备都支持。

在此界面中可以配置许多较低级别的设置，这些设置可以设置显示器、TV或投影仪应用于视频信号的 HDR 曲线的形状。如果您不确定这些数字的含义，则必须寻求技术建议，了解如何为您的特定显示器以及要输出的 HDR 信号类型正确设置这些参数，因为对此进行记录超出了本手册的范围。然而，为这些设置提供了一些标准预设，这可能就是所需的全部。

对于 HDR 观看，您还需要在 xSTUDIO 中使用的 OpenColor IO (OCIO) 配置中进行适当的“显示”设备配置，以确保在通过 SDI 输出视频信号之前将正确的颜色转换应用于视频信号。再次强调，如果您不确定如何正确设置，请寻求技术建议或参考OCIO文档。

故障排除

如果您在使 SDI 输出正常工作时遇到问题，请检查以下事项： * 确保您的 Decklink 卡已在系统上正确安装和配置，并且安装了最新的驱动程序。使用BMD实用软件测试该卡并确保其正常工作。 * 检查 xSTUDIO 日志输出中是否有与 Decklink plugin 或 SDI 输出相关的错误消息。这可以提供有关可能出现问题的线索。 * 验证您是否在 SDI 输出设置中选择了正确的 SDI 输出格式、分辨率和帧速率，或尝试更改这些设置以查看是否可以解决问题。某些显示器或投影仪可能仅支持某些格式或分辨率。 * 如果您使用 SDI->HDMI 转换器，请检查它是否正常工作并且支持您选择的输出格式。 * 如果您尝试输出 HDR 视频，请确保您的显示器支持 HDR，并且您已在 SDI 输出设置中正确配置 HDR 设置。 * 在测试 xSTUDIO 期间，开发人员偶尔会发现某些型号的 Decklink 卡似乎工作正常，但在首先检查上述检查后，视频输出在显示器上不可见。在这些情况下，通常只需重新启动xSTUDIO即可解决问题。

热键

xSTUDIO 的界面可以通过热键（键盘快捷键）广泛派生，适合喜欢这种应用程序工作方式的用户。然而，热键的使用完全是可选的，因为没有无法通过按钮或菜单通过界面实现的交互。

xSTUDIO 的热键快捷键可以从帮助->热键面板中查看，其中可以找到所有热键及其用途的描述。

附录

xSTUDIO 偏好设置

许多影响 xSTUDIO 组件的设置（无论是在用户界面中还是在应用程序核心及其播放引擎中）都是通过首选项系统进行控制的。首选项是通过加载首选项文件来设置的。一般来说，用户不需要了解这些文件及其正在执行的操作，但我们在此提供了一些有关这些文件如何工作以及如何使用它们来驱动 xSTUDIO 自定义的详细信息。这对于大型组织（例如后期制作工作室）特别有用，他们可能希望控制自己的 xSTUDIO 自定义和配置。

首选项管理器

用户可能想要控制的许多设置可以通过此界面进行访问。它可以从主菜单栏的文件->首选项->首选项管理器菜单启动。用户首选项被分类到分类选项卡中以帮助导航。浏览这些设置可能是值得的，因为它们包含用户可能希望利用的许多自定义设置。

清除用户首选项

要清除用户首选项并将 xSTUDIO 恢复为其默认配置，您可以删除（或者更好的是，移动以便仍然有备份）xSTUDIO 定期保存的用户首选项文件。

mv  $HOME/.config/DNEG/xstudio  $HOME/.config/DNEG/xstudio_safe

首选项文件（针对开发人员）

（本节对于开发人员或管理部署的人员来说更有用，但有些信息也可能对个人用户有用）

xSTUDIO 定期保存用户首选项的当前状态，并且始终在应用程序退出时保存。用户首选项文件的位置是 $HOME/.config/DNEG/xstudio。首选项文件的格式为 json。如果 user 首选项文件中有条目，则表示相应的首选项值已从默认值更改，并将在下次 xSTUDIO 启动时被覆盖。默认首选项在 share/preferences 文件夹中的文件中定义，该文件夹是 xSTUDIO 发行版（和源代码）的一部分，浏览这些默认首选项文件有助于了解如何驱动 xSTUDIO 的配置。

Addxstudio 启动时也可以通过命令行选项 —pref 加载特定的首选项文件。这意味着后期制作工作室等组织可以使用适当的包装脚本和自定义首选项文件覆盖默认的 xSTUDIO 设置。

xSTUDIO 媒体项目结构

在VFX和动画管道中，磁盘上通常有相同渲染、扫描、播放预览等的多种编码。例如，CG 渲染可能作为渲染器或合成应用程序输出的一组高分辨率、高位深度EXR 图像存在于文件系统上。这些 EXR 图像还可能是渲染后生成的轻量级压缩编码，作为 QuickTime 影片，可以更轻松地流式传输到像 xSTUDIO 这样的播放器中。或者可能存在相同的 EXR 序列，分辨率为一半或四分之一（通常称为代理）。有时，同一输出会有“许多”并行编码，以支持特定的客户端可交付成果和内部管道要求。这完全取决于工作室的专有管道。

在查看图像时，xSTUDIO 用户可能希望根据查看活动查看这些编码中的一种或另一种（动画样片可能只需要轻量级编码，灯光样片可能需要所有像素）。

xSTUDIO 的核心数据模型旨在反映 VFX 和动画工作室的这一常见做法，例如 xSTUDIO 中的“媒体项”（意味着在 playlist 中作为单独、谨慎的项出现的对象）可以在内部由一个或多个“媒体源”组成。 xSTUDIO 的界面以及 API 提供了快速切换媒体项的活动媒体源类型的功能（例如 Viewport 工具栏中的“源”按钮）

为了让xSTUDIO用户能够利用此功能，xSTUDIO必须通过一些管道集成plugins进行扩展，这些集成知道如何查找给定输出版本的各种编码，并在用户想要加载它时相应地构建媒体项。可以通过 Python 或 C++ API 构建和添加具有多个媒体源的媒体。

对于在已建立的管道和相关基础设施之外工作的xSTUDIO用户，可以忽略xSTUDIO的此功能，因为包装单个媒体源的媒体项是无缝处理的。

Python 脚本介绍

xSTUDIO 有一个 python API，允许您通过 python 脚本控制播放、加载媒体、探索 playlists、探索媒体等。 API 的一个特点是，在幕后 Python 解释器和 xSTUDIO 应用程序之间的所有交互都是通过网络套接字实现的。这意味着您可以在xSTUDIO中的嵌入式Python解释器中或在完全不同的进程中执行Python代码来控制xSTUDIO，这样您的Python执行就不会阻塞xSTUDIO，反之亦然。

执行Python代码…

…在应用程序内

xSTUDIO 具有嵌入式 Python 解释器，允许您在应用程序中运行代码。 Python snippets python_snippets和Python plugins python_plugins都提供了在xSTUDIO中运行自定义代码的简单方法，以及Python解释器界面面板，用于在应用程序本身中交互式执行Python命令。

…远程

您还可以在 xSTUDIO 外部执行 Python 代码，以便远程控制应用程序的实例，如下所述。但是，为了实现这一点，您必须确保您运行的 Python 版本与构建 xSTUDIO 时使用的 Python 版本兼容。此外，xSTUDIO python 模块位置应包含在 sys.path 列表中。更好的是，如果您的 xSTUDIO 安装包括 Python 本身（MacOS 和 Windows 上通常是这种情况），那么您可以从 xSTUDIO 安装运行 python，并且您的脚本应该可以运行，而不必担心 sys.path。

在 Windows 上运行脚本可能看起来类似，具体取决于您安装的 xSTUDIO 版本。您可以设置适当的 powershell 快捷方式或桌面快捷方式，以使其更加方便。

& 'C:\Program Files\xSTUDIO 1.0.0\bin\python3\python.exe' C:\Users\tedwaine\dev\xstudio_scripts\my_script.py

在 MacOS 上运行脚本可能看起来类似，具体取决于您安装的 xSTUDIO 版本。您可以设置终端别名命令或快捷方式，以使其更加方便。

/Applications/xSTUDIO.app/Contents/MacOS/python3.12 C:\Users\tedwaine\dev\xstudio_scripts\my_script.py

在 Linux 上，xSTUDIO 的安装不如其他发行版独立，并且 xSTUDIO 可能是使用操作系统上的 Python 版本构建的。因此，您可以修改脚本开头的 PYTHONPATH 环境变量或 sys.path，以确保可以在 Python 搜索路径上找到 xSTUDIO python 模块。然后您可以直接运行脚本。

通讯端口

xSTUDIO 在启动时打开一个用于远程控制的端口，随后由 Python API 使用，也可通过命令行将媒体“推送”到正在运行的session。 xSTUDIO 将尝试打开的端口号范围可以指定为命令行选项或在首选项文件中。在Python中创建Connection对象时，您可以指定要连接的xSTUDIOsession的端口号。对于有兴趣管理多个xSTUDIO实例以支持工作流程的工作室，可以通过适当的包装脚本和Python集成代码来利用它

使用特定端口启动 xSTUDIO：

xstudio -n —端口=45501

from urllib.parse import urlparse
from xstudio.connection import Connection
 
XSTUDIO = Connection(auto_connect=False)
XSTUDIO.connect_remote(host="127.0.0.1", port=45501)
 
# now we can interact with xstudio

Python 脚本示例

除了 python ‘plugins’（本质上是实例化自定义 plugin 类来处理回调并管理与核心应用程序的某些典型通信的脚本）之外，您还可以通过简单的脚本执行许多操作。

这是一个非常基本的示例，它打印出 session 中的所有媒体路径。

from urllib.parse import urlparse
from xstudio.connection import Connection
 
XSTUDIO = Connection(auto_connect=True)
playlists = XSTUDIO.api.session.playlists
 
for playlist in playlists:
 
    media = playlist.media
    for m in media:
        p = urlparse(
                str(m.media_source().media_reference.uri())
                )
        print(p.path)

以下示例展示了如何开始构建playlist、修改媒体播放速率并开始播放：

from xstudio.connection import Connection
from xstudio.core import MediaType, FrameRate
 
XSTUDIO = Connection(auto_connect=True)
 
# paths to media on the filesystem ...
frames = '/home/Media/jpeg_sequence.####.jpg'
video = '/home/Media/some_quicktime.mov'
audio = '/home/Media/some_audio.wav'
 
# create a playlist - note the result is a pair, the first element is the
# Uuid, the second is the Playlist class instance
playlist = XSTUDIO.api.session.create_playlist(name='My Playlist')[1]
 
# make the playlist the 'viewed' playlist
XSTUDIO.api.session.set_on_screen_source(playlist)
 
# add a frames based source (eg. jpegs.0001.jpg, jpegs.0002.jpg etc.)
frames_based_media = playlist.add_media(frames)
# set the frame rate for the frames source
frames_based_media.media_source().rate = FrameRate(30.0)
 
# add a containerised media item
video_only = playlist.add_media(video)
 
# add a combined audio/video
combined = playlist.add_media_with_audio(video, audio)
 
# add an audio only source
audio_only = playlist.add_media(audio)
 
# get the playlist's playhead. Each playlist has its own playhead - by making
# it the 'active' (viewed) playhead below we can start playing media from the
# playlist in the viewer.
playhead = playlist.playhead
 
# get the 'playhead_selection' object, which is used to choose
# items from a playlist for playing
plahead_selector = playlist.playhead_selection
 
# select all the added media for playing (using their uuids)
plahead_selector.set_selection(
    [
        frames_based_media.uuid,
        video_only.uuid,
        combined.uuid,
        audio_only.uuid
        ])
 
XSTUDIO.api.app.active_viewport.set_playhead(playhead)
 
# Some components of xSTUDIO are built with the 'Module' base class. These
# components have attributes which can be queried and modified through the API.
 
# To inspect the attributes you can call the attributes_digest() method thus:
#
print("Viewport attrs: {0}".format(XSTUDIO.api.app.active_viewport.list_attributes()))
 
# By inspecting the attributes on the playhead, we can see the compare attr
# and it's options ... by setting to String the playhead will string together
# the selected media in a (most basic) sequence. Other options are 'A/B' or 'Off'.
playhead.attributes["Compare"].set_value("String")
 
# while we're at it let's set the viewport to 'Best' fit, so the whole image is
# fitted to the viewport area
XSTUDIO.api.app.active_viewport.attributes["Fit (F)"].set_value("Best")
 
# start playback
playhead.playing = True
 
# We can also interact with the 'colour_pipeline' object (the OCIO colour
# management plugin), for example
XSTUDIO.api.app.active_viewport.colour_pipeline.attributes["Exposure (E)"].set_value(0.5)

Python“片段”

Python snippet 是一个自包含的 Python 脚本，可以从“片段”菜单或“媒体列表”菜单在 xSTUDIO 内执行。我们的想法是提供一种便捷的方法，将有用的 Python 脚本添加到 xSTUDIO 环境中，以自动执行某些任务、构建 playlists 或通过 Python API 与 Session 进行任何其他交互

创建片段

要创建片段，您只需在 xSTUDIO 扫描片段的位置之一创建扩展名为“.py”的文件。这些位置由片段路径首选项控制，它是文件系统路径的列表。默认情况下，xSTUDIO 检查的路径之一是 $HOME 文件夹中的 xStudio/snippets。因此，如果您在家庭空间中创建一个 xStudio 文件夹（请注意字母大小写），然后在其中创建一个 snippets 文件夹，那么您可以将片段放入该位置，xSTUDIO 会找到它们。

例如，在此屏幕截图中，路径 /user_data/ted/snippets 已通过首选项管理器添加到片段路径中…

现在，如果我在主空间的默认位置 C:\Users\tedwaine\xStudio\snippets 创建一个名为 my_test_snippet.py 的文件，然后在 Snippets 菜单下点击 Reload，那么我的 Snippets 菜单如下所示：

现在，如果我单击“我的测试片段”，my_test_snippet.py 文件中的代码将在 xSTUDIO 的 python 解释器中执行。

示例片段

您可以从片段中运行您想要的任何 python 代码。这是一个简单的示例，它将随机化当前查看的序列中所有选定的剪辑的颜色（如果Viewport中正在查看序列）

from xstudio.api.session.playlist.timeline import Timeline, Clip
import random
import colorsys
 
def random_clip_colour(item=XSTUDIO.api.session.viewed_container):
    if isinstance(item, Timeline):
        for i in item.selection:
            if isinstance(i, Clip):
                c = random.randrange(0, 255)
 
                rgb = colorsys.hsv_to_rgb(c * (1.0/255.0), 1, 1)
                i.item_flag = "#FF" + f"{int(rgb[0]*255.0):0{2}x}"+ f"{int(rgb[1]*255.0):0{2}x}"+ f"{int(rgb[2]*255.0):0{2}x}"
 
random_clip_colour()

这是结果\！

PythonPlugins

介绍

通过提供 plugin 基类，xSTUDIO 具有 Python plugin API，您可以使用这些基类来构建自己的 xSTUDIO 扩展。 plugin 基类允许通过多种方式与应用程序和 session 数据进行交互：

• • 与xSTUDIO的核心session对象交互

    • 构建和管理Playlists
    • 并发媒体创建以实现快速加载
    • 构建或加载多轨序列对象timelines
    • 导入/导出 timeline 的 OpenTimelineIO 文件 交换

• • 与xSTUDIO的播放引擎、viewport和颜色交互 管理组件

    • 开始/停止播放，定位playhead，跳转 媒体
    • 动态设置媒体比较（A/B、Wipe、Grid (Contact Sheet)) 模式
    • 动态控制色彩管理数据（Change 曝光，应用等级）
    • 生成“QuickView”播放器窗口以查看个人 主界面之外的媒体项目。

• • Add 将数据项归属于您的plugin。

    • • 属性是灵活的复合数据类型，可以 代表多种数据类型：

        • 布尔值
        • 整数
        • 细绳
        • 实数
        • 列表
        • 字典（Json 格式）

    • 可以直接从 QML 代码访问属性数据

    • 属性集可以在 QML 中作为动态访问 “模型”数据与 Qt 的模型-视图-委托设计保持一致 图案

• 创建通过 Qt 嵌入到 xSTUDIO UI 中的自定义 UI“面板” 质量管理语言

• 创建自定义 Qt QML 浮动窗口或对话框

• 为任何数据的 Viewport 创建自定义叠加 QML 图形 您需要的可视化

• 在xSTUDIO的菜单系统中注入菜单项

• Add 触发时运行您自己的回调的热键快捷键

• 接收来自 UI 代码的回调 (Qt QML)

• Add Viewport 工具栏的自定义项目

• • 订阅各种广播的事件消息 xSTUDIO 组件

    • 当屏幕上的媒体项目发生变化时收到通知
    • 当playhead状态（位置、 播放、compare mode 等）变化
    • 创建新的 Viewport 时收到通知

创作Plugins

启动时xSTUDIO加载Pythonplugins。有一项首选项设置（Preferences Manager preferences` 的 Python 部分中的 Python Plugin 路径），您可以在其中为 xSTUDIO 设置一个或多个文件系统目录以扫描您的 plugins。除此之外，xSTUDIO 还将搜索环境变量 XSTUDIO_PYTHON_PLUGIN_PATH 中的目录（在 Mac/Linux 上以冒号分隔的列表，在 Windows 上以分号分隔）。

每个 plugin 应作为 Python 可导入模块安装在其自己的文件夹中。 plugin python 模块的接口必须包含一个方法 create_plugin_instance，该方法返回 plugin 类的实例（请参见下面的示例）。

基本框架 Plugin 示例

假设我们已将目录 /home/Users/tedwaine/xstudio_plugins 添加到 Python Plugin 路径首选项中。在这个目录中，我有另一个目录，名为 my_plugin。在其中，我可以有一个名为 demo_plugin.py 的文件，如下所示：

from xstudio.plugin import PluginBase
from xstudio.core import KeyboardModifier
 
# Declare our plugin class - we're using the PluginBase base class here which
# is a general purpose plugin
class MyDemoPlugin(PluginBase):
 
    def __init__(self, connection):
 
        PluginBase.__init__(
            self,
            connection,
            "My Demo Plugin")
 
        self.shortcut_id = self.register_hotkey(
            self.shortcut_callback,
            "W",
            KeyboardModifier.ControlModifier,
            "Demo Plugin Shorcut",
            "Simple example hotkey",
            auto_repeat=False,
            component="Demo Plugins",
            context=None)
 
        self.insert_menu_item(
            "main menu bar",
            "Run Callback",
            "Plugins|Demo Plugin",
            0.0,
            hotkey_uuid=self.shortcut_id,
            callback=self.my_callback,
            user_data="some extra info")
 
        # ensure that the new 'Plugins' section of the menu bar appears
        # at the end (right side) of the menu bar
        self.set_submenu_position(
            "main menu bar",
            "Plugins",
            1000.0)
 
    def shortcut_callback(self, shortcut_uuid, context):
 
        print ("Hotkey pressed in context {}".format(context))
 
    def my_callback(self):
 
        print ("my_callback executed")
 
    def menu_item_activated(self, menu_item_data, user_data):
 
        print ("my_callback executed with user data", menu_item_data, user_data)
 
# This method is required by xSTUDIO
def create_plugin_instance(connection):
    return MyDemoPlugin(connection)

在文件系统的同一位置，我还需要一个 __init__.py 文件来将关键的 create_plugin_instance 公开给 xSTUDIO 的 plugin 加载器：

from .demo_plugin import create_plugin_instance

More 复杂 plugin 示例

2025 年 8 月 - 我们仍在研究一些全面的 Python Plugin API 示例，这些示例展示了所有功能以及 UI 界面开发、与 xSTUDIO 集成和交互方面的可能性。

然而，有一些现有的 plugins 随 xSTUDIO 源代码一起提供，提供了一些完全开发的 plugins 来执行 HUD 覆盖图形或添加自定义 Viewport 布局（画中画）。这些 plugins 旨在成为这些功能的有用参考实现，可以在 xSTUDIO 源代码存储库的 src/plugin/python_plugins/ 文件夹中找到。

色彩管理

由于与 OpenColorIO (OCIO) 框架集成，xSTUDIO 具有色彩管理功能。有了适当的配置文件，就可以确保显示设备（显示器、投影仪等）的颜色配置文件与媒体源颜色空间正确组合，从而正确表示最终图像。还可以在像素到达屏幕之前合并艺术外观修改，例如分级值或胶片模拟 LUT。 xSTUDIO 利用OCIO 的最新 V2 功能来计算色彩空间转换并将 LUT 应用到显卡上，以保证准确性和高性能。

如果您确实拥有有效的 OCIO 配置，则以下指南适用：

• 工具栏“显示”选项： 使用此工具栏按钮进行选择 从列表中选择适当的显示设备来匹配您给定的 显示硬件。您的选择将保存到本地 首选项文件，并将在 session 之间持续存在。
• 工具栏“查看”选项 - 使用此工具栏按钮选择 组合视图和外观

色彩管理系统的工作原理是将正在查看的媒体的色彩空间转换为显示设备（笔记本电脑屏幕/PC 显示器等）的显示色彩空间。因此，OCIO需要知道您媒体的色彩空间。它有一些逻辑来尝试自动推断这一点，但您也可以手动设置源色彩空间。这可以通过在 Viewpoer 中单击鼠标右键（或单击 Viewport 右上角的 More 按钮）并进入 OCIO->源子菜单来完成。

OCIO 配置（开发者用）

要利用这些功能，您需要文件系统上存在所需的 OCIO 配置文件和关联的 LUT 数据文件。对于大多数 VFX 工作室和其他后期制作设施，OCIO 数据的配置由专业人士或团队管理，我们认为此类技术专业知识是现有的。请参阅 ocio 网站 了解完整详细信息。

根据约定，xSTUDIO将从存储在**$OCIO环境变量**中的路径加载配置文件。您可以通过使用 python API 在媒体上设置特殊元数据值或实现“媒体挂钩”C++ plugin 来添加必要的元数据来覆盖此每个媒体源。本质上，“媒体挂钩”plugin 提供了一个回调函数，每当 xSTUDIO 加载新媒体时就会执行该函数。该函数返回一个 json 字典，该字典合并到新媒体项的元数据中。这是一种允许在创建时向媒体添加自定义元数据的机制（多种机制之一）。

作为此自定义元数据的一部分，您可以添加一个“colour_pipeline”字典，其中包含 OCIO plugin 将查找的字符串键/值对。 xSTUDIO 的 OCIO plugin 使用这些键/值对来启动 OCIO 处理器中的上下文对象，以及要加载和应用的 OCIO 配置文件。因此，例如，如果您的 OCIO 配置设置为使用文件路径匹配规则来使用 SHOT 键查找分级数据，则您可以在媒体挂钩 plugin 中设置 SHOT 值。请参考xSTUDIO源代码树中的’dneg.cpp’文件来查看DNEG自己的实现以供参考。

您还可以在媒体元数据中设置“ocio_config”值以绕过 OCIO 环境变量，而是为每个源设置 OCIO 配置。

from xstudio.connection import Connection
 
XSTUDIO = Connection(auto_connect=True)
playlists = XSTUDIO.api.session.playlists
 
colour_management_metadata = {
    'input_display': 'Rec709',
    'input_view': 'Film',
    'ocio_config': '/home/colour_data/config.ocio',
    'ocio_context': {
        'SHOT': 'shot_001',
        }
    }
 
for playlist in playlists:
 
    media = playlist.media
    for m in media:
        metadata = m.media_source().metadata
        metadata['colour_pipeline'] = colour_management_metadata
        m.media_source().metadata = metadata

发布Notes

v1.2.0

Over查看

xSTUDIO 是一款高性能播放和审查工具，由动画和后期制作专业人士设计并为Visual Effects 设计。该应用程序可以加载和播放大量媒体文件。高效的播放引擎允许您快速加载和播放具有多种文件格式和编码的高分辨率图像格式。直观的工具允许您创建和组织 playlists 以及 playlists 中的媒体子集，以构建交互式评论 session、图像和视频参考库。多轨timeline编辑界面提供了加载或创建从简单到复杂的编辑的设施。 xSTUDIO 的 python 和 C++ API 提供了强大的工具，用于定制以及与生产管道和资产管理系统集成。 xSTUDIO 被设计为一款灵活的工具，可以在生产过程中以多​​种方式使用 - 从样片审核到 VFX 镜头审核、分级和色彩管理、到客户演示等。

此版本中的新增功能 (v1.2.x)

• SDI 通过Blackmagic 设计Decklink 卡输出。
• 将 annotations 导出为图像或蜡笔包以供导入 进入 3D 应用程序。
• 演示/参考管道集成plugin。适用于 开发人员作为与 xSTUDIO 创作管道集成的模型。
• PDF 阅读器 plugin 用于在 xSTUDIO 作为框架查看 PDF 文档 基于媒体项目。
• 使用 Ninja 构建系统更快地构建对 Windows 的支持。
• 基于以下内容对用户界面和工作流程进行了许多改进 来自社区的反馈和贡献。
• 许多错误修复和性能改进。

自 v1.1.x 起可用的功能

• 渲染playlists、timelines和contact sheets以输出视频 快速、轻松地使用您喜欢的任何 ffmpeg 编码参数。
• 通过工具栏设置媒体FPS，右键Viewport菜单或热键 捷径。
• 许多 API 扩展均受到社区反馈的启发。
• Viewport时间滑块在Timeline’focus’模式下自动缩放。

xSTUDIO亮点

• 高效、高性能的播放引擎。
• 与多种媒体文件格式兼容。
• 灵活且高度可配置的用户界面。
• 简单直观的 playlist 驱动的 session 工作流程。
• 多轨NLEtimeline接口。
• 通过 OpenColorIO 集成进行准确的色彩管理。
• 注释输入工作流程 - 仅文本、绘图或两者兼而有之。
• 用于分级或进行分级的色彩校正工具notes。
• Python API 用于脚本编写，plugin 扩展和远程控制
• C++ API 用于高性能 plugin 扩展和图形覆盖