A Boolean value that determines whether the view presents its content using a Core Animation transaction.
- iOS 9.0+
- macOS 10.11+
- Mac Catalyst 13.0+
- tvOS 9.0+
By default this value is
MTKView displays the output of a rendering pass to the display as quickly as possible and asynchronously to any Core Animation transactions. However, if your game or app combines Metal and Core Animation content, it's not guaranteed that your Metal content will arrive in the same frame as your Core Animation content. This could be an issue if, for example, your app draws UIKit content (such as labels with a target position and time) over the top of your
MTKView and the two domains need to be synchronized.
Setting this value to
YES changes this default behavior so that your
MTKView displays its drawable content synchronously, using whichever Core Animation transaction is current at the time the drawable’s
present method is called.
However, if you allow Metal to choose when to call the present method (by using the
present method of a command buffer), the transaction during which you scheduled presentation might end before the drawable is ready to be presented. To avoid this situation, commit the command buffer and call its
wait method to synchronously wait until the drawable is ready, then call the drawable’s
present method directly.