Struct RefineResult 

#[non_exhaustive]
pub struct RefineResult {
    pub x: f32,
    pub y: f32,
    pub score: f32,
    pub status: RefineStatus,
}

Result of refining a single corner candidate.

Coordinates are in the input image pixel frame, with the origin at the top-left corner of the top-left pixel (i.e. pixel (0, 0) has its center at (0.0, 0.0)). Both x and y are subpixel values in pixels — no normalization or scaling is applied by the refiner itself.

Check status before using x and y: only RefineStatus::Accepted guarantees that the refiner moved the position. For all other statuses the coordinates are copied unchanged from the input seed.

The score field measures how well the local image structure supports the refined position. Its meaning depends on the active refiner:

• CenterOfMass: score is the sum of positive response weights in the patch (Σ w where w = response.clamp(0, ∞)). Higher is stronger; units match the ChESS response scale. A score of 0.0 means no positive response was found.
• Förstner: score is det(T) / (trace(T)² + ε) where T is the structure tensor. Ranges roughly in (0, 0.25]; higher means the patch has balanced gradient energy in both directions (closer to a true corner). The value 0.0 is returned on all failure paths.
• SaddlePoint: score is sqrt(|det(H)|) where H is the fitted quadratic Hessian. Larger magnitude indicates a sharper saddle (steeper curvature); no absolute scale is defined.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

x: f32

Refined subpixel x coordinate in input-image pixels. Valid only when status is RefineStatus::Accepted; otherwise equals the input seed x.

y: f32

Refined subpixel y coordinate in input-image pixels. Valid only when status is RefineStatus::Accepted; otherwise equals the input seed y.

score: f32

Refiner-specific quality score. Higher values indicate stronger evidence for the refined position. See the RefineResult docs for per-refiner definitions. Always 0.0 on OutOfBounds and may be 0.0 on other non-Accepted statuses.

status: RefineStatus

Whether the refiner accepted, rejected, or could not process this candidate. See RefineStatus.

Implementations

impl RefineResult

pub fn accepted(xy: [f32; 2], score: f32) -> Self

Build a RefineStatus::Accepted result at xy with the given score.

Trait Implementations

impl Clone for RefineResult

fn clone(&self) -> RefineResult

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for RefineResult

impl Debug for RefineResult

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.