Metal iOS 12.4 to 13.0 API Differences

MTLArgument.h

Added MTLDataTypeRenderPipeline

Added MTLDataTypeComputePipeline

MTLArgumentEncoder.h

Added -[MTLArgumentEncoder setRenderPipelineState:atIndex:]

Added -[MTLArgumentEncoder setRenderPipelineStates:withRange:]

Added -[MTLArgumentEncoder setComputePipelineState:atIndex:]

Added -[MTLArgumentEncoder setComputePipelineStates:withRange:]

MTLBlitCommandEncoder.h

Added -[MTLBlitCommandEncoder copyFromTexture:sourceSlice:sourceLevel:toTexture:destinationSlice:destinationLevel:sliceCount:levelCount:]

Added -[MTLBlitCommandEncoder copyFromTexture:toTexture:]

Added -[MTLBlitCommandEncoder getTextureAccessCounters:region:mipLevel:slice:resetCounters:countersBuffer:countersBufferOffset:]

Added -[MTLBlitCommandEncoder resetTextureAccessCounters:region:mipLevel:slice:]

MTLCaptureManager.h

Added MTLCaptureErrorDomain

Added MTLCaptureError

Added MTLCaptureErrorNotSupported

Added MTLCaptureErrorAlreadyCapturing

Added MTLCaptureErrorInvalidDescriptor

Added MTLCaptureDestination

Added MTLCaptureDestinationDeveloperTools

Added MTLCaptureDestinationGPUTraceDocument

Added MTLCaptureDescriptor

Added MTLCaptureDescriptor.captureObject

Added MTLCaptureDescriptor.destination

Added MTLCaptureDescriptor.outputURL

Added -[MTLCaptureManager supportsDestination:]

Added -[MTLCaptureManager startCaptureWithDescriptor:error:]

Modified -[MTLCaptureManager startCaptureWithDevice:]

	Availability	Deprecation Message
From	Available	none
To	Deprecated	Use startCaptureWithDescriptor:error: instead

Modified -[MTLCaptureManager startCaptureWithCommandQueue:]

	Availability	Deprecation Message
From	Available	none
To	Deprecated	Use startCaptureWithDescriptor:error: instead

Modified -[MTLCaptureManager startCaptureWithScope:]

	Availability	Deprecation Message
From	Available	none
To	Deprecated	Use startCaptureWithDescriptor:error: instead

MTLCommandBuffer.h

Added -[MTLCommandBuffer resourceStateCommandEncoder]

Modified MTLCommandBufferErrorDomain

	Declaration
From	NSString *const MTLCommandBufferErrorDomain
To	const NSErrorDomain MTLCommandBufferErrorDomain

MTLComputeCommandEncoder.h

Added -[MTLComputeCommandEncoder executeCommandsInBuffer:withRange:]

Added -[MTLComputeCommandEncoder executeCommandsInBuffer:indirectBuffer:indirectBufferOffset:]

MTLComputePipeline.h

Added MTLComputePipelineDescriptor.supportIndirectCommandBuffers

Added MTLComputePipelineState.supportIndirectCommandBuffers

MTLDevice.h

Added MTLGPUFamily

Added MTLGPUFamilyApple1

Added MTLGPUFamilyApple2

Added MTLGPUFamilyApple3

Added MTLGPUFamilyApple4

Added MTLGPUFamilyApple5

Added MTLGPUFamilyApple6

Added MTLGPUFamilyMac1

Added MTLGPUFamilyMac2

Added MTLGPUFamilyCommon1

Added MTLGPUFamilyCommon2

Added MTLGPUFamilyCommon3

Added MTLGPUFamilyiOSMac1

Added MTLGPUFamilyiOSMac2

Added MTLSparseTextureRegionAlignmentMode

Added MTLSparseTextureRegionAlignmentModeOutward

Added MTLSparseTextureRegionAlignmentModeInward

Added MTLDevice.hasUnifiedMemory

Added -[MTLDevice newSharedTextureWithDescriptor:]

Added -[MTLDevice newSharedTextureWithHandle:]

Added -[MTLDevice supportsFamily:]

Added -[MTLDevice supportsRasterizationRateMapWithLayerCount:]

Added -[MTLDevice newRasterizationRateMapWithDescriptor:]

Added -[MTLDevice sparseTileSizeWithTextureType:pixelFormat:sampleCount:]

Added MTLDevice.sparseTileSizeInBytes

Added -[MTLDevice convertSparsePixelRegions:toTileRegions:withTileSize:alignmentMode:numRegions:]

Added -[MTLDevice convertSparseTileRegions:toPixelRegions:withTileSize:numRegions:]

Added -[MTLDevice supportsVertexAmplificationCount:]

MTLHeap.h

Added MTLHeapType

Added MTLHeapTypeAutomatic

Added MTLHeapTypePlacement

Added MTLHeapTypeSparse

Added MTLHeapDescriptor.hazardTrackingMode

Added MTLHeapDescriptor.resourceOptions

Added MTLHeapDescriptor.type

Added MTLHeap.hazardTrackingMode

Added MTLHeap.resourceOptions

Added MTLHeap.type

Added -[MTLHeap newBufferWithLength:options:offset:]

Added -[MTLHeap newTextureWithDescriptor:offset:]

MTLIndirectCommandBuffer.h

Added MTLIndirectCommandTypeConcurrentDispatch

Added MTLIndirectCommandTypeConcurrentDispatchThreads

Added MTLIndirectCommandBufferExecutionRange

Added MTLIndirectCommandBufferExecutionRangeMake()

Added MTLIndirectCommandBufferDescriptor.inheritPipelineState

Added MTLIndirectCommandBufferDescriptor.maxKernelBufferBindCount

Added -[MTLIndirectCommandBuffer indirectComputeCommandAtIndex:]

MTLIndirectCommandEncoder.h

Added -[MTLIndirectRenderCommand setRenderPipelineState:]

Added MTLIndirectComputeCommand

Added -[MTLIndirectComputeCommand setComputePipelineState:]

Added -[MTLIndirectComputeCommand setKernelBuffer:offset:atIndex:]

Added -[MTLIndirectComputeCommand concurrentDispatchThreadgroups:threadsPerThreadgroup:]

Added -[MTLIndirectComputeCommand concurrentDispatchThreads:threadsPerThreadgroup:]

Added -[MTLIndirectComputeCommand setBarrier]

Added -[MTLIndirectComputeCommand clearBarrier]

Added -[MTLIndirectComputeCommand reset]

Added -[MTLIndirectComputeCommand setThreadgroupMemoryLength:atIndex:]

Added -[MTLIndirectComputeCommand setStageInRegion:]

MTLLibrary.h

Added MTLLanguageVersion2_2

Modified MTLLibraryErrorDomain

	Declaration
From	NSString *const MTLLibraryErrorDomain
To	const NSErrorDomain MTLLibraryErrorDomain

Modified -[MTLLibrary newFunctionWithName:constantValues:completionHandler:]

	Declaration
From	- (void)newFunctionWithName:(NSString )name constantValues:(MTLFunctionConstantValues )constantValues completionHandler:(void (^)(id<MTLFunction> _Nullable, NSError * _Nonnull))completionHandler
To	- (void)newFunctionWithName:(NSString )name constantValues:(MTLFunctionConstantValues )constantValues completionHandler:(void (^)(id<MTLFunction> _Nullable, NSError * _Nullable))completionHandler

MTLPixelFormat.h

Added MTLPixelFormatASTC_4x4_HDR

Added MTLPixelFormatASTC_5x4_HDR

Added MTLPixelFormatASTC_5x5_HDR

Added MTLPixelFormatASTC_6x5_HDR

Added MTLPixelFormatASTC_6x6_HDR

Added MTLPixelFormatASTC_8x5_HDR

Added MTLPixelFormatASTC_8x6_HDR

Added MTLPixelFormatASTC_8x8_HDR

Added MTLPixelFormatASTC_10x5_HDR

Added MTLPixelFormatASTC_10x6_HDR

Added MTLPixelFormatASTC_10x8_HDR

Added MTLPixelFormatASTC_10x10_HDR

Added MTLPixelFormatASTC_12x10_HDR

Added MTLPixelFormatASTC_12x12_HDR

Added MTLPixelFormatDepth16Unorm

MTLRasterizationRate.h

Added MTLRasterizationRateSampleArray

Added -[MTLRasterizationRateSampleArray objectAtIndexedSubscript:]

Added -[MTLRasterizationRateSampleArray setObject:atIndexedSubscript:]

Added MTLRasterizationRateLayerDescriptor

Added -[MTLRasterizationRateLayerDescriptor initWithSampleCount:]

Added -[MTLRasterizationRateLayerDescriptor initWithSampleCount:horizontal:vertical:]

Added MTLRasterizationRateLayerDescriptor.sampleCount

Added MTLRasterizationRateLayerDescriptor.horizontalSampleStorage

Added MTLRasterizationRateLayerDescriptor.verticalSampleStorage

Added MTLRasterizationRateLayerDescriptor.horizontal

Added MTLRasterizationRateLayerDescriptor.vertical

Added MTLRasterizationRateLayerArray

Added -[MTLRasterizationRateLayerArray objectAtIndexedSubscript:]

Added -[MTLRasterizationRateLayerArray setObject:atIndexedSubscript:]

Added MTLRasterizationRateMapDescriptor

Added +[MTLRasterizationRateMapDescriptor rasterizationRateMapDescriptorWithScreenSize:]

Added +[MTLRasterizationRateMapDescriptor rasterizationRateMapDescriptorWithScreenSize:layer:]

Added +[MTLRasterizationRateMapDescriptor rasterizationRateMapDescriptorWithScreenSize:layerCount:layers:]

Added -[MTLRasterizationRateMapDescriptor layerAtIndex:]

Added -[MTLRasterizationRateMapDescriptor setLayer:atIndex:]

Added MTLRasterizationRateMapDescriptor.layers

Added MTLRasterizationRateMapDescriptor.screenSize

Added MTLRasterizationRateMapDescriptor.label

Added MTLRasterizationRateMapDescriptor.layerCount

Added MTLRasterizationRateMap

Added MTLRasterizationRateMap.device

Added MTLRasterizationRateMap.label

Added MTLRasterizationRateMap.screenSize

Added MTLRasterizationRateMap.physicalGranularity

Added MTLRasterizationRateMap.layerCount

Added MTLRasterizationRateMap.parameterBufferSizeAndAlign

Added -[MTLRasterizationRateMap copyParameterDataToBuffer:offset:]

Added -[MTLRasterizationRateMap physicalSizeForLayer:]

Added -[MTLRasterizationRateMap mapScreenToPhysicalCoordinates:forLayer:]

Added -[MTLRasterizationRateMap mapPhysicalToScreenCoordinates:forLayer:]

MTLRenderCommandEncoder.h

Added MTLVertexAmplificationViewMapping

Added -[MTLRenderCommandEncoder setVertexAmplificationCount:viewMappings:]

Added -[MTLRenderCommandEncoder useResource:usage:stages:]

Added -[MTLRenderCommandEncoder useResources:count:usage:stages:]

Added -[MTLRenderCommandEncoder useHeap:stages:]

Added -[MTLRenderCommandEncoder useHeaps:count:stages:]

Added -[MTLRenderCommandEncoder executeCommandsInBuffer:indirectBuffer:indirectBufferOffset:]

MTLRenderPass.h

Added MTLRenderPassDescriptor.rasterizationRateMap

MTLRenderPipeline.h

Added MTLRenderPipelineDescriptor.maxVertexAmplificationCount

MTLResource.h

Added MTLHazardTrackingMode

Added MTLHazardTrackingModeDefault

Added MTLHazardTrackingModeUntracked

Added MTLHazardTrackingModeTracked

Added MTLResourceHazardTrackingModeDefault

Added MTLResourceHazardTrackingModeTracked

Added MTLResource.hazardTrackingMode

Added MTLResource.resourceOptions

Added MTLResource.heapOffset

MTLResourceStateCommandEncoder.h

Added MTLSparseTextureMappingMode

Added MTLSparseTextureMappingModeMap

Added MTLSparseTextureMappingModeUnmap

Added MTLMapIndirectArguments

Added MTLResourceStateCommandEncoder

Added -[MTLResourceStateCommandEncoder updateTextureMappings:mode:regions:mipLevels:slices:numRegions:]

Added -[MTLResourceStateCommandEncoder updateTextureMapping:mode:region:mipLevel:slice:]

Added -[MTLResourceStateCommandEncoder updateTextureMapping:mode:indirectBuffer:indirectBufferOffset:]

Added -[MTLResourceStateCommandEncoder updateFence:]

Added -[MTLResourceStateCommandEncoder waitForFence:]

MTLTexture.h

Added MTLTextureSwizzle

Added MTLTextureSwizzleZero

Added MTLTextureSwizzleOne

Added MTLTextureSwizzleRed

Added MTLTextureSwizzleGreen

Added MTLTextureSwizzleBlue

Added MTLTextureSwizzleAlpha

Added MTLTextureSwizzleChannels

Added MTLTextureSwizzleChannelsMake()

Added #def MTLTextureSwizzleChannelsDefault

Added MTLSharedTextureHandle

Added MTLSharedTextureHandle.device

Added MTLSharedTextureHandle.label

Added MTLTextureDescriptor.hazardTrackingMode

Added MTLTextureDescriptor.swizzle

Added MTLTexture.shareable

Added MTLTexture.firstMipmapInTail

Added MTLTexture.tailSizeInBytes

Added MTLTexture.isSparse

Added -[MTLTexture newSharedTextureHandle]

Added MTLTexture.swizzle

Added -[MTLTexture newTextureViewWithPixelFormat:textureType:levels:slices:swizzle:]

MTLTypes.h

Added MTLCoordinate2D

Added MTLCoordinate2DMake()