NAME¶

SDL_Metal_CreateView - Create a CAMetalLayer-backed NSView/UIView and attach it to the specified window.

SYNOPSIS¶

#include <SDL3/SDL_metal.h>

SDL_MetalView SDL_Metal_CreateView(SDL_Window *window);

DESCRIPTION¶

On macOS, this does not associate a MTLDevice with the CAMetalLayer on its own. It is up to user code to do that.

The returned handle can be casted directly to a NSView or UIView. To access the backing CAMetalLayer, call SDL_Metal_GetLayer().

FUNCTION PARAMETERS¶

window

the window.

RETURN VALUE¶

Returns handle NSView or UIView.

THREAD SAFETY¶

This function should only be called on the main thread.

AVAILABILITY¶

This function is available since SDL 3.2.0.

SEE ALSO¶

SDL_Metal_DestroyView(3), SDL_Metal_GetLayer(3)