LanguageEnglish
  • C#
  • JS

Script language

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

Texture.GetNativeTexturePtr

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

Sumbission failed

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

Close

Cancel

public function GetNativeTexturePtr(): IntPtr;
public IntPtr GetNativeTexturePtr();

Description

Retrieve native ('hardware') pointer to a texture.

Use this function to retrieve a pointer/handle corresponding to a particular texture as it is represented on the native graphics device level. This can be used to enable texture manipulation from native code plugins.

On Direct3D-like devices this returns a pointer to the base texture type (IDirect3DBaseTexture9 on D3D9, ID3D11Resource on D3D11). On OpenGL-like devices the GL texture "name" is returned; cast the pointer to integer type to get it. On Metal, the id<MTLTexture> pointer is returned. On platforms that do not support native code plugins, this function always returns NULL.

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.