Returns a Texture2D generated from the downloaded data (Read Only).
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. Each invocation of texture property allocates a new Texture2D. If you
continously download textures you must use LoadImageIntoTexture or Destroy
the previously created texture.
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.
JPG files are loaded into RGB24 format, PNG files are loaded into
ARGB32 format. If you want to DXT-compress the downloaded image,
use LoadImageIntoTexture instead.
If the object has not finished downloading the data a dummy image will be returned.
Use isDone or yield to see if the data is available.
using UnityEngine; using System.Collections;
// Get the latest webcam shot from outside "Friday's" in Times Square public class ExampleClass : MonoBehaviour { public string url = "http://images.earthcam.com/ec_metros/ourcams/fridays.jpg";
IEnumerator Start() { // Start a download of the given URL using (WWW www = new WWW(url)) { // Wait for download to complete yield return www;
// assign texture Renderer renderer = GetComponent<Renderer>(); renderer.material.mainTexture = www.texture; } } }
Note: The WWW.texture property allocates a new Texture2D every time it is called.
Therefore, it is important to always assign the result to a local variable so that it can
later be freed using Destroy().
The call to www.texture allocates a new texture, but the texture is never deallocated because
no local reference to it exists.
Alternatively, use WWW.LoadImageIntoTexture.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.