Legacy Documentation: Version 4.5.0

Script language:

  • JS
  • C#
  • Boo
Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Texture2D.ReadPixels

ReadPixels(source: Rect, destX: int, destY: int, recalculateMipMaps: bool = true): void;
void ReadPixels(Rect source, int destX, int destY, bool recalculateMipMaps = true);
def ReadPixels(source as Rect, destX as int, destY as int, recalculateMipMaps as bool = true) as void

Parameters

sourceRectangular region of the view to read from.
destXHorizontal pixel position in the texture to place the pixels that are read.
destYVertical pixel position in the texture to place the pixels that are read.
recalculateMipMapsShould the texture's mipmaps be recalculated after reading?

Description

Read screen pixels into the saved texture data.

This will copy a rectangular pixel area from the currently active RenderTexture or the view (specified by the source parameter) into the position defined by destX and destY. Both coordinates use pixel space - (0,0) is lower left.

If recalculateMipMaps is set to true, the mip maps of the texture will also be updated. If recalculateMipMaps is set to false, you must call Apply to recalculate them.

This function works only on ARGB32 and RGB24 texture formats. The texture also has to have Read/Write Enabled flag set in the import settings. ReadPixels is unsupported on Flash.

	// This script should be attached to a camera. 

// Grab the camera's view when this variable is true. var grab: boolean;

// The "display" is the object whose texture will be set // to the captured image. var display: Renderer;

function OnPostRender() { if (grab) { // Make a new texture of the right size and // read the camera image into it. var tex = new Texture2D(128, 128); tex.ReadPixels(new Rect(0, 0, 128, 128), 0, 0); tex.Apply(); // Set the display texture to the newly captured image. display.material.mainTexture = tex; // Reset the grab variable to avoid making multiple // captures. grab = false; } }

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    public bool grab;
    public Renderer display;
    void OnPostRender() {
        if (grab) {
            Texture2D tex = new Texture2D(128, 128);
            tex.ReadPixels(new Rect(0, 0, 128, 128), 0, 0);
            tex.Apply();
            display.material.mainTexture = tex;
            grab = false;
        }
    }
}
import UnityEngine
import System.Collections

public class ExampleClass(MonoBehaviour):

	public grab as bool

	public display as Renderer

	def OnPostRender() as void:
		if grab:
			tex as Texture2D = Texture2D(128, 128)
			tex.ReadPixels(Rect(0, 0, 128, 128), 0, 0)
			tex.Apply()
			display.material.mainTexture = tex
			grab = false

See Also: EncodeToPNG.