centroid() [3/3]

template<PositionCarrying T, std::invocable< const T & > WeightFn>
requires std::convertible_to<std::invoke_result_t<WeightFn, const T&>, float>

glm::vec3 MayaFlux::Kinesis::centroid ( std::span< T >  pts, WeightFn  weight  )

noexcept

Scalar-weighted centroid of a PositionCarrying span.

Each point contributes weight(point) to the measure. Suitable for mesh vertices weighted by deformation magnitude, particles weighted by energy (size / thickness field), or any domain-specific scalar.

Falls back to the zero vector when total weight is zero or the span is empty.

Template Parameters

T	Any type satisfying PositionCarrying.
WeightFn	Callable: const T& -> float (or any float-convertible type).

Parameters

pts	Non-owning span of points.
weight	Per-point weight callable.

Returns

Weighted mean position.

Definition at line 70 of file Morphology.hpp.

{
    if (pts.empty())
        return glm::vec3(0.0F);
    glm::vec3 acc(0.0F);
    float total = 0.0F;
    for (const auto& p : pts) {
        const auto w = static_cast<float>(std::invoke(weight, p));
        acc += static_cast<glm::vec3>(p.position) * w;
        total += w;
    }
    return total > 0.0F ? acc / total : glm::vec3(0.0F);
}

References weight.