Features.hpp

Go to the documentation of this file.

#pragma once
 
#include "MayaFlux/Kinesis/Spatial/Bounds.hpp"
 
namespace MayaFlux::Core {
class VKImage;
}
 
namespace MayaFlux::Kinesis::Vision {
 
/**
 * @brief Axis-aligned bounding box in normalised image coordinates.
 *
 * Origin is top-left, x and y in [0, 1], +Y down. Distinct from
 * Kinesis::AABB2D which is NDC with center origin and +Y up.
 *
 * Use to_ndc() to convert to AABB2D for Forma hit testing.
 */
struct BoundingBox {
    float x {};
    float y {};
    float w {};
    float h {};
    float confidence { 1.0F };
    uint32_t label_id {};
 
    /**
     * @brief Convert to NDC AABB2D for use with Portal::Forma::Element.
     *
     * Maps [0, 1] image space to [-1, 1] NDC, flipping Y axis.
     */
    [[nodiscard]] Kinesis::AABB2D to_ndc() const noexcept
    {
        return {
            .min = { x * 2.0F - 1.0F, 1.0F - (y + h) * 2.0F },
            .max = { (x + w) * 2.0F - 1.0F, 1.0F - y * 2.0F },
        };
    }
};
 
/**
 * @brief Closed contour extracted from a binary mask.
 *
 * Points are in normalised image coordinates [0, 1], top-left origin.
 */
struct Contour {
    static constexpr uint32_t no_parent = 0xFFFFFFFFU; ///< Outer contour parent sentinel.
 
    std::vector<glm::vec2> points;
    float area; ///< Pixel coverage divided by total image area.
    float perimeter; ///< Closed boundary length in pixels.
 
    /**
     * @brief no_parent for an outer contour. For a hole contour, the label id
     *        (1-based) of the foreground component this hole is
     *        enclosed by.
     */
    uint32_t parent_label { no_parent };
 
    /**
     * @brief 1-based label id of the component this contour traces, matching
     *        ComponentResult::boxes and BoundingBox::label_id numbering, and
     *        the value written per pixel in ConnectedComponents' device
     *        label buffer. 0 for a hole contour: a hole has no foreground
     *        pixels of its own to select by label, it is already absent
     *        from the label buffer wherever it opens through the parent's
     *        silhouette.
     */
    uint32_t label_id { 0 };
};
 
/**
 * @brief Single interest point produced by a corner or blob detector.
 *
 * Position is in normalised image coordinates [0, 1], top-left origin.
 */
struct Keypoint {
    glm::vec2 position;
    float response;
    float scale;
    float angle;
};
 
/**
 * @brief Image captured mid-pipeline by a Snapshot step.
 *
 * The CPU executor fills pixels, a normalised float buffer in the format
 * active at the snapshot point. The GPU executor fills image instead: a copy
 * of the working image that later steps do not overwrite, valid until the
 * next run on the same executor. channels distinguishes single-channel
 * (grayscale, Harris response) from three-channel (HSV) and four-channel
 * (RGBA).
 */
struct SnapshotEntry {
    std::vector<float> pixels;
    std::shared_ptr<Core::VKImage> image;
    uint32_t w { 0 };
    uint32_t h { 0 };
    uint32_t channels { 0 };
};
 
} // namespace MayaFlux::Kinesis::Vision