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)