Version: 5.4 beta (switch to 5.3)
LanguageEnglish
  • C#
  • JS

Script language

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

WWW.LoadImageIntoTexture

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

public function LoadImageIntoTexture(tex: Texture2D): void;
public void LoadImageIntoTexture(Texture2D tex);

Parameters

tex An existing texture object to be overwritten with the image data.

Description

Replaces the contents of an existing Texture2D with an image from the downloaded data.

The data must be an image in JPG or PNG format. If the data is not a valid image, the generated texture will be a small image of a question mark. It is recommended to use power-of-two size for each dimension of the image; arbitrary sizes will also work but can load slightly slower and take up a bit more memory.

For PNG files, gamma correction is applied to the texture if PNG file contains gamma information. Display gamma for correction is assumed to be 2.0. If file does not contain gamma information, no color correction will be performed.

This function replaces texture contents with downloaded image data, so 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 data has not finished downloading the texture will be left untouched. Use isDone or yield to see if the data is available.

// Continuously get the latest webcam shot from outside "Friday's" in Times Square
// and DXT compress them at runtime
var url = "http://images.earthcam.com/ec_metros/ourcams/fridays.jpg";

function Start () { // Create a texture in DXT1 format renderer.material.mainTexture = new Texture2D(4, 4, TextureFormat.DXT1, false); while(true) { // Start a download of the given URL var www = new WWW(url);

// wait until the download is done yield www;

// assign the downloaded image to the main texture of the object www.LoadImageIntoTexture(renderer.material.mainTexture); } }
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { public string url = "http://images.earthcam.com/ec_metros/ourcams/fridays.jpg"; IEnumerator Start() { renderer.material.mainTexture = new Texture2D(4, 4, TextureFormat.DXT1, false); while (true) { WWW www = new WWW(url); yield return www; www.LoadImageIntoTexture(renderer.material.mainTexture); } } }