📘

This feature requires the Immerse SDK Enterprise Edition

This is different to the free Immerse SDK. Contact [email protected] if you require access.

Understand the difference between the Free and Enterprise SDK

Highlighting an object can be done in a multitude of ways. The quickest of which is to add a Highlight component, which can be enabled/disabled to highlight the object it is attached to.

Highlighting via Code

To take advantage of the full flexibility of the Highlight package, you will need to highlight via code.

Simple Highlighting

The most simple way to highlight an object is by passing in a GameObject. The code example below demonstrates how to do this.

using ImmerseSDK.Highlight;

...
  
var highlightHandle = HighlightService.CreateHighlight(gameObject);

The method to create a highlight will return a HighlightHandle. This object is used when you wish to remove the highlight.

using ImmerseSDK.Highlight;

...
  
HighlightService.RemoveHighlight(highlightHandle);

If you only wish to temporarily hide the highlight, an Enabled parameter exists within the HighlightHandle class that will disable it. However, when you are done with it, it is strongly advised to remove it properly to all Unity to free up memory.

Highlight Config

For more control over the behaviour of the highlight, a HighlightConfig is required. This object allows you to change settings for a specific highlight such as the material and mesh used and if the highlight should follow the original object being highlighted or not.

The below example demonstrates how to create a highlight that will use 'target' as reference for it's mesh and for it's position/rotation as well as using the custom Material 'material' to draw the highlight.

using ImmerseSDK.Highlight;

...
  
var config = new HighlightConfig 
{
  MeshSource = target,
  FollowTransform = target,
  Material = material
};

var highlightHandle = HighlightService.CreateHighlight(config);

The full list of options available in the HighlightConfig class are listed below