panda3d.egg.EggTransform

from panda3d.egg import EggTransform

class EggTransform

This represents the <Transform> entry of a group or texture node: a list of component transform operations, applied in order, that describe a net transform matrix.

This may be either a 3-d transform, and therefore described by a 4x4 matrix, or a 2-d transform, described by a 3x3 matrix.

Inheritance diagram

__init__() → None

__init__(copy: EggTransform) → None

assign(copy: EggTransform) → EggTransform

Return type

EggTransform

clearTransform() → None

Resets the transform to empty, identity.

addTranslate2d(translate: LVector2d) → None

Appends a 2-d translation operation to the current transform.

addTranslate3d(translate: LVector3d) → None

Appends a 3-d translation operation to the current transform.

addRotate2d(angle: float) → None

Appends a 2-d rotation to the current transform. The rotation angle is specified in degrees counterclockwise about the origin.

addRotx(angle: float) → None

Appends a rotation about the X axis to the current transform. The rotation angle is specified in degrees counterclockwise about the axis.

addRoty(angle: float) → None

Appends a rotation about the Y axis to the current transform. The rotation angle is specified in degrees counterclockwise about the axis.

addRotz(angle: float) → None

Appends a rotation about the Z axis to the current transform. The rotation angle is specified in degrees counterclockwise about the axis.

addRotate3d(quat: LQuaterniond) → None

Appends an arbitrary 3-d rotation to the current transform, expressed as a quaternion. This is converted to axis-angle notation for the egg file.

addRotate3d(angle: float, axis: LVector3d) → None

Appends a 3-d rotation about an arbitrary axis to the current transform. The rotation angle is specified in degrees counterclockwise about the axis.

addScale2d(scale: LVecBase2d) → None

Appends a possibly non-uniform scale to the current transform.

addScale3d(scale: LVecBase3d) → None

Appends a possibly non-uniform scale to the current transform.

addUniformScale(scale: float) → None

Appends a uniform scale to the current transform.

addMatrix3(mat: LMatrix3d) → None

Appends an arbitrary 3x3 matrix to the current transform.

addMatrix4(mat: LMatrix4d) → None

Appends an arbitrary 4x4 matrix to the current transform.

hasTransform() → bool

Returns true if the transform is nonempty, false if it is empty (no transform components have been added). This is true for either a 2-d or a 3-d transform.

hasTransform2d() → bool

Returns true if the transform is specified as a 2-d transform, e.g. with a 3x3 matrix, or false if it is specified as a 3-d transform (with a 4x4 matrix), or not specified at all.

Normally, EggTextures have a 2-d matrix (but occasionally they use a 3-d matrix), and EggGroups always have a 3-d matrix.

setTransform2d(mat: LMatrix3d) → None

Sets the overall transform as a 3x3 matrix. This completely replaces whatever componentwise transform may have been defined.

hasTransform3d() → bool

Returns true if the transform is specified as a 3-d transform, e.g. with a 4x4 matrix, or false if it is specified as a 2-d transform (with a 2x2 matrix), or not specified at all.

Normally, EggTextures have a 3-d matrix (but occasionally they use a 3-d matrix), and EggGroups always have a 3-d matrix.

setTransform3d(mat: LMatrix4d) → None

Sets the overall transform as a 4x4 matrix. This completely replaces whatever componentwise transform may have been defined.

getTransform2d() → LMatrix3d

Returns the overall transform as a 3x3 matrix. It is an error to call this if hasTransform3d() is true.

Return type

LMatrix3d

getTransform3d() → LMatrix4d

Returns the overall transform as a 4x4 matrix. It is valid to call this even if hasTransform2d() is true; in this case, the 3x3 transform will be expanded to a 4x4 matrix.

Return type

LMatrix4d

transformIsIdentity() → bool

Returns true if the described transform is identity, false otherwise.

getNumComponents() → int

Returns the number of components that make up the transform.

getComponentType(n: int) → ComponentType

Returns the type of the nth component.

Return type

ComponentType

getComponentNumber(n: int) → float

Returns the solitary number associated with the nth component. In the case of a rotation, this is the angle in degrees to rotate; in the case of uniform scale, this is the amount of the scale. Other types do not use this property.

getComponentVec2(n: int) → LVecBase2d

Returns the 2-component vector associated with the nth component. This may be the translate vector, rotate axis, or non-uniform scale. It is an error to call this if the component type does not use a 2-d vector property.

Return type

LVecBase2d

getComponentVec3(n: int) → LVecBase3d

Returns the 3-component vector associated with the nth component. This may be the translate vector, rotate axis, or non-uniform scale. It is an error to call this if the component type does not use a 3-d vector property.

Return type

LVecBase3d

getComponentMat3(n: int) → LMatrix3d

Returns the 3x3 matrix associated with the nth component. It is an error to call this if the component type is not CT_matrix3.

Return type

LMatrix3d

getComponentMat4(n: int) → LMatrix4d

Returns the 4x4 matrix associated with the nth component. It is an error to call this if the component type is not CT_matrix4.

Return type

LMatrix4d

write(out: ostream, indent_level: int, label: str) → None

Writes the transform to the indicated stream in Egg format.

enum ComponentType

enumerator CT_invalid = 0

enumerator CT_translate2d = 1

enumerator CT_translate3d = 2

enumerator CT_rotate2d = 3

enumerator CT_rotx = 4

enumerator CT_roty = 5

enumerator CT_rotz = 6

enumerator CT_rotate3d = 7

enumerator CT_scale2d = 8

enumerator CT_scale3d = 9

enumerator CT_uniform_scale = 10

enumerator CT_matrix3 = 11

enumerator CT_matrix4 = 12