bandField

bandField

Coordinate Field
Inside Value Field
Outside Value Field
Center Field
Width Field
Blend Amount Field
Blend Function
field
bandField
RayTK
v0.42

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

Name Description Regular Handling Read-Only Handling
Coord Type
  • Auto:
  • 1D:
  • 2D:
  • 3D:
Axis Semi-Baked Semi-Baked
  • X:
  • Y:
  • Z:
  • Distance From Origin:
Center

The center position along the axis of the “inside” part of the band.

 Runtime Baked
Width

The width of the “inside” part of the band, along the axis.

 Runtime Baked
Enable Blending

Whether to smooth the transition between “inside” and “outside” vs a hard cutoff.

 Semi-Baked Semi-Baked
Blending

The blending distance between “inside” and “outside”. This applies to both borders of the “inside” area.

 Runtime Baked
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.

 Runtime Baked
Outside Value

The value used for the “outside” part. If Return Type is Float, only the first parameter will be used.

 Runtime Baked
Enable
Reverse Semi-Baked Semi-Baked
Enable Repeat Semi-Baked Semi-Baked
Repeat Size Runtime Baked
Repeat Shift Runtime Baked

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 vec4
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext VertexContext PixelContext
    • Return Types: float vec4
  • 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 vec4
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext VertexContext PixelContext
    • Return Types: float vec4
    • Supports Variables From Inputs: coordField
  • 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 vec4
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext VertexContext PixelContext
    • Return Types: float vec4
    • Supports Variables From Inputs: coordField insideValue
  • Center Field: (optional) Optional function used to control how `Blending` is applied.
    • Coordinate Types: float vec2 vec3 vec4
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext VertexContext PixelContext
    • Return Types: float
    • Supports Variables From Inputs: coordField insideValue outsideValue
  • Width Field: (optional)
    • Coordinate Types: float vec2 vec3 vec4
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext VertexContext PixelContext
    • Return Types: float
    • Supports Variables From Inputs: coordField insideValue outsideValue centerField
  • Blend Amount Field: (optional)
    • Coordinate Types: float vec2 vec3 vec4
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext VertexContext PixelContext
    • Return Types: float
    • Supports Variables From Inputs: coordField insideValue outsideValue centerField widthField
  • Blend Function: (optional)
    • Coordinate Types: float
    • Context Types: Context MaterialContext CameraContext LightContext RayContext ParticleContext VertexContext PixelContext
    • Return Types: float
    • Supports Variables From Inputs: coordField insideValue outsideValue centerField widthField blendingField