Legacy Documentation: Version 4.6.2
Language: English
  • C#
  • JS
  • Boo

Script language

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

Texture2D.LoadImage

public function LoadImage(data: byte[]): bool;

Parameters

data The byte array containing the image data to load.

Returns

bool Returns true if the data can be loaded, else false.

Description

Loads an image from a byte array.

This function loads a JPG or PNG image from a raw byte[] array.

	// Load a .jpg or .png file by adding .byte extensions to the file
	// and dragging it on the imageTA variable

var imageTA : TextAsset; function Start () { var tex = new Texture2D (4, 4); tex.LoadImage(imageTA.bytes); renderer.material.mainTexture = tex; }

This function replaces texture contents with new image data. After LoadImage, texture size and format might change. JPG files are loaded into RGB24 format, PNG files are loaded into ARGB32 format. If texture format before calling LoadImage is DXT1 or DXT5, then the loaded image will be DXT-compressed (into DXT1 for JPG images and DXT5 for PNG images). If the platform is not able to perform runtime compression then false will be returned.
The example loads the pixel data from a Text Asset. The text asset is a JPG or PNG image with the extension of .bytes. This allows the Text Asset to be read as an array of bytes.

See Also: EncodeToPNG function.