Texture3D.SetPixels
Declaration
public void SetPixels(Color[] colors, int miplevel);public void SetPixels(Color[] colors);Параметры
| Параметр | Описание |
|---|---|
| цвета | Массив используемых цветов пикселей. Это текстура 3D, сплоченная до 1D массива. |
| мипуровень | Уровень mipmap для записи colors. Диапазон 0 до текстуры Texture.mipmapCount. Значение по умолчанию 0. |
Описание
Задает цвета пикселей для всего уровня mipmap.
Этот метод устанавливает пиксельные данные для текстуры в памяти CPU. Texture.isReadable должно быть true, и вы должны вызвать Apply после SetPixels для загрузки измененных пикселей в GPU.
Apply является дорогостоящей операцией, потому что она копирует все пиксели текстуры, даже если вы изменили только некоторые пиксели, так что измените как можно больше пикселей, прежде чем вызовёте ее.colors должен содержать пиксели слой за слоем начиная с передней части текстуры. Каждый слой должен содержать пиксели строка за строкой, начиная с нижней левой части текстуры. Размер массива должен быть равен ширине × высоте × глубине уровня mipmap.
Единый призыв к SetPixels обычно быстрее, чем несколько вызовов SetPixel, особенно для больших текстур.SetPixels может быть медленнее, чем некоторые другие методы текстуры, потому что он преобразует Color структуру в формат, используемый текстурой. Чтобы задать данные пикселей быстрее, используйте SetPixelData вместо этого.
Вы можете использовать SetPixels со следующим текстом: текстурные форматы:
- Alpha8
- ARGB32
- ARGB4444
- BGRA32
- R16
- R16_SIGNED
- R8
- R8_SIGNED
- RFloat
- RG16
- RG16_SIGNED
- RG32
- RG32_SIGNED
- RGB24
- RGB24_SIGNED
- RGB48
- RGB48_SIGNED
- RGB565
- RGB9e5Float
- RGBA32
- RGBA32_SIGNED
- RGBA4444
- RGBA64
- RGBA64_SIGNED
- RGBAFloat
- RGBAHalf
- RGFloat
- RGHalf
- RHalf
Для всех других форматов, SetPixels не срабатывает. Unity вызывает исключение, когда SetPixels не срабатывает.
Дополнительные ресурсы: GetPixels, SetPixels32, SetPixelData, Apply, mipmapCount.