translate

Shortcuts:
  • tr
Keywords:
  • move
  • position
  • transform
  • translate

Translates coordinates of the input ROP.

Translate can be used in 2D or 3D.

It can either specify an offset for each axis, or a direction and a distance.

When specifying an offset for each axis, it can optionally use a vector field to apply variable amounts of translation based on coordinates. If a field is used, the field values are added to the Translate XYZ parameter.

When specifying a direction and distance, it can optionally use a field to add to the distance specified in the Distance parameter.

Parameters

Name Description Regular Handling Read-Only Handling
Enable
Translate Mode

How to specify the amount of translation.

  • XYZ Distance:
  • Direction and Distance:
Translate

Amount of translation along each axis. For 2D, only X and Y are used.

Runtime Baked
Direction

Vector indicating which direction to move towards. A value of 1,0,0 would move to the right on the X axis, and 0,-1,0 would move down on the Y axis.

Runtime Baked
Distance

How far to move in the specified direction.

Runtime Baked
Coord Type
  • Auto:
  • 2D:
  • 3D:
Apply To
  • Coordinates:
  • SDF UV:
  • SDF Secondary UV:
  • UV In Material:
  • Field Values:

Inputs

  • definition_in: (optional)
    • Coordinate Types: vec2 vec3
    • Context Types: MaterialContext
    • Return Types: float vec4 Sdf Volume Ray Light Particle
  • Translate Field: (optional) If provided, this field is used to control the amount of translation at each point in space. If the field returns a float (or SDF), the `Translate` parameter is *multiplied* by that value. If it returns a vec4, the parts are *added* to the `Translate` parameter parts.
    • Coordinate Types: vec2 vec3
    • Context Types: MaterialContext
    • Return Types: vec4
  • Distance Field: (optional) If provided, this field is used to add to the distance that space is moved.
    • Coordinate Types: vec2 vec3
    • Context Types: MaterialContext
    • Return Types: float
  • Direction Field: (optional)
    • Coordinate Types: vec2 vec3
    • Context Types: MaterialContext
    • Return Types: vec4