diff --git a/src/Magnum/Math/Frustum.h b/src/Magnum/Math/Frustum.h index 51b731044..a3e73cdc9 100644 --- a/src/Magnum/Math/Frustum.h +++ b/src/Magnum/Math/Frustum.h @@ -87,7 +87,13 @@ template class Frustum { /** @brief Construct a frustum without initializing the contents */ explicit Frustum(NoInitT) noexcept: _data{Vector4{NoInit}, Vector4{NoInit}, Vector4{NoInit}, Vector4{NoInit}, Vector4{NoInit}, Vector4{NoInit}} {} - /** @brief Construct a frustum from plane equations */ + /** + * @brief Construct a frustum from plane equations + * + * The equations are in a form @f$ ax + by + cz + d = 0 @f$. You can + * use @ref planeEquation() to calculate the coefficients from a normal + * and a point. + */ constexpr /*implicit*/ Frustum(const Vector4& left, const Vector4& right, const Vector4& bottom, const Vector4& top, const Vector4& near, const Vector4& far) noexcept: _data{left, right, bottom, top, near, far} {} /** diff --git a/src/Magnum/Math/Vector4.h b/src/Magnum/Math/Vector4.h index 73ba55954..c90182a30 100644 --- a/src/Magnum/Math/Vector4.h +++ b/src/Magnum/Math/Vector4.h @@ -245,7 +245,7 @@ using a dot product with the normal @f$ \boldsymbol{n} @f$ using the point d = - \boldsymbol{n} \cdot \boldsymbol{p} @f] @see @ref planeEquation(const Vector3&, const Vector3&, const Vector3&), - @ref dot() + @ref dot(), @ref Frustum */ template Vector4 planeEquation(const Vector3& normal, const Vector3& point) { return {normal, -Math::dot(normal, point)};