Cubemap.GetPixels

Parameters

Description

返回立方体贴图面的像素颜色。

This method returns an array of pixel colors of the whole mip level of a cubemap face.

返回的数组是一个平展 2D 数组，其中像素是从右到左、 自上而下排列（即，逐行排列）的。数组大小为所用 Mip 级别的宽度乘以高度。 默认 Mip 级别为零（基础纹理），在这种情况下，其大小只是该纹理的大小。 在一般情况下，Mip 级别的大小为 mipSize=max(1,width>>miplevel)。

The texture must have the Is Readable flag set in the import settings, otherwise this method will fail. GetPixels is not available on Textures using Crunch texture compression.

使用 GetPixels 可比反复调用 GetPixel 更快，尤其是 对于较大纹理而言。此外，GetPixels 还可访问单独的 Mipmap 级别。

注意：假设从外面能够看到每个立方体贴图的六个侧面。这 意味着像素是从左到右、自上而下排列（即，逐行排列）的。如果该立方体贴图 围绕着世界，则像素从右向左显示。

另请参阅：SetPixels、mipmapCount。

// copy the +X face of a cubemap to a texture.

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour
{
    public Cubemap c;
    public Texture2D t;
    private Color[] CubeMapColors;

    void Example()
    {
        CubeMapColors = c.GetPixels(CubemapFace.PositiveX);
        t.SetPixels(CubeMapColors);
        t.Apply();
    }
}