ToolClips.xml 文件存储在以下位置:
Windows:C:Program FilesAutodeskMaya<版本>esourcesuiltin.toolclips
Mac OS X:/Applications/Autodesk/maya<版本>/Maya.app/Contents/Resources/builtin.toolclips
Linux:/usr/autodesk/maya<版本>-x64/resources/builtin.toolclips
工具动画演示可以包含两个级别的数据。本主题将此文件分为以下部分:
主元素
级别 1 工具动画演示部分
级别 2 工具动画演示部分
主元素
XML 文件的主体由一个 <toolclips> 元素定义。
下表介绍了 <toolclips> 元素的属性。
属性 | 说明 |
<ui> | 指定 QML 描述的位置。该文件描述默认工具动画演示窗口的布局。默认情况下,ToolClipUI.qml 文件位于 builtin.toolclipsui 目录中。 |
<simple> | 指定简化 QML UI 描述的位置。此文件描述当在“帮助”首选项中启用“仅显示工具名称和快捷方式”(Display tool name and shortcut only)时,工具动画演示的显示方式。默认情况下,SimpleTooltip.qml 文件位于 builtin.toolclipsui 目录中。 |
<locale> | 指定 ToolClips.xml 文件中包含的工具动画演示语言区域设置。默认属性值为 en_US(英语)。 提示如果要将工具动画演示本地化为日语或简体中文,可以使用 ja_JP 或 zh_CN 作为属性值。 |
示例代码:
xml version="1.0" encoding="utf-8"<toolclips ui="ui/ToolClipUI.qml" simple="ui/SimpleTooltip.qml" locale="en_US”>... </toolclips>
级别 1 工具动画演示
所有工具动画演示都包含一个级别 1 窗口。
下表介绍了定义级别 1 工具动画演示各部分的属性。
属性 | 说明 |
<toolclip> | 包含所有级别 1 和级别 2 工具动画演示元素。 |
<key> | 用于请求工具动画演示的关键帧名称。请参见创建工具动画演示。 注意 如果某一关键帧名称存在于工具动画演示搜索路径内的两个 ToolClip.xml 文件中,Maya 将使用第一次遇到的关键帧名称。 |
<help> | (可选)指定当级别 2 工具动画演示不存在时,工具动画演示窗口中所含帮助链接的位置。该位置可以是一个 URL 或内部帮助字符串(如以下示例代码所示)。如果未指定位置,帮助链接将默认为“帮助”主页。 |
<title> | 显示在工具动画演示窗口中的工具标题。 |
<shortcut> | (可选)默认的键盘快捷键。键盘快捷键在 Maya 中是自动分配的,但您可以使用此属性覆盖工具动画演示窗口中的显示内容。 |
<text> | 显示在工具动画演示窗口中的摘要文本。 |
示例代码:
<toolclip key="moveTool" help="files/MoveTool.htm" title="Move Tool" shortcut="W"> <text>Move selected objects or components by dragging the transform manipulator.</text>...</toolclip>
级别 2 工具动画演示
级别 2 工具动画演示是可选的,在存在其他学习内容时使用。如果存在级别 2 工具动画演示,级别 1 工具动画演示中会显示“更多(More)”按钮。
下表介绍了定义级别 2 工具动画演示各部分的属性。
属性 | 说明 |
<expanded> | 包含所有级别 2 工具动画演示数据。如果工具动画演示包含展开区域,级别 1 工具动画演示窗口中会显示“更多”(More)按钮。 |
<default-resource> |
(可选)指定当打开级别 2 工具动画演示时,可以将工具动画演示资源列表中的特定视频或图像资源载入查看器/播放器中。<index> 属性决定将载入查看器或播放器中的资源列表项。例如,值设置为 2 时,将显示列表中的第二项。默认情况下,<index> 属性设置为 1。 |
<resourcelist> | 指定要显示在级别 2 工具动画演示窗口中的资源列表。可以包含视频、图像和/或外部资源的链接。 |
<video> |
将视频添加到资源列表中。使用 <location> 属性指示显示在工具动画演示窗口中的文件名称和标题。当创建自定义工具动画演示时,所有视频必须采用 WebM 格式,并且位于 users.toolclipsResources 或 <自定义目录>Resources 子目录中。 |
<image> |
将图像添加到资源列表中。使用 <location> 属性指示显示在工具动画演示窗口中的文件名称和标题。当创建自定义工具动画演示时,所有图像必须采用 JPEG 或 PNG 格式,并且位于 users.toolclipsResources 或 <自定义目录>Resources 子目录中。 |
<link> |
将外部链接添加到资源列表中。使用 location 属性指示链接位置和显示在工具动画演示窗口中的标题。该位置可以是完全限定的 URL 或内部帮助字符串(如以下示例代码所示)。 |
示例代码:
<expanded> <default-resource index=”1”/> <resourcelist> <video location="MoveTool.webm">Move Objects</video> <image location=”MoveTool.jpg”>Show Objects</image> <link location="files/MoveTool.htm">Using the Move Tool</link> </resourcelist> </expanded>