Version: Unity 6 (6000.0)
LanguageEnglish
  • C#

GraphicsTexture

class in UnityEngine.Rendering

/

Implemented in:UnityEngine.CoreModule

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

Description

Represents the view on a single texture resource that is uploaded to the graphics device.

A GraphicsTexture specifically represents the actual resource that a Texture object uploads to the GPU. A Texture may create several different GraphicsTextures in its lifetime (such as to represent different mipmap levels or the color and depth buffers in a RenderTexture) and will recreate GraphicsTextures when certain changes are made to the Texture (such as resizing). Use Texture.graphicsTexture to get a Texture's current GraphicsTexture.

GraphicsTextures are useful for getting the current uploaded state of a texture on the graphics device. GraphicsTextureDescriptor.mipCount represents only the uploaded mipmap levels when using texture streaming or mipmap limit settings. Consequently, GraphicsTextureDescriptor.width and GraphicsTextureDescriptor.height represent the width and height of the maximum uploaded mipmap level.

GraphicsTextures are purely run-time objects and cannot be saved as assets.

To use a GraphicsTexture as a render target, it must have GraphicsTextureDescriptorFlags.RenderTarget enabled in its GraphicsTextureDescriptor.flags.

Additional resources: Texture.graphicsTexture, Graphics.SetRenderTarget.

Static Properties

activeCurrently active graphics texture.

Properties

descriptorContains all the information Unity uses to create a GraphicsTexture.
stateThe current state of a GraphicsTexture.