Texture3D.GetPixels
Declaration
public Color[] GetPixels(int miplevel);public Color[] GetPixels();Параметры
| Параметр | Описание |
|---|---|
| мипуровень | Уровень mipmap для получения. Диапазон 0 через текстуру Texture.mipmapCount. Значение по умолчанию 0. |
Возвращаемое значение
Color[] Массив, содержащий цвета пикселей.
Описание
Получает данные цвета пикселей для уровня mipmap как структуры Color.
Этот метод получает данные пикселей из текстуры в памяти CPU. Texture.isReadable должно быть true.
Массив содержит пиксели по очереди, начиная с переднего края текстуры. Каждый слой содержит пиксели по очереди, начиная с нижнего левого угла текстуры. Размер массива равен ширине × высоте × глубине уровня mipmap.
Каждый пиксель является Color struct. GetPixels может быть медленнее, чем некоторые другие методы текстуры, потому что он преобразует формат текстуры использует в Color. GetPixels также необходимо декомпрессировать сжатые текстуры и использовать память для хранения декомпрессированной области. Чтобы получить пиксельные данные быстрее, используйте GetPixelData вместо этого.
Единый призыв к GetPixels обычно быстрее, чем несколько вызовов GetPixel, особенно для больших текстур.
Если GetPixels не удаётся, Unity вызывает исключение. GetPixels может завершиться неудачей, если массив содержит слишком много данных. GetPixelData вместо очень больших текстур.
Вы не можете использовать GetPixel с текстурами, использующими сжатие текстуры Crunch. Использование GetPixels32 вместо этого.
using UnityEngine;
public class Texture3DExample : MonoBehaviour { public Texture3D source; public Texture3D destination;
void Start() { // Get a copy of the color data from the source Texture3D, in high-precision float format. // Each element in the array represents the color data for an individual pixel. int sourceMipLevel = 0; Color[] pixels = source.GetPixels(sourceMipLevel);
// If required, manipulate the pixels before applying them to the destination texture. // This example code reverses the array, which rotates the image 180 degrees. System.Array.Reverse(pixels, 0, pixels.Length);
// Set the pixels of the destination Texture3D. int destinationMipLevel = 0; destination.SetPixels(pixels, destinationMipLevel);
// Apply changes to the destination Texture3D, which uploads its data to the GPU. destination.Apply(); } }
Дополнительные ресурсы: SetPixel, SetPixels, SetPixels32, GetPixel, GetPixelBilinear, GetPixels32, GetPixelData, Apply функции.