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.
CloseIntPtr Pointer to an underlying graphics API texture resource.
Retrieve a native (underlying graphics API) pointer to the texture resource.
Use this function to retrieve a pointer/handle corresponding to a particular texture
as it is represented on the native graphics API level.
This can be used to enable texture manipulation from native code plugins.
Note: When you use the Unity APIs to modify the pixel data of a Texture object, it changes the underlying graphics API native pointer. Call GetNativeTexturePtr to get the new native pointer.
For specific platforms, Unity has the following specifications:
IDirect3DBaseTexture9
on D3D9, ID3D11Resource
on D3D11, ID3D12Resource
on D3D12).id<MTLTexture>
pointer.VkImage
pointer.Note that calling this function when using multi-threaded rendering will synchronize with the rendering
thread (a slow operation), so best practice is to set up needed texture pointers only at initialization
time.
See Also: Native code plugins, Texture2D.CreateExternalTexture, Cubemap.CreateExternalTexture, RenderTexture.GetNativeDepthBufferPtr.