Gradient

public Gradient();

Creates two points: opaque black at 0 and white at 1, with Linear and Srgb interpolation.

public Color[] Colors { get; set; }

Colors of the current points. Reading returns an independent Color[] without forcing point sorting. Editing that copy does not change the resource. Assigning an array resizes the point count to its length and can discard existing points. Prepare matching Colors and Offsets lengths; assignment is not a partial update.

public Gradient.ColorSpace InterpolationColorSpace { get; set; }

Interpolation space: Srgb by default, LinearSrgb or Oklab. The latter two transform RGB for interpolation and convert the result back to sRGB; alpha is interpolated separately. Constant returns the point color without that conversion. This is not a texture HDR flag.

public Gradient.InterpolationModeEnum InterpolationMode { get; set; }

Sampling between points: Linear by default, Constant holds the left color until the next point, and Cubic uses neighboring points and can exceed the 0…1 component range. At an exact point position, Sample returns that point color. This is not texture antialiasing or sampler filtering.

public float[] Offsets { get; set; }

Point positions. Reading returns an independent float[] in current internal order without forcing sorting. Assignment resizes the point count to the array length and schedules sorting for a later point operation. Normally use finite, unique positions in 0…1; the setter does not clamp them to that range.

public void AddPoint(float offset, Color color);

Adds a position/color pair, increases the point count and marks the order unsorted. Sample, GetColor/GetOffset and SetColor/SetOffset perform sorting. Track a point’s meaning separately because its index can change after sorting.

public Color GetColor(int point);

Sorts points by position, then returns the indexed color. The index must exist; an invalid index is not a way to sample outside the gradient.

public Color[] GetColors();

Returns the value of Gradient.Colors.

public Gradient.ColorSpace GetInterpolationColorSpace();

Returns the value of Gradient.InterpolationColorSpace.

public Gradient.InterpolationModeEnum GetInterpolationMode();

Returns the value of Gradient.InterpolationMode.

public float GetOffset(int point);

Sorts points by position, then returns the indexed position. This read can change the internal order exposed by Colors and Offsets.

public float[] GetOffsets();

Returns the value of Gradient.Offsets.

public int GetPointCount();

Returns the current position/color pair count, including zero after assigning an empty array. Reading the count does not trigger sorting.

public void RemovePoint(int point);

Removes an existing index in the current order without first sorting. This method cannot remove the last remaining point. Assign an empty Offsets or Colors array to clear all points. Do not reuse an index after operations that change the order.

public void Reverse();

Replaces each position with 1 − offset, retains its color and sorts the result. It does not clamp original positions to 0…1: −0.5 becomes 1.5.

public Color Sample(float offset);

Returns the color at a finite position using the selected interpolation mode and space, sorting points if needed. Before the first or after the last point it returns the endpoint color. An empty gradient returns opaque black; one point returns its color. Cubic can exceed 0…1; avoid duplicate positions, NaN and Infinity.

public void SetColor(int point, Color color);

Sorts points, replaces the color at an existing index and emits the resource change notification. A connected gradient texture queues pixel regeneration.

public void SetColors(Color[] colors);

Assigns the value of Gradient.Colors.

public void SetColors(ReadOnlySpan<Color> colors);

Assigns the value of Gradient.Colors.

public void SetInterpolationColorSpace(Gradient.ColorSpace interpolationColorSpace);

Assigns the value of Gradient.InterpolationColorSpace.

public void SetInterpolationMode(Gradient.InterpolationModeEnum interpolationMode);

Assigns the value of Gradient.InterpolationMode.

public void SetOffset(int point, float offset);

Sorts points, changes the position at an existing index and marks the order unsorted again. The position is not clamped to 0…1. This point can have a different index after the next sort.

public void SetOffsets(ReadOnlySpan<float> offsets);

Assigns the value of Gradient.Offsets.

public void SetOffsets(float[] offsets);

Assigns the value of Gradient.Offsets.