SDL_Metal_CreateView

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

Header File

Defined in <SDL3/SDL_metal.h>

Syntax

SDL_MetalView SDL_Metal_CreateView(SDL_Window *window);

Function Parameters

Return Value

(SDL_MetalView) Returns handle NSView or UIView.

Remarks

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().

Version

This function is available since SDL 3.2.0.

See Also

• SDL_Metal_DestroyView
• SDL_Metal_GetLayer

CategoryAPI, CategoryAPIFunction, CategoryMetal