版本:Unity 6 (6000.0)
语言英语
  • C#

ImageConversion.EncodeNativeArrayToPNG

建议更改

成功!

感谢您帮助我们提高 Unity 文档的质量。虽然我们无法接受所有提交内容,但我们会阅读用户提出的每一个更改建议,并在适用情况下进行更新。

关闭

提交失败

由于某种原因,您的更改建议无法提交。请<a>稍后再试</a>。感谢您抽出时间帮助我们提高 Unity 文档的质量。

关闭

取消

声明

public static NativeArray<byte> EncodeNativeArrayToPNG(NativeArray<T> input, Experimental.Rendering.GraphicsFormat format, uint width, uint height, uint rowBytes);

参数

input 要转换的原生数组。
format 图像数据的像素格式。
width 图像数据以像素为单位的宽度。
height 图像数据以像素为单位的高度。
rowBytes 单行以字节为单位的长度。默认值为 0,这意味着 Unity 会自动计算长度。

描述

将此原生数组编码为 PNG 格式。

此函数返回一个 NativeArray<byte>,它是 PNG 数据。您可以将编码后的数据存储为文件或在不进行进一步处理的情况下将其发送到网络。

此函数不适用于任何压缩格式。编码后的 PNG 数据将是 8 位灰度、RGB 或 RGBA(取决于传入的格式)。对于单通道红色纹理(R8R16RFloatRHalf),编码后的 PNG 数据将为灰度。

PNG 数据不包含伽马校正或色彩配置文件信息。

此函数返回的原生数组使用持久分配器分配,因此此函数只能从主线程调用。

// Saves screenshot as PNG file.
using System.Collections;
using System.IO;
using Unity.Collections;
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 NativeArray<byte> imageBytes = new NativeArray<byte>(tex.GetRawTextureData(), Allocator.Temp); var bytes = ImageConversion.EncodeNativeArrayToPNG(imageBytes, 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.ToArray()); } }