Metal macOS 10.14 to 10.15 API Differences

MTLBlitCommandEncoder.h

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

Added -[MTLBlitCommandEncoder copyFromTexture:toTexture:]

Added -[MTLBlitCommandEncoder sampleCountersInBuffer:atSampleIndex:withBarrier:]

Added -[MTLBlitCommandEncoder resolveCounters:inRange:destinationBuffer:destinationOffset:]

MTLBuffer.h

Added MTLBuffer.remoteStorageBuffer

Added -[MTLBuffer newRemoteBufferViewForDevice:]

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

Added MTLCommandBuffer.kernelEndTime

Added MTLCommandBuffer.GPUStartTime

Added MTLCommandBuffer.GPUEndTime

Modified MTLCommandBufferErrorDomain

	Declaration
From	NSString *const MTLCommandBufferErrorDomain
To	const NSErrorDomain MTLCommandBufferErrorDomain

MTLComputeCommandEncoder.h

Added -[MTLComputeCommandEncoder sampleCountersInBuffer:atSampleIndex:withBarrier:]

MTLCounters.h

Added #def MTLCounterErrorValue

Added MTLCommonCounter

Added MTLCommonCounterTimestamp

Added MTLCommonCounterTessellationInputPatches

Added MTLCommonCounterVertexInvocations

Added MTLCommonCounterPostTessellationVertexInvocations

Added MTLCommonCounterClipperInvocations

Added MTLCommonCounterClipperPrimitivesOut

Added MTLCommonCounterFragmentInvocations

Added MTLCommonCounterFragmentsPassed

Added MTLCommonCounterComputeKernelInvocations

Added MTLCommonCounterTotalCycles

Added MTLCommonCounterVertexCycles

Added MTLCommonCounterTessellationCycles

Added MTLCommonCounterPostTessellationVertexCycles

Added MTLCommonCounterFragmentCycles

Added MTLCommonCounterRenderTargetWriteCycles

Added MTLCommonCounterSet

Added MTLCommonCounterSetTimestamp

Added MTLCommonCounterSetStageUtilization

Added MTLCommonCounterSetStatistic

Added MTLCounterResultTimestamp

Added MTLCounterResultStageUtilization

Added MTLCounterResultStatistic

Added MTLCounter

Added MTLCounter.name

Added MTLCounterSet

Added MTLCounterSet.name

Added MTLCounterSet.counters

Added MTLCounterSampleBufferDescriptor

Added MTLCounterSampleBufferDescriptor.counterSet

Added MTLCounterSampleBufferDescriptor.label

Added MTLCounterSampleBufferDescriptor.storageMode

Added MTLCounterSampleBufferDescriptor.sampleCount

Added MTLCounterSampleBuffer

Added MTLCounterSampleBuffer.device

Added MTLCounterSampleBuffer.label

Added MTLCounterSampleBuffer.sampleCount

Added -[MTLCounterSampleBuffer resolveCounterRange:]

Added MTLCounterErrorDomain

Added MTLCounterSampleBufferError

Added MTLCounterSampleBufferErrorOutOfMemory

Added MTLCounterSampleBufferErrorInternal

MTLDevice.h

Added MTLGPUFamily

Added MTLGPUFamilyApple1

Added MTLGPUFamilyApple2

Added MTLGPUFamilyApple3

Added MTLGPUFamilyApple4

Added MTLGPUFamilyApple5

Added MTLGPUFamilyMac1

Added MTLGPUFamilyMac2

Added MTLGPUFamilyCommon1

Added MTLGPUFamilyCommon2

Added MTLGPUFamilyCommon3

Added MTLGPUFamilyMacCatalyst1

Added MTLGPUFamilyMacCatalyst2

Added MTLDeviceLocation

Added MTLDeviceLocationBuiltIn

Added MTLDeviceLocationSlot

Added MTLDeviceLocationExternal

Added MTLDeviceLocationUnspecified

Added MTLDevice.hasUnifiedMemory

Added MTLDevice.location

Added MTLDevice.locationNumber

Added MTLDevice.maxTransferRate

Added MTLDevice.barycentricCoordsSupported

Added MTLDevice.supportsShaderBarycentricCoordinates

Added -[MTLDevice supportsFamily:]

Added MTLDevice.peerGroupID

Added MTLDevice.peerIndex

Added MTLDevice.peerCount

Added MTLDevice.counterSets

Added -[MTLDevice newCounterSampleBufferWithDescriptor:error:]

Added -[MTLDevice sampleTimestamps:gpuTimestamp:]

MTLHeap.h

Added MTLHeapType

Added MTLHeapTypeAutomatic

Added MTLHeapTypePlacement

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

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

MTLRenderCommandEncoder.h

Added -[MTLRenderCommandEncoder useResource:usage:stages:]

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

Added -[MTLRenderCommandEncoder useHeap:stages:]

Added -[MTLRenderCommandEncoder useHeaps:count:stages:]

Added -[MTLRenderCommandEncoder sampleCountersInBuffer:atSampleIndex:withBarrier:]

MTLRenderPass.h

Added #def MTLCounterDontSample

Added #def MTLMaxRenderPassSampleBuffers

Added MTLRenderPassDescriptor.defaultRasterSampleCount

Added MTLRenderPassDescriptor.renderTargetWidth

Added MTLRenderPassDescriptor.renderTargetHeight

MTLResource.h

Added MTLHazardTrackingMode

Added MTLHazardTrackingModeDefault

Added MTLHazardTrackingModeUntracked

Added MTLHazardTrackingModeTracked

Added MTLResourceHazardTrackingModeDefault

Added MTLResourceHazardTrackingModeTracked

Added MTLResource.hazardTrackingMode

Added MTLResource.resourceOptions

Added MTLResource.heapOffset

MTLTexture.h

Added MTLTextureSwizzle

Added MTLTextureSwizzleZero

Added MTLTextureSwizzleOne

Added MTLTextureSwizzleRed

Added MTLTextureSwizzleGreen

Added MTLTextureSwizzleBlue

Added MTLTextureSwizzleAlpha

Added MTLTextureSwizzleChannels

Added MTLTextureSwizzleChannelsMake()

Added #def MTLTextureSwizzleChannelsDefault

Added MTLTextureDescriptor.hazardTrackingMode

Added MTLTextureDescriptor.swizzle

Added MTLTexture.remoteStorageTexture

Added -[MTLTexture newRemoteTextureViewForDevice:]

Added MTLTexture.swizzle

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