Panda3D
|
This is a three-component vector distance (as opposed to a three-component point, which represents a particular point in space). More...
#include "lvector3.h"
Public Types | |
typedef const double * | const_iterator |
typedef const double * | iterator |
Public Member Functions | |
LVector3d (const LVecBase3d ©) | |
LVector3d (double fill_value) | |
LVector3d (double x, double y, double z) | |
size_t | add_hash (size_t hash) const |
Adds the vector into the running hash. | |
size_t | add_hash (size_t hash, double threshold) const |
Adds the vector into the running hash. | |
void | add_to_cell (int i, double value) |
void | add_x (double value) |
void | add_y (double value) |
void | add_z (double value) |
bool | almost_equal (const LVecBase3d &other, double threshold) const |
Returns true if two vectors are memberwise equal within a specified tolerance. | |
bool | almost_equal (const LVecBase3d &other) const |
Returns true if two vectors are memberwise equal within a default tolerance based on the numeric type. | |
double | angle_deg (const LVector3d &other) const |
Returns the angle between this vector and the other one, expressed in degrees. | |
double | angle_rad (const LVector3d &other) const |
Returns the unsigned angle between this vector and the other one, expressed in radians. | |
iterator | begin () |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style. | |
const_iterator | begin () const |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style. | |
int | compare_to (const LVecBase3d &other, double threshold) const |
Sorts vectors lexicographically, componentwise. | |
int | compare_to (const LVecBase3d &other) const |
This flavor of compare_to uses a default threshold value based on the numeric type. | |
LVector3d | cross (const LVecBase3d &other) const |
void | cross_into (const LVecBase3d &other) |
double | dot (const LVecBase3d &other) const |
iterator | end () |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style. | |
const_iterator | end () const |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style. | |
void | fill (double fill_value) |
Sets each element of the vector to the indicated fill_value. | |
LVecBase3d | fmax (const LVecBase3d &other) |
LVecBase3d | fmin (const LVecBase3d &other) |
void | generate_hash (ChecksumHashGenerator &hashgen) const |
Adds the vector to the indicated hash generator. | |
void | generate_hash (ChecksumHashGenerator &hashgen, double threshold) const |
Adds the vector to the indicated hash generator. | |
double | get_cell (int i) const |
const double * | get_data () const |
Returns the address of the first of the three data elements in the vector. | |
size_t | get_hash () const |
Returns a suitable hash for phash_map. | |
size_t | get_hash (double threshold) const |
Returns a suitable hash for phash_map. | |
int | get_num_components () const |
Returns the number of elements in the vector, three. | |
LVecBase3d | get_standardized_hpr () const |
Try to un-spin the hpr to a standard form. | |
double | get_x () const |
LVector2d | get_xy () const |
Returns a 2-component vector that shares just the first two components of this vector. | |
LVector2d | get_xz () const |
Returns a 2-component vector that shares just the first and last components of this vector. | |
double | get_y () const |
LVector2d | get_yz () const |
Returns a 2-component vector that shares just the last two components of this vector. | |
double | get_z () const |
bool | is_nan () const |
Returns true if any component of the vector is not-a-number, false otherwise. | |
double | length () const |
Returns the length of the vector, by the Pythagorean theorem. | |
double | length_squared () const |
Returns the square of the vector's length, cheap and easy. | |
bool | normalize () |
Normalizes the vector in place. | |
bool | operator!= (const LVecBase3d &other) const |
LVector3d | operator* (double scalar) const |
void | operator*= (double scalar) |
LVector3d | operator+ (const LVector3d &other) const |
LVecBase3d | operator+ (const LVecBase3d &other) const |
void | operator+= (const LVecBase3d &other) |
LVecBase3d | operator- (const LVecBase3d &other) const |
LVector3d | operator- () const |
LVector3d | operator- (const LVector3d &other) const |
void | operator-= (const LVecBase3d &other) |
LVector3d | operator/ (double scalar) const |
void | operator/= (double scalar) |
bool | operator< (const LVecBase3d &other) const |
This performs a lexicographical comparison. | |
LVector3d & | operator= (double fill_value) |
LVector3d & | operator= (const LVecBase3d ©) |
bool | operator== (const LVecBase3d &other) const |
double | operator[] (int i) const |
double & | operator[] (int i) |
void | output (ostream &out) const |
LVector3d | project (const LVecBase3d &onto) const |
Returns a new vector representing the projection of this vector onto another one. | |
void | read_datagram (DatagramIterator &source) |
Function to read itself from a datagramIterator. | |
double | relative_angle_deg (const LVector3d &other) const |
This method is deprecated. | |
double | relative_angle_rad (const LVector3d &other) const |
This method is deprecated. | |
void | set (double x, double y, double z) |
void | set_cell (int i, double value) |
void | set_x (double value) |
void | set_y (double value) |
void | set_z (double value) |
double | signed_angle_deg (const LVector3d &other, const LVector3d &ref) const |
Returns the signed angle between two vectors. | |
double | signed_angle_rad (const LVector3d &other, const LVector3d &ref) const |
returns the signed angle between two vectors. | |
void | write_datagram (Datagram &destination) const |
Function to write itself into a datagram. | |
Static Public Member Functions | |
static LVector3d | back (CoordinateSystem cs=CS_default) |
Returns the back vector for the given coordinate system. | |
static LVector3d | down (CoordinateSystem cs=CS_default) |
Returns the down vector for the given coordinate system. | |
static LVector3d | forward (CoordinateSystem cs=CS_default) |
Returns the forward vector for the given coordinate system. | |
static TypeHandle | get_class_type () |
static void | init_type () |
static LVector3d | left (CoordinateSystem cs=CS_default) |
Returns the left vector for the given coordinate system. | |
static LVector3d | rfu (double right, double fwd, double up, CoordinateSystem cs=CS_default) |
Returns a vector that is described by its right, forward, and up components, in whatever way the coordinate system represents that vector. | |
static LVector3d | right (CoordinateSystem cs=CS_default) |
Returns the right vector for the given coordinate system. | |
static int | size () |
Returns 3: the number of components of a LVecBase3. | |
static const LVector3d & | unit_x () |
Returns a unit X vector. | |
static const LVector3d & | unit_y () |
Returns a unit Y vector. | |
static const LVector3d & | unit_z () |
Returns a unit Z vector. | |
static LVector3d | up (CoordinateSystem cs=CS_default) |
Returns the up vector for the given coordinate system. | |
static const LVector3d & | zero () |
Returns a zero-length vector. | |
Public Attributes | |
union { | |
double data [3] | |
struct { | |
double _0 | |
double _1 | |
double _2 | |
} v | |
} | _v |
This is a three-component vector distance (as opposed to a three-component point, which represents a particular point in space).
Some of the methods are slightly different between LPoint3 and LVector3; in particular, subtraction of two points yields a vector, while addition of a vector and a point yields a point.
Definition at line 737 of file lvector3.h.
size_t LVecBase3d::add_hash | ( | size_t | hash | ) | const [inline, inherited] |
Adds the vector into the running hash.
Definition at line 2111 of file lvecBase3.h.
size_t LVecBase3d::add_hash | ( | size_t | hash, |
double | threshold | ||
) | const [inline, inherited] |
Adds the vector into the running hash.
Definition at line 2122 of file lvecBase3.h.
bool LVecBase3d::almost_equal | ( | const LVecBase3d & | other, |
double | threshold | ||
) | const [inline, inherited] |
Returns true if two vectors are memberwise equal within a specified tolerance.
Definition at line 2282 of file lvecBase3.h.
Referenced by EggPolygon::is_planar(), and FltToEggLevelState::set_transform().
bool LVecBase3d::almost_equal | ( | const LVecBase3d & | other | ) | const [inline, inherited] |
Returns true if two vectors are memberwise equal within a default tolerance based on the numeric type.
Definition at line 2296 of file lvecBase3.h.
double LVector3d::angle_deg | ( | const LVector3d & | other | ) | const [inline] |
Returns the angle between this vector and the other one, expressed in degrees.
Both vectors should be initially normalized.
Definition at line 1063 of file lvector3.h.
double LVector3d::angle_rad | ( | const LVector3d & | other | ) | const [inline] |
Returns the unsigned angle between this vector and the other one, expressed in radians.
Both vectors should be initially normalized.
Definition at line 1043 of file lvector3.h.
LVector3d LVector3d::back | ( | CoordinateSystem | cs = CS_default | ) | [inline, static] |
Returns the back vector for the given coordinate system.
Definition at line 1244 of file lvector3.h.
LVecBase3d::iterator LVecBase3d::begin | ( | ) | [inline, inherited] |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style.
Definition at line 1814 of file lvecBase3.h.
LVecBase3d::const_iterator LVecBase3d::begin | ( | ) | const [inline, inherited] |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style.
Definition at line 1836 of file lvecBase3.h.
int LVecBase3d::compare_to | ( | const LVecBase3d & | other | ) | const [inline, inherited] |
This flavor of compare_to uses a default threshold value based on the numeric type.
Definition at line 2054 of file lvecBase3.h.
Referenced by EggVertexUV::compare_to(), EggAttributes::compare_to(), and EggBinner::sorts_less().
int LVecBase3d::compare_to | ( | const LVecBase3d & | other, |
double | threshold | ||
) | const [inline, inherited] |
Sorts vectors lexicographically, componentwise.
Returns a number less than 0 if this vector sorts before the other one, greater than zero if it sorts after, 0 if they are equivalent (within the indicated tolerance).
Definition at line 2069 of file lvecBase3.h.
LVector3d LVector3d::down | ( | CoordinateSystem | cs = CS_default | ) | [inline, static] |
Returns the down vector for the given coordinate system.
Definition at line 1222 of file lvector3.h.
LVecBase3d::iterator LVecBase3d::end | ( | ) | [inline, inherited] |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style.
Definition at line 1825 of file lvecBase3.h.
LVecBase3d::const_iterator LVecBase3d::end | ( | ) | const [inline, inherited] |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style.
Definition at line 1847 of file lvecBase3.h.
void LVecBase3d::fill | ( | double | fill_value | ) | [inline, inherited] |
Sets each element of the vector to the indicated fill_value.
This is particularly useful for initializing to zero.
Definition at line 1859 of file lvecBase3.h.
LVector3d LVector3d::forward | ( | CoordinateSystem | cs = CS_default | ) | [inline, static] |
Returns the forward vector for the given coordinate system.
Definition at line 1191 of file lvector3.h.
Referenced by EggXfmSAnim::compose_with_order().
void LVecBase3d::generate_hash | ( | ChecksumHashGenerator & | hashgen | ) | const [inline, inherited] |
Adds the vector to the indicated hash generator.
Definition at line 2335 of file lvecBase3.h.
void LVecBase3d::generate_hash | ( | ChecksumHashGenerator & | hashgen, |
double | threshold | ||
) | const [inline, inherited] |
Adds the vector to the indicated hash generator.
Definition at line 2346 of file lvecBase3.h.
const double * LVecBase3d::get_data | ( | ) | const [inline, inherited] |
Returns the address of the first of the three data elements in the vector.
The remaining elements occupy the next positions consecutively in memory.
Definition at line 1793 of file lvecBase3.h.
Referenced by XFileDataObject::set().
size_t LVecBase3d::get_hash | ( | double | threshold | ) | const [inline, inherited] |
Returns a suitable hash for phash_map.
Definition at line 2100 of file lvecBase3.h.
size_t LVecBase3d::get_hash | ( | ) | const [inline, inherited] |
Returns a suitable hash for phash_map.
Definition at line 2089 of file lvecBase3.h.
int LVecBase3d::get_num_components | ( | ) | const [inline, inherited] |
Returns the number of elements in the vector, three.
Definition at line 1803 of file lvecBase3.h.
LVecBase3d LVecBase3d::get_standardized_hpr | ( | ) | const [inline, inherited] |
Try to un-spin the hpr to a standard form.
Like all standards, someone decides between many arbitrary possible standards. This function assumes that 0 and 360 are the same, as is 720 and -360. Also 180 and -180 are the same. Another example is -90 and 270. Each element will be in the range -180.0 to 179.99999. The original usage of this function is for human readable output.
It doesn't work so well for asserting that foo_hpr is roughly equal to bar_hpr. Try using LQuaternionf::is_same_direction() for that. See Also: get_standardized_rotation, LQuaternion::is_same_direction
Definition at line 2040 of file lvecBase3.h.
LVector2d LVector3d::get_xy | ( | ) | const [inline] |
Returns a 2-component vector that shares just the first two components of this vector.
Reimplemented from LVecBase3d.
Definition at line 937 of file lvector3.h.
LVector2d LVector3d::get_xz | ( | ) | const [inline] |
Returns a 2-component vector that shares just the first and last components of this vector.
Reimplemented from LVecBase3d.
Definition at line 948 of file lvector3.h.
LVector2d LVector3d::get_yz | ( | ) | const [inline] |
Returns a 2-component vector that shares just the last two components of this vector.
Reimplemented from LVecBase3d.
Definition at line 959 of file lvector3.h.
bool LVecBase3d::is_nan | ( | ) | const [inline, inherited] |
Returns true if any component of the vector is not-a-number, false otherwise.
Definition at line 1624 of file lvecBase3.h.
LVector3d LVector3d::left | ( | CoordinateSystem | cs = CS_default | ) | [inline, static] |
Returns the left vector for the given coordinate system.
Definition at line 1233 of file lvector3.h.
double LVecBase3d::length | ( | ) | const [inline, inherited] |
Returns the length of the vector, by the Pythagorean theorem.
Definition at line 1886 of file lvecBase3.h.
Referenced by EggMesherEdge::compute_length(), and EggSwitchConditionDistance::transform().
double LVecBase3d::length_squared | ( | ) | const [inline, inherited] |
Returns the square of the vector's length, cheap and easy.
Definition at line 1898 of file lvecBase3.h.
bool LVecBase3d::normalize | ( | ) | [inline, inherited] |
Normalizes the vector in place.
Returns true if the vector was normalized, false if it was a zero-length vector.
Definition at line 1911 of file lvecBase3.h.
Referenced by EggPolygon::calculate_normal(), DXFFile::compute_ocs(), EggVertexUV::transform(), and EggAttributes::transform().
bool LVecBase3d::operator< | ( | const LVecBase3d & | other | ) | const [inline, inherited] |
This performs a lexicographical comparison.
It's of questionable mathematical meaning, but sometimes has a practical purpose for sorting unique vectors, especially in an STL container. Also see compare_to().
Definition at line 1971 of file lvecBase3.h.
LVector3d LVector3d::project | ( | const LVecBase3d & | onto | ) | const [inline] |
Returns a new vector representing the projection of this vector onto another one.
The resulting vector will be a scalar multiple of onto.
Reimplemented from LVecBase3d.
Definition at line 1031 of file lvector3.h.
void LVecBase3d::read_datagram | ( | DatagramIterator & | source | ) | [inline, inherited] |
Function to read itself from a datagramIterator.
Definition at line 2377 of file lvecBase3.h.
double LVector3d::relative_angle_deg | ( | const LVector3d & | other | ) | const [inline] |
double LVector3d::relative_angle_rad | ( | const LVector3d & | other | ) | const [inline] |
LVector3d LVector3d::rfu | ( | double | right, |
double | fwd, | ||
double | up, | ||
CoordinateSystem | cs = CS_default |
||
) | [inline, static] |
Returns a vector that is described by its right, forward, and up components, in whatever way the coordinate system represents that vector.
Definition at line 1258 of file lvector3.h.
LVector3d LVector3d::right | ( | CoordinateSystem | cs = CS_default | ) | [inline, static] |
Returns the right vector for the given coordinate system.
Definition at line 1180 of file lvector3.h.
Referenced by EggXfmSAnim::compose_with_order().
double LVector3d::signed_angle_deg | ( | const LVector3d & | other, |
const LVector3d & | ref | ||
) | const [inline] |
Returns the signed angle between two vectors.
The angle is positive if the rotation from this vector to other is clockwise when looking in the direction of the ref vector.
Vectors (except the ref vector) should be initially normalized.
Definition at line 1100 of file lvector3.h.
double LVector3d::signed_angle_rad | ( | const LVector3d & | other, |
const LVector3d & | ref | ||
) | const [inline] |
returns the signed angle between two vectors.
The angle is positive if the rotation from this vector to other is clockwise when looking in the direction of the ref vector.
Vectors (except the ref vector) should be initially normalized.
Definition at line 1079 of file lvector3.h.
int LVecBase3d::size | ( | ) | [inline, static, inherited] |
Returns 3: the number of components of a LVecBase3.
Definition at line 1613 of file lvecBase3.h.
const LVector3d & LVector3d::unit_x | ( | ) | [inline, static] |
const LVector3d & LVector3d::unit_y | ( | ) | [inline, static] |
const LVector3d & LVector3d::unit_z | ( | ) | [inline, static] |
LVector3d LVector3d::up | ( | CoordinateSystem | cs = CS_default | ) | [inline, static] |
Returns the up vector for the given coordinate system.
Definition at line 1153 of file lvector3.h.
Referenced by EggXfmSAnim::compose_with_order().
void LVecBase3d::write_datagram | ( | Datagram & | destination | ) | const [inline, inherited] |
Function to write itself into a datagram.
Definition at line 2359 of file lvecBase3.h.
const LVector3d & LVector3d::zero | ( | ) | [inline, static] |
Returns a zero-length vector.
Reimplemented from LVecBase3d.
Definition at line 896 of file lvector3.h.
Referenced by EggPolygon::calculate_normal(), EggTransform::get_component_vec3(), and FltToEggLevelState::set_transform().