Unity - Scripting API: Networking.UnityWebRequestTexture.GetTexture
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.
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.
Parameters
| Parameter | Description |
|---|---|
| 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.
Use UnityWebRequestTexture.GetTexture to retrieve a Texture file from a remote server. This function is very similar to UnityWebRequest.Get, but is optimized for downloading and storing textures efficiently. It creates a UnityWebRequest and sets the target URL to the one specified as a string or uri object in the uri argument. No other flags or custom headers are set.
This method attaches a DownloadHandlerTexture object to the UnityWebRequest. DownloadHandlerTexture is a specialized DownloadHandler optimized for storing images that 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 is performed on a worker thread.
This method attaches no UploadHandler to the UnityWebRequest.
The texture is created as if it stores color data. Only JPG and PNG formats are supported.
Additional resources: TextureImporter.sRGBTexture.
Parameters
| Parameter | Description |
|---|---|
| uri | The URI of the image to download. |
| parameters | Parameters specifying various properties of texture that will be created. |
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.
Same as an overload with only uri parameter, except that it allows more control over the properties of texture that will be created. For example, using this overload you can disable creation of mipmaps or use linear color space.