Panda3D
Public Types | Public Member Functions | Static Public Member Functions | Public Attributes

LPoint3d Class Reference

This is a three-component point in space (as opposed to a three-component vector, which represents a direction and a distance). More...

#include "lpoint3.h"

Inheritance diagram for LPoint3d:
LVecBase3d

List of all members.

Public Types

typedef const double * const_iterator
typedef const double * iterator

Public Member Functions

 LPoint3d (const LVecBase3d &copy)
 LPoint3d (double fill_value)
 LPoint3d (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.
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) const
 This flavor of compare_to uses a default threshold value based on the numeric type.
int compare_to (const LVecBase3d &other, double threshold) const
 Sorts vectors lexicographically, componentwise.
LPoint3d 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
LPoint2d get_xy () const
 Returns a 2-component vector that shares just the first two components of this vector.
LPoint2d get_xz () const
 Returns a 2-component vector that shares just the first and last components of this vector.
double get_y () const
LPoint2d 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
LPoint3d operator* (double scalar) const
void operator*= (double scalar)
LPoint3d operator+ (const LVector3d &other) const
LVecBase3d operator+ (const LVecBase3d &other) const
void operator+= (const LVecBase3d &other)
LPoint3d operator- (const LVector3d &other) const
LVector3d operator- (const LPoint3d &other) const
LPoint3d operator- () const
LVecBase3d operator- (const LVecBase3d &other) const
void operator-= (const LVecBase3d &other)
LPoint3d operator/ (double scalar) const
void operator/= (double scalar)
bool operator< (const LVecBase3d &other) const
 This performs a lexicographical comparison.
LPoint3doperator= (double fill_value)
LPoint3doperator= (const LVecBase3d &copy)
bool operator== (const LVecBase3d &other) const
double operator[] (int i) const
double & operator[] (int i)
void output (ostream &out) const
LPoint3d 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.
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)
void write_datagram (Datagram &destination) const
 Function to write itself into a datagram.

Static Public Member Functions

static TypeHandle get_class_type ()
static void init_type ()
static LPoint3d origin (CoordinateSystem cs=CS_default)
 Returns the origin of the indicated coordinate system.
static LPoint3d rfu (double right, double fwd, double up, CoordinateSystem cs=CS_default)
 Returns a point described by right, forward, up displacements from the origin, wherever that maps to in the given coordinate system.
static int size ()
 Returns 3: the number of components of a LVecBase3.
static const LPoint3dunit_x ()
 Returns a unit X point.
static const LPoint3dunit_y ()
 Returns a unit Y point.
static const LPoint3dunit_z ()
 Returns a unit Z point.
static const LPoint3dzero ()
 Returns a zero-length point.

Public Attributes

union {
   double   data [3]
   struct {
      double   _0
      double   _1
      double   _2
   }   v
_v

Detailed Description

This is a three-component point in space (as opposed to a three-component vector, which represents a direction and a distance).

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 517 of file lpoint3.h.


Member Function Documentation

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.

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.

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.

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 ( ) const [inline, inherited]

Returns a suitable hash for phash_map.

Definition at line 2089 of file lvecBase3.h.

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.

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.

LPoint2d LPoint3d::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 705 of file lpoint3.h.

LPoint2d LPoint3d::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 716 of file lpoint3.h.

LPoint2d LPoint3d::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 727 of file lpoint3.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.

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.

LPoint3d LPoint3d::origin ( CoordinateSystem  cs = CS_default) [inline, static]

Returns the origin of the indicated coordinate system.

This is always 0, 0, 0 with all of our existing coordinate systems; it's hard to imagine it ever being different.

Definition at line 842 of file lpoint3.h.

LPoint3d LPoint3d::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 809 of file lpoint3.h.

void LVecBase3d::read_datagram ( DatagramIterator source) [inline, inherited]

Function to read itself from a datagramIterator.

Definition at line 2377 of file lvecBase3.h.

LPoint3d LPoint3d::rfu ( double  right,
double  fwd,
double  up,
CoordinateSystem  cs = CS_default 
) [inline, static]

Returns a point described by right, forward, up displacements from the origin, wherever that maps to in the given coordinate system.

Definition at line 854 of file lpoint3.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 LPoint3d & LPoint3d::unit_x ( ) [inline, static]

Returns a unit X point.

Reimplemented from LVecBase3d.

Definition at line 674 of file lpoint3.h.

const LPoint3d & LPoint3d::unit_y ( ) [inline, static]

Returns a unit Y point.

Reimplemented from LVecBase3d.

Definition at line 684 of file lpoint3.h.

const LPoint3d & LPoint3d::unit_z ( ) [inline, static]

Returns a unit Z point.

Reimplemented from LVecBase3d.

Definition at line 694 of file lpoint3.h.

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 LPoint3d & LPoint3d::zero ( ) [inline, static]

Returns a zero-length point.

Reimplemented from LVecBase3d.

Definition at line 664 of file lpoint3.h.

Referenced by MayaNodeTree::get_egg_group(), and EggVertex::get_uvw().


The documentation for this class was generated from the following files:
 All Classes Functions Variables Enumerations