Panda3D
Public Member Functions | Static Public Member Functions | List of all members
LVector3f Class Reference

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"

Inheritance diagram for LVector3f:
LVecBase3f

Public Member Functions

 LVector3f (const LVecBase3f &copy)
 
 LVector3f (float fill_value)
 
 LVector3f (float x, float y, float z)
 
 LVector3f (const LVecBase2f &copy, float z)
 
float angle_deg (const LVector3f &other) const
 Returns the angle between this vector and the other one, expressed in degrees. More...
 
float angle_rad (const LVector3f &other) const
 Returns the unsigned angle between this vector and the other one, expressed in radians. More...
 
LVector3f cross (const LVecBase3f &other) const
 
LVector2f get_xy () const
 Returns a 2-component vector that shares just the first two components of this vector. More...
 
LVector2f get_xz () const
 Returns a 2-component vector that shares just the first and last components of this vector. More...
 
LVector2f get_yz () const
 Returns a 2-component vector that shares just the last two components of this vector. More...
 
LVector3f normalized () const
 Normalizes the vector and returns the normalized vector as a copy. More...
 
LVector3f operator* (float scalar) const
 
LVecBase3f operator+ (const LVecBase3f &other) const
 
LVector3f operator+ (const LVector3f &other) const
 
LVector3f operator- () const
 
LVecBase3f operator- (const LVecBase3f &other) const
 
LVector3f operator- (const LVector3f &other) const
 
LVector3f operator/ (float scalar) const
 
LVector3foperator= (const LVecBase3f &copy)
 
LVector3foperator= (float fill_value)
 
LVector3f project (const LVecBase3f &onto) const
 Returns a new vector representing the projection of this vector onto another one. More...
 
float relative_angle_deg (const LVector3f &other) const
 This method is deprecated. More...
 
float relative_angle_rad (const LVector3f &other) const
 This method is deprecated. More...
 
float signed_angle_deg (const LVector3f &other, const LVector3f &ref) const
 Returns the signed angle between two vectors. More...
 
float signed_angle_rad (const LVector3f &other, const LVector3f &ref) const
 returns the signed angle between two vectors. More...
 
- Public Member Functions inherited from LVecBase3f
 LVecBase3f (const LVecBase3f &copy)
 
 LVecBase3f (float fill_value)
 
 LVecBase3f (float x, float y, float z)
 
 LVecBase3f (const LVecBase2f &copy, float z)
 
 LVecBase3f (const EVector3 &v)
 
size_t add_hash (size_t hash) const
 Adds the vector into the running hash. More...
 
size_t add_hash (size_t hash, float threshold) const
 Adds the vector into the running hash. More...
 
void add_to_cell (int i, float value)
 
void add_x (float value)
 
void add_y (float value)
 
void add_z (float value)
 
bool almost_equal (const LVecBase3f &other, float threshold) const
 Returns true if two vectors are memberwise equal within a specified tolerance. More...
 
bool almost_equal (const LVecBase3f &other) const
 Returns true if two vectors are memberwise equal within a default tolerance based on the numeric type. More...
 
iterator begin ()
 Returns an iterator that may be used to traverse the elements of the matrix, STL-style. More...
 
const_iterator begin () const
 Returns an iterator that may be used to traverse the elements of the matrix, STL-style. More...
 
int compare_to (const LVecBase3f &other) const
 This flavor of compare_to uses a default threshold value based on the numeric type. More...
 
int compare_to (const LVecBase3f &other, float threshold) const
 Sorts vectors lexicographically, componentwise. More...
 
void componentwise_mult (const LVecBase3f &other)
 
LVecBase3f cross (const LVecBase3f &other) const
 
void cross_into (const LVecBase3f &other)
 
float dot (const LVecBase3f &other) const
 
iterator end ()
 Returns an iterator that may be used to traverse the elements of the matrix, STL-style. More...
 
const_iterator end () const
 Returns an iterator that may be used to traverse the elements of the matrix, STL-style. More...
 
void fill (float fill_value)
 Sets each element of the vector to the indicated fill_value. More...
 
LVecBase3f fmax (const LVecBase3f &other) const
 
LVecBase3f fmin (const LVecBase3f &other) const
 
void generate_hash (ChecksumHashGenerator &hashgen) const
 Adds the vector to the indicated hash generator. More...
 
void generate_hash (ChecksumHashGenerator &hashgen, float threshold) const
 Adds the vector to the indicated hash generator. More...
 
float get_cell (int i) const
 
const float * get_data () const
 Returns the address of the first of the three data elements in the vector. More...
 
size_t get_hash () const
 Returns a suitable hash for phash_map. More...
 
size_t get_hash (float threshold) const
 Returns a suitable hash for phash_map. More...
 
int get_num_components () const
 Returns the number of elements in the vector, three. More...
 
LVecBase3f get_standardized_hpr () const
 Try to un-spin the hpr to a standard form. More...
 
float get_x () const
 
LVecBase2f get_xy () const
 Returns a 2-component vector that shares just the first two components of this vector. More...
 
LVecBase2f get_xz () const
 Returns a 2-component vector that shares just the first and last components of this vector. More...
 
float get_y () const
 
LVecBase2f get_yz () const
 Returns a 2-component vector that shares just the last two components of this vector. More...
 
float get_z () const
 
bool is_nan () const
 Returns true if any component of the vector is not-a-number, false otherwise. More...
 
float length () const
 Returns the length of the vector, by the Pythagorean theorem. More...
 
float length_squared () const
 Returns the square of the vector's length, cheap and easy. More...
 
bool normalize ()
 Normalizes the vector in place. More...
 
LVecBase3f normalized () const
 Normalizes the vector and returns the normalized vector as a copy. More...
 
bool operator!= (const LVecBase3f &other) const
 
LVecBase3f operator* (float scalar) const
 
void operator*= (float scalar)
 
LVecBase3f operator+ (const LVecBase3f &other) const
 
void operator+= (const LVecBase3f &other)
 
LVecBase3f operator- () const
 
LVecBase3f operator- (const LVecBase3f &other) const
 
void operator-= (const LVecBase3f &other)
 
LVecBase3f operator/ (float scalar) const
 
void operator/= (float scalar)
 
bool operator< (const LVecBase3f &other) const
 This performs a lexicographical comparison. More...
 
LVecBase3foperator= (const LVecBase3f &copy)
 
LVecBase3foperator= (float fill_value)
 
bool operator== (const LVecBase3f &other) const
 
float operator[] (int i) const
 
float & operator[] (int i)
 
void output (ostream &out) const
 
LVecBase3f project (const LVecBase3f &onto) const
 Returns a new vector representing the projection of this vector onto another one. More...
 
void read_datagram (DatagramIterator &source)
 Reads the vector from the Datagram using get_stdfloat(). More...
 
void read_datagram_fixed (DatagramIterator &source)
 Reads the vector from the Datagram using get_float32() or get_float64(). More...
 
void set (float x, float y, float z)
 
void set_cell (int i, float value)
 
void set_x (float value)
 
void set_y (float value)
 
void set_z (float value)
 
void write_datagram (Datagram &destination) const
 Writes the vector to the Datagram using add_stdfloat(). More...
 
void write_datagram_fixed (Datagram &destination) const
 Writes the vector to the Datagram using add_float32() or add_float64(), depending on the type of floats in the vector, regardless of the setting of Datagram::set_stdfloat_double(). More...
 

Static Public Member Functions

static LVector3f back (CoordinateSystem cs=CS_default)
 Returns the back vector for the given coordinate system. More...
 
static LVector3f down (CoordinateSystem cs=CS_default)
 Returns the down vector for the given coordinate system. More...
 
static LVector3f forward (CoordinateSystem cs=CS_default)
 Returns the forward vector for the given coordinate system. More...
 
static TypeHandle get_class_type ()
 
static void init_type ()
 
static LVector3f left (CoordinateSystem cs=CS_default)
 Returns the left vector for the given coordinate system. More...
 
static LVector3f rfu (float right, float fwd, float 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. More...
 
static LVector3f right (CoordinateSystem cs=CS_default)
 Returns the right vector for the given coordinate system. More...
 
static const LVector3funit_x ()
 Returns a unit X vector. More...
 
static const LVector3funit_y ()
 Returns a unit Y vector. More...
 
static const LVector3funit_z ()
 Returns a unit Z vector. More...
 
static LVector3f up (CoordinateSystem cs=CS_default)
 Returns the up vector for the given coordinate system. More...
 
static const LVector3fzero ()
 Returns a zero-length vector. More...
 
- Static Public Member Functions inherited from LVecBase3f
static TypeHandle get_class_type ()
 
static void init_type ()
 
static int size ()
 Returns 3: the number of components of a LVecBase3. More...
 
static const LVecBase3funit_x ()
 Returns a unit X vector. More...
 
static const LVecBase3funit_y ()
 Returns a unit Y vector. More...
 
static const LVecBase3funit_z ()
 Returns a unit Z vector. More...
 
static const LVecBase3fzero ()
 Returns a zero-length vector. More...
 

Additional Inherited Members

- Public Types inherited from LVecBase3f
enum  { num_components = 3, is_int = 0 }
 
typedef const float * const_iterator
 
typedef LSimpleMatrix< float, 1, 3 > EVector3
 
typedef const float * iterator
 
typedef float numeric_type
 
- Public Attributes inherited from LVecBase3f
EVector3 _v
 

Detailed Description

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 100 of file lvector3.h.

Member Function Documentation

◆ angle_deg()

float LVector3f::angle_deg ( const LVector3f 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 451 of file lvector3.h.

Referenced by GeoMipTerrain::make_slope_image().

◆ angle_rad()

float LVector3f::angle_rad ( const LVector3f 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 431 of file lvector3.h.

References MathNumbers::cpi().

◆ back()

LVector3f LVector3f::back ( CoordinateSystem  cs = CS_default)
inlinestatic

Returns the back vector for the given coordinate system.

Definition at line 632 of file lvector3.h.

Referenced by WindowFramework::load_default_model(), and GraphicsOutput::process_events().

◆ down()

LVector3f LVector3f::down ( CoordinateSystem  cs = CS_default)
inlinestatic

Returns the down vector for the given coordinate system.

Definition at line 610 of file lvector3.h.

Referenced by Trackball::get_trans_mat().

◆ forward()

LVector3f LVector3f::forward ( CoordinateSystem  cs = CS_default)
inlinestatic

◆ get_xy()

LVector2f LVector3f::get_xy ( ) const
inline

Returns a 2-component vector that shares just the first two components of this vector.

Definition at line 311 of file lvector3.h.

◆ get_xz()

LVector2f LVector3f::get_xz ( ) const
inline

Returns a 2-component vector that shares just the first and last components of this vector.

Definition at line 322 of file lvector3.h.

◆ get_yz()

LVector2f LVector3f::get_yz ( ) const
inline

Returns a 2-component vector that shares just the last two components of this vector.

Definition at line 333 of file lvector3.h.

◆ left()

LVector3f LVector3f::left ( CoordinateSystem  cs = CS_default)
inlinestatic

Returns the left vector for the given coordinate system.

Definition at line 621 of file lvector3.h.

◆ normalized()

LVector3f LVector3f::normalized ( ) const
inline

Normalizes the vector and returns the normalized vector as a copy.

If the vector was a zero-length vector, a zero length vector will be returned.

Definition at line 407 of file lvector3.h.

Referenced by EggSaver::add_node().

◆ project()

LVector3f LVector3f::project ( const LVecBase3f 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.

Definition at line 419 of file lvector3.h.

◆ relative_angle_deg()

float LVector3f::relative_angle_deg ( const LVector3f other) const
inline

This method is deprecated.

Do not use.

Definition at line 509 of file lvector3.h.

◆ relative_angle_rad()

float LVector3f::relative_angle_rad ( const LVector3f other) const
inline

This method is deprecated.

Do not use.

Definition at line 499 of file lvector3.h.

◆ rfu()

LVector3f LVector3f::rfu ( float  right,
float  fwd,
float  up,
CoordinateSystem  cs = CS_default 
)
inlinestatic

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 645 of file lvector3.h.

Referenced by PGItem::get_text_node(), PGSliderBar::recompute(), PGScrollFrame::remanage(), PGSliderBar::remanage(), CardMaker::set_frame(), PGScrollFrame::setup(), PGSliderBar::setup_scroll_bar(), PGSliderBar::setup_slider(), and MouseWatcherBase::update_regions().

◆ right()

LVector3f LVector3f::right ( CoordinateSystem  cs = CS_default)
inlinestatic

Returns the right vector for the given coordinate system.

Definition at line 568 of file lvector3.h.

Referenced by PGItem::activate_region(), Trackball::get_trans_mat(), RocketRenderInterface::render(), TextPropertiesManager::set_graphic(), and PGEntry::setup().

◆ signed_angle_deg()

float LVector3f::signed_angle_deg ( const LVector3f other,
const LVector3f 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 488 of file lvector3.h.

◆ signed_angle_rad()

float LVector3f::signed_angle_rad ( const LVector3f other,
const LVector3f 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 467 of file lvector3.h.

◆ unit_x()

const LVector3f & LVector3f::unit_x ( )
inlinestatic

Returns a unit X vector.

Definition at line 280 of file lvector3.h.

◆ unit_y()

const LVector3f & LVector3f::unit_y ( )
inlinestatic

Returns a unit Y vector.

Definition at line 290 of file lvector3.h.

◆ unit_z()

const LVector3f & LVector3f::unit_z ( )
inlinestatic

Returns a unit Z vector.

Definition at line 300 of file lvector3.h.

◆ up()

LVector3f LVector3f::up ( CoordinateSystem  cs = CS_default)
inlinestatic

◆ zero()

const LVector3f & LVector3f::zero ( )
inlinestatic

The documentation for this class was generated from the following files: