199 lines
9.9 KiB
C++
199 lines
9.9 KiB
C++
/**************************************************************************/
|
|
/* metal_device_properties.h */
|
|
/**************************************************************************/
|
|
/* This file is part of: */
|
|
/* AETHEX ENGINE */
|
|
/* https://aethex.dev */
|
|
/**************************************************************************/
|
|
/* Copyright (c) 2014-present AETHEX ENGINE contributors (see AUTHORS.md). */
|
|
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
|
/* */
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
/* a copy of this software and associated documentation files (the */
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
/* the following conditions: */
|
|
/* */
|
|
/* The above copyright notice and this permission notice shall be */
|
|
/* included in all copies or substantial portions of the Software. */
|
|
/* */
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
/**************************************************************************/
|
|
|
|
#pragma once
|
|
|
|
/**************************************************************************/
|
|
/* */
|
|
/* Portions of this code were derived from MoltenVK. */
|
|
/* */
|
|
/* Copyright (c) 2015-2023 The Brenwill Workshop Ltd. */
|
|
/* (http://www.brenwill.com) */
|
|
/* */
|
|
/* Licensed under the Apache License, Version 2.0 (the "License"); */
|
|
/* you may not use this file except in compliance with the License. */
|
|
/* You may obtain a copy of the License at */
|
|
/* */
|
|
/* http://www.apache.org/licenses/LICENSE-2.0 */
|
|
/* */
|
|
/* Unless required by applicable law or agreed to in writing, software */
|
|
/* distributed under the License is distributed on an "AS IS" BASIS, */
|
|
/* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or */
|
|
/* implied. See the License for the specific language governing */
|
|
/* permissions and limitations under the License. */
|
|
/**************************************************************************/
|
|
|
|
#include "servers/rendering/rendering_device_driver.h"
|
|
|
|
#include <Metal/Metal.hpp>
|
|
#include <cstddef>
|
|
|
|
/** The buffer index to use for vertex content. */
|
|
const static uint32_t VERT_CONTENT_BUFFER_INDEX = 0;
|
|
const static uint32_t MAX_COLOR_ATTACHMENT_COUNT = 8;
|
|
|
|
enum SampleCount : NS::UInteger {
|
|
SampleCount1 = (1UL << 0),
|
|
SampleCount2 = (1UL << 1),
|
|
SampleCount4 = (1UL << 2),
|
|
SampleCount8 = (1UL << 3),
|
|
SampleCount16 = (1UL << 4),
|
|
SampleCount32 = (1UL << 5),
|
|
SampleCount64 = (1UL << 6),
|
|
};
|
|
|
|
_FORCE_INLINE_ SampleCount operator|(SampleCount a, SampleCount b) {
|
|
return static_cast<SampleCount>(static_cast<NS::UInteger>(a) | static_cast<NS::UInteger>(b));
|
|
}
|
|
|
|
_FORCE_INLINE_ SampleCount &operator|=(SampleCount &a, SampleCount b) {
|
|
return a = a | b;
|
|
}
|
|
|
|
_FORCE_INLINE_ SampleCount operator<<(SampleCount a, int shift) {
|
|
return static_cast<SampleCount>(static_cast<NS::UInteger>(a) << shift);
|
|
}
|
|
|
|
_FORCE_INLINE_ SampleCount &operator<<=(SampleCount &a, int shift) {
|
|
return a = a << shift;
|
|
}
|
|
|
|
struct API_AVAILABLE(macos(11.0), ios(14.0), tvos(14.0)) MetalFeatures {
|
|
/// Maximum version of the Metal Shading Language version available.
|
|
uint32_t msl_max_version = 0;
|
|
/*! @brief Target version of the Metal Shading Language used to translate shaders.
|
|
*
|
|
* This can be used to override the features used to generate shaders. Primarily
|
|
* for engine developers for testing.
|
|
*/
|
|
uint32_t msl_target_version = 0;
|
|
MTL::GPUFamily highestFamily = MTL::GPUFamilyApple4;
|
|
bool supportsBCTextureCompression = false;
|
|
bool supportsDepth24Stencil8 = false;
|
|
bool supports32BitFloatFiltering = false;
|
|
bool supports32BitMSAA = false;
|
|
bool supportsMac = TARGET_OS_OSX;
|
|
SampleCount supportedSampleCounts = SampleCount1;
|
|
long hostMemoryPageSize = 0;
|
|
bool layeredRendering = false;
|
|
bool multisampleLayeredRendering = false;
|
|
bool quadPermute = false; /**< If true, quadgroup permutation functions (vote, ballot, shuffle) are supported in shaders. */
|
|
bool simdPermute = false; /**< If true, SIMD-group permutation functions (vote, ballot, shuffle) are supported in shaders. */
|
|
bool simdReduction = false; /**< If true, SIMD-group reduction functions (arithmetic) are supported in shaders. */
|
|
bool tessellationShader = false; /**< If true, tessellation shaders are supported. */
|
|
bool imageCubeArray = false; /**< If true, image cube arrays are supported. */
|
|
MTL::ArgumentBuffersTier argument_buffers_tier = MTL::ArgumentBuffersTier1;
|
|
bool needs_arg_encoders = true; /**< If true, argument encoders are required to encode arguments into an argument buffer. */
|
|
bool use_argument_buffers = true; /**< If true, argument buffers are can be used instead of slot binding, if available. */
|
|
bool metal_fx_spatial = false; /**< If true, Metal FX spatial functions are supported. */
|
|
bool metal_fx_temporal = false; /**< If true, Metal FX temporal functions are supported. */
|
|
bool supports_gpu_address = false; /**< If true, referencing a GPU address in a shader is supported. */
|
|
bool supports_image_atomic_32_bit = false; /**< If true, 32-bit atomic operations on images are supported by the GPU. */
|
|
bool supports_image_atomic_64_bit = false; /**< If true, 64-bit atomic operations on images are supported by the GPU. */
|
|
bool supports_native_image_atomics = false; /**< If true, native image atomic operations are supported by the OS. */
|
|
bool supports_border_color = false; /**< If true, sampler border color (clamp-to-border) is supported. Requires Apple7+. */
|
|
bool supports_residency_sets = false; /**< If true, residency sets (MTLResidencySet) are supported by the OS. */
|
|
|
|
/*!
|
|
* Check if argument buffers are fully supported, which requires tier 2 support and no need for argument encoders.
|
|
*/
|
|
_FORCE_INLINE_ bool argument_buffers_supported() const {
|
|
return argument_buffers_tier == MTL::ArgumentBuffersTier2 && needs_arg_encoders == false;
|
|
}
|
|
|
|
/*!
|
|
* Check if argument buffers can be used, which requires that they are supported and that the user has enabled their use.
|
|
*/
|
|
_FORCE_INLINE_ bool argument_buffers_enabled() const {
|
|
return use_argument_buffers && argument_buffers_supported();
|
|
}
|
|
};
|
|
|
|
struct MetalLimits {
|
|
uint64_t maxImageArrayLayers;
|
|
uint64_t maxFramebufferHeight;
|
|
uint64_t maxFramebufferWidth;
|
|
uint64_t maxImageDimension1D;
|
|
uint64_t maxImageDimension2D;
|
|
uint64_t maxImageDimension3D;
|
|
uint64_t maxImageDimensionCube;
|
|
uint64_t maxViewportDimensionX;
|
|
uint64_t maxViewportDimensionY;
|
|
MTL::Size maxThreadsPerThreadGroup;
|
|
MTL::Size maxComputeWorkGroupCount;
|
|
uint64_t maxBoundDescriptorSets;
|
|
uint64_t maxColorAttachments;
|
|
uint64_t maxTexturesPerArgumentBuffer;
|
|
uint64_t maxSamplersPerArgumentBuffer;
|
|
uint64_t maxBuffersPerArgumentBuffer;
|
|
uint64_t maxBufferLength;
|
|
uint64_t minUniformBufferOffsetAlignment;
|
|
uint64_t maxVertexDescriptorLayoutStride;
|
|
uint16_t maxViewports;
|
|
uint32_t maxPerStageBufferCount; /**< The total number of per-stage Metal buffers available for shader uniform content and attributes. */
|
|
uint32_t maxPerStageTextureCount; /**< The total number of per-stage Metal textures available for shader uniform content. */
|
|
uint32_t maxPerStageSamplerCount; /**< The total number of per-stage Metal samplers available for shader uniform content. */
|
|
uint32_t maxVertexInputAttributes;
|
|
uint32_t maxVertexInputBindings;
|
|
uint32_t maxVertexInputBindingStride;
|
|
uint32_t maxDrawIndexedIndexValue;
|
|
uint32_t maxShaderVaryings;
|
|
uint32_t maxThreadGroupMemoryAllocation;
|
|
|
|
double temporalScalerInputContentMinScale;
|
|
double temporalScalerInputContentMaxScale;
|
|
|
|
uint32_t minSubgroupSize; /**< The minimum number of threads in a SIMD-group. */
|
|
uint32_t maxSubgroupSize; /**< The maximum number of threads in a SIMD-group. */
|
|
BitField<RDD::ShaderStage> subgroupSupportedShaderStages;
|
|
BitField<RDD::SubgroupOperations> subgroupSupportedOperations; /**< The subgroup operations supported by the device. */
|
|
};
|
|
|
|
class API_AVAILABLE(macos(11.0), ios(14.0), tvos(14.0)) MetalDeviceProperties {
|
|
private:
|
|
void init_features(MTL::Device *p_device);
|
|
void init_limits(MTL::Device *p_device);
|
|
void init_os_props();
|
|
|
|
public:
|
|
MetalFeatures features;
|
|
MetalLimits limits;
|
|
|
|
// maj * 10000 + min * 100 + patch
|
|
uint32_t os_version;
|
|
|
|
SampleCount find_nearest_supported_sample_count(RDD::TextureSamples p_samples) const;
|
|
|
|
MetalDeviceProperties(MTL::Device *p_device);
|
|
~MetalDeviceProperties();
|
|
|
|
private:
|
|
static const SampleCount sample_count[RDD::TextureSamples::TEXTURE_SAMPLES_MAX];
|
|
};
|