Develop
Develop
Select your platform

Get Node Guardian Intersection

This Blueprint returns the intersection between a tracked device (HMD or Controller) and the Guardian boundary.

Overview

This Blueprint returns the intersection between a tracked device (HMD or Controller) and the Guardian boundary.

Blueprint

Get Node Guardian Intersection Blueprint

Arguments

  • Device Type: An enum representing the type of device you want to retrieve the intersection with the Guardian on. You can set this value to:
    • No Devices: Tells the system that it shouldn’t check any devices to see if they are currently intersecting the Guardian.
    • HMD: Checks the head position to see if it is currently intersecting the Guardian.
    • Left Hand: Checks the position of the controller associated with the left hand to see if it is currently intersecting the Guardian.
    • Right Hand: Checks the position of the controller associated with the right hand to see if it is currently intersecting the Guardian.
    • All Hands: Checks the position of both controllers (left and right hands) to see if either is currently intersecting the Guardian.
    • Device Object Zero: Checks if a camera tracked by the sensors currently intersects the guardian. The mixed reality feature uses an external camera. In this scenario, the user attaches a Touch controller to the camera, and the sensors then track the camera by tracking the Touch controller.
    • All Devices: Checks all available devices to see if any are intersecting the Guardian.
  • Boundary Type: An enum representing the type of guardian boundary the system should check against. You may set this value to:
    • Outer Boundary: The exact bounds of the Guardian area.
    • Play Area: A rectangle within the Outer Boundary.

Output

  • Return Value: A Guardian Test Result structure that specifies the intersection between the node and the selected guardian boundary. This structure contains the following fields:
    • Is Triggering: A boolean indicating whether a triggering interaction exists between the node and guardian boundary.
    • Device Type: An ETrackedDeviceTypeEnum that specifies the type of device that is triggering the boundary.
    • Closest Distance: The distance of the node from the boundary.
    • Closest Point: The closest point to the node that resides on the surface of the specified boundary.
    • Closest Point Normal: The geometrical normal vector for the Closest Point relative to the boundary surface.

Example

Example of getting a node guardian intersection
Did you find this page helpful?