Gradient

public Gradient();

Создаёт две точки: непрозрачный чёрный в 0 и белый в 1, Linear и Srgb.

public Color[] Colors { get; set; }

Массив цветов текущих точек. Чтение возвращает отдельный Color[], без принудительной сортировки точек. Изменение копии не меняет ресурс. Назначение массива меняет число точек до его длины и может удалить прежние точки. Подготовьте Colors и Offsets одинаковой длины; не считайте назначение частичным обновлением.

public Gradient.ColorSpace InterpolationColorSpace { get; set; }

Пространство интерполяции: Srgb по умолчанию, LinearSrgb или Oklab. В двух последних вариантах RGB преобразуется для интерполяции и возвращается обратно в sRGB; альфа интерполируется отдельно. Constant возвращает цвет точки без такого преобразования. Это не флаг HDR текстуры.

public Gradient.InterpolationModeEnum InterpolationMode { get; set; }

Способ выборки между точками: Linear по умолчанию, Constant удерживает левый цвет до следующей точки, Cubic использует соседние точки и может дать компоненты вне 0…1. В точной позиции точки Sample возвращает её цвет. Это не сглаживание текстуры и не настройка фильтра sampler.

public float[] Offsets { get; set; }

Позиции текущих точек. Чтение возвращает отдельный float[] в текущем внутреннем порядке, без принудительной сортировки. Назначение меняет число точек до длины массива и отмечает порядок для последующей сортировки. Обычно используйте конечные уникальные позиции 0…1; setter сам этот диапазон не ограничивает.

public void AddPoint(float offset, Color color);

Добавляет пару позиции и цвета, увеличивает число точек и делает текущий порядок несортированным. Сортировка выполняется при Sample, GetColor/GetOffset и SetColor/SetOffset. Сохраняйте собственный смысл точки отдельно: индекс после сортировки может измениться.

public Color GetColor(int point);

Сначала сортирует точки по позиции, затем возвращает цвет указанного индекса. Индекс должен существовать; ошибочный индекс не является способом получить цвет за пределами градиента.

public Color[] GetColors();

Возвращает значение свойства Gradient.Colors.

public Gradient.ColorSpace GetInterpolationColorSpace();

Возвращает значение свойства Gradient.InterpolationColorSpace.

public Gradient.InterpolationModeEnum GetInterpolationMode();

Возвращает значение свойства Gradient.InterpolationMode.

public float GetOffset(int point);

Сначала сортирует точки по позиции, затем возвращает позицию указанного индекса. Это чтение может изменить внутренний порядок массивов Colors и Offsets.

public float[] GetOffsets();

Возвращает значение свойства Gradient.Offsets.

public int GetPointCount();

Возвращает текущее число пар позиции/цвета, включая ноль после назначения пустого массива. Само число точек не запускает сортировку.

public void RemovePoint(int point);

Удаляет существующий индекс в текущем порядке, не выполняя предварительную сортировку. Нельзя удалять последнюю оставшуюся точку этим методом. Для полного обнуления назначьте пустой массив Offsets или Colors. Не используйте сохранённый индекс после операций, которые меняют порядок.

public void Reverse();

Заменяет каждую позицию на 1 − offset, сохраняет её цвет и сортирует результат. Не ограничивает исходные позиции диапазоном 0…1: позиция −0.5 станет 1.5.

public Color Sample(float offset);

Возвращает цвет для конечной позиции с учётом режима и пространства интерполяции; при необходимости сортирует точки. До первой и после последней точки возвращает крайний цвет. Пустой градиент даёт непрозрачный чёрный, одна точка — её цвет. Cubic может выходить за 0…1; одинаковые позиции, NaN и Infinity не используйте.

public void SetColor(int point, Color color);

Сначала сортирует точки, затем заменяет цвет существующего индекса и уведомляет об изменении ресурса. Назначенная градиентная текстура получит запрос на пересоздание пикселей.

public void SetColors(Color[] colors);

Назначает значение свойства Gradient.Colors.

public void SetColors(ReadOnlySpan<Color> colors);

Назначает значение свойства Gradient.Colors.

public void SetInterpolationColorSpace(Gradient.ColorSpace interpolationColorSpace);

Назначает значение свойства Gradient.InterpolationColorSpace.

public void SetInterpolationMode(Gradient.InterpolationModeEnum interpolationMode);

Назначает значение свойства Gradient.InterpolationMode.

public void SetOffset(int point, float offset);

Сначала сортирует точки, затем меняет позицию существующего индекса и снова помечает порядок несортированным. Позиция не зажимается в 0…1. После следующей сортировки индекс этой точки может измениться.

public void SetOffsets(ReadOnlySpan<float> offsets);

Назначает значение свойства Gradient.Offsets.

public void SetOffsets(float[] offsets);

Назначает значение свойства Gradient.Offsets.