Cubemap.GetPixels
Declaration
public Color[] GetPixels(CubemapFace face, int miplevel);public Color[] GetPixels(CubemapFace face);Параметры
| Параметр | Описание |
|---|---|
| лицо | CubemapFace для чтения. |
| мипуровень | Уровень 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.
using UnityEngine;
public class CubemapExample : MonoBehaviour { public Cubemap source; public Cubemap destination;
void Start() { // Get a copy of the color data from the source Cubemap, in high-precision float format. // Each element in the array represents the color data for an individual pixel. CubemapFace sourceFace = CubemapFace.PositiveX; int sourceMipLevel = 0; Color[] pixels = source.GetPixels(sourceFace, 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 Cubemap. CubemapFace destinationFace = CubemapFace.PositiveX; int destinationMipLevel = 0; destination.SetPixels(pixels, destinationFace, destinationMipLevel);
// Apply changes to the destination Cubemap, which uploads its data to the GPU. destination.Apply(); } }
Дополнительные ресурсы: ,SetPixels,, ,GetPixelData,, ,Texture.mipmapCount,.