class in UnityEngine.Rendering
/
Implemented in:UnityEngine.CoreModule
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.
CloseFor 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.
CloseRepresents 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.
| active | Currently active graphics texture. |
| descriptor | Contains all the information Unity uses to create a GraphicsTexture. |
| state | The current state of a GraphicsTexture. |