// Copyright 2017 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

library fuchsia.ui.gfx;

/// Describes where a hit occurred within the content of a node tagged
/// by this session.
///
/// To compute the point of intersection within the node's local coordinate
/// system, perform the following calculation using the ray which was
/// originally passed to `Session.HitTest()`.
///
///   hit_point = ray.origin + (hit.distance * ray.direction)
///   local_point = hit.inverse_transform * hit_point
struct Hit {
    /// The node's tag value.
    uint32 tag_value;

    /// The origin of the ray that was used for the hit test, in the hit
    /// node's coordinate system.
    vec4 ray_origin;

    /// The direction of the ray that was used for the hit test, in the hit
    /// node's coordinate system.
    vec4 ray_direction;

    /// The inverse transformation matrix which maps the coordinate system of
    /// the node at which the hit test was initiated into the local coordinate
    /// system of the node which was hit.
    mat4 inverse_transform;

    /// The distance from the ray's origin to the closest point of intersection
    /// in multiples of the ray's direction vector.
    float32 distance;
};