Get Node Guardian Intersection

Returns the intersection result between a tracked device (HMD or Controller) and the Guardian boundary.

Overview

This Blueprint only works with the Oculus Rift, since it retrieves information related to the Oculus Guardian, which is only meaningful when positional tracking is available, i.e. when 6DOF (six degrees of freedom) support is provided by the product.

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

Blueprint

Arguments

  • Device Type - An enum representing the type of device for which the intersection with the guardian is requested. It may be set to:
    • No Devices: Specifies that no devices should be checked to see if they are currently intersecting the guardian.
    • HMD: Specifies that the head position should be checked to see if it is currently intersecting the guardian.
    • Left Hand: Specifies that the position of the controller associated with the left hand should be checked to see if it is currently intersecting the guardian.
    • Right Hand: Specifies that the position of the controller associated with the right hand should be checked to see if it is currently intersecting the guardian.
    • All Hands: Specifies that the position of both controllers (left hand and right hand) should be checked to see if either is currently intersecting the guardian.
    • Device Object Zero: Specifies that a camera tracked by the sensors should be checked to see if it is currently intersecting the guardian. An external camera is used by the mixed reality feature. 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: Specifies that all available devices should be checked to see if any are currently intersecting the guardian.
  • Boundary Type - An enum representing the type of guardian boundary that should be checked against. It may be set to:
    • “Outer Boundary” - The exact bounds of the Oculus 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 that indicates whether or not there is a triggering interaction between the node and guardian boundary.
    • Device Type - An ETrackedDeviceTypeEnum which 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