Optional x: number | number[]The x value. Defaults to 0. If x is an array of length 3, the array will be used to populate all components.
Optional y: numberThe y value. Defaults to 0.
Optional z: numberThe z value. Defaults to 0.
Private _rotationPrivate _shaderThe first component of the vector.
The second component of the vector.
The third component of the vector.
Static Readonly BACKA constant vector set to [0, 0, 1].
Static Readonly DOWNA constant vector set to [0, -1, 0].
Static Readonly FORWARDA constant vector set to [0, 0, -1].
Static Readonly LEFTA constant vector set to [-1, 0, 0].
Static Readonly ONEA constant vector set to [1, 1, 1].
Static Readonly RIGHTA constant vector set to [1, 0, 0].
Static Readonly UPA constant vector set to [0, 1, 0].
Static Readonly ZEROA constant vector set to [0, 0, 0].
获得此3维向量的朝向rotation
用于传入shader的数据
Adds a 3-dimensional vector to another in place.
Self for chaining.
var a = new pc.Vec3(10, 10, 10);
var b = new pc.Vec3(20, 20, 20);
a.add(b);
// Outputs [30, 30, 30]
console.log("The result of the addition is: " + a.toString());
The vector to add to the specified vector.
Adds two 3-dimensional vectors together and returns the result.
Self for chaining.
var a = new pc.Vec3(10, 10, 10);
var b = new pc.Vec3(20, 20, 20);
var r = new pc.Vec3();
r.add2(a, b);
// Outputs [30, 30, 30]
console.log("The result of the addition is: " + r.toString());
The first vector operand for the addition.
The second vector operand for the addition.
Copies the contents of a source 3-dimensional vector to a destination 3-dimensional vector.
Self for chaining.
var src = new pc.Vec3(10, 20, 30);
var dst = new pc.Vec3();
dst.copy(src);
console.log("The two vectors are " + (dst.equals(src) ? "equal" : "different"));
A vector to copy to the specified vector.
Returns the result of a cross product operation performed on the two specified 3-dimensional vectors.
Self for chaining.
var back = new pc.Vec3().cross(pc.Vec3.RIGHT, pc.Vec3.UP);
// Prints the Z axis (i.e. [0, 0, 1])
console.log("The result of the cross product is: " + back.toString());
The first 3-dimensional vector operand of the cross product.
The second 3-dimensional vector operand of the cross product.
Returns the distance between the two specified 3-dimensional vectors.
The distance between the two vectors.
var v1 = new pc.Vec3(5, 10, 20);
var v2 = new pc.Vec3(10, 20, 40);
var d = v1.distance(v2);
console.log("The distance between v1 and v2 is: " + d);
The second 3-dimensional vector to test.
Divides a 3-dimensional vector by another in place.
Self for chaining.
var a = new pc.Vec3(4, 9, 16);
var b = new pc.Vec3(2, 3, 4);
a.div(b);
// Outputs [2, 3, 4]
console.log("The result of the division is: " + a.toString());
The vector to divide the specified vector by.
Divides one 3-dimensional vector by another and writes the result to the specified vector.
Self for chaining.
var a = new pc.Vec3(4, 9, 16);
var b = new pc.Vec3(2, 3, 4);
var r = new pc.Vec3();
r.div2(a, b);
// Outputs [2, 3, 4]
console.log("The result of the division is: " + r.toString());
The dividend vector (the vector being divided).
The divisor vector (the vector dividing the dividend).
Divides each element of a vector by a number.
Self for chaining.
var vec = new pc.Vec3(3, 6, 9);
vec.divScalar(3);
// Outputs [1, 2, 3]
console.log("The result of the division is: " + vec.toString());
The number to divide by.
Returns the result of a dot product operation performed on the two specified 3-dimensional vectors.
The result of the dot product operation.
var v1 = new pc.Vec3(5, 10, 20);
var v2 = new pc.Vec3(10, 20, 40);
var v1dotv2 = v1.dot(v2);
console.log("The result of the dot product is: " + v1dotv2);
The second 3-dimensional vector operand of the dot product.
Reports whether two vectors are equal.
True if the vectors are equal and false otherwise.
var a = new pc.Vec3(1, 2, 3);
var b = new pc.Vec3(4, 5, 6);
console.log("The two vectors are " + (a.equals(b) ? "equal" : "different"));
The vector to compare to the specified vector.
Returns the result of a linear interpolation between two specified 3-dimensional vectors.
Self for chaining.
var a = new pc.Vec3(0, 0, 0);
var b = new pc.Vec3(10, 10, 10);
var r = new pc.Vec3();
r.lerp(a, b, 0); // r is equal to a
r.lerp(a, b, 0.5); // r is 5, 5, 5
r.lerp(a, b, 1); // r is equal to b
The 3-dimensional to interpolate from.
The 3-dimensional to interpolate to.
The value controlling the point of interpolation. Between 0 and 1, the linear interpolant will occur on a straight line between lhs and rhs. Outside of this range, the linear interpolant will occur on a ray extrapolated from this line.
Multiplies a 3-dimensional vector to another in place.
Self for chaining.
var a = new pc.Vec3(2, 3, 4);
var b = new pc.Vec3(4, 5, 6);
a.mul(b);
// Outputs 8, 15, 24
console.log("The result of the multiplication is: " + a.toString());
The 3-dimensional vector used as the second multiplicand of the operation.
Returns the result of multiplying the specified 3-dimensional vectors together.
Self for chaining.
var a = new pc.Vec3(2, 3, 4);
var b = new pc.Vec3(4, 5, 6);
var r = new pc.Vec3();
r.mul2(a, b);
// Outputs 8, 15, 24
console.log("The result of the multiplication is: " + r.toString());
The 3-dimensional vector used as the first multiplicand of the operation.
The 3-dimensional vector used as the second multiplicand of the operation.
Multiplies each element of a vector by a number.
Self for chaining.
var vec = new pc.Vec3(3, 6, 9);
vec.mulScalar(3);
// Outputs [9, 18, 27]
console.log("The result of the multiplication is: " + vec.toString());
The number to multiply by.
Returns this 3-dimensional vector converted to a unit vector in place. If the vector has a length of zero, the vector's elements will be set to zero.
Self for chaining.
var v = new pc.Vec3(25, 0, 0);
v.normalize();
// Outputs 1, 0, 0
console.log("The result of the vector normalization is: " + v.toString());
Projects this 3-dimensional vector onto the specified vector.
Self for chaining.
var v = new pc.Vec3(5, 5, 5);
var normal = new pc.Vec3(1, 0, 0);
v.project(normal);
// Outputs 5, 0, 0
console.log("The result of the vector projection is: " + v.toString());
The vector onto which the original vector will be projected on.
Sets the specified 3-dimensional vector to the supplied numerical values.
Self for chaining.
var v = new pc.Vec3();
v.set(5, 10, 20);
// Outputs 5, 10, 20
console.log("The result of the vector set is: " + v.toString());
The value to set on the first component of the vector.
The value to set on the second component of the vector.
The value to set on the third component of the vector.
Subtracts a 3-dimensional vector from another in place.
Self for chaining.
var a = new pc.Vec3(10, 10, 10);
var b = new pc.Vec3(20, 20, 20);
a.sub(b);
// Outputs [-10, -10, -10]
console.log("The result of the subtraction is: " + a.toString());
The vector to add to the specified vector.
Subtracts two 3-dimensional vectors from one another and returns the result.
Self for chaining.
var a = new pc.Vec3(10, 10, 10);
var b = new pc.Vec3(20, 20, 20);
var r = new pc.Vec3();
r.sub2(a, b);
// Outputs [-10, -10, -10]
console.log("The result of the subtraction is: " + r.toString());
The first vector operand for the addition.
The second vector operand for the addition.
Subtracts a number from each element of a vector.
Self for chaining.
var vec = new pc.Vec3(3, 4, 5);
vec.subScalar(2);
// Outputs [1, 2, 3]
console.log("The result of the subtraction is: " + vec.toString());
The number to subtract.
Creates a new Vec3 object.
Example