Version:

Atom 工具常用功能

Atom 所包含的工具建立在一个共同的基础之上。它们共享相同的核心概念、功能、工作流程和用户体验。

Basic Tool

文档系统

所有 Atom 工具都使用多文档、多视图系统。这使得所有工具都遵循相同的模式,因此它们共享相同的功能、用户界面和基本交互。无论你编辑什么类型的数据,你都能在所有工具中获得熟悉的体验。

文档是文件或其他数据的表示形式,可以在工具中创建、打开和编辑。至少,所有文档类型都支持打开、保存、撤销、重做等操作,并提供可在检查器中编辑的属性列表、

视图通常是一个窗口或其他用户界面,它允许你对文档进行可视化、检查或交互。

每种工具都专门针对一组文件类型而设计:

  • 材质编辑器目前只支持一种文档类型,用于编辑".material"和查看".materialtype"文件
  • Material Canvas 支持".materialgraph", “.materialgraphnode”, 和 “.shader"文件的多种文件类型。
  • 着色器管理控制台支持”.shadervariantlist"文件的一种文档类型。

您可以同时打开和编辑多个文档。

  • 使用中央窗口顶部的选项卡访问每个文档。
  • 每个文档选项卡都会显示文档的文件名。
  • 在标签页上右击,可打开一个上下文菜单,其中包含以文档为中心的操作。
  • 选择一个选项卡可激活相应的文档,显示任何相关视图,并用文档内容更新其他窗口(如检查器)。

单实例

默认情况下,工具设置为一次只允许运行一个实例。如果尝试重新启动已在运行的工具,则会集中在现有实例上。如果工具正在运行,而您试图从 O3DE 编辑器或文件浏览器打开相关的文件类型,则该文件会在同一工具的新标签页中打开。

Python 脚本

在此基础上构建的所有工具都有通用的 API,用于使用 Python 编写脚本、实现自动化和扩展。虽然与主要的 O3DE 编辑器环境和脚本 API 有所不同,但您应该可以通过项目和启用的 Gems 访问所有其他脚本功能。

  • 文件系统完全可以用脚本编写。
  • C++ 中使用的几个实用功能在 Python 中也同样可用。
  • 使用 PyQt 控制和扩展用户界面。
  • 通过文件菜单、资产浏览器上下文菜单或作为命令行参数传递的方式运行脚本。

主窗口

主窗口是一个工具的枢纽,拥有该工具的所有用户界面。

标题栏

主窗口顶部的标题栏显示应用程序名称和活动 RHI、渲染后端(DX12 或 Vulkan)。

布局

每次打开工具时,都会保存并还原主窗口和任何子窗口的位置、大小和状态。你可以从视图菜单中保存、还原和管理自定义布局。

停靠窗口

主窗口包含多个不同功能的子窗口,你可以将它们停靠、浮动、堆叠或重新排列到自定义布局中。

所有工具都有一套通用的基本面板,但您可以根据每个工具的需要添加更多面板。

检查器

检查器显示活动文档的上下文相关、可编辑的属性。

Asset Browser

使用 “资产浏览器 ”面板探索和管理活动项目和 Gems 中的资产。设置过滤器,选择、创建、重命名、移动、删除资产并执行其他操作。资产浏览器会自动选择与最近打开或激活的文档相对应的文件。这只有在设置了显示文档类型的筛选器时才会发生。将资产从 “资产浏览器 ”拖入 “检查器 ”中的资产属性和其他支持拖放文件类型的窗口。

日志

使用日志窗口查看工具启动后报告的所有跟踪、警告和错误信息。

Python 终端

使用 Python 终端可直接从工具中调用脚本命令。它还会显示会话期间执行的任何 Python 代码的输出、警告和错误。还有其他按钮可显示可用的脚本命令和总线。

主菜单

每个工具的主菜单栏都包含一组通用选项,但每个工具都可以自定义。

File菜单

文件菜单包含创建、打开、关闭和保存文档的所有常用操作。此外,还有运行 Python 脚本的操作。

菜单项快捷键功能
New…Ctrl+N打开创建新文档的对话框。如果工具支持多种文档类型,则首先会显示一个子菜单,列出这些类型。
Open…Ctrl+O打开对话框以打开现有文档。如果工具支持多种文档类型,首先会显示一个子菜单,列出这些类型。
SaveCtrl+S保存活动文档。
Save As…将活动文档保存到指定的文件夹和文件名。
Save As Child…保存当前文档的新子文档。只有 “材质画布 ”和 “材质编辑器 ”有此操作。
Save All保存所有打开文档中的编辑内容。
CloseCtrl+F4关闭活动文档。
Close All关闭所有打开的文档。
Close Others关闭除活动文档外的所有文档。
Run Python…打开对话框,选择并运行 Python 脚本。
Exit关闭应用程序。

Edit 菜单

编辑菜单具有撤销和重做活动文档更改的常用操作。其他工具可能还有其他操作,具体取决于它们支持的文档类型。

菜单项快捷键功能
UndoCtrl+Z撤销最近的操作。
RedoCtrl+Y重做最近取消的操作。

View 菜单

视图菜单包括在文档之间切换的操作。其他工具可能还有其他操作,具体取决于它们支持的文档类型。

菜单项快捷键功能
Previous TabCtrl+Shift+Tab切换到之前打开的选项卡。
Next TabCtrl+Tab切换到下一个打开的选项卡。

Tools 菜单

工具菜单包括切换可停靠面板的可见性和打开设置对话框的操作。其他工具可能还有其他操作,具体取决于它们支持的文档类型。

菜单项快捷键功能
Asset Browser切换 “资产浏览器 ”窗口。
Inspector切换检查器窗口。
Logging切换日志记录窗口。
Python Terminal切换 Python 终端窗口。

Help 菜单

帮助菜单包括打开帮助和关于对话框的操作。

菜单项快捷键功能
Help…打开帮助对话框,其中包含有关如何使用工具的信息。
About…打开 “关于 ”对话框,显示工具的相关信息。

Settings设置

通过 设置注册表 自定义和配置工具。每个工具中的设置对话框都提供了若干常用和特定于应用程序的设置。所有修改过的设置值都会在会话之间保存。

Settings Dialog