Metal macOS 10.12 to 10.13 API Differences

	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 dispatchThreads:threadsPerThreadgroup:]

Added -[MTLComputeCommandEncoder updateFence:]

Added -[MTLComputeCommandEncoder waitForFence:]

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

MTLDevice.h

Removed #def MTLFeatureSet_TVOS_GPUFamily1_v1

Added MTLDeviceNotificationName

Added MTLDeviceWasAddedNotification

Added MTLDeviceRemovalRequestedNotification

Added MTLDeviceWasRemovedNotification

Added MTLDeviceNotificationHandler

Added MTLCopyAllDevicesWithObserver()

Added MTLRemoveDeviceObserver()

Added MTLFeatureSet_macOS_GPUFamily1_v1

Added MTLFeatureSet_macOS_GPUFamily1_v2

Added MTLFeatureSet_macOS_ReadWriteTextureTier2

Added MTLFeatureSet_macOS_GPUFamily1_v3

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.removable

Added MTLDevice.readWriteTextureSupport

Added MTLDevice.argumentBuffersSupport

Added MTLDevice.rasterOrderGroupsSupported

Added MTLDevice.currentAllocatedSize

Added -[MTLDevice heapTextureSizeAndAlignWithDescriptor:]

Added -[MTLDevice heapBufferSizeAndAlignWithLength:options:]

Added -[MTLDevice newHeapWithDescriptor:]

Added -[MTLDevice newLibraryWithURL:error:]

Added -[MTLDevice newFence]

Added -[MTLDevice minimumLinearTextureAlignmentForPixelFormat:]

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 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 newTextureWithDescriptor:iosurface:plane:]

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

Modified -[MTLDevice newSamplerStateWithDescriptor:]

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

MTLDrawable.h

Added MTLDrawablePresentedHandler

MTLFence.h

Added MTLFence

Added MTLFence.device

Added MTLFence.label

MTLHeap.h

Added MTLHeapDescriptor

Added MTLHeapDescriptor.size

Added MTLHeapDescriptor.storageMode

Added MTLHeapDescriptor.cpuCacheMode

Added MTLHeap

Added MTLHeap.label

Added MTLHeap.device

Added MTLHeap.storageMode

Added MTLHeap.cpuCacheMode

Added MTLHeap.size

Added MTLHeap.usedSize

Added MTLHeap.currentAllocatedSize

Added -[MTLHeap maxAvailableSizeWithAlignment:]

Added -[MTLHeap newBufferWithLength:options:]

Added -[MTLHeap newTextureWithDescriptor:]

Added -[MTLHeap setPurgeableState:]

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 MTLRenderStageVertex

Added MTLRenderStageFragment

Added -[MTLRenderCommandEncoder setViewports:count:]

Added -[MTLRenderCommandEncoder setScissorRects:count:]

Added -[MTLRenderCommandEncoder setColorStoreActionOptions:atIndex:]

Added -[MTLRenderCommandEncoder setDepthStoreActionOptions:]

Added -[MTLRenderCommandEncoder setStencilStoreActionOptions:]

Added -[MTLRenderCommandEncoder updateFence:afterStages:]

Added -[MTLRenderCommandEncoder waitForFence:beforeStages:]

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 setSamplePositions:count:]

Added -[MTLRenderPassDescriptor getSamplePositions:count:]

MTLRenderPipeline.h

Added MTLRenderPipelineDescriptor.rasterSampleCount

Added MTLRenderPipelineDescriptor.vertexBuffers

Added MTLRenderPipelineDescriptor.fragmentBuffers

MTLResource.h

Added MTLResourceHazardTrackingModeUntracked

Added MTLResource.heap

Added MTLResource.allocatedSize

Added -[MTLResource makeAliasable]

Added -[MTLResource isAliasable]

MTLSampler.h

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

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