An encoder that writes GPU commands into a command buffer.
- iOS 8.0+
- macOS 10.11+
- Mac Catalyst 13.0+
- tvOS 9.0+
Don't implement this protocol yourself; instead you call methods on a
MTLCommand object to create command encoders. Command encoder objects are lightweight objects that you re-create every time you need to send commands to the GPU.
There are many different kinds of command encoders, each providing a different set of commands that can be encoded into the buffer. A command encoder implements the
MTLCommand protocol and an additional protocol specific to the kind of encoder being created. Table 1 lists command encoders and the protocols they implement.
While a command encoder is active, it has the exclusive right to append commands to its command buffer. Once you finish encoding commands, call the
end method to finish encoding the commands. To write further commands into the same command buffer, create a new command encoder.
You can call the
pop methods to put debug strings into the command buffer and to push or pop string labels used to identify groups of encoded commands. These methods don't change the rendering or compute behavior of your app; the Xcode debugger uses them to organize your app’s rendering commands in a format that may provide insight into how your app works.