VRTK_BaseHighlighter

Overview

The Base Highlighter is an abstract class that all other highlighters inherit and are required to implement the public methods.

As this is an abstract class, it cannot be applied directly to a game object and performs no logic.

Inspector Parameters

• Active: Determines if this highlighter is the active highlighter for the object the component is attached to. Only 1 active highlighter can be applied to a game object.
• Unhighlight On Disable: Determines if the highlighted object should be unhighlighted when it is disabled.

Class Methods

Initialise/2

public abstract void Initialise(Color? color = null, Dictionary<string, object> options = null);

• Parameters
• Color? color - An optional colour may be passed through at point of initialisation in case the highlighter requires it.
• Dictionary<string, object> options - An optional dictionary of highlighter specific options that may be differ with highlighter implementations.
• Returns
• none

The Initalise method is used to set up the state of the highlighter.

ResetHighlighter/0

public abstract void ResetHighlighter();

• Parameters
• none
• Returns
• none

The ResetHighlighter method is used to reset the highlighter if anything on the object has changed. It should be called by any scripts changing object materials or colours.

Highlight/2

public abstract void Highlight(Color? color = null, float duration = 0f);

• Parameters
• Color? color - An optional colour to highlight the game object to. The highlight colour may already have been set in the Initialise method so may not be required here.
• float duration - An optional duration of how long before the highlight has occured. It can be used by highlighters to fade the colour if possible.
• Returns
• none

The Highlight method is used to initiate the highlighting logic to apply to an object.

Unhighlight/2

public abstract void Unhighlight(Color? color = null, float duration = 0f);

• Parameters
• Color? color - An optional colour that could be used during the unhighlight phase. Usually will be left as null.
• float duration - An optional duration of how long before the unhighlight has occured.
• Returns
• none

The Unhighlight method is used to initiate the logic that returns an object back to it's original appearance.

GetOption/2

public virtual T GetOption<T>(Dictionary<string, object> options, string key)

• Type Params
• T - The system type that is expected to be returned.
• Parameters
• Dictionary<string, object> options - The dictionary of options to check in.
• string key - The identifier key to look for.
• Returns
• T - The value in the options at the given key returned in the provided system type.

The GetOption method is used to return a value from the options array if the given key exists.

UsesClonedObject/0

public virtual bool UsesClonedObject()

• Parameters
• none
• Returns
• bool - Returns true if the highlighter creates a cloned object to apply the highlighter on, returns false if no additional object is created.

The UsesClonedObject method is used to return whether the current highlighter creates a cloned object to do the highlighting with.

GetActiveHighlighter/1

public static VRTK_BaseHighlighter GetActiveHighlighter(GameObject obj)

• Parameters
• GameObject obj - The game object to check for a highlighter on.
• Returns
• VRTK_BaseHighlighter - A valid and active highlighter.

The GetActiveHighlighter method checks the given game object for a valid and active highlighter.