Vec3¶
#include <Imath/ImathVec.h>
The Vec3
class template represents a 3D vector, with predefined
typedefs for vectors of type short
, int
, int64_t
,
float
, and double
.
Note that the integer specializations of Vec3
lack the
length()
and normalize()
methods that are present in the
float
and double
versions, because the results don’t fit into
integer quantities.
There are also various utility functions that operate on vectors
defined in ImathVecAlgo.h
and described in Vector Functions.
Example:
#include <Imath/ImathVec.h>
void
vec3_example()
{
Imath::V3f a (1.0f, 2.0f, 3.0f);
Imath::V3f b; // b is uninitialized
b.x = a[0];
b.y = a[1];
b.z = a[2];
assert (a == b);
assert (a.length() == sqrt (a ^ a));
a.normalize();
assert (Imath::equalWithAbsError (a.length(), 1.0f, 1e-6f));
}
-
template<class T>
class Imath::Vec3¶ 3-element vector
Subclassed by Imath::Color3< T >, Imath::Euler< T >
Constructors and Assignment
-
inline Vec3() noexcept¶
Uninitialized by default.
-
template<class S>
inline constexpr Vec3(const Vec3<S> &v) noexcept¶ Construct from Vec3 of another base type.
-
template<class S>
inline explicit constexpr Vec3(const Vec4<S> &v) noexcept¶ Vec4 to Vec3 conversion: divide x, y and z by w, even if w is 0.
The result depends on how the environment handles floating-point exceptions.
-
template<class S>
inline explicit constexpr Vec3(const Vec4<S> &v, InfException)¶ Vec4 to Vec3 conversion: divide x, y and z by w.
Throws an exception if w is zero or if division by w would overflow.
-
~Vec3() noexcept = default¶
Destructor.
Compatibility with Sb
Arithmetic and Comparison
-
inline constexpr bool equalWithAbsError(const Vec3<T> &v, T e) const noexcept¶
Compare two matrices and test if they are “approximately equal”:
- Returns
True if the coefficients of this and
m
are the same with an absolute error of no more than e, i.e., for all i, j:abs (this[i][j] - m[i][j]) <= e
-
inline constexpr bool equalWithRelError(const Vec3<T> &v, T e) const noexcept¶
Compare two matrices and test if they are “approximately equal”:
- Returns
True if the coefficients of this and m are the same with a relative error of no more than e, i.e., for all i, j:
abs (this[i] - v[i][j]) <= e * abs (this[i][j])
Query and Manipulation
-
inline constexpr T length2() const noexcept¶
Return the square of the Euclidean norm, i.e.
the dot product with itself.
-
inline const Vec3 &normalizeNonNull() noexcept¶
Normalize without any checks for length()==0.
Slightly faster than the other normalization routines, but if v.length() is 0.0, the result is undefined.
Numeric Limits
- static inline constexpr static T baseTypeLowest () noexcept
Largest possible negative value.
- static inline constexpr static T baseTypeMax () noexcept
Largest possible positive value.
- static inline constexpr static T baseTypeSmallest () noexcept
Smallest possible positive value.
- static inline constexpr static T baseTypeEpsilon () noexcept
Smallest possible e for which 1+e != 1.
Public Types
Public Functions
-
short length() const noexcept = delete
-
const Vec3<short> &normalize() noexcept = delete
-
const Vec3<short> &normalizeExc() = delete
-
const Vec3<short> &normalizeNonNull() noexcept = delete
-
Vec3<short> normalized() const noexcept = delete
-
Vec3<short> normalizedExc() const = delete
-
Vec3<short> normalizedNonNull() const noexcept = delete
-
int length() const noexcept = delete
-
const Vec3<int> &normalize() noexcept = delete
-
const Vec3<int> &normalizeExc() = delete
-
const Vec3<int> &normalizeNonNull() noexcept = delete
-
Vec3<int> normalized() const noexcept = delete
-
Vec3<int> normalizedExc() const = delete
-
Vec3<int> normalizedNonNull() const noexcept = delete
-
int64_t length() const noexcept = delete
-
const Vec3<int64_t> &normalize() noexcept = delete
-
const Vec3<int64_t> &normalizeExc() = delete
-
const Vec3<int64_t> &normalizeNonNull() noexcept = delete
-
Vec3<int64_t> normalized() const noexcept = delete
-
Vec3<int64_t> normalizedExc() const = delete
-
Vec3<int64_t> normalizedNonNull() const noexcept = delete
Public Static Functions
- static inline constexpr static unsigned int dimensions () noexcept
Return the number of dimensions, i.e. 3.
-
inline Vec3() noexcept¶