Texture2D.GetRawTextureData

Returns

NativeArray<T> Raw texture data view.

Description

Get raw data from a texture for reading or writing.

This function returns a direct "view" into the texture pixel data as a Unity.Collections.NativeArray.

The data will be whole texture according to its width, height, data format and mipmapCount. Mipmaps are laid out in memory starting from largest, with smaller mip level data immediately following. For example, a 16x8 texture of RGBA32 format with no mipmaps will result in a 512-byte array (16x8x4), or a 128-element array if Color32 is used as a type.

You can read from and write to the returned array. If you write to it, you must call the Apply method to upload the texture to the GPU.

GetRawTextureData does not allocate memory; the returned NativeArray directly points to the texture system memory data buffer.

Note: The returned array can become invalid (i.e. it no longer points to valid memory) if modifications or uploads happen to the texture after you call this method. Therefore the recommended way to use this method is to get the data, and use or modify it immediately. You should not store the returned array for later use.

See Also: Apply, SetPixels, SetPixels32, LoadRawTextureData.

using UnityEngine;

public class ExampleScript : MonoBehaviour
{
    void Start()
    {
        var texture = new Texture2D(128, 128, TextureFormat.RGBA32, false);
        GetComponent<Renderer>().material.mainTexture = texture;

        // RGBA32 texture format data layout exactly matches Color32 struct
        var data = texture.GetRawTextureData<Color32>();

        // fill texture data with a simple pattern
        Color32 orange = new Color32(255, 165, 0, 255);
        Color32 teal = new Color32(0, 128, 128, 255);
        int index = 0;
        for (int y = 0; y < texture.height; y++)
        {
            for (int x = 0; x < texture.width; x++)
            {
                data[index++] = ((x &amp; y) == 0 ? orange : teal);
            }
        }
        // upload to the GPU
        texture.Apply();
    }
}

Returns

byte[] 原始纹理数据的字节数组。

Description

从纹理中获取原始数据。

该函数将原始纹理数据以字节数组的形式返回，以便您可以使用 Texture2D.LoadRawTextureData 进行加载。这让您能够序列化和加载任意格式（包括压缩格式）的纹理，并稍后重新将它们加载到纹理中。

Note that this function returns Unity's system memory copy of the texture data, so for it to work the texture must have the read/write enabled flag set in the texture import settings.

另请注意，系统内存副本可能与当前 GPU 纹理数据中的内容不匹配。例如， 在调用 SetPixels 后，系统内存副本已修改， 但只有在调用 Apply() 后，GPU 副本才会匹配。对于某些 Graphics.CopyTexture，可能只复制 GPU 纹理部分 （例如从 RenderTexture 复制到 Texture2D），这不会反映在 GetRawTextureData 内容中。

using UnityEngine;

class CopyTexture : MonoBehaviour
{
    // the source texture.
    Texture2D tex;

    void Start()
    {
        // Create a copy of the texture by reading and applying the raw texture data.
        Texture2D texCopy = new Texture2D(tex.width, tex.height, tex.format, tex.mipmapCount > 1);
        texCopy.LoadRawTextureData(tex.GetRawTextureData());
        texCopy.Apply();
    }
}