Transform Category

  • The following list shows the Transform Category Magma nodes available in Krakatoa MX 2.x.
  • These nodes are used to transform data in and out variouys coordinate systems.

FromCamera

  • The FromCamera operator transforms a Vector from Camera Space into World Space.
  • The FromCamera operator has one input and one output.
../../../_images/transform_fromcamera.png

Input 1: Vector (CS)

  • The input must be a Vector.
  • It will be assumed that the Vector is already in Camera Space.
  • The input has no default value when unconnected.

Output 1: CameraSpace

  • The output returns the input Vector transformed from Camera Space into World Space.
  • The Properties and Actions rollout of the node defines:
    • Input Type:
      • Point - Used to transform Position vectors. Affects Orientation, Scaling and Translation.
      • Vector - Used to transform Vectors with direction and magnitude like Velocity. Affects Orientation and Scaling but no Translation.
      • Normal - Used to transform Normals. Affects Orientation only, no Scaling and Translation.

FromSpace

  • The FromSpace operator has one input and one output.
  • The FromSpace operator has three inputs and one output.
    • In Krakatoa versions prior to 2.4.0, it had only two inputs - Vector and Object.
../../../_images/transform_fromspace.png

Input 1: Vector (WS)

  • The first input must be a Vector.
  • It is assumed that the Vector is already in the Object Space of the Reference Object.
  • If unconnected, the socket will have a default value of 0,0,0 which can be canged via the node’s properties.

Input 2: Objects

  • The second input is mandatory when no Reference Object has been picked via the node’s properties.
  • The input is an Objects List with one or more objects.
  • For example, the Objects output of an InputGeometry node is a list of the nodes of the picked objects, while the output of the InputObject node is a list with a single object.
  • The object from the list to be used is specified using the third input.
  • If a Reference Object has been picked via the node’s properties, the input socket becomes optional.
  • If a Reference Object is specified via both the input socket and the nide’s properties, the input object will be used.

Input 3: ObjIndex

  • This input defines the 0-based index within the Objects List provided by the second input.
  • Default value is 0 and it can be changed via the Input Defaults settings of the node’s properties.
  • The default value of 0 picks the first object from the list.
  • This socket can be connected for example to the ObjIndex output socket of an IntersectRay or NearestPoint operator to select the correct object from an InputGeometry list.

Output

  • Returns the Vector transformed from the reference Object’s Space into World Space.
  • The Properties and Actions rollout of the node defines:
    • Input Type:
      • Point - Used to transform Position vectors. Affects Orientation, Scaling and Translation.
      • Vector - Used to transform Vectors with direction and magnitude like Velocity. Affects Orientation and Scaling but no Translation.
      • Normal - Used to transform Normals. Affects Orientation only, no Scaling and Translation.
    • Pick Scene Object…
      • Picks a scene object to transform to its space without using the Inputs 2 and 3.
    • Input Defaults
      • Specifies default values for Inputs 1 and 3, if unconnected.

FromWorld

  • The FromWorld operator transforms a Vector from World Space to Object Space.
  • The FromWorld operator has one input and one output.
../../../_images/transform_fromworld.png

Input 1: Vector (WS)

  • The input must be a Vector in World Space.
  • The input has no default value when unconnected.

Output 1: ObjectSpace

  • The output returns the Vector transformed from World Space into Object Space.
  • The Properties and Actions rollout of the node defines:
    • Input Type:
      • Point - Used to transform Position vectors. Affects Orientation, Scaling and Translation.
      • Vector - Used to transform Vectors with direction and magnitude like Velocity. Affects Orientation and Scaling but no Translation.
      • Normal - Used to transform Normals. Affects Orientation only, no Scaling and Translation.

ToCamera

  • The ToCamera operator transforms a World Space Vector into a Vector in Camera Space based on the current Viewport / Camera Transforms.
  • The ToCamera operator has one input and one output.
../../../_images/transform_tocamera.png

Input 1: Vector (WS)

  • The input must be a Vector
  • The input has no default value when unconnected.

Output 1: CameraSpace

  • The output returns the input Vector transformed from World Space into Camera Space.
  • The Properties and Actions rollout of the node defines:
    • Input Type:
      • Point - Used to transform Position vectors. Affects Orientation, Scaling and Translation.
      • Vector - Used to transform Vectors with direction and magnitude like Velocity. Affects Orientation and Scaling but no Translation.
      • Normal - Used to transform Normals. Affects Orientation only, no Scaling and Translation.

ToSpace

  • The ToSpace operator transforms a World Space Vector into the coordinate space of a reference object using the object’s world transformation matrix.
  • The ToSpace operator has three inputs and one output.
    • In Krakatoa versions prior to 2.4.0, it had only two inputs - Vector and Object.
../../../_images/transform_tospace.png

Input 1: Vector (WS)

  • The first input must be a Vector in World Space
  • If unconnected, the socket will have a default value of 0,0,0 which can be canged via the node’s properties.

Input 2: Objects

  • The second input is mandatory when no Reference Object has been picked via the node’s properties.
  • The input is an Objects List with one or more objects.
  • For example, the Objects output of an InputGeometry node is a list of the nodes of the picked objects, while the output of the InputObject node is a list with a single object.
  • The object from the list to be used is specified using the third input.
  • If a Reference Object has been picked via the node’s properties, the input socket becomes optional.
  • If a Reference Object is specified via both the input socket and the nide’s properties, the input object will be used.

Input 3: ObjIndex

  • This input defines the 0-based index within the Objects List provided by the second input.
  • Default value is 0 and it can be changed via the Input Defaults settings of the node’s properties.
  • The default value of 0 picks the first object from the list.
  • This socket can be connected for example to the ObjIndex output socket of an IntersectRay or NearestPoint operator to select the correct object from an InputGeometry list.

Output

  • Returns the Vector transformed from World Space into the reference object’s space.
  • The Properties and Actions rollout of the node defines:
    • Input Type:
      • Point - Used to transform Position vectors. Affects Orientation, Scaling and Translation.
      • Vector - Used to transform Vectors with direction and magnitude like Velocity. Affects Orientation and Scaling but no Translation.
      • Normal - Used to transform Normals. Affects Orientation only, no Scaling and Translation.
    • Pick Scene Object…
      • Picks a scene object to transform to its space without using the Inputs 2 and 3.
    • Input Defaults
      • Specifies default values for Inputs 1 and 3, if unconnected.

ToWorld

  • The ToWorld operator transforms a Vector from a Object Space to World Space.
  • The ToWorld operator has one input and one output.
../../../_images/transform_toworld.png

Input 1: Vector (OS)

  • The input must be a Vector in Object Space.
  • The input has no default value when unconnected.

Output 1: WorldSpace

  • The output returns the Vector transformed from Object Space into World Space.
  • The Properties and Actions rollout of the node defines:
    • Input Type:
      • Point - Used to transform Position vectors. Affects Orientation, Scaling and Translation.
      • Vector - Used to transform Vectors with direction and magnitude like Velocity. Affects Orientation and Scaling but no Translation.
      • Normal - Used to transform Normals. Affects Orientation only, no Scaling and Translation.

TransformByQuat

  • The TransformByQuat operator transforms a Quat or Vector value by a Quat value.
  • This can be used to rotate a Vector or a Quat using another Quat.
  • The TransformByQuat operator has two inputs and one output.
../../../_images/transform_by_quat.png

Input 1: Quat

  • The first input must be a Quat value defining the transformation.
  • The input has a default value of (quat 0 0 0 1) when unconnected.

Input 2: QuatOrVector

  • The second input must be a Quat or Vector value to be transformed by the first Quat.
  • The input has a default Vector value of (0 0 0 0) when unconnected.

Output 1: TransformByQuat

  • The output returns the second Input value transformed by the first Input’s Quat value.