rhodonite
    Preparing search index...

    Class AnimatedVector4

    An animated 4D vector that interpolates between keyframe values over time. This class extends Vector4 and provides animation capabilities by sampling from animation tracks and optionally blending between two tracks.

    const samplers = new Map();
    const animatedVector = new AnimatedVector4(samplers, 'track1');
    animatedVector.setTime(2.5);
    console.log(animatedVector.x, animatedVector.y, animatedVector.z, animatedVector.w);

    Hierarchy (View Summary)

    Implements

    Index

    Constructors

    constructor

    Properties

    _v isLoop

    Accessors

    blendingRatio bytesPerComponent className glslStrAsFloat glslStrAsInt glslStrAsUint w wgslStrAsFloat wgslStrAsInt wgslStrAsUint x y z compositionType

    Methods

    at clone deleteAnimationSampler dot flattenAsArray getAllTrackNames getAnimationSampler getFirstActiveAnimationTrackName getMaxEndInputTime getMinStartInputTime getNumberArray getSecondActiveAnimationTrackName isDummy isEqual isStrictEqual isTheSourceSame length lengthSquared lengthTo setAnimationSampler setFirstActiveAnimationTrackName setFloat32Array setSecondActiveAnimationTrackName setTime toString toStringApproximately useGlobalTime v _add _divide _divideVector _dummy _fromCopy4 _fromCopyArray _fromCopyArray4 _fromCopyVector3 _fromCopyVector4 _fromVector2 _multiply _multiplyVector _normalize _one _subtract _zero add addTo divide divideTo divideVector divideVectorTo dot dummy fromArrayBuffer fromCopy4 fromCopyArray fromCopyArray4 fromCopyFloat32Array fromCopyVector3 fromCopyVector4 fromFloat32Array lengthBtw lengthSquared multiply multiplyTo multiplyVector multiplyVectorTo normalize one subtract subtractTo zero

    Constructors

    Properties

    _v

    _v: TypedArray = ...

    Internal typed array storage for vector components

    isLoop: boolean = true

    Whether the animation should loop when it reaches the end.

    Accessors

    • get blendingRatio(): number

      Gets the current blending ratio between animation tracks.

      Returns number

      The current blending ratio

    • set blendingRatio(value: number): void

      Sets the blending ratio between the first and second animation tracks. A value of 0 means only the first track is used, 1 means only the second track, and values in between create a linear blend.

      Parameters

      • value: number

        The blending ratio (typically between 0 and 1)

      Returns void

    • get bytesPerComponent(): number

      Gets the number of bytes per component in the underlying typed array.

      Returns number

      The number of bytes per element (4 for Float32Array, 8 for Float64Array)

    • get glslStrAsFloat(): string

      Converts the vector to a GLSL vec4 string representation with float precision.

      Returns string

      A GLSL-compatible vec4 string (e.g., "vec4(1.0, 2.0, 3.0, 4.0)")

    • get glslStrAsInt(): string

      Converts the vector to a GLSL ivec4 string representation with integer values.

      Returns string

      A GLSL-compatible ivec4 string (e.g., "ivec4(1, 2, 3, 4)")

    • get glslStrAsUint(): string

      Converts the vector to a GLSL uvec4 string representation with unsigned integer values.

      Returns string

      A GLSL-compatible uvec4 string (e.g., "uvec4(1u, 2u, 3u, 4u)")

    • get wgslStrAsFloat(): string

      Converts the vector to a WGSL vec4f string representation with float precision.

      Returns string

      A WGSL-compatible vec4f string (e.g., "vec4f(1.0, 2.0, 3.0, 4.0)")

    • get wgslStrAsInt(): string

      Converts the vector to a WGSL vec4i string representation with integer values.

      Returns string

      A WGSL-compatible vec4i string (e.g., "vec4i(1, 2, 3, 4)")

    • get wgslStrAsUint(): string

      Converts the vector to a WGSL vec4u string representation with unsigned integer values.

      Returns string

      A WGSL-compatible vec4u string (e.g., "vec4u(1u, 2u, 3u, 4u)")

    • get compositionType(): CompositionTypeClass<"VEC4">

      Gets the composition type identifier for this vector type.

      Returns CompositionTypeClass<"VEC4">

      The CompositionType.Vec4 identifier

    Methods

    • Gets the component value at the specified index.

      Parameters

      • i: number

        The index (0=x, 1=y, 2=z, 3=w)

      Returns number

      The component value at the specified index

    • Removes an animation sampler for the specified track.

      Parameters

      • trackName: string

        The name of the animation track to remove

      Returns void

    • Calculates the dot product between this vector and another vector. The dot product is the sum of the products of corresponding components.

      Parameters

      • vec: IVector4

        The vector to calculate dot product with

      Returns number

      The dot product of the two vectors

    • Gets an array of all available animation track names.

      Returns string[]

      An array containing all animation track names

    • Gets the animation sampler for the specified track.

      Parameters

      • trackName: string

        The name of the animation track

      Returns AnimationSampler

      The animation sampler for the specified track

      When the specified animation track is not found

    • Gets the name of the first (primary) active animation track.

      Returns string

      The name of the first active animation track

    • Gets the maximum end time of the specified animation track.

      Parameters

      • trackName: string

        The name of the animation track

      Returns number

      The maximum end time of the track

      When the specified animation track is not found

    • Gets the minimum start time of the specified animation track.

      Parameters

      • trackName: string

        The name of the animation track

      Returns number

      The minimum start time of the track

      When the specified animation track is not found

    • Returns the vector components as a regular JavaScript array.

      Returns number[]

      An array containing the x, y, z, and w components

    • Gets the name of the second (secondary) active animation track.

      Returns string | undefined

      The name of the second active animation track, or undefined if not set

    • Checks if this vector is approximately equal to another vector within a specified tolerance.

      Parameters

      • vec: IVector4

        The vector to compare with

      • delta: number = Number.EPSILON

        The tolerance value for comparison (default: Number.EPSILON)

      Returns boolean

      True if the vectors are approximately equal, false otherwise

    • Checks if the internal storage shares the same ArrayBuffer as the provided one. Useful for determining if vectors share underlying memory.

      Parameters

      • arrayBuffer: ArrayBuffer

        The ArrayBuffer to compare against

      Returns boolean

      True if the same ArrayBuffer is used, false otherwise

    • Sets or adds an animation sampler for the specified track.

      Parameters

      • animationTrackName: string

        The name of the animation track

      • animationSampler: AnimationSampler

        The animation sampler to set for this track

      Returns void

    • Sets the first (primary) active animation track.

      Parameters

      • animationTrackName: string

        The name of the animation track to set as primary

      Returns void

    • Sets the internal Float32Array data and triggers an update.

      Parameters

      • array: Float32Array

        The Float32Array to set as the internal data

      Returns void

    • Sets the second (secondary) active animation track for blending.

      Parameters

      • animationTrackName: string

        The name of the animation track to set as secondary

      Returns void

    • Sets the animation time for this vector. When set, this overrides the global time.

      Parameters

      • time: number

        The time value in seconds

      Returns void

    • Switches back to using the global animation time instead of a custom time. This removes any previously set custom time.

      Returns void

    • Gets the component value at the specified index. Alias for the at() method for convenience.

      Parameters

      • i: number

        The index of the component to retrieve

      Returns number

      The component value at the given index

    Static_add

    Static_divide

    Static_divideVector

    Static_dummy

    Static_fromCopy4

    Static_fromCopyArray

    Static_fromCopyArray4

    Static_fromCopyVector3

    Static_fromCopyVector4

    Static_fromVector2

    Static_multiply

    Static_multiplyVector

    Static_normalize

    Static_one

    Static_subtract

    Static_zero

    • Divides a vector by a scalar value and returns a new vector. If the divisor is zero, the result components will be set to Infinity and an error will be logged.

      Parameters

      • vec: IVector4

        The vector to divide

      • value: number

        The scalar value to divide by

      Returns Vector4

      A new Vector4 with each component divided by the scalar

    • Divides a vector by a scalar value and stores the result in the output vector. If the divisor is zero, the result components will be set to Infinity and an error will be logged. This method modifies the output vector in-place for better performance.

      Parameters

      • vec: IVector4

        The vector to divide

      • value: number

        The scalar value to divide by

      • out: IMutableVector4

        The output vector to store the result (will be modified)

      Returns IMutableVector4

      The modified output vector with each component divided by the scalar

    • Divides the left vector by the right vector component-wise and returns a new vector. If any component of the right vector is zero, the corresponding result component will be set to Infinity.

      Parameters

      • l_vec: IVector4

        The left operand vector (dividend)

      • r_vec: IVector4

        The right operand vector (divisor)

      Returns Vector4

      A new Vector4 with component-wise division result

    • Divides the left vector by the right vector component-wise and stores the result in the output vector. If any component of the right vector is zero, the corresponding result component will be set to Infinity. This method modifies the output vector in-place for better performance.

      Parameters

      • l_vec: IVector4

        The left operand vector (dividend)

      • r_vec: IVector4

        The right operand vector (divisor)

      • out: IMutableVector4

        The output vector to store the result (will be modified)

      Returns IMutableVector4

      The modified output vector with component-wise division result

    • Calculates the dot product of two vectors. The dot product is the sum of the products of corresponding components.

      Parameters

      Returns number

      The dot product of the two vectors

    • Creates a dummy vector with no components (empty array). This is used as a placeholder when a vector is needed but not yet initialized.

      Returns Vector4

      A new dummy Vector4 with empty components

    • Creates a new Vector4 from an ArrayBuffer. The ArrayBuffer should contain at least 16 bytes (4 float32 values).

      Parameters

      • arrayBuffer: ArrayBuffer

        The ArrayBuffer containing vector data

      Returns Vector4

      A new Vector4 instance using the ArrayBuffer data

    • Creates a new Vector4 from individual component values.

      Parameters

      • x: number

        The X component value

      • y: number

        The Y component value

      • z: number

        The Z component value

      • w: number

        The W component value

      Returns Vector4

      A new Vector4 instance with the specified component values

    • Creates a new Vector4 by copying values from an array. Takes the first 4 elements from the array. If the array has fewer than 4 elements, the remaining components will be undefined.

      Parameters

      • array: number[]

        Array containing numeric values (at least 4 elements recommended)

      Returns Vector4

      A new Vector4 instance with copied values

    • Creates a new Vector4 by copying from a Float32Array. This creates a new Float32Array copy of the input data.

      Parameters

      • float32Array: Float32Array

        The Float32Array to copy from

      Returns Vector4

      A new Vector4 instance with copied Float32Array data

    • Creates a new Vector4 from a Float32Array. The Float32Array is used directly without copying.

      Parameters

      • float32Array: Float32Array

        The Float32Array containing vector components

      Returns Vector4

      A new Vector4 instance using the provided Float32Array

    • Calculates the squared length (magnitude) of a vector. This is more efficient than length() when only comparing magnitudes.

      Parameters

      • vec: IVector4

        The vector to calculate squared length for

      Returns number

      The squared length of the vector

    • Multiplies a vector by a scalar value and returns a new vector. This operation scales the vector while preserving its direction.

      Parameters

      • vec: IVector4

        The vector to multiply

      • value: number

        The scalar value to multiply by

      Returns Vector4

      A new Vector4 with each component multiplied by the scalar

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Accessors
    Methods
    atclonedeleteAnimationSamplerdotflattenAsArraygetAllTrackNamesgetAnimationSamplergetFirstActiveAnimationTrackNamegetMaxEndInputTimegetMinStartInputTimegetNumberArraygetSecondActiveAnimationTrackNameisDummyisEqualisStrictEqualisTheSourceSamelengthlengthSquaredlengthTosetAnimationSamplersetFirstActiveAnimationTrackNamesetFloat32ArraysetSecondActiveAnimationTrackNamesetTimetoStringtoStringApproximatelyuseGlobalTimev_add_divide_divideVector_dummy_fromCopy4_fromCopyArray_fromCopyArray4_fromCopyVector3_fromCopyVector4_fromVector2_multiply_multiplyVector_normalize_one_subtract_zeroaddaddTodividedivideTodivideVectordivideVectorTodotdummyfromArrayBufferfromCopy4fromCopyArrayfromCopyArray4fromCopyFloat32ArrayfromCopyVector3fromCopyVector4fromFloat32ArraylengthBtwlengthSquaredmultiplymultiplyTomultiplyVectormultiplyVectorTonormalizeonesubtractsubtractTozero