GoogleARCore.Frame

Provides a snapshot of the state of ARCore at a specific timestamp associated with the current frame.

Summary

Frame holds information about ARCore's state including the pose of the camera relative to the world, estimated lighting parameters, and information on updates to objects (like Planes or Point Clouds) that ARCore is tracking.

Properties
LightEstimate	static LightEstimate Gets the current light estimate for this frame.
Pose	static Pose Gets the pose of the ARCore device for the frame in Unity world coordinates.

Public static functions
Raycast(float x, float y, TrackableHitFlags filter, out TrackableHit hitResult)	bool Performs a raycast against objects being tracked by ARCore.
Raycast(Vector3 origin, Vector3 direction, out TrackableHit hitResult, float maxDistance, TrackableHitFlags filter)	bool Performs a raycast against objects being tracked by ARCore.
RaycastAll(float x, float y, TrackableHitFlags filter, List< TrackableHit > hitResults)	bool Performs a raycast against objects being tracked by ARCore.
RaycastAll(Vector3 origin, Vector3 direction, List< TrackableHit > hitResults, float maxDistance, TrackableHitFlags filter)	bool Performs a raycast against objects being tracked by ARCore.
RaycastInstantPlacement(float x, float y, float approximateDistanceMeters, out TrackableHit hitResult)	bool Performs a ray cast that can return a result before ARCore establishes full tracking.

Classes
GoogleARCore.Frame.CameraImage	Container for state related to the ARCore camera for the frame.
GoogleARCore.Frame.CameraMetadata	Container for state related to the ARCore camera image metadata for the frame.
GoogleARCore.Frame.PointCloud	Container for state related to the ARCore point cloud for the frame.

Properties

LightEstimate

static LightEstimate LightEstimate

Gets the current light estimate for this frame.

Pose

static Pose Pose

Gets the pose of the ARCore device for the frame in Unity world coordinates.

Public static functions

Raycast

bool Raycast(
  float x,
  float y,
  TrackableHitFlags filter,
  out TrackableHit hitResult
)

Performs a raycast against objects being tracked by ARCore.

Output the closest hit from the camera. Note that the Unity's screen coordinate (0, 0) starts from bottom left.

Details
Parameters	x Horizontal touch position in Unity screen coordinates. y Vertical touch position in Unity screen coordinates. filter A filter bitmask where each set bit in TrackableHitFlags represents a category of raycast hits the method call should consider valid. hitResult A TrackableHit that will be set if the raycast is successful.
Returns	true if the raycast had a hit, otherwise false.

Raycast

bool Raycast(
  Vector3 origin,
  Vector3 direction,
  out TrackableHit hitResult,
  float maxDistance,
  TrackableHitFlags filter
)

Performs a raycast against objects being tracked by ARCore.

Output the closest hit from the origin.

Details
Parameters	origin The starting point of the ray in world coordinates. direction The direction of the ray. hitResult A TrackableHit that will be set if the raycast is successful. maxDistance The max distance the ray should check for collisions. filter A filter bitmask where each set bit in TrackableHitFlags represents a category of raycast hits the method call should consider valid.
Returns	true if the raycast had a hit, otherwise false.

RaycastAll

bool RaycastAll(
  float x,
  float y,
  TrackableHitFlags filter,
  List< TrackableHit > hitResults
)

Performs a raycast against objects being tracked by ARCore.

Output all hits from the camera. Note that the Unity's screen coordinate (0, 0) starts from bottom left.

Details
Parameters	x Horizontal touch position in Unity screen coordinates. y Vertical touch position in Unity screen coordinates. filter A filter bitmask where each set bit in TrackableHitFlags represents a category of raycast hits the method call should consider valid. hitResults A list of TrackableHit that will be set if the raycast is successful.
Returns	true if the raycast had a hit, otherwise false.

RaycastAll

bool RaycastAll(
  Vector3 origin,
  Vector3 direction,
  List< TrackableHit > hitResults,
  float maxDistance,
  TrackableHitFlags filter
)

Performs a raycast against objects being tracked by ARCore.

Output all hits from the origin.

Details
Parameters	origin The starting point of the ray in world coordinates. direction The direction of the ray. hitResults A list of TrackableHit that will be set if the raycast is successful. maxDistance The max distance the ray should check for collisions. filter A filter bitmask where each set bit in TrackableHitFlags represents a category of raycast hits the method call should consider valid.
Returns	true if the raycast had a hit, otherwise false.

RaycastInstantPlacement

bool RaycastInstantPlacement(
  float x,
  float y,
  float approximateDistanceMeters,
  out TrackableHit hitResult
)

Performs a ray cast that can return a result before ARCore establishes full tracking.

The pose and apparent scale of attached objects depends on the InstantPlacementPoint tracking method and the provided approximateDistanceMeters. A discussion of the different tracking methods and the effects of apparent object scale are described in InstantPlacementPoint.

This function will succeed only if InstantPlacementMode is InstantPlacementMode.LocalYUp in the ARCore session configuration, the ARCore session status is SessionStatus.Tracking, and there are sufficient feature points to track the point in screen space.

Details
Parameters	x Horizontal touch position in Unity screen coordinates. y Vertical touch position in Unity screen coordinates. approximateDistanceMeters The distance at which to create an InstantPlacementPoint. This is only used while the tracking method for the returned point is InstantPlacementPointTrackingMethod.ScreenspaceWithApproximateDistance. hitResult If successful a HitResult with a trackable of type InstantPlacementPoint.
Returns	true if successful, otherwise false.