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