Repository navigation
Metal tvOS xcode27.2 b3
Alex Soto edited this page Oct 17, 2026
·
1 revision
#Metal.framework
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4Archive.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4Archive.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4Archive.h 2026-08-15 22:12:43
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4Archive.h 2026-10-04 01:21:11
@@ -32,19 +32,15 @@
///
/// - ``newComputePipelineStateWithDescriptor:dynamicLinkingDescriptor:error:``
/// - ``newComputePipelineStateWithDescriptor:error:``
-/// - ``newComputePipelineStateWithName:dynamicLinkingDescriptor:error:``
-/// - ``newComputePipelineStateWithName:error:``
///
/// ### Creating render pipeline states
///
/// - ``newRenderPipelineStateWithDescriptor:dynamicLinkingDescriptor:error:``
/// - ``newRenderPipelineStateWithDescriptor:error:``
-/// - ``newRenderPipelineStateWithName:dynamicLinkingDescriptor:error:``
-/// - ``newRenderPipelineStateWithName:error:``
///
/// ### Creating binary functions
///
-/// - ``newBinaryFunctionWithDescriptor:functionType:error:``
+/// - ``newBinaryFunctionWithDescriptor:error:``
API_AVAILABLE(macos(26.0), ios(26.0)) NS_SWIFT_SENDABLE
@protocol MTL4Archive <NSObject>
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4CommandBuffer.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4CommandBuffer.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4CommandBuffer.h 2026-08-10 02:12:57
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4CommandBuffer.h 2026-10-04 01:21:10
@@ -58,7 +58,7 @@
///
/// Command allocators only service a single command buffer at a time. If you need to issue multiple
/// calls to this method simultaneously, for example, in a multi-threaded command encoding scenario,
-/// create multiple instances of ``MTLCommandAllocator`` and use one for each call.
+/// create multiple instances of ``MTL4CommandAllocator`` and use one for each call.
///
/// You can safely reuse command allocators after ending the command buffer using it by calling
/// ``endCommandBuffer``.
@@ -77,7 +77,7 @@
///
/// Command allocators only service a single command buffer at a time. If you need to issue multiple
/// calls to this method simultaneously, for example, in a multi-threaded command encoding scenario,
-/// create multiple instances of ``MTLCommandAllocator`` and use one for each call.
+/// create multiple instances of ``MTL4CommandAllocator`` and use one for each call.
///
/// You can safely reuse command allocators after ending the command buffer using it by calling
/// ``endCommandBuffer``.
@@ -95,11 +95,13 @@
- (void)beginCommandBufferWithAllocator:(id<MTL4CommandAllocator>)allocator
options:(MTL4CommandBufferOptions *)options;
-/// Closes a command buffer to prepare it for submission to a command queue.
+/// Finalizes a command buffer which makes it ready for you to submit it to a command queue.
///
-/// Explicitly ending the command buffer allows you to reuse the ``MTL4CommandAllocator`` to start servicing other
-/// command buffers. It is an error to call ``commit`` on a command buffer previously recording before calling this
-/// method.
+/// Metal generates an error if you submit a command buffer to a queue, such as with its
+/// ``MTL4CommandQueue/commit:count:`` method, before calling this method.
+///
+/// > Note: Ending a command buffer also marks its ``MTL4CommandAllocator`` as available
+/// for you to assign it to work with another command buffer.
- (void)endCommandBuffer;
/// Creates a render command encoder from a render pass descriptor.
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4PipelineDataSetSerializer.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4PipelineDataSetSerializer.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4PipelineDataSetSerializer.h 2026-08-15 22:12:42
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4PipelineDataSetSerializer.h 2026-10-04 03:15:43
@@ -22,14 +22,14 @@
typedef NS_OPTIONS(NSUInteger, MTL4PipelineDataSetSerializerConfiguration) {
/// Enables serializing pipeline scripts.
///
- /// Set this mask to use ``MTL4PipelineDataSetSerializer.serializeAsPipelinesScriptWithError``.
+ /// Set this mask to use ``MTL4PipelineDataSetSerializer/serializeAsPipelinesScriptWithError:``.
///
/// This for the default behavior.
MTL4PipelineDataSetSerializerConfigurationCaptureDescriptors = (1 << 0),
/// Enables serializing pipeline binary functions.
///
- /// Set this mask to use ``MTL4PipelineDataSetSerializer.serializeAsArchiveAndFlush(toURL:error:)``.
+ /// Set this mask to use ``MTL4PipelineDataSetSerializer/serializeAsArchiveAndFlushToURL:error:``.
MTL4PipelineDataSetSerializerConfigurationCaptureBinaries = (1 << 1),
} API_AVAILABLE(macos(26.0), ios(26.0));
@@ -42,11 +42,11 @@
///
/// The configuration of the serialization process determines the mechanisms you use to serialize pipeline data sets.
///
-/// When this configuration contains ``MTL4PipelineDataSetSerializerConfigurationCaptureDescriptors``, use
-/// ``serializeAsPipelinesScriptWithError:`` to serialize pipeline scripts.
+/// When this configuration contains ``MTL4PipelineDataSetSerializerConfiguration/MTL4PipelineDataSetSerializerConfigurationCaptureDescriptors``, use
+/// ``MTL4PipelineDataSetSerializer/serializeAsPipelinesScriptWithError:`` to serialize pipeline scripts.
///
-/// If this option contains ``MTL4PipelineDataSetSerializerConfigurationCaptureBinaries``, the serializer can additionally
-/// serialize to a binary archive by calling ``serializeAsArchiveAndFlushToURL:error::``.
+/// If this option contains ``MTL4PipelineDataSetSerializerConfiguration/MTL4PipelineDataSetSerializerConfigurationCaptureBinaries``, the serializer can additionally
+/// serialize to a binary archive by calling ``MTL4PipelineDataSetSerializer/serializeAsArchiveAndFlushToURL:error:``.
@property(readwrite, nonatomic) MTL4PipelineDataSetSerializerConfiguration configuration;
@end
@@ -54,7 +54,7 @@
/// A fast-addition container for collecting data during pipeline state creation.
///
/// Pipeline data serializer instances allow you to create binary archives and serialize pipeline scripts to use with
-/// the offline Metal binary generator (`metal-tt`) <doc:compiling-binary-archives-from-a-custom-configuration-script.md>.
+/// the offline Metal binary generator (`metal-tt`) <doc://com.apple.documentation/documentation/metal/compiling-binary-archives-from-a-custom-configuration-script>.
///
/// You capture and retain all relevant data for all pipelines a compiler instance creates by providing an instance of
/// this object to its ``MTL4CompilerDescriptor``.
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4RenderPass.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4RenderPass.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4RenderPass.h 2026-08-08 18:07:14
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4RenderPass.h 2026-09-12 00:28:07
@@ -52,7 +52,7 @@
/// For tile-based rendering, Metal divides each render attachment into smaller regions, or _tiles_.
/// The property's default is `0`, which tells Metal to select a size that fits in tile memory.
///
-/// See <doc:tailor-your-apps-for-apple-gpus-and-tile-based-deferred-rendering>
+/// See <doc://com.apple.documentation/documentation/metal/tailor-your-apps-for-apple-gpus-and-tile-based-deferred-rendering>
/// for more information about tiles, tile memory, and deferred rendering.
@property (nonatomic) NSUInteger tileWidth;
@@ -61,7 +61,7 @@
/// For tile-based rendering, Metal divides each render attachment into smaller regions, or _tiles_.
/// The property's default is `0`, which tells Metal to select a size that fits in tile memory.
///
-/// See <doc:tailor-your-apps-for-apple-gpus-and-tile-based-deferred-rendering>
+/// See <doc://com.apple.documentation/documentation/metal/tailor-your-apps-for-apple-gpus-and-tile-based-deferred-rendering>
/// for more information about tiles, tile memory, and deferred rendering.
@property (nonatomic) NSUInteger tileHeight;
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4RenderPipeline.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4RenderPipeline.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4RenderPipeline.h 2026-08-15 22:12:43
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTL4RenderPipeline.h 2026-10-04 03:15:44
@@ -33,8 +33,10 @@
/// Deduces the color attachment mapping by inheriting it from the color attachment map of the current encoder.
///
- /// Use this setting to indicate Metal should inherit the mapping from the ``colorAttachmentMap`` property of the current
- /// ``MTL4RenderCommandEncoder`` or ``MTLRenderCommandEncoder`` in use at draw time.
+ /// This setting instructs the pipeline state to inherit the color attachment map of the current
+ /// render encoder:
+ /// - For an ``MTL4RenderCommandEncoder``, call its ``MTL4RenderCommandEncoder/setColorAttachmentMap:`` method.
+ /// - For an ``MTLRenderCommandEncoder``, call its ``MTLRenderCommandEncoder/setColorAttachmentMap:`` method.
MTL4LogicalToPhysicalColorAttachmentMappingStateInherited = 1,
};
@@ -45,47 +47,47 @@
/// Configures the pixel format.
///
-/// This property defaults to ``MTLPixelFormatInvalid``.
+/// This property defaults to ``MTLPixelFormat/MTLPixelFormatInvalid``.
@property (nonatomic) MTLPixelFormat pixelFormat;
/// Configure the blend state for color attachments the pipeline state uses.
///
-/// This property's default value is ``MTL4BlendStateDisabled``.
+/// This property's default value is ``MTL4BlendState/MTL4BlendStateDisabled``.
@property (nonatomic) MTL4BlendState blendingState;
/// Configures the source RGB blend factor.
///
-/// This property defaults to ``MTLBlendFactorOne``.
+/// This property defaults to ``MTLBlendFactor/MTLBlendFactorOne``.
@property (nonatomic) MTLBlendFactor sourceRGBBlendFactor;
/// Configures the destination RGB blend factor.
///
-/// This property defaults to ``MTLBlendFactorZero``.
+/// This property defaults to ``MTLBlendFactor/MTLBlendFactorZero``.
@property (nonatomic) MTLBlendFactor destinationRGBBlendFactor;
/// Configures the RGB blend operation.
///
-/// This property defaults to ``MTLBlendOperationAdd``.
+/// This property defaults to ``MTLBlendOperation/MTLBlendOperationAdd``.
@property (nonatomic) MTLBlendOperation rgbBlendOperation;
/// Configures the source-alpha blend factor.
///
-/// This property defaults to ``MTLBlendFactorOne``.
+/// This property defaults to ``MTLBlendFactor/MTLBlendFactorOne``.
@property (nonatomic) MTLBlendFactor sourceAlphaBlendFactor;
/// Configures the destination-alpha blend factor.
///
-/// This property defaults to ``MTLBlendFactorZero``.
+/// This property defaults to ``MTLBlendFactor/MTLBlendFactorZero``.
@property (nonatomic) MTLBlendFactor destinationAlphaBlendFactor;
/// Configures the alpha blending operation.
///
-/// This property defaults to ``MTLBlendOperationAdd``.
+/// This property defaults to ``MTLBlendOperation/MTLBlendOperationAdd``.
@property (nonatomic) MTLBlendOperation alphaBlendOperation;
/// Configures the color write mask.
///
-/// This property defaults to ``MTLColorWriteMaskAll``.
+/// This property defaults to ``MTLColorWriteMask/MTLColorWriteMaskAll``.
@property (nonatomic) MTLColorWriteMask writeMask;
/// Resets this descriptor to its default state.
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLAllocation.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLAllocation.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLAllocation.h 2026-08-08 18:08:03
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLAllocation.h 2026-09-12 00:28:06
@@ -14,7 +14,7 @@
/// This protocol provides a common interface for adding Metal resources to ``MTLResidencySet`` instances. Call
/// ``MTLResidencySet/addAllocation:`` to add a Metal resource allocation to a residency set.
///
-/// <doc:simplifying-gpu-resource-management-with-residency-sets.md>
+/// <doc://com.apple.documentation/documentation/metal/simplifying-gpu-resource-management-with-residency-sets>
API_AVAILABLE(macos(15.0), ios(18.0))
@protocol MTLAllocation <NSObject>
@property (readonly) NSUInteger allocatedSize API_AVAILABLE(macos(15.0), ios(18.0));
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLComputeCommandEncoder.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLComputeCommandEncoder.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLComputeCommandEncoder.h 2026-08-08 18:25:13
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLComputeCommandEncoder.h 2026-10-04 01:21:10
@@ -300,13 +300,14 @@
*/
- (void)executeCommandsInBuffer:(id<MTLIndirectCommandBuffer>)indirectCommandBuffer withRange:(NSRange)executionRange API_AVAILABLE(macos(11.0), macCatalyst(14.0), ios(13.0));
-/*!
- * @method executeCommandsInBuffer:indirectBuffer:indirectBufferOffset:
- * @abstract Execute commands in the buffer within the range specified by the indirect range buffer.
- * @param indirectRangeBuffer An indirect buffer from which the device reads the execution range parameter, as laid out in the MTLIndirectCommandBufferExecutionRange structure.
- * @param indirectBufferOffset The byte offset within indirectBuffer where the execution range parameter is located. Must be a multiple of 4 bytes.
- * @discussion The same indirect command buffer may be executed any number of times within the same encoder.
- */
+/// Runs commands with an execution range that Metal reads from a buffer.
+///
+/// The same indirect command buffer can run any number of times within the same encoder.
+///
+/// - Parameters:
+/// - indirectCommandbuffer: The indirect command buffer containing the commands to run.
+/// - indirectRangeBuffer: An indirect buffer from which the device reads the execution range parameter, as laid out in the MTLIndirectCommandBufferExecutionRange structure.
+/// - indirectBufferOffset: The byte offset within indirectRangeBuffer where the execution range parameter is located. Must be a multiple of 4 bytes.
- (void)executeCommandsInBuffer:(id<MTLIndirectCommandBuffer>)indirectCommandbuffer indirectBuffer:(id<MTLBuffer>)indirectRangeBuffer indirectBufferOffset:(NSUInteger)indirectBufferOffset API_AVAILABLE(macos(11.0), macCatalyst(14.0), ios(13.0));
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLDevice.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLDevice.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLDevice.h 2026-08-08 18:07:11
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLDevice.h 2026-10-04 00:25:58
@@ -1267,10 +1267,13 @@
error:(NSError **)error API_AVAILABLE(macos(27.0), ios(27.0));
-/*!
- @method functionHandleWithFunction:
- @abstract Returns the function handle for a function that was compiled with MTLFunctionOptionPipelineIndependent and MTLFunctionOptionCompileToBinary.
- */
+/// Returns the handle for a function that you can add to a function table.
+///
+/// - Parameter function: A function that the Metal compiler created with both of the following settings:
+/// - ``MTLFunctionOptions/MTLFunctionOptionCompileToBinary``
+/// - ``MTLFunctionOptions/MTLFunctionOptionPipelineIndependent``
+///
+/// - Returns: A function handle if the method succeeds, otherwise `nil`.
- (nullable id<MTLFunctionHandle>)functionHandleWithFunction:(id<MTLFunction>)function API_AVAILABLE(macos(26.0), ios(26.0));
@@ -1439,12 +1442,12 @@
- (uint64_t)queryTimestampFrequency
API_AVAILABLE(macos(26.0), ios(26.0));
-/// Get the function handle for the specified binary-linked function from the pipeline state.
+/// Returns the handle for a binary function from a pipeline state.
///
-/// - Parameters:
-/// - function: A ``MTL4BinaryFunction`` instance representing the function binary.
+/// - Parameter function: A function that the Metal compiler created with the
+/// ``MTLFunctionOptions/MTLFunctionOptionPipelineIndependent`` setting.
///
-/// - Returns: A ``MTLFunctionHandle`` instance for a binary function that was compiled with ``MTLFunctionOptionPipelineIndependent``, otherwise `nil`.
+/// - Returns: A function handle if the method succeeds, otherwise `nil`.
- (nullable id<MTLFunctionHandle>)functionHandleWithBinaryFunction:(id<MTL4BinaryFunction>)function
API_AVAILABLE(macos(26.0), ios(26.0));
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLRenderCommandEncoder.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLRenderCommandEncoder.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLRenderCommandEncoder.h 2026-08-15 22:12:43
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLRenderCommandEncoder.h 2026-10-04 01:21:11
@@ -1018,13 +1018,14 @@
*/
- (void)executeCommandsInBuffer:(id<MTLIndirectCommandBuffer>)indirectCommandBuffer withRange:(NSRange)executionRange API_AVAILABLE(macos(10.14), ios(12.0));
-/*!
- * @method executeCommandsInBuffer:indirectBuffer:indirectBufferOffset:
- * @abstract Execute commands in the buffer within the range specified by the indirect range buffer.
- * @param indirectRangeBuffer An indirect buffer from which the device reads the execution range parameter, as laid out in the MTLIndirectCommandBufferExecutionRange structure.
- * @param indirectBufferOffset The byte offset within indirectBuffer where the execution range parameter is located. Must be a multiple of 4 bytes.
- * @discussion The same indirect command buffer may be executed any number of times within the same encoder.
- */
+/// Runs commands with an execution range that Metal reads from a buffer.
+///
+/// The same indirect command buffer can run any number of times within the same encoder.
+///
+/// - Parameters:
+/// - indirectCommandbuffer: The indirect command buffer containing the commands to run.
+/// - indirectRangeBuffer: An indirect buffer from which the device reads the execution range parameter, as laid out in the MTLIndirectCommandBufferExecutionRange structure.
+/// - indirectBufferOffset: The byte offset within indirectRangeBuffer where the execution range parameter is located. Must be a multiple of 4 bytes.
- (void)executeCommandsInBuffer:(id<MTLIndirectCommandBuffer>)indirectCommandbuffer indirectBuffer:(id<MTLBuffer>)indirectRangeBuffer indirectBufferOffset:(NSUInteger)indirectBufferOffset API_AVAILABLE(macos(10.14), macCatalyst(13.0), ios(13.0));
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLRenderPass.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLRenderPass.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLRenderPass.h 2026-08-08 18:07:14
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLRenderPass.h 2026-10-04 01:21:12
@@ -49,11 +49,11 @@
MTLStoreActionOptionCustomSamplePositions = 1 << 0,
} API_DEPRECATED("Store action options have no effect on Apple Silicon", macos(10.13, 27.0), ios(11.0, 27.0));
-/// This enumeration controls if Metal accumulates visibility results between render encoders or resets them.
+/// Actions for visibility results between render passes.
///
-/// You can specify this property for ``MTLRenderCommandEncoders`` and for ``MTL4RenderCommandEncoders`` through
-/// their descriptors' ``MTLRenderCommandEncoder/visibilityResultType`` and ``MTL4RenderCommandEncoder/visibilityResultType``
-/// methods.
+/// You can apply a visibility result action to either kind of render command encoder:
+/// - For an ``MTL4RenderCommandEncoder``, set the ``MTL4RenderPassDescriptor/visibilityResultType`` property of an ``MTL4RenderPassDescriptor`` instance.
+/// - For an ``MTLRenderCommandEncoder``, set the ``MTLRenderPassDescriptor/visibilityResultType`` property of an ``MTLRenderPassDescriptor`` instance.
typedef NS_ENUM(NSInteger, MTLVisibilityResultType)
{
/// Reset visibility result data when you create a render command encoder.
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLSampler.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLSampler.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLSampler.h 2026-08-08 18:07:15
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLSampler.h 2026-10-04 01:55:15
@@ -160,12 +160,12 @@
/// Sets the reduction mode for filtering contributing samples.
///
-/// The property's default value is ``MTLSamplerReductionModeWeightedAverage``.
+/// The property's default value is ``MTLSamplerReductionMode/MTLSamplerReductionModeWeightedAverage``.
/// The sampler ignores this property if any of the following property values are equal to a specific value:
-/// - The sampler's ``mipFilter`` property is equal to ``MTLSamplerMipFilterNotMipmapped``.
-/// - The sampler's ``mipFilter`` property is equal to ``MTLSamplerMipFilterNearest``.
-/// - The sampler's ``minFilter`` property is equal to ``MTLSamplerMinMagFilterNearest``.
-/// - The sampler's ``magFilter`` property is equal to ``MTLSamplerMinMagFilterNearest``.
+/// - The sampler's ``mipFilter`` property is equal to ``MTLSamplerMipFilter/MTLSamplerMipFilterNotMipmapped``.
+/// - The sampler's ``mipFilter`` property is equal to ``MTLSamplerMipFilter/MTLSamplerMipFilterNearest``.
+/// - The sampler's ``minFilter`` property is equal to ``MTLSamplerMinMagFilter/MTLSamplerMinMagFilterNearest``.
+/// - The sampler's ``magFilter`` property is equal to ``MTLSamplerMinMagFilter/MTLSamplerMinMagFilterNearest``.
@property (nonatomic) MTLSamplerReductionMode reductionMode API_AVAILABLE(macos(26.0), ios(26.0));
/*!