Panda3D
|
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"
Public Types | |
typedef const float * | const_iterator |
typedef const float * | iterator |
Public Member Functions | |
LPoint3f (const LVecBase3f ©) | |
LPoint3f (float fill_value) | |
LPoint3f (float x, float y, float z) | |
size_t | add_hash (size_t hash) const |
Adds the vector into the running hash. | |
size_t | add_hash (size_t hash, float threshold) const |
Adds the vector into the running hash. | |
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. | |
bool | almost_equal (const LVecBase3f &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 LVecBase3f &other) const |
This flavor of compare_to uses a default threshold value based on the numeric type. | |
int | compare_to (const LVecBase3f &other, float threshold) const |
Sorts vectors lexicographically, componentwise. | |
LPoint3f | 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. | |
const_iterator | end () const |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style. | |
void | fill (float fill_value) |
Sets each element of the vector to the indicated fill_value. | |
LVecBase3f | fmax (const LVecBase3f &other) |
LVecBase3f | fmin (const LVecBase3f &other) |
void | generate_hash (ChecksumHashGenerator &hashgen) const |
Adds the vector to the indicated hash generator. | |
void | generate_hash (ChecksumHashGenerator &hashgen, float threshold) const |
Adds the vector to the indicated hash generator. | |
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. | |
size_t | get_hash () const |
Returns a suitable hash for phash_map. | |
size_t | get_hash (float threshold) const |
Returns a suitable hash for phash_map. | |
int | get_num_components () const |
Returns the number of elements in the vector, three. | |
LVecBase3f | get_standardized_hpr () const |
Try to un-spin the hpr to a standard form. | |
float | get_x () const |
LPoint2f | get_xy () const |
Returns a 2-component vector that shares just the first two components of this vector. | |
LPoint2f | get_xz () const |
Returns a 2-component vector that shares just the first and last components of this vector. | |
float | get_y () const |
LPoint2f | get_yz () const |
Returns a 2-component vector that shares just the last two components of this vector. | |
float | get_z () const |
bool | is_nan () const |
Returns true if any component of the vector is not-a-number, false otherwise. | |
float | length () const |
Returns the length of the vector, by the Pythagorean theorem. | |
float | length_squared () const |
Returns the square of the vector's length, cheap and easy. | |
bool | normalize () |
Normalizes the vector in place. | |
bool | operator!= (const LVecBase3f &other) const |
LPoint3f | operator* (float scalar) const |
void | operator*= (float scalar) |
LPoint3f | operator+ (const LVector3f &other) const |
LVecBase3f | operator+ (const LVecBase3f &other) const |
void | operator+= (const LVecBase3f &other) |
LPoint3f | operator- (const LVector3f &other) const |
LVector3f | operator- (const LPoint3f &other) const |
LPoint3f | operator- () const |
LVecBase3f | operator- (const LVecBase3f &other) const |
void | operator-= (const LVecBase3f &other) |
LPoint3f | operator/ (float scalar) const |
void | operator/= (float scalar) |
bool | operator< (const LVecBase3f &other) const |
This performs a lexicographical comparison. | |
LPoint3f & | operator= (float fill_value) |
LPoint3f & | operator= (const LVecBase3f ©) |
bool | operator== (const LVecBase3f &other) const |
float | operator[] (int i) const |
float & | operator[] (int i) |
void | output (ostream &out) const |
LPoint3f | project (const LVecBase3f &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 (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 |
Function to write itself into a datagram. | |
Static Public Member Functions | |
static TypeHandle | get_class_type () |
static void | init_type () |
static LPoint3f | origin (CoordinateSystem cs=CS_default) |
Returns the origin of the indicated coordinate system. | |
static LPoint3f | rfu (float right, float fwd, float 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 LPoint3f & | unit_x () |
Returns a unit X point. | |
static const LPoint3f & | unit_y () |
Returns a unit Y point. | |
static const LPoint3f & | unit_z () |
Returns a unit Z point. | |
static const LPoint3f & | zero () |
Returns a zero-length point. | |
Public Attributes | |
union { | |
float data [3] | |
struct { | |
float _0 | |
float _1 | |
float _2 | |
} v | |
} | _v |
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.
size_t LVecBase3f::add_hash | ( | size_t | hash | ) | const [inline, inherited] |
Adds the vector into the running hash.
Definition at line 933 of file lvecBase3.h.
size_t LVecBase3f::add_hash | ( | size_t | hash, |
float | threshold | ||
) | const [inline, inherited] |
Adds the vector into the running hash.
Definition at line 944 of file lvecBase3.h.
bool LVecBase3f::almost_equal | ( | const LVecBase3f & | other, |
float | threshold | ||
) | const [inline, inherited] |
Returns true if two vectors are memberwise equal within a specified tolerance.
Definition at line 1104 of file lvecBase3.h.
Referenced by NurbsCurveResult::adaptive_sample(), ParametricCurve::convert_to_hermite(), ColorScaleAttrib::fillin(), ACMatrixSwitchType::output_value(), and FltToEggLevelState::set_transform().
bool LVecBase3f::almost_equal | ( | const LVecBase3f & | other | ) | const [inline, inherited] |
Returns true if two vectors are memberwise equal within a default tolerance based on the numeric type.
Definition at line 1118 of file lvecBase3.h.
LVecBase3f::iterator LVecBase3f::begin | ( | ) | [inline, inherited] |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style.
Definition at line 636 of file lvecBase3.h.
LVecBase3f::const_iterator LVecBase3f::begin | ( | ) | const [inline, inherited] |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style.
Definition at line 658 of file lvecBase3.h.
int LVecBase3f::compare_to | ( | const LVecBase3f & | other | ) | const [inline, inherited] |
This flavor of compare_to uses a default threshold value based on the numeric type.
Definition at line 876 of file lvecBase3.h.
Referenced by BillboardEffect::compare_to_impl(), and TransformState::sorts_less().
int LVecBase3f::compare_to | ( | const LVecBase3f & | other, |
float | 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 891 of file lvecBase3.h.
LVecBase3f::iterator LVecBase3f::end | ( | ) | [inline, inherited] |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style.
Definition at line 647 of file lvecBase3.h.
LVecBase3f::const_iterator LVecBase3f::end | ( | ) | const [inline, inherited] |
Returns an iterator that may be used to traverse the elements of the matrix, STL-style.
Definition at line 669 of file lvecBase3.h.
void LVecBase3f::fill | ( | float | 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 681 of file lvecBase3.h.
void LVecBase3f::generate_hash | ( | ChecksumHashGenerator & | hashgen | ) | const [inline, inherited] |
Adds the vector to the indicated hash generator.
Definition at line 1157 of file lvecBase3.h.
void LVecBase3f::generate_hash | ( | ChecksumHashGenerator & | hashgen, |
float | threshold | ||
) | const [inline, inherited] |
Adds the vector to the indicated hash generator.
Definition at line 1168 of file lvecBase3.h.
const float * LVecBase3f::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 615 of file lvecBase3.h.
Referenced by DXGraphicsStateGuardian9::bind_light(), and DXGraphicsStateGuardian8::bind_light().
size_t LVecBase3f::get_hash | ( | ) | const [inline, inherited] |
Returns a suitable hash for phash_map.
Definition at line 911 of file lvecBase3.h.
size_t LVecBase3f::get_hash | ( | float | threshold | ) | const [inline, inherited] |
Returns a suitable hash for phash_map.
Definition at line 922 of file lvecBase3.h.
int LVecBase3f::get_num_components | ( | ) | const [inline, inherited] |
Returns the number of elements in the vector, three.
Definition at line 625 of file lvecBase3.h.
LVecBase3f LVecBase3f::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 862 of file lvecBase3.h.
LPoint2f LPoint3f::get_xy | ( | ) | const [inline] |
Returns a 2-component vector that shares just the first two components of this vector.
Reimplemented from LVecBase3f.
LPoint2f LPoint3f::get_xz | ( | ) | const [inline] |
Returns a 2-component vector that shares just the first and last components of this vector.
Reimplemented from LVecBase3f.
LPoint2f LPoint3f::get_yz | ( | ) | const [inline] |
Returns a 2-component vector that shares just the last two components of this vector.
Reimplemented from LVecBase3f.
bool LVecBase3f::is_nan | ( | ) | const [inline, inherited] |
Returns true if any component of the vector is not-a-number, false otherwise.
Definition at line 446 of file lvecBase3.h.
Referenced by PhysxActor::add_force(), PhysxActor::add_force_at_local_pos(), PhysxActor::add_force_at_pos(), PhysicsObject::add_impact(), PhysicsObject::add_impulse(), PhysxActor::add_local_force(), PhysxActor::add_local_force_at_local_pos(), PhysxActor::add_local_force_at_pos(), PhysicsObject::add_local_impact(), PhysicsObject::add_local_impulse(), PhysxActor::add_local_torque(), PhysxActor::add_torque(), BoundingSphere::around_points(), BoundingBox::around_points(), PhysxCloth::attach_vertex_to_global_pos(), PhysxCloth::attach_vertex_to_shape(), BoundingBox::BoundingBox(), BoundingSphere::BoundingSphere(), PhysxBounds3::bounds_of_obb(), PhysxUtilLib::box_box_intersect(), PhysxSegment::compute_direction(), PhysxCapsule::compute_direction(), PhysxSegment::compute_point(), PhysxCapsule::compute_point(), PhysxBounds3::contain(), PhysxSphere::contains(), BoundingSphere::contains_lineseg(), BoundingBox::contains_lineseg(), BoundingSphere::contains_point(), BoundingBox::contains_point(), BoundingSphere::extend_by_point(), BoundingBox::extend_by_point(), PhysxActor::get_local_point_velocity(), PhysxActor::get_point_velocity(), PhysxBounds3::include(), PhysxActor::move_global_pos(), PhysxUtilLib::point_obb_sqr_dist(), PhysxUtilLib::ray_aabb_intersect(), PhysxUtilLib::ray_capsule_intersect(), PhysxUtilLib::ray_obb_intersect(), PhysxUtilLib::ray_sphere_intersect(), PhysxUtilLib::ray_tri_intersect(), PhysicsObject::reset_position(), PhysxUtilLib::segment_aabb_intersect(), PhysxUtilLib::segment_box_intersect(), PhysxUtilLib::segment_obb_intersect(), PhysxBounds3::set(), PhysxSphere::set_center(), PhysxBox::set_center(), PhysxBounds3::set_center_extents(), PhysxBoxShapeDesc::set_dimensions(), PhysxBoxForceFieldShapeDesc::set_dimensions(), PhysxRay::set_direction(), CLerpNodePathInterval::set_end_hpr(), CLerpNodePathInterval::set_end_pos(), CLerpNodePathInterval::set_end_quat(), CLerpNodePathInterval::set_end_scale(), CLerpNodePathInterval::set_end_shear(), PhysxBox::set_extents(), PhysxCloth::set_external_acceleration(), Lens::set_frustum_from_corners(), PhysxActor::set_global_pos(), PhysxController::set_global_speed(), PhysxSceneDesc::set_gravity(), PhysxScene::set_gravity(), PhysxController::set_local_speed(), PhysxBounds3::set_max(), PhysxBounds3::set_min(), PhysxRay::set_origin(), PhysxSegment::set_origin_direction(), PhysxCapsule::set_origin_direction(), PhysxSegment::set_p0(), PhysxCapsule::set_p0(), PhysxSegment::set_p1(), PhysxCapsule::set_p1(), PhysxPlaneShapeDesc::set_plane(), PhysicsObject::set_position(), CLerpNodePathInterval::set_start_hpr(), CLerpNodePathInterval::set_start_pos(), CLerpNodePathInterval::set_start_scale(), CLerpNodePathInterval::set_start_shear(), PhysxSphericalJointDesc::set_swing_axis(), PhysicsObject::set_velocity(), Lens::set_view_hpr(), Lens::set_view_vector(), PhysxCloth::set_wind_acceleration(), PhysxUtilLib::sweep_box_box(), PhysxUtilLib::sweep_box_capsule(), PhysxUtilLib::sweep_box_sphere(), PhysxUtilLib::sweep_capsule_capsule(), PhysxUtilLib::sweep_sphere_capsule(), PhysxUtilLib::swept_spheres_intersect(), PhysxBounds3::transform(), and PhysxUtilLib::tri_box_intersect().
float LVecBase3f::length | ( | ) | const [inline, inherited] |
Returns the length of the vector, by the Pythagorean theorem.
Definition at line 708 of file lvecBase3.h.
Referenced by AIBehaviors::accumulate_force(), PhysicsObject::add_impact(), PhysicsCollisionHandler::apply_friction(), PhysicsCollisionHandler::apply_net_shove(), Arrival::arrival_activate(), AIBehaviors::calculate_prioritized(), Arrival::do_arrival(), Evade::do_evade(), Flee::do_flee(), AIBehaviors::do_flock(), ObstacleAvoidance::do_obstacle_avoidance(), Evade::evade_activate(), CollisionTube::fill_viz_geom(), CollisionDSSolid::fill_viz_geom(), Flee::flee_activate(), CollisionDSSolid::get_collision_origin(), AIBehaviors::is_conflict(), ObstacleAvoidance::obstacle_detection(), PSphereLens::project_impl(), FisheyeLens::project_impl(), MeshDrawer::stream(), AICharacter::update(), CMotionTrail::update_motion_trail(), CollisionPolygon::verify_points(), PGFrameStyle::xform(), and LODNode::xform().
float LVecBase3f::length_squared | ( | ) | const [inline, inherited] |
Returns the square of the vector's length, cheap and easy.
Definition at line 720 of file lvecBase3.h.
Referenced by CollisionHandlerHighestEvent::add_entry(), ObstacleAvoidance::obstacle_detection(), and Lens::set_frustum_from_corners().
bool LVecBase3f::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 733 of file lvecBase3.h.
Referenced by AIBehaviors::accumulate_force(), PhysicsObject::add_impact(), Fog::adjust_to_camera(), TinyGraphicsStateGuardian::bind_light(), AIBehaviors::calculate_prioritized(), ParametricCurve::convert_to_hermite(), Arrival::do_arrival(), NodePath::do_billboard_axis(), NodePath::do_billboard_point_eye(), NodePath::do_billboard_point_world(), Evade::do_evade(), AIBehaviors::do_flock(), ObstacleAvoidance::do_obstacle_avoidance(), Pursue::do_pursue(), Wander::do_wander(), MeshDrawer::explosion(), GraphicsStateGuardian::fetch_specified_part(), GraphicsStateGuardian::fetch_specified_value(), CollisionPlane::fill_viz_geom(), Flee::flee_activate(), BaseParticleEmitter::generate(), Texture::generate_normalization_cube_map(), CollisionDSSolid::get_collision_origin(), GeoMipTerrain::get_normal(), CollisionHandlerPusher::handle_entries(), CollisionHandlerFluidPusher::handle_entries(), AIBehaviors::is_conflict(), GeoMipTerrain::make_slope_image(), ObstacleAvoidance::obstacle_detection(), AICharacter::update(), and CollisionSolid::xform().
bool LVecBase3f::operator< | ( | const LVecBase3f & | 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 793 of file lvecBase3.h.
LPoint3f LPoint3f::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 418 of file lpoint3.h.
Referenced by CollisionPlane::get_collision_origin(), CollisionFloorMesh::get_collision_origin(), CollisionSegment::set_from_lens(), and CollisionRay::set_from_lens().
LPoint3f LPoint3f::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.
Reimplemented from LVecBase3f.
void LVecBase3f::read_datagram | ( | DatagramIterator & | source | ) | [inline, inherited] |
Function to read itself from a datagramIterator.
Definition at line 1199 of file lvecBase3.h.
Referenced by TransformState::fillin(), PortalNode::fillin(), Fog::fillin(), BillboardEffect::fillin(), CollisionTube::fillin(), CollisionSphere::fillin(), CollisionSolid::fillin(), CollisionSegment::fillin(), CollisionRay::fillin(), CollisionFloorMesh::fillin(), CollisionDSSolid::fillin(), CollisionBox::fillin(), and AnimChannelMatrixFixed::fillin().
LPoint3f LPoint3f::rfu | ( | float | right, |
float | fwd, | ||
float | 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 430 of file lpoint3.h.
Referenced by WindowFramework::load_default_model().
int LVecBase3f::size | ( | ) | [inline, static, inherited] |
Returns 3: the number of components of a LVecBase3.
Definition at line 435 of file lvecBase3.h.
Referenced by CollisionPolygon::fillin(), and CollisionPolygon::xform().
const LPoint3f & LPoint3f::unit_x | ( | ) | [inline, static] |
const LPoint3f & LPoint3f::unit_y | ( | ) | [inline, static] |
const LPoint3f & LPoint3f::unit_z | ( | ) | [inline, static] |
void LVecBase3f::write_datagram | ( | Datagram & | destination | ) | const [inline, inherited] |
Function to write itself into a datagram.
Definition at line 1181 of file lvecBase3.h.
Referenced by TransformState::write_datagram(), Fog::write_datagram(), BillboardEffect::write_datagram(), CollisionTube::write_datagram(), CollisionSphere::write_datagram(), CollisionSolid::write_datagram(), CollisionSegment::write_datagram(), CollisionRay::write_datagram(), CollisionDSSolid::write_datagram(), CollisionBox::write_datagram(), and AnimChannelMatrixFixed::write_datagram().
const LPoint3f & LPoint3f::zero | ( | ) | [inline, static] |
Returns a zero-length point.
Reimplemented from LVecBase3f.
Definition at line 240 of file lpoint3.h.
Referenced by Character::clear_lod_animation(), CollisionEntry::get_all(), CollisionEntry::get_all_contact_info(), PhysxActor::get_c_mass_global_pos(), PhysxActor::get_c_mass_local_pos(), TexGenAttrib::get_constant_value(), OdeCollisionEntry::get_contact_point(), CollisionEntry::get_contact_pos(), PhysxJoint::get_global_anchor(), PhysxActor::get_global_pos(), PhysxShape::get_local_pos(), LwoPoints::get_point(), ScissorEffect::get_point(), BoundingHexahedron::get_point(), BoundingBox::get_point(), CollisionPolygon::get_point(), CollisionBox::get_point(), CollisionBox::get_point_aabb(), PhysxForceFieldShape::get_pos(), PhysxController::get_pos(), NurbsCurveResult::get_sample_point(), CollisionEntry::get_surface_point(), PortalNode::get_vertex(), LineSegs::get_vertex(), PhysxCloth::get_vertex_attachment_pos(), and CLwoLayer::make_egg().