Skip to main content Link Menu Expand (external link) Document Search Copy Copied
bandField

bandField

Field that applies values based on a band/slice of an axis.

For example, this can be used to have one color within Z = 0.3 to 0.5, and another color for all other coordinates.

See also the slice operator, which behaves similarly for SDF results.

Parameters

  • Coord Type:
    • Auto:
    • 1D:
    • 2D:
    • 3D:
  • Axis:
    • X:
    • Y:
    • Z:
    • Distance From Origin:
  • Center: The center position along the axis of the "inside" part of the band.
  • Width: The width of the "inside" part of the band, along the axis.
  • Enable Blending: Whether to smooth the transition between "inside" and "outside" vs a hard cutoff.
  • Blending: The blending distance between "inside" and "outside". This applies to both borders of the "inside" area.
  • Return Type: Whether to produce a single float value or a vector with 4 parts.
    • Float:
    • Vector:
  • Inside Value: The value used for the "inside" part. If `Return Type` is `Float`, only the first parameter will be used.
  • Outside Value: The value used for the "outside" part. If `Return Type` is `Float`, only the first parameter will be used.
  • Enable:
  • Enable Repeat:
  • Repeat Size:
  • Repeat Shift:

Inputs

  • Coordinate Field: (optional) Optional float field that can be used as an alternative coordinate source (instead of using the `Axis` parameter).
    • Coordinate Types: float vec2 vec3
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext
    • Return Types: float
  • Inside Value Field: (optional) Optional field that is used to produce the values for the "inside" part. If used, the `Inside Value` parameter will be ignored.
    • Coordinate Types: float vec2 vec3
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext
    • Return Types: float vec4
  • Outside Value Field: (optional) Optional field that is used to produce the values for the "outside" part. If used, the `Outside Value` parameter will be ignored.
    • Coordinate Types: float vec2 vec3
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext
    • Return Types: float vec4
  • Blend Function: (optional) Optional function used to control how `Blending` is applied.
    • Coordinate Types: float
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext
    • Return Types: float