Transform

Enumerations: com.aspose.threed (aspose-3d-foss)

Transform controlla la posizione, l’orientamento e la scala di un Node nella scena 3D. Ogni nodo ha esattamente uno Transform, accessibile tramite node.getTransform().

public class Transform extends A3DObject

Accesso al Transform di un Node

import com.aspose.threed.Scene;

Scene scene = new Scene();
Node node = scene.getRootNode().createChildNode("box");
Transform t = node.getTransform();

Enumerations

Name	Type	Access	Description
`translation`	`Vector3`	Read	Gets the translation.
`scaling`	`Vector3`	Read	Gets the scaling.
`eulerAngles`	`Vector3`	Read	Gets the euler angles.
`rotation`	`Quaternion`	Read	Gets the rotation.
`preRotation`	`Vector3`	Read	Gets the pre rotation.
`postRotation`	`Vector3`	Read	Gets the post rotation.
`geometricTranslation`	`Vector3`	Read	Gets the geometric translation.
`geometricScaling`	`Vector3`	Read	Gets the geometric scaling.
`geometricRotation`	`Vector3`	Read	Gets the geometric rotation.
`scalingOffset`	`Vector3`	Read	Gets the scaling offset.
`scalingPivot`	`Vector3`	Read	Gets the scaling pivot.
`rotationOffset`	`Vector3`	Read	Gets the rotation offset.
`rotationPivot`	`Vector3`	Read	Gets the rotation pivot.
`transformMatrix`	`Matrix4`	Read	Gets the transform matrix.
`name`	`String`	Read	Gets the name.
`properties`	`PropertyCollection`	Read	Gets the properties.

Metodi setter fluent

Tutti i setter restituiscono this, consentendo il chaining:

Signature	Description
`Transform()`	Calls Transform on this Transform instance.
`Transform(name: String)`	Calls Transform(name) on this Transform instance.
`getTranslation()` → `Vector3`	Returns the translation.
`setTranslation(value: Vector3)`	Sets the translation value.
`setTranslation(x: double, y: double, z: double)` → `Transform`	Sets the translation value.
`getScaling()` → `Vector3`	Returns the scaling.
`setScaling(value: Vector3)`	Sets the scaling value.
`setScale(x: double, y: double, z: double)` → `Transform`	Sets the scale value.
`getEulerAngles()` → `Vector3`	Returns the euler angles.
`setEulerAngles(value: Vector3)`	Sets the euler angles value.
`setEulerAngles(x: double, y: double, z: double)` → `Transform`	Sets the euler angles value.
`getRotation()` → `Quaternion`	Returns the rotation.
`setRotation(value: Quaternion)`	Sets the rotation value.
`setRotation(x: double, y: double, z: double, w: double)` → `Transform`	Sets the rotation value.
`setPreRotation(x: double, y: double, z: double)` → `Transform`	Sets the pre rotation value.
`getPreRotation()` → `Vector3`	Returns the pre rotation.
`setPreRotation(value: Vector3)`	Sets the pre rotation value.
`setPostRotation(x: double, y: double, z: double)` → `Transform`	Sets the post rotation value.
`getPostRotation()` → `Vector3`	Returns the post rotation.
`setPostRotation(value: Vector3)`	Sets the post rotation value.
`getGeometricTranslation()` → `Vector3`	Returns the geometric translation.
`setGeometricTranslation(value: Vector3)`	Sets the geometric translation value.
`setGeometricTranslation(x: double, y: double, z: double)` → `Transform`	Sets the geometric translation value.
`getGeometricScaling()` → `Vector3`	Returns the geometric scaling.
`setGeometricScaling(value: Vector3)`	Sets the geometric scaling value.
`setGeometricScaling(x: double, y: double, z: double)` → `Transform`	Sets the geometric scaling value.
`getGeometricRotation()` → `Vector3`	Returns the geometric rotation.
`setGeometricRotation(value: Vector3)`	Sets the geometric rotation value.
`setGeometricRotation(x: double, y: double, z: double)` → `Transform`	Sets the geometric rotation value.
`getScalingOffset()` → `Vector3`	Returns the scaling offset.
`setScalingOffset(value: Vector3)`	Sets the scaling offset value.
`getScalingPivot()` → `Vector3`	Returns the scaling pivot.
`setScalingPivot(value: Vector3)`	Sets the scaling pivot value.
`getRotationOffset()` → `Vector3`	Returns the rotation offset.
`setRotationOffset(value: Vector3)`	Sets the rotation offset value.
`getRotationPivot()` → `Vector3`	Returns the rotation pivot.
`setRotationPivot(value: Vector3)`	Sets the rotation pivot value.
`getTransformMatrix()` → `Matrix4`	Returns the transform matrix.
`setTransformMatrix(value: Matrix4)`	Sets the transform matrix value.
`A3DObject()`	Parameterized Cylinder. It can also be used to represent a cone when one of radiusTop/radiusBottom is zero.
`getName()` → `String`	The segments of the curve.
`setName(name: String)`	Constructs a CircleShape profile with specified radius.
`getProperties()` → `PropertyCollection`	Initializes a new instance of Cylinder class.
`findProperty(name: String)` → `Property`	Initializes a new instance of the Bone class.
`getProperty(name: String)` → `Object`	Gets the transform matrix of the node in current pose.
`setProperty(name: String, value: Object)`	Gets the width segments.
`removeProperty(name: String)` → `boolean`	Gets flip coordinate system of control points/normal during importing/exporting.

Esempi di utilizzo

Posizionare un Node

import com.aspose.threed.Scene;
import com.aspose.threed.*;

Scene scene = new Scene();
Node node = scene.getRootNode().createChildNode("box");

// Using fluent setters
node.getTransform().setTranslation(5.0, 0.0, -3.0);

// Or via property setter
node.getTransform().setTranslation(new Vector3(5.0, 0.0, -3.0));

Ruotare con angoli di Eulero

Scene scene = new Scene(); Node node = scene.getRootNode().createChildNode(“rotated”);

// Rotate 45 degrees around Y axis node.getTransform().setEulerAngles(0.0, 45.0, 0.0);

// Chain multiple operations node.getTransform() .setTranslation(2.0, 0.0, 0.0) .setScale(2.0, 2.0, 2.0);


### Ruotare con un Quaternion

```java
import com.aspose.threed.Scene;
import com.aspose.threed.*;
import com.aspose.threed.*;

Scene scene = new Scene();
Node node = scene.getRootNode().createChildNode("q-rotated");

// 90 degrees rotation around the Y axis
double halfAngle = Math.toRadians(45);   // half the total rotation
Quaternion q = new Quaternion(Math.cos(halfAngle), 0.0, Math.sin(halfAngle), 0.0);
node.getTransform().setRotation(q);

System.out.println("Euler: " + node.getTransform().getEulerAngles());   // synced automatically

Scala e posizione insieme

Scene scene = new Scene(); Node node = scene.getRootNode().createChildNode(“big-offset”);

node.getTransform() .setTranslation(10.0, 0.0, 0.0) .setScale(3.0, 3.0, 3.0) .setEulerAngles(0.0, 90.0, 0.0);


### Offset geometrico (Offset del pivot)

Le trasformazioni geometriche spostano la geometria rispetto al pivot del nodo senza influenzare i nodi figli; utile per centrare una mesh all'interno del suo nodo:



Scene scene = new Scene();
Node node = scene.getRootNode().createChildNode("centered-mesh");

// Shift the mesh half a unit down so its base sits at y=0
node.getTransform().setGeometricTranslation(0.0, -0.5, 0.0);

Leggi la matrice Transform combinata

Scene scene = new Scene(); Node node = scene.getRootNode().createChildNode(“m”); node.getTransform().setTranslation(1.0, 2.0, 3.0); node.getTransform().setEulerAngles(0.0, 45.0, 0.0);

Matrix4 m = node.getTransform().getTransformMatrix(); System.out.println(m.getClass().getName()); // com.aspose.threed.Matrix4


---

## Vedi anche

- [Riferimento alla classe Node](/3d/java/node/)
- [Riferimento classe GlobalTransform](/3d/java/global-transform/)
- [Riferimento della classe Scene](/3d/java/scene/)
- [Riferimento classe Quaternion](/3d/java/quaternion/)
- [Riferimento alla classe Matrix4](/3d/java/matrix4/)