ImageConversion.EncodeArrayToPNG

Unity · Версия 2020.3 LTS · Scripting · ImageConversion

ImageConversion.EncodeArrayToPNG

Объявление

public static byte[] EncodeArrayToPNG(Array array, Experimental.Rendering.GraphicsFormat format, uint width, uint height, uint rowBytes);

Параметры

array Массив байтов для преобразования.
format Пиксельный формат данных изображения.
width Ширина данных изображения в пикселях.
height Высота данных изображения в пикселях.
rowBytes Длина одной строки в байтах.

Описание

Кодирует этот массив в формат PNG.

Возвращенный массив байтов представляет собой "файл" PNG. Вы можете записать их на диск, чтобы получить файл PNG, отправить их по сети и т. д.

Закодированные данные PNG будут содержать альфа-канал для текстур RGBA32, ARGB32 и не будут содержать альфа-канал для RGB24 текстуры. Для одноканальных красных текстур ( R8, R16, RFloat и RHalf ), закодированные данные PNG будут в оттенках серого. Данные PNG не будут содержать информацию о гамма-коррекции или цветовом профиле.

Этот метод является потокобезопасным.

Если передать rowBytes значение 0, длина строки в байтах будет автоматически рассчитана.

// Saves screenshot as PNG file.
using System.Collections;
using System.IO;
using UnityEngine;

public class PNGScreenSaver : MonoBehaviour
{
    // Take a shot immediately
    IEnumerator Start()
    {
        yield return SaveScreenPNG();
    }

    IEnumerator SaveScreenPNG()
    {
        // Read the screen buffer after rendering is complete
        yield return new WaitForEndOfFrame();

        // Create a texture in RGB24 format the size of the screen
        int width = Screen.width;
        int height = Screen.height;
        Texture2D tex = new Texture2D(width, height, TextureFormat.RGB24, false);

        // Read the screen contents into the texture
        tex.ReadPixels(new Rect(0, 0, width, height), 0, 0);
        tex.Apply();

        // Encode the bytes in PNG format
        byte[] bytes = ImageConversion.EncodeArrayToPNG(tex.GetRawTextureData(), tex.graphicsFormat, (uint)width, (uint)height);
        Object.Destroy(tex);

        // Write the returned byte array to a file in the project folder
        File.WriteAllBytes(Application.dataPath + "/../SavedScreen.png", bytes);
    }
}

Смотрите так же: EncodeToPNG, EncodeNativeArrayToPNG, EncodeArrayToJPG, EncodeArrayToTGA, EncodeArrayToEXR.

Обновлено 17 ноября 2026 г.