Public Attributes | |
VuVector2F | point |
Point in the normalized coordinate space of the camera frame to use as the origin of the ray. | |
VuCameraFrame * | frame |
Camera frame retrieved from the Vuforia State that the hit-test should be performed on. | |
VuHitTestHint | hint |
A hint about the orientation of the plane in the scene. Default value is VU_HIT_TEST_HINT_NONE. | |
float | deviceHeight |
Height of the device center above ground plane in meters. Default value is 1.4 meters. | |
Configuration for performing a hit-test.
Hit-test functionality performs a hit test between a ray and a plane in the world as understood by the Vuforia Engine. The ray is cast from the given point on the device's screen (typically from a user tapping the screen). An approximate device height above an assumed infinite ground plane may be used to provide an estimated ground plane intersection when the available data on the environment is limited. A single hit test may generate multiple results if the ray intersects more than one detected plane.
Specific behavior of the hit test depends on the active Fusion provider (see vuPlatformControllerGetFusionProviderType()).
deviceHeight
specifies the device's approximate height above an assumed infinite ground plane on which the hit test result may lie; however it will be ignored if an existing (finite, localized) plane from a previous hit test is found along or near to the ray path. Additionally, Vuforia will not return hit test results when the device pose observer for positional device tracking is initializing, as indicated by its status info (see VuDevicePoseObservationStatusInfo).deviceHeight
is ignored and Vuforia will only return results when the hit test ray intersects actual detected planes in the user's environment.VuVector2F point |
Point in the normalized coordinate space of the camera frame to use as the origin of the ray.
VuHitTestHint hint |
A hint about the orientation of the plane in the scene. Default value is VU_HIT_TEST_HINT_NONE.
float deviceHeight |
Height of the device center above ground plane in meters. Default value is 1.4 meters.