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_JPzh_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>  



,