Highlight

显示已弃用

*此内容使用人工智能（Beta）翻译，可能包含错误。若要查看英文页面，请点按 此处。

Highlight 实例是你可以使用来吸引体验中特定对象注意力的视觉效果。每个亮点效果都有一个环绕对象的轮廓 轮廓 和一个显示在对象上的固体覆盖层 内部 。您可以独立地自定义这两个组件来修改突出显示的视觉外观。

</img>



          



        <figcaption>基础对象</figcaption>

      </figure>

    </td>



    <td width="30%">

      <figure>

        <img src="/assets/ui/highlighting-objects/Adding-Highlight.jpg">



        </img>



          



        <figcaption>白色轮廓，50%红色内部</figcaption>

      </figure>

    </td>



    <td width="30%">

      <figure>

        <img src="/assets/ui/highlighting-objects/Overview-Yellow-Outline.jpg">



        </img>



          



        <figcaption>黄色轮廓，黑色内部</figcaption>

      </figure>

    </td>

  </tr>

</tbody>

亮点效果的有用应用程序包括：

  • 提供对象是重要和/或可交互的视觉反馈。
  • 使远离用户的对象通过更靠近用户的对象可见。
  • 显示其他角色的当前位置和状态。

限制

作为性能限制，Studio 只在客户端显示 31 个同时 Highlight 实例。如果您超过此限制，额外实例将被忽略。请注意，虽然 Highlight 与 Enabled 设置为 false 不显示，但它仍然需要 31 个可用栏位之一，因此如果您计划永久禁用 Highlight 实例，最好删除它而不是禁用它。

概要

属性

查看继承自 Instance 的全部
查看继承自 Object 的全部

属性

Adornee

Instance
读取并联

用于应用效果到子/父关系外的 Instance 的 Highlight ，用于将效果应用到孩子/父关系外的 Instance 。

DepthMode

Enum.HighlightDepthMode
读取并联

控制 Highlight 效果在世界上其他对象上显示的方式。你可以将此属性设置为以下选项之一：

  • AlwaysOnTop — 允许高亮显示，无论是否存在在相机和突出对象之间的对象。这意味着观察者始终能够看到突出显示，无论亮点对象和相镜头之间有什么。

  • Occluded — 隐藏镜头和突出对象之间存在对象的情况下的突出显示这意味着观察者只能在突出对象和相机查看图之间没有遮挡物的情况下看到对象。

</img>



          



        <figcaption>深度模式 = 总是在顶部</figcaption>

      </figure>

    </td>



    <td width="50%">

      <figure>

        <img src="/assets/ui/highlighting-objects/DepthMode-Occluded.jpg">



        </img>



          



        <figcaption>深度模式 = 包含在内</figcaption>

      </figure>

    </td>

  </tr>

</tbody>

Enabled

boolean
读取并联

设置是否启用高亮显示。这不会影响性能，但禁用 Highlight 实例仍然会占用 31 个可用栏位之一。如果您计划永久禁用 Highlight 实例，最好删除它而不是禁用它。

FillColor

Color3
读取并联

设置高亮内部的 Color3 值。

</img>



          



        <figcaption>填充颜色 = \[255, 100, 50]</figcaption>

      </figure>

    </td>



    <td width="30%">

      <figure>

        <img src="/assets/ui/highlighting-objects/FillColor-Green.jpg">



        </img>



          



        <figcaption>填充颜色 = \[0, 255, 125]</figcaption>

      </figure>

    </td>



    <td width="30%">

      <figure>

        <img src="/assets/ui/highlighting-objects/FillColor-Blue.jpg">



        </img>



          



        <figcaption>填充颜色 = \[75, 150, 255]</figcaption>

      </figure>

    </td>

  </tr>

</tbody>

FillTransparency

number
读取并联

将突出显示的内部可见度设置为默认值 0 (不透明) 和 1 (隐形) 之间的任何值。您可以使用此属性来确定观察者应该看到多少已有对象的颜色。

</img>



          



        <figcaption>透明度填充 = 0</figcaption>

      </figure>

    </td>



    <td width="30%">

      <figure>

        <img src="/assets/ui/highlighting-objects/FillTransparency-Half.jpg">



        </img>



          



        <figcaption>透明度填充=0.5</figcaption>

      </figure>

    </td>



    <td width="30%">

      <figure>

        <img src="/assets/ui/highlighting-objects/FillTransparency-1.jpg">



        </img>



          



        <figcaption>透明度填充 = 1</figcaption>

      </figure>

    </td>

  </tr>

</tbody>

OutlineColor

Color3
读取并联

设置高亮轮廓的 Color3 值。

</img>



          



        <figcaption>轮廓颜色 = \[255, 100, 50]</figcaption>

      </figure>

    </td>



    <td width="30%">

      <figure>

        <img src="/assets/ui/highlighting-objects/OutlineColor-Green.jpg">



        </img>



          



        <figcaption>轮廓颜色 = \[0, 255, 125]</figcaption>

      </figure>

    </td>



    <td width="30%">

      <figure>

        <img src="/assets/ui/highlighting-objects/OutlineColor-Blue.jpg">



        </img>



          



        <figcaption>轮廓颜色 = \[75, 150, 255]</figcaption>

      </figure>

    </td>

  </tr>

</tbody>

OutlineTransparency

number
读取并联

将突出显示轮廓设置为值在 0 (不透明) 和 1 (透明) 之间。

</img>



          



        <figcaption>轮廓透明度 = 0</figcaption>

      </figure>

    </td>



    <td width="30%">

      <figure>

        <img src="/assets/ui/highlighting-objects/OutlineTransparency-1.jpg">



        </img>



          



        <figcaption>轮廓透明 = 1</figcaption>

      </figure>

    </td>



    <td width="30%" />

  </tr>

</tbody>
查看继承自 Instance 的全部
查看继承自 Object 的全部

方法

查看继承自 Instance 的全部
查看继承自 Object 的全部

活动

查看继承自 Instance 的全部
查看继承自 Object 的全部