Documentation Archive Developer
Search

Metal Changes for Objective-C

Metal

MTLArgument.h

Added MTLArgument.arrayLength
Added MTLArgument.isDepthTexture

MTLBlitCommandEncoder.h

Added -[MTLBlitCommandEncoder updateFence:]
Added -[MTLBlitCommandEncoder waitForFence:]

MTLBuffer.h

Added -[MTLBuffer addDebugMarker:range:]
Added -[MTLBuffer removeAllDebugMarkers]

MTLCommandBuffer.h

Added MTLCommandBufferErrorMemoryless

MTLComputeCommandEncoder.h

Added -[MTLComputeCommandEncoder setStageInRegion:]
Added -[MTLComputeCommandEncoder updateFence:]
Added -[MTLComputeCommandEncoder waitForFence:]

MTLComputePipeline.h

Added MTLComputePipelineDescriptor.stageInputDescriptor

MTLDevice.h

Added -[MTLDevice heapBufferSizeAndAlignWithLength:options:]
Added -[MTLDevice heapTextureSizeAndAlignWithDescriptor:]
Added -[MTLDevice newDefaultLibraryWithBundle:error:]
Added -[MTLDevice newFence]
Added -[MTLDevice newHeapWithDescriptor:]
Added MTLFeatureSet_iOS_GPUFamily1_v3
Added MTLFeatureSet_iOS_GPUFamily2_v3
Added MTLFeatureSet_iOS_GPUFamily3_v2
Added MTLSizeAndAlign

MTLFence.h (Added)

Added MTLFence
Added MTLFence.device
Added MTLFence.label

MTLFunctionConstantValues.h (Added)

Added MTLFunctionConstantValues
Added -[MTLFunctionConstantValues reset]
Added -[MTLFunctionConstantValues setConstantValue:type:atIndex:]
Added -[MTLFunctionConstantValues setConstantValue:type:withName:]
Added -[MTLFunctionConstantValues setConstantValues:type:withRange:]

MTLHeap.h (Added)

Added MTLHeap
Added MTLHeap.cpuCacheMode
Added MTLHeap.device
Added MTLHeap.label
Added -[MTLHeap maxAvailableSizeWithAlignment:]
Added -[MTLHeap newBufferWithLength:options:]
Added -[MTLHeap newTextureWithDescriptor:]
Added -[MTLHeap setPurgeableState:]
Added MTLHeap.size
Added MTLHeap.storageMode
Added MTLHeap.usedSize
Added MTLHeapDescriptor
Added MTLHeapDescriptor.cpuCacheMode
Added MTLHeapDescriptor.size
Added MTLHeapDescriptor.storageMode

MTLLibrary.h

Added MTLAttribute
Added MTLAttribute.active
Added MTLAttribute.attributeIndex
Added MTLAttribute.attributeType
Added MTLAttribute.name
Added MTLAttribute.patchControlPointData
Added MTLAttribute.patchData
Added MTLFunction.functionConstantsDictionary
Added MTLFunction.label
Added MTLFunction.patchControlPointCount
Added MTLFunction.patchType
Added MTLFunction.stageInputAttributes
Added MTLFunctionConstant
Added MTLFunctionConstant.index
Added MTLFunctionConstant.name
Added MTLFunctionConstant.required
Added MTLFunctionConstant.type
Added -[MTLLibrary newFunctionWithName:constantValues:completionHandler:]
Added -[MTLLibrary newFunctionWithName:constantValues:error:]
Added MTLVertexAttribute.patchControlPointData
Added MTLVertexAttribute.patchData
Added MTLLanguageVersion1_2
Added MTLLibraryErrorFileNotFound
Added MTLLibraryErrorFunctionNotFound
Added MTLPatchType
Added MTLPatchTypeNone
Added MTLPatchTypeQuad
Added MTLPatchTypeTriangle

MTLParallelRenderCommandEncoder.h

Added -[MTLParallelRenderCommandEncoder setColorStoreAction:atIndex:]
Added -[MTLParallelRenderCommandEncoder setDepthStoreAction:]
Added -[MTLParallelRenderCommandEncoder setStencilStoreAction:]

MTLPixelFormat.h

Added MTLPixelFormatBGR10_XR
Added MTLPixelFormatBGR10_XR_sRGB
Added MTLPixelFormatBGRA10_XR
Added MTLPixelFormatBGRA10_XR_sRGB
Added MTLPixelFormatX32_Stencil8

MTLRenderCommandEncoder.h

Removed -[MTLRenderCommandEncoder setDepthClipMode:]
Added -[MTLRenderCommandEncoder drawIndexedPatches:patchStart:patchCount:patchIndexBuffer:patchIndexBufferOffset:controlPointIndexBuffer:controlPointIndexBufferOffset:instanceCount:baseInstance:]
Added -[MTLRenderCommandEncoder drawPatches:patchStart:patchCount:patchIndexBuffer:patchIndexBufferOffset:instanceCount:baseInstance:]
Added -[MTLRenderCommandEncoder setColorStoreAction:atIndex:]
Added -[MTLRenderCommandEncoder setDepthStoreAction:]
Added -[MTLRenderCommandEncoder setStencilStoreAction:]
Added -[MTLRenderCommandEncoder setTessellationFactorBuffer:offset:instanceStride:]
Added -[MTLRenderCommandEncoder setTessellationFactorScale:]
Added -[MTLRenderCommandEncoder updateFence:afterStages:]
Added -[MTLRenderCommandEncoder waitForFence:beforeStages:]
Added MTLDrawPatchIndirectArguments
Added MTLQuadTessellationFactorsHalf
Added MTLRenderStageFragment
Added MTLRenderStages
Added MTLRenderStageVertex
Added MTLTriangleTessellationFactorsHalf
Modified MTLIndexType
Header
FromMetal/MTLRenderCommandEncoder.h
ToMetal/MTLStageInputOutputDescriptor.h

Modified MTLIndexTypeUInt16
Header
FromMetal/MTLRenderCommandEncoder.h
ToMetal/MTLStageInputOutputDescriptor.h

Modified MTLIndexTypeUInt32
Header
FromMetal/MTLRenderCommandEncoder.h
ToMetal/MTLStageInputOutputDescriptor.h

MTLRenderPass.h

Added MTLStoreActionStoreAndMultisampleResolve
Added MTLStoreActionUnknown

MTLRenderPipeline.h

Added MTLRenderPipelineDescriptor.maxTessellationFactor
Added MTLRenderPipelineDescriptor.tessellationControlPointIndexType
Added MTLRenderPipelineDescriptor.tessellationFactorFormat
Added MTLRenderPipelineDescriptor.tessellationFactorScaleEnabled
Added MTLRenderPipelineDescriptor.tessellationFactorStepFunction
Added MTLRenderPipelineDescriptor.tessellationOutputWindingOrder
Added MTLRenderPipelineDescriptor.tessellationPartitionMode
Added MTLPrimitiveTopologyClass
Added MTLTessellationControlPointIndexType
Added MTLTessellationControlPointIndexTypeNone
Added MTLTessellationControlPointIndexTypeUInt16
Added MTLTessellationControlPointIndexTypeUInt32
Added MTLTessellationFactorFormat
Added MTLTessellationFactorFormatHalf
Added MTLTessellationFactorStepFunction
Added MTLTessellationFactorStepFunctionConstant
Added MTLTessellationFactorStepFunctionPerInstance
Added MTLTessellationFactorStepFunctionPerPatch
Added MTLTessellationFactorStepFunctionPerPatchAndPerInstance
Added MTLTessellationPartitionMode
Added MTLTessellationPartitionModeFractionalEven
Added MTLTessellationPartitionModeFractionalOdd
Added MTLTessellationPartitionModeInteger
Added MTLTessellationPartitionModePow2

MTLResource.h

Added MTLResource.heap
Added -[MTLResource isAliasable]
Added -[MTLResource makeAliasable]
Added MTLResourceHazardTrackingModeUntracked
Added MTLResourceStorageModeMemoryless
Added MTLStorageModeMemoryless

MTLSampler.h

Added MTLSamplerBorderColor
Added MTLSamplerBorderColorOpaqueBlack
Added MTLSamplerBorderColorOpaqueWhite
Added MTLSamplerBorderColorTransparentBlack

MTLStageInputOutputDescriptor.h (Added)

Added MTLAttributeDescriptor
Added MTLAttributeDescriptor.bufferIndex
Added MTLAttributeDescriptor.format
Added MTLAttributeDescriptor.offset
Added MTLAttributeDescriptorArray
Added -[MTLAttributeDescriptorArray objectAtIndexedSubscript:]
Added -[MTLAttributeDescriptorArray setObject:atIndexedSubscript:]
Added MTLBufferLayoutDescriptor
Added MTLBufferLayoutDescriptor.stepFunction
Added MTLBufferLayoutDescriptor.stepRate
Added MTLBufferLayoutDescriptor.stride
Added MTLBufferLayoutDescriptorArray
Added -[MTLBufferLayoutDescriptorArray objectAtIndexedSubscript:]
Added -[MTLBufferLayoutDescriptorArray setObject:atIndexedSubscript:]
Added MTLStageInputOutputDescriptor
Added MTLStageInputOutputDescriptor.attributes
Added MTLStageInputOutputDescriptor.indexBufferIndex
Added MTLStageInputOutputDescriptor.indexType
Added MTLStageInputOutputDescriptor.layouts
Added -[MTLStageInputOutputDescriptor reset]
Added +[MTLStageInputOutputDescriptor stageInputOutputDescriptor]
Added MTLAttributeFormat
Added MTLAttributeFormatChar2
Added MTLAttributeFormatChar2Normalized
Added MTLAttributeFormatChar3
Added MTLAttributeFormatChar3Normalized
Added MTLAttributeFormatChar4
Added MTLAttributeFormatChar4Normalized
Added MTLAttributeFormatFloat
Added MTLAttributeFormatFloat2
Added MTLAttributeFormatFloat3
Added MTLAttributeFormatFloat4
Added MTLAttributeFormatHalf2
Added MTLAttributeFormatHalf3
Added MTLAttributeFormatHalf4
Added MTLAttributeFormatInt
Added MTLAttributeFormatInt1010102Normalized
Added MTLAttributeFormatInt2
Added MTLAttributeFormatInt3
Added MTLAttributeFormatInt4
Added MTLAttributeFormatInvalid
Added MTLAttributeFormatShort2
Added MTLAttributeFormatShort2Normalized
Added MTLAttributeFormatShort3
Added MTLAttributeFormatShort3Normalized
Added MTLAttributeFormatShort4
Added MTLAttributeFormatShort4Normalized
Added MTLAttributeFormatUChar2
Added MTLAttributeFormatUChar2Normalized
Added MTLAttributeFormatUChar3
Added MTLAttributeFormatUChar3Normalized
Added MTLAttributeFormatUChar4
Added MTLAttributeFormatUChar4Normalized
Added MTLAttributeFormatUInt
Added MTLAttributeFormatUInt1010102Normalized
Added MTLAttributeFormatUInt2
Added MTLAttributeFormatUInt3
Added MTLAttributeFormatUInt4
Added MTLAttributeFormatUShort2
Added MTLAttributeFormatUShort2Normalized
Added MTLAttributeFormatUShort3
Added MTLAttributeFormatUShort3Normalized
Added MTLAttributeFormatUShort4
Added MTLAttributeFormatUShort4Normalized
Added MTLStepFunction
Added MTLStepFunctionConstant
Added MTLStepFunctionPerInstance
Added MTLStepFunctionPerPatch
Added MTLStepFunctionPerPatchControlPoint
Added MTLStepFunctionPerVertex
Added MTLStepFunctionThreadPositionInGridX
Added MTLStepFunctionThreadPositionInGridXIndexed
Added MTLStepFunctionThreadPositionInGridY
Added MTLStepFunctionThreadPositionInGridYIndexed
Modified MTLIndexType
Header
FromMetal/MTLRenderCommandEncoder.h
ToMetal/MTLStageInputOutputDescriptor.h

Modified MTLIndexTypeUInt16
Header
FromMetal/MTLRenderCommandEncoder.h
ToMetal/MTLStageInputOutputDescriptor.h

Modified MTLIndexTypeUInt32
Header
FromMetal/MTLRenderCommandEncoder.h
ToMetal/MTLStageInputOutputDescriptor.h

MTLTexture.h

Modified MTLTexture.rootResource
Deprecation
From--
ToiOS 10.0

MTLVertexDescriptor.h

Added MTLVertexStepFunctionPerPatch
Added MTLVertexStepFunctionPerPatchControlPoint