Version: 2021.3

WaitForEndOfFrame

class in UnityEngine

/

继承自:YieldInstruction

切换到手册

描述

等待,直到该帧结束,在 Unity 渲染每一个摄像机和 GUI 之后,在屏幕上显示该帧之前。

可以用它将显示内容读取到纹理中,将其编码为图像文件(请参阅 Texture2D.ReadPixelsTexture2D.Texture2D),并将其存储在设备上。

从 Game 视图切换到 Scene 视图将导致 WaitForEndOfFrame 冻结。它只在应用程序切换回 Game 视图时才会继续。只有当应用程序在 Unity 编辑器中运行时才会发生这种情况。

注意:在批处理模式下,不会在编辑器上调用此协程。如需了解更多详细信息,请参阅手册中的命令行参数页面。

using System.IO;
using UnityEngine;
using UnityEngine.Networking;
using System.Collections;

public class ExampleClass : MonoBehaviour { // Take a shot immediately IEnumerator Start() { UploadPNG(); yield return null; }

IEnumerator UploadPNG() { // We should only read the screen buffer after rendering is complete yield return new WaitForEndOfFrame();

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

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

// Encode texture into PNG byte[] bytes = tex.EncodeToPNG(); Destroy(tex);

// For testing purposes, also write to a file in the project folder // File.WriteAllBytes(Application.dataPath + "/../SavedScreen.png", bytes);

// Create a Web Form WWWForm form = new WWWForm(); form.AddField("frameCount", Time.frameCount.ToString()); form.AddBinaryData("fileUpload", bytes);

// Upload to a cgi script var w = UnityWebRequest.Post("http://localhost/cgi-bin/env.cgi?post", form); yield return w.SendWebRequest(); if (w.result != UnityWebRequest.Result.Success) print(w.error); else print("Finished Uploading Screenshot"); yield return null; } }
using UnityEngine;
using System.Collections;

public class ExampleScript : MonoBehaviour { // A script that shows destination alpha channel in the game view.

Material mat;

void CreateMaterial() { // Unity has a built-in shader that is useful for drawing // simple colored things. In this case, we just want to use // a blend mode that inverts destination colors. var shader = Shader.Find("Hidden/Internal-Colored"); mat = new Material(shader); mat.hideFlags = HideFlags.HideAndDontSave; // Set blend mode to show destination alpha channel. mat.SetInt("_SrcBlend", (int)UnityEngine.Rendering.BlendMode.DstAlpha); mat.SetInt("_DstBlend", (int)UnityEngine.Rendering.BlendMode.Zero); // Turn off backface culling, depth writes, depth test. mat.SetInt("_Cull", (int)UnityEngine.Rendering.CullMode.Off); mat.SetInt("_ZWrite", 0); mat.SetInt("_ZTest", (int)UnityEngine.Rendering.CompareFunction.Always); }

public IEnumerator Start() { CreateMaterial(); while (true) { // Wait until all rendering + UI is done. yield return new WaitForEndOfFrame(); // Draw a quad that shows alpha channel. GL.PushMatrix(); GL.LoadOrtho(); mat.SetPass(0); GL.Begin(GL.QUADS); GL.Vertex3(0, 0, 0); GL.Vertex3(1, 0, 0); GL.Vertex3(1, 1, 0); GL.Vertex3(0, 1, 0); GL.End(); GL.PopMatrix(); } yield return null; } }

继承的成员