axis_fraction()

std::function< float(glm::vec2)> MayaFlux::Kinesis::axis_fraction ( AABB2D  bounds, float  handle_extent = 0.F, bool  horizontal = true  )

inlinenoexcept

Fraction along one axis of bounds, inverse to fader placement.

horizontal_fader and vertical_fader place the handle's leading edge at min + value * (extent - handle_extent), so the handle centre travels a span shorter than the track by one handle. This subtracts half a handle before dividing by the reduced span, so the handle centre tracks the cursor across the whole range rather than lagging by up to half a handle at the extremes.

Pass handle_extent of zero for mappings with no handle inset, such as a level_meter used as a scrub region.

Parameters

bounds	Track region in NDC.
handle_extent	Handle width for horizontal, height for vertical.
horizontal	True to map the x axis, false for y.

Returns

Callable producing a value in [0, 1].

Definition at line 37 of file Projection.hpp.

{
    const float extent = horizontal ? bounds.width() : bounds.height();
    const float span = extent - handle_extent;
    const float origin = horizontal ? bounds.min.x : bounds.min.y;
    const float half = handle_extent * 0.5F;
 
    return [origin, half, span, horizontal](glm::vec2 p) -> float {
        if (span <= 0.F)
            return 0.F;
        const float pos = horizontal ? p.x : p.y;
        return std::clamp((pos - origin - half) / span, 0.F, 1.F);
    };
}

References MayaFlux::Kinesis::AABB2D::height(), MayaFlux::Kinesis::AABB2D::min, and MayaFlux::Kinesis::AABB2D::width().

Referenced by MayaFlux::Portal::Forma::Geometry::horizontal_fader(), and MayaFlux::Portal::Forma::Geometry::vertical_fader().

Here is the call graph for this function:

Here is the caller graph for this function: