Skip to main content

DecorateFace​

原型​

std::unique_ptr<DecoratedFaceHandle> DecorateFace(unsigned bodyId, unsigned faceIndex);

功能​

用于高亮显示指定实体的面。当返回的 DecoratedFaceHandle 对象生命周期结束时，高亮效果会被自动清除。

Decorate只高亮3D区域，不影响layout区域。它不属于select动作，不会被ProcessCraft内置的交互动作清除。因此开发者必须小心手动管理返回值的生命周期。

参数​

  • bodyId: 面所属的实体Id
  • faceIndex: 要高亮显示的面的索引

返回值​

返回一个 std::unique_ptr<DecoratedFaceHandle> 智能指针。当该指针被销毁时,面的高亮效果会自动清除。

示例​

// 高亮显示一个面
auto handle = mpl::DecorateFace(bodyId, faceIndex);
// 当handle超出作用域或被重置时,高亮会自动清除