Metal iOS 10.3 to 11.0 API Differences

	Declaration
From	- (nonnull id<MTLTexture>)newTextureWithDescriptor:(nonnull MTLTextureDescriptor *)descriptor offset:(NSUInteger)offset bytesPerRow:(NSUInteger)bytesPerRow
To	- (nullable id<MTLTexture>)newTextureWithDescriptor:(nonnull MTLTextureDescriptor *)descriptor offset:(NSUInteger)offset bytesPerRow:(NSUInteger)bytesPerRow

MTLCaptureManager.h

Added MTLCaptureManager

Added +[MTLCaptureManager sharedCaptureManager]

Added -[MTLCaptureManager newCaptureScopeWithDevice:]

Added -[MTLCaptureManager newCaptureScopeWithCommandQueue:]

Added -[MTLCaptureManager startCaptureWithDevice:]

Added -[MTLCaptureManager startCaptureWithCommandQueue:]

Added -[MTLCaptureManager startCaptureWithScope:]

Added -[MTLCaptureManager stopCapture]

Added MTLCaptureManager.defaultCaptureScope

Added MTLCaptureManager.isCapturing

MTLCaptureScope.h

Added MTLCaptureScope

Added -[MTLCaptureScope beginScope]

Added -[MTLCaptureScope endScope]

Added MTLCaptureScope.label

Added MTLCaptureScope.device

Added MTLCaptureScope.commandQueue

MTLCommandBuffer.h

Added -[MTLCommandBuffer pushDebugGroup:]

Added -[MTLCommandBuffer popDebugGroup]

Modified -[MTLCommandBuffer blitCommandEncoder]

	Declaration
From	- (nonnull id<MTLBlitCommandEncoder>)blitCommandEncoder
To	- (nullable id<MTLBlitCommandEncoder>)blitCommandEncoder

Modified -[MTLCommandBuffer renderCommandEncoderWithDescriptor:]

	Declaration
From	- (nonnull id<MTLRenderCommandEncoder>)renderCommandEncoderWithDescriptor:(nonnull MTLRenderPassDescriptor *)renderPassDescriptor
To	- (nullable id<MTLRenderCommandEncoder>)renderCommandEncoderWithDescriptor:(nonnull MTLRenderPassDescriptor *)renderPassDescriptor

Modified -[MTLCommandBuffer computeCommandEncoder]

	Declaration
From	- (nonnull id<MTLComputeCommandEncoder>)computeCommandEncoder
To	- (nullable id<MTLComputeCommandEncoder>)computeCommandEncoder

Modified -[MTLCommandBuffer parallelRenderCommandEncoderWithDescriptor:]

	Declaration
From	- (nonnull id<MTLParallelRenderCommandEncoder>)parallelRenderCommandEncoderWithDescriptor:(nonnull MTLRenderPassDescriptor *)renderPassDescriptor
To	- (nullable id<MTLParallelRenderCommandEncoder>)parallelRenderCommandEncoderWithDescriptor:(nonnull MTLRenderPassDescriptor *)renderPassDescriptor

MTLCommandEncoder.h

Added MTLResourceUsage

Added MTLResourceUsageRead

Added MTLResourceUsageWrite

Added MTLResourceUsageSample

MTLCommandQueue.h

Modified -[MTLCommandQueue commandBuffer]

	Declaration
From	- (nonnull id<MTLCommandBuffer>)commandBuffer
To	- (nullable id<MTLCommandBuffer>)commandBuffer

Modified -[MTLCommandQueue commandBufferWithUnretainedReferences]

	Declaration
From	- (nonnull id<MTLCommandBuffer>)commandBufferWithUnretainedReferences
To	- (nullable id<MTLCommandBuffer>)commandBufferWithUnretainedReferences

Modified -[MTLCommandQueue insertDebugCaptureBoundary]

	Availability	Deprecation Message
From	Available	none
To	Deprecated	Use MTLCaptureScope instead

MTLComputeCommandEncoder.h

Added -[MTLComputeCommandEncoder setImageblockWidth:height:]

Added -[MTLComputeCommandEncoder dispatchThreads:threadsPerThreadgroup:]

Added -[MTLComputeCommandEncoder useResource:usage:]

Added -[MTLComputeCommandEncoder useResources:count:usage:]

Added -[MTLComputeCommandEncoder useHeap:]

Added -[MTLComputeCommandEncoder useHeaps:count:]

Modified -[MTLComputeCommandEncoder setBuffers:offsets:withRange:]

	Declaration
From	- (void)setBuffers:(id<MTLBuffer> _Nullable const [])buffers offsets:(const NSUInteger [])offsets withRange:(NSRange)range
To	- (void)setBuffers:(nonnull id<MTLBuffer> _Nullable const [])buffers offsets:(nonnull const NSUInteger [])offsets withRange:(NSRange)range

Modified -[MTLComputeCommandEncoder setTextures:withRange:]

	Declaration
From	- (void)setTextures:(nullable id<MTLTexture> _Nullable const [])textures withRange:(NSRange)range
To	- (void)setTextures:(nonnull id<MTLTexture> _Nullable const [])textures withRange:(NSRange)range

Modified -[MTLComputeCommandEncoder setSamplerStates:withRange:]

	Declaration
From	- (void)setSamplerStates:(nullable id<MTLSamplerState> _Nullable const [])samplers withRange:(NSRange)range
To	- (void)setSamplerStates:(nonnull id<MTLSamplerState> _Nullable const [])samplers withRange:(NSRange)range

Modified -[MTLComputeCommandEncoder setSamplerStates:lodMinClamps:lodMaxClamps:withRange:]

	Declaration
From	- (void)setSamplerStates:(nullable id<MTLSamplerState> _Nullable const [])samplers lodMinClamps:(nullable const float [])lodMinClamps lodMaxClamps:(nullable const float [])lodMaxClamps withRange:(NSRange)range
To	- (void)setSamplerStates:(nonnull id<MTLSamplerState> _Nullable const [])samplers lodMinClamps:(nonnull const float [])lodMinClamps lodMaxClamps:(nonnull const float [])lodMaxClamps withRange:(NSRange)range

MTLComputePipeline.h

Added MTLComputePipelineDescriptor.buffers

Added MTLComputePipelineState.label

Added MTLComputePipelineState.staticThreadgroupMemoryLength

Added -[MTLComputePipelineState imageblockMemoryLengthForDimensions:]

MTLDevice.h

Removed #def MTLFeatureSet_TVOS_GPUFamily1_v1

Added MTLFeatureSet_iOS_GPUFamily1_v4

Added MTLFeatureSet_iOS_GPUFamily2_v4

Added MTLFeatureSet_iOS_GPUFamily3_v3

Added MTLFeatureSet_iOS_GPUFamily4_v1

Added MTLReadWriteTextureTier

Added MTLReadWriteTextureTierNone

Added MTLReadWriteTextureTier1

Added MTLReadWriteTextureTier2

Added MTLArgumentBuffersTier

Added MTLArgumentBuffersTier1

Added MTLArgumentBuffersTier2

Added MTLArgumentDescriptor

Added +[MTLArgumentDescriptor argumentDescriptor]

Added MTLArgumentDescriptor.dataType

Added MTLArgumentDescriptor.index

Added MTLArgumentDescriptor.arrayLength

Added MTLArgumentDescriptor.access

Added MTLArgumentDescriptor.textureType

Added MTLArgumentDescriptor.constantBlockAlignment

Added MTLDevice.registryID

Added MTLDevice.readWriteTextureSupport

Added MTLDevice.argumentBuffersSupport

Added MTLDevice.rasterOrderGroupsSupported

Added MTLDevice.currentAllocatedSize

Added -[MTLDevice newTextureWithDescriptor:iosurface:plane:]

Added -[MTLDevice newLibraryWithURL:error:]

Added -[MTLDevice minimumLinearTextureAlignmentForPixelFormat:]

Added -[MTLDevice newRenderPipelineStateWithTileDescriptor:options:reflection:error:]

Added -[MTLDevice newRenderPipelineStateWithTileDescriptor:options:completionHandler:]

Added MTLDevice.maxThreadgroupMemoryLength

Added MTLDevice.programmableSamplePositionsSupported

Added -[MTLDevice getDefaultSamplePositions:count:]

Added -[MTLDevice newArgumentEncoderWithArguments:]

Modified MTLDevice.name

	Declaration
From	@property (readonly, nullable) NSString *name
To	@property (readonly, nonnull) NSString *name

Modified -[MTLDevice newCommandQueue]

	Declaration
From	- (nonnull id<MTLCommandQueue>)newCommandQueue
To	- (nullable id<MTLCommandQueue>)newCommandQueue

Modified -[MTLDevice newCommandQueueWithMaxCommandBufferCount:]

	Declaration
From	- (nonnull id<MTLCommandQueue>)newCommandQueueWithMaxCommandBufferCount:(NSUInteger)maxCommandBufferCount
To	- (nullable id<MTLCommandQueue>)newCommandQueueWithMaxCommandBufferCount:(NSUInteger)maxCommandBufferCount

Modified -[MTLDevice newHeapWithDescriptor:]

	Declaration
From	- (nonnull id<MTLHeap>)newHeapWithDescriptor:(nonnull MTLHeapDescriptor *)descriptor
To	- (nullable id<MTLHeap>)newHeapWithDescriptor:(nonnull MTLHeapDescriptor *)descriptor

Modified -[MTLDevice newBufferWithLength:options:]

	Declaration
From	- (nonnull id<MTLBuffer>)newBufferWithLength:(NSUInteger)length options:(MTLResourceOptions)options
To	- (nullable id<MTLBuffer>)newBufferWithLength:(NSUInteger)length options:(MTLResourceOptions)options

Modified -[MTLDevice newBufferWithBytes:length:options:]

	Declaration
From	- (nonnull id<MTLBuffer>)newBufferWithBytes:(nonnull const void *)pointer length:(NSUInteger)length options:(MTLResourceOptions)options
To	- (nullable id<MTLBuffer>)newBufferWithBytes:(nonnull const void *)pointer length:(NSUInteger)length options:(MTLResourceOptions)options

Modified -[MTLDevice newBufferWithBytesNoCopy:length:options:deallocator:]

	Declaration
From	- (nonnull id<MTLBuffer>)newBufferWithBytesNoCopy:(nonnull void )pointer length:(NSUInteger)length options:(MTLResourceOptions)options deallocator:(nullable void (^)(void _Nonnull, NSUInteger))deallocator
To	- (nullable id<MTLBuffer>)newBufferWithBytesNoCopy:(nonnull void )pointer length:(NSUInteger)length options:(MTLResourceOptions)options deallocator:(nullable void (^)(void _Nonnull, NSUInteger))deallocator

Modified -[MTLDevice newDepthStencilStateWithDescriptor:]

	Declaration
From	- (nonnull id<MTLDepthStencilState>)newDepthStencilStateWithDescriptor:(nonnull MTLDepthStencilDescriptor *)descriptor
To	- (nullable id<MTLDepthStencilState>)newDepthStencilStateWithDescriptor:(nonnull MTLDepthStencilDescriptor *)descriptor

Modified -[MTLDevice newTextureWithDescriptor:]

	Declaration
From	- (nonnull id<MTLTexture>)newTextureWithDescriptor:(nonnull MTLTextureDescriptor *)descriptor
To	- (nullable id<MTLTexture>)newTextureWithDescriptor:(nonnull MTLTextureDescriptor *)descriptor

Modified -[MTLDevice newSamplerStateWithDescriptor:]

	Declaration
From	- (nonnull id<MTLSamplerState>)newSamplerStateWithDescriptor:(nonnull MTLSamplerDescriptor *)descriptor
To	- (nullable id<MTLSamplerState>)newSamplerStateWithDescriptor:(nonnull MTLSamplerDescriptor *)descriptor

Modified -[MTLDevice newFence]

	Declaration
From	- (nonnull id<MTLFence>)newFence
To	- (nullable id<MTLFence>)newFence

MTLHeap.h

Added MTLHeap.currentAllocatedSize

MTLLibrary.h

Removed MTLRenderPipelineErrorDomain

Removed MTLRenderPipelineError

Removed MTLRenderPipelineErrorInternal

Removed MTLRenderPipelineErrorUnsupported

Removed MTLRenderPipelineErrorInvalidInput

Added MTLAutoreleasedArgument

Added -[MTLFunction newArgumentEncoderWithBufferIndex:]

Added -[MTLFunction newArgumentEncoderWithBufferIndex:reflection:]

Added MTLLanguageVersion2_0

MTLParallelRenderCommandEncoder.h

Added -[MTLParallelRenderCommandEncoder setColorStoreActionOptions:atIndex:]

Added -[MTLParallelRenderCommandEncoder setDepthStoreActionOptions:]

Added -[MTLParallelRenderCommandEncoder setStencilStoreActionOptions:]

Modified -[MTLParallelRenderCommandEncoder renderCommandEncoder]

	Declaration
From	- (nonnull id<MTLRenderCommandEncoder>)renderCommandEncoder
To	- (nullable id<MTLRenderCommandEncoder>)renderCommandEncoder

MTLPipeline.h

Added MTLMutability

Added MTLMutabilityDefault

Added MTLMutabilityMutable

Added MTLMutabilityImmutable

Added MTLPipelineBufferDescriptor

Added MTLPipelineBufferDescriptor.mutability

Added MTLPipelineBufferDescriptorArray

Added -[MTLPipelineBufferDescriptorArray objectAtIndexedSubscript:]

Added -[MTLPipelineBufferDescriptorArray setObject:atIndexedSubscript:]

MTLPixelFormat.h

Added MTLPixelFormatBGR10A2Unorm

MTLRenderCommandEncoder.h

Added -[MTLRenderCommandEncoder setDepthClipMode:]

Added -[MTLRenderCommandEncoder setColorStoreActionOptions:atIndex:]

Added -[MTLRenderCommandEncoder setDepthStoreActionOptions:]

Added -[MTLRenderCommandEncoder setStencilStoreActionOptions:]

Added MTLRenderCommandEncoder.tileWidth

Added MTLRenderCommandEncoder.tileHeight

Added -[MTLRenderCommandEncoder setTileBytes:length:atIndex:]

Added -[MTLRenderCommandEncoder setTileBuffer:offset:atIndex:]

Added -[MTLRenderCommandEncoder setTileBufferOffset:atIndex:]

Added -[MTLRenderCommandEncoder setTileBuffers:offsets:withRange:]

Added -[MTLRenderCommandEncoder setTileTexture:atIndex:]

Added -[MTLRenderCommandEncoder setTileTextures:withRange:]

Added -[MTLRenderCommandEncoder setTileSamplerState:atIndex:]

Added -[MTLRenderCommandEncoder setTileSamplerStates:withRange:]

Added -[MTLRenderCommandEncoder setTileSamplerState:lodMinClamp:lodMaxClamp:atIndex:]

Added -[MTLRenderCommandEncoder setTileSamplerStates:lodMinClamps:lodMaxClamps:withRange:]

Added -[MTLRenderCommandEncoder dispatchThreadsPerTile:]

Added -[MTLRenderCommandEncoder setThreadgroupMemoryLength:offset:atIndex:]

Added -[MTLRenderCommandEncoder useResource:usage:]

Added -[MTLRenderCommandEncoder useResources:count:usage:]

Added -[MTLRenderCommandEncoder useHeap:]

Added -[MTLRenderCommandEncoder useHeaps:count:]

Modified -[MTLRenderCommandEncoder setVertexBuffers:offsets:withRange:]

	Declaration
From	- (void)setVertexBuffers:(id<MTLBuffer> _Nullable const [])buffers offsets:(const NSUInteger [])offsets withRange:(NSRange)range
To	- (void)setVertexBuffers:(nonnull id<MTLBuffer> _Nullable const [])buffers offsets:(nonnull const NSUInteger [])offsets withRange:(NSRange)range

Modified -[MTLRenderCommandEncoder setVertexTextures:withRange:]

	Declaration
From	- (void)setVertexTextures:(nullable id<MTLTexture> _Nullable const [])textures withRange:(NSRange)range
To	- (void)setVertexTextures:(nonnull id<MTLTexture> _Nullable const [])textures withRange:(NSRange)range

Modified -[MTLRenderCommandEncoder setVertexSamplerStates:withRange:]

	Declaration
From	- (void)setVertexSamplerStates:(nullable id<MTLSamplerState> _Nullable const [])samplers withRange:(NSRange)range
To	- (void)setVertexSamplerStates:(nonnull id<MTLSamplerState> _Nullable const [])samplers withRange:(NSRange)range

Modified -[MTLRenderCommandEncoder setVertexSamplerStates:lodMinClamps:lodMaxClamps:withRange:]

	Declaration
From	- (void)setVertexSamplerStates:(nullable id<MTLSamplerState> _Nullable const [])samplers lodMinClamps:(nullable const float [])lodMinClamps lodMaxClamps:(nullable const float [])lodMaxClamps withRange:(NSRange)range
To	- (void)setVertexSamplerStates:(nonnull id<MTLSamplerState> _Nullable const [])samplers lodMinClamps:(nonnull const float [])lodMinClamps lodMaxClamps:(nonnull const float [])lodMaxClamps withRange:(NSRange)range

Modified -[MTLRenderCommandEncoder setFragmentBuffers:offsets:withRange:]

	Declaration
From	- (void)setFragmentBuffers:(id<MTLBuffer> _Nullable const [])buffers offsets:(const NSUInteger [])offset withRange:(NSRange)range
To	- (void)setFragmentBuffers:(nonnull id<MTLBuffer> _Nullable const [])buffers offsets:(nonnull const NSUInteger [])offsets withRange:(NSRange)range

Modified -[MTLRenderCommandEncoder setFragmentTextures:withRange:]

	Declaration
From	- (void)setFragmentTextures:(nullable id<MTLTexture> _Nullable const [])textures withRange:(NSRange)range
To	- (void)setFragmentTextures:(nonnull id<MTLTexture> _Nullable const [])textures withRange:(NSRange)range

Modified -[MTLRenderCommandEncoder setFragmentSamplerStates:withRange:]

	Declaration
From	- (void)setFragmentSamplerStates:(nullable id<MTLSamplerState> _Nullable const [])samplers withRange:(NSRange)range
To	- (void)setFragmentSamplerStates:(nonnull id<MTLSamplerState> _Nullable const [])samplers withRange:(NSRange)range

Modified -[MTLRenderCommandEncoder setFragmentSamplerStates:lodMinClamps:lodMaxClamps:withRange:]

	Declaration
From	- (void)setFragmentSamplerStates:(nullable id<MTLSamplerState> _Nullable const [])samplers lodMinClamps:(nullable const float [])lodMinClamps lodMaxClamps:(nullable const float [])lodMaxClamps withRange:(NSRange)range
To	- (void)setFragmentSamplerStates:(nonnull id<MTLSamplerState> _Nullable const [])samplers lodMinClamps:(nonnull const float [])lodMinClamps lodMaxClamps:(nonnull const float [])lodMaxClamps withRange:(NSRange)range

MTLRenderPass.h

Added MTLStoreActionCustomSampleDepthStore

Added MTLStoreActionOptions

Added MTLStoreActionOptionNone

Added MTLStoreActionOptionCustomSamplePositions

Added MTLRenderPassAttachmentDescriptor.storeActionOptions

Added MTLRenderPassDescriptor.imageblockSampleLength

Added MTLRenderPassDescriptor.threadgroupMemoryLength

Added MTLRenderPassDescriptor.tileWidth

Added MTLRenderPassDescriptor.tileHeight

Added MTLRenderPassDescriptor.defaultSampleCount

Added MTLRenderPassDescriptor.defaultRasterSampleCount

Added MTLRenderPassDescriptor.renderTargetWidth

Added MTLRenderPassDescriptor.renderTargetHeight

Added -[MTLRenderPassDescriptor setSamplePositions:count:]

Added -[MTLRenderPassDescriptor getSamplePositions:count:]

MTLRenderPipeline.h

Added MTLBlendFactorSource1Color

Added MTLBlendFactorOneMinusSource1Color

Added MTLBlendFactorSource1Alpha

Added MTLBlendFactorOneMinusSource1Alpha

Added MTLRenderPipelineReflection.tileArguments

Added MTLRenderPipelineDescriptor.rasterSampleCount

Added MTLRenderPipelineDescriptor.vertexBuffers

Added MTLRenderPipelineDescriptor.fragmentBuffers

Added MTLRenderPipelineState.maxTotalThreadsPerThreadgroup

Added MTLRenderPipelineState.threadgroupSizeMatchesTileSize

Added MTLRenderPipelineState.imageblockSampleLength

Added -[MTLRenderPipelineState imageblockMemoryLengthForDimensions:]

Added MTLTileRenderPipelineColorAttachmentDescriptor

Added MTLTileRenderPipelineColorAttachmentDescriptor.pixelFormat

Added MTLTileRenderPipelineColorAttachmentDescriptorArray

Added -[MTLTileRenderPipelineColorAttachmentDescriptorArray objectAtIndexedSubscript:]

Added -[MTLTileRenderPipelineColorAttachmentDescriptorArray setObject:atIndexedSubscript:]

Added MTLTileRenderPipelineDescriptor

Added MTLTileRenderPipelineDescriptor.label

Added MTLTileRenderPipelineDescriptor.tileFunction

Added MTLTileRenderPipelineDescriptor.rasterSampleCount

Added MTLTileRenderPipelineDescriptor.colorAttachments

Added MTLTileRenderPipelineDescriptor.threadgroupSizeMatchesTileSize

Added MTLTileRenderPipelineDescriptor.tileBuffers

Added -[MTLTileRenderPipelineDescriptor reset]

MTLResource.h

Added MTLResource.allocatedSize

MTLSampler.h

Removed MTLSamplerBorderColorTransparentBlack

Removed MTLSamplerBorderColorOpaqueBlack

Removed MTLSamplerBorderColorOpaqueWhite

Added MTLSamplerDescriptor.supportArgumentBuffers

MTLStageInputOutputDescriptor.h

Added MTLAttributeFormatUChar4Normalized_BGRA

Added MTLAttributeFormatUChar

Added MTLAttributeFormatChar

Added MTLAttributeFormatUCharNormalized

Added MTLAttributeFormatCharNormalized

Added MTLAttributeFormatUShort

Added MTLAttributeFormatShort

Added MTLAttributeFormatUShortNormalized

Added MTLAttributeFormatShortNormalized

Added MTLAttributeFormatHalf

MTLTexture.h

Added MTLTextureTypeCubeArray

Added MTLTexture.iosurface

Added MTLTexture.iosurfacePlane

Modified -[MTLTexture newTextureViewWithPixelFormat:]

	Declaration
From	- (nonnull id<MTLTexture>)newTextureViewWithPixelFormat:(MTLPixelFormat)pixelFormat
To	- (nullable id<MTLTexture>)newTextureViewWithPixelFormat:(MTLPixelFormat)pixelFormat

Modified -[MTLTexture newTextureViewWithPixelFormat:textureType:levels:slices:]

	Declaration
From	- (nonnull id<MTLTexture>)newTextureViewWithPixelFormat:(MTLPixelFormat)pixelFormat textureType:(MTLTextureType)textureType levels:(NSRange)levelRange slices:(NSRange)sliceRange
To	- (nullable id<MTLTexture>)newTextureViewWithPixelFormat:(MTLPixelFormat)pixelFormat textureType:(MTLTextureType)textureType levels:(NSRange)levelRange slices:(NSRange)sliceRange

MTLTypes.h

Added MTLSamplePosition

Added MTLSamplePositionMake()

MTLVertexDescriptor.h

Added MTLVertexFormatUChar4Normalized_BGRA

Added MTLVertexFormatUChar

Added MTLVertexFormatChar

Added MTLVertexFormatUCharNormalized

Added MTLVertexFormatCharNormalized

Added MTLVertexFormatUShort

Added MTLVertexFormatShort

Added MTLVertexFormatUShortNormalized

Added MTLVertexFormatShortNormalized

Added MTLVertexFormatHalf