Legacy Documentation: Version 5.5
LanguageEnglish
  • C#
  • JS

Script language

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

UnityWebRequest.GetTexture

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

Submission failed

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

Close

Cancel

public static function GetTexture(uri: string): Networking.UnityWebRequest;
public static Networking.UnityWebRequest GetTexture(string uri);
public static function GetTexture(uri: string, nonReadable: bool): Networking.UnityWebRequest;
public static Networking.UnityWebRequest GetTexture(string uri, bool nonReadable);

Parameters

uri The URI of the image to download.
nonReadable If true, the texture's raw data will not be accessible to script. This can conserve memory. Default: false.

Returns

UnityWebRequest A UnityWebRequest properly configured to download an image and convert it to a Texture.

Description

Create a UnityWebRequest intended to download an image via HTTP GET and create a Texture based on the retrieved data.

This method creates a UnityWebRequest and sets the target URL to the string uri argument. This method sets no other flags or custom headers.

This method attaches a DownloadHandlerTexture object to the UnityWebRequest. DownloadHandlerTexture is a specialized DownloadHandler which is optimized for storing images which are to be used as textures in the Unity Engine. Using this class significantly reduces memory reallocation compared to downloading raw bytes and creating a texture manually in script. In addition, texture conversion will be performed on a worker thread.

This method attaches no UploadHandler to the UnityWebRequest.

no example available in JavaScript
using UnityEngine;
using UnityEngine.Networking;
using System.Collections;
 
class MyBehaviour: public MonoBehaviour {
    void Start() {
        StartCoroutine(GetTexture());
    }
 
    IEnumerator GetTexture() {
        using(UnityWebRequest www = UnityWebRequest.GetTexture("http://www.my-server.com/image.png")) {
            yield return www.Send();
     
            if(www.isError) {
                Debug.Log(www.error);
            }
            else {
                Texture myTexture = DownloadHandlerTexture.GetContent(www);
            }
        }
    }
}