# panda3d.core.LVecBase3d¶

from panda3d.core import LVecBase3d

class LVecBase3d

This is the base class for all three-component vectors and points.

Inheritance diagram

__init__() → None
__init__(copy: LVecBase2d, z: float) → None
__init__(param0: LVecBase3d) → None
__init__(fill_value: float) → None
__init__(x: float, y: float, z: float) → None
addHash(hash: size_t) → size_t

Adds the vector into the running hash.

Return type

size_t

addHash(hash: size_t, threshold: float) → size_t

Adds the vector into the running hash.

Return type

size_t

addToCell(i: int, value: float) → None

These next functions add to an existing value. i.e. foo.:meth:~LVecBase3d.setX(foo.get_x() + value) These are useful to reduce overhead in scripting languages:

addX(value: float) → None
addY(value: float) → None
addZ(value: float) → None
almostEqual(other: LVecBase3d) → bool

Returns true if two vectors are memberwise equal within a default tolerance based on the numeric type.

almostEqual(other: LVecBase3d, threshold: float) → bool

Returns true if two vectors are memberwise equal within a specified tolerance.

assign(copy: LVecBase3d) → LVecBase3d
Return type

LVecBase3d

assign(fill_value: float) → LVecBase3d
Return type

LVecBase3d

compareTo(other: LVecBase3d) → int

This flavor of compareTo() uses a default threshold value based on the numeric type.

compareTo(other: LVecBase3d, threshold: float) → int

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).

componentwiseMult(other: LVecBase3d) → None
cross(other: LVecBase3d) → LVecBase3d
Return type

LVecBase3d

crossInto(other: LVecBase3d) → None
dot(other: LVecBase3d) → float
fill(fill_value: float) → None

Sets each element of the vector to the indicated fill_value. This is particularly useful for initializing to zero.

fmax(other: LVecBase3d) → LVecBase3d
Return type

LVecBase3d

fmin(other: LVecBase3d) → LVecBase3d
Return type

LVecBase3d

generateHash(hashgen: ChecksumHashGenerator) → None

Adds the vector to the indicated hash generator.

generateHash(hashgen: ChecksumHashGenerator, threshold: float) → None

Adds the vector to the indicated hash generator.

getCell(i: int) → float
static getClassType() → TypeHandle
Return type

TypeHandle

getData() → None

Returns the address of the first of the three data elements in the vector. The remaining elements occupy the next positions consecutively in memory.

getHash() → size_t

Returns a suitable hash for phash_map.

Return type

size_t

getHash(threshold: float) → size_t

Returns a suitable hash for phash_map.

Return type

size_t

static getNumComponents() → int
getStandardizedHpr() → LVecBase3d

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.isSameDirection() for that. See Also: get_standardized_rotation, LQuaternion::is_same_direction

Return type

LVecBase3d

getX() → float
getXy() → LVecBase2d

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

Return type

LVecBase2d

getXz() → LVecBase2d

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

Return type

LVecBase2d

getY() → float
getYz() → LVecBase2d

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

Return type

LVecBase2d

getZ() → float
isNan() → bool

Returns true if any component of the vector is not-a-number, false otherwise.

length() → float

Returns the length of the vector, by the Pythagorean theorem.

lengthSquared() → float

Returns the square of the vector’s length, cheap and easy.

normalize() → bool

Normalizes the vector in place. Returns true if the vector was normalized, false if it was a zero-length vector.

normalized() → LVecBase3d

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.

Return type

LVecBase3d

operatorNew(size: size_t) → None
output(out: ostream) → None
project(onto: LVecBase3d) → LVecBase3d

Returns a new vector representing the projection of this vector onto another one. The resulting vector will be a scalar multiple of onto.

Return type

LVecBase3d

readDatagram(source: DatagramIterator) → None

Reads the vector from the Datagram using get_stdfloat().

readDatagramFixed(source: DatagramIterator) → None

Reads the vector from the Datagram using get_float32() or get_float64(). See writeDatagramFixed().

set(x: float, y: float, z: float) → None
setCell(i: int, value: float) → None
setX(value: float) → None
setY(value: float) → None
setZ(value: float) → None
static size() → int
static unitX() → LVecBase3d

Returns a unit X vector.

Return type

LVecBase3d

static unitY() → LVecBase3d

Returns a unit Y vector.

Return type

LVecBase3d

static unitZ() → LVecBase3d

Returns a unit Z vector.

Return type

LVecBase3d

writeDatagram(destination: Datagram) → None

Writes the vector to the Datagram using add_stdfloat(). This is appropriate when you want to write the vector using the standard width setting, especially when you are writing a bam file.

writeDatagramFixed(destination: Datagram) → None

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.setStdfloatDouble(). This is appropriate when you want to write a fixed-width value to the datagram, especially when you are not writing a bam file.

property x

Getter Setter

Return type

float

property xy

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

Return type

LVecBase2d

property xz

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

Return type

LVecBase2d

property y

Getter Setter

Return type

float

property yz

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

Return type

LVecBase2d

property z

Getter Setter

Return type

float

static zero() → LVecBase3d

Returns a zero-length vector.

Return type

LVecBase3d