(This is the legacy documentation for stable SDL2, the current stable version; SDL3 is the current development version.)

SDL_RenderGetMetalLayer

Get the CAMetalLayer associated with the given Metal renderer.

Header File

Defined in SDL_render.h

Syntax

void* SDL_RenderGetMetalLayer(SDL_Renderer * renderer);

Function Parameters

Return Value

Returns a CAMetalLayer * on success, or NULL if the renderer isn't a Metal renderer

Remarks

This function returns void *, so SDL doesn't have to include Metal's headers, but it can be safely cast to a CAMetalLayer *.

Version

This function is available since SDL 2.0.8.

See Also

• SDL_RenderGetMetalCommandEncoder

CategoryAPI, CategoryAPIFunction, CategoryRender