| // Copyright 2019 The Dawn Authors |
| // |
| // 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 "dawn/native/Features.h" |
| |
| #include <array> |
| #include <utility> |
| |
| #include "dawn/common/Assert.h" |
| #include "dawn/common/BitSetIterator.h" |
| #include "dawn/common/ityp_array.h" |
| |
| namespace dawn::native { |
| namespace { |
| |
| struct ManualFeatureInfo { |
| const char* description; |
| const char* url; |
| FeatureInfo::FeatureState featureState; |
| }; |
| |
| struct FeatureEnumAndInfo { |
| Feature feature; |
| ManualFeatureInfo info; |
| }; |
| |
| static constexpr FeatureEnumAndInfo kFeatureInfo[] = { |
| {Feature::TextureCompressionBC, |
| {"Support Block Compressed (BC) texture formats", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=42", FeatureInfo::FeatureState::Stable}}, |
| {Feature::TextureCompressionETC2, |
| {"Support Ericsson Texture Compressed (ETC2/EAC) texture formats", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=955", FeatureInfo::FeatureState::Stable}}, |
| {Feature::TextureCompressionASTC, |
| {"Support Adaptable Scalable Texture Compressed (ASTC) " |
| "texture formats", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=955", FeatureInfo::FeatureState::Stable}}, |
| {Feature::PipelineStatisticsQuery, |
| {"Support Pipeline Statistics Query", "https://bugs.chromium.org/p/dawn/issues/detail?id=434", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::TimestampQuery, |
| {"Support Timestamp Query", "https://bugs.chromium.org/p/dawn/issues/detail?id=434", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::TimestampQueryInsidePasses, |
| {"Support Timestamp Query inside render/compute pass", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=434", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::DepthClipControl, |
| {"Disable depth clipping of primitives to the clip volume", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1178", FeatureInfo::FeatureState::Stable}}, |
| {Feature::Depth32FloatStencil8, |
| {"Support depth32float-stencil8 texture format", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=690", FeatureInfo::FeatureState::Stable}}, |
| {Feature::ChromiumExperimentalDp4a, |
| {"Support experimental DP4a instructions in WGSL", |
| "https://bugs.chromium.org/p/tint/issues/detail?id=1497", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::IndirectFirstInstance, |
| {"Support non-zero first instance values on indirect draw calls", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1197", FeatureInfo::FeatureState::Stable}}, |
| {Feature::ShaderF16, |
| {"Supports the \"enable f16;\" directive in WGSL", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1510", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::RG11B10UfloatRenderable, |
| {"Allows the RENDER_ATTACHMENT usage on textures with format \"rg11b10ufloat\", and also " |
| "allows textures of that format to be multisampled.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1518", FeatureInfo::FeatureState::Stable}}, |
| {Feature::BGRA8UnormStorage, |
| {"Allows the STORAGE usage on textures with format \"bgra8unorm\".", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1591", FeatureInfo::FeatureState::Stable}}, |
| {Feature::Float32Filterable, |
| {"Allows textures with formats \"r32float\" \"rg32float\" and \"rgba32float\" to be filtered.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1664", FeatureInfo::FeatureState::Stable}}, |
| {Feature::ChromiumExperimentalSubgroups, |
| {"Experimental, allows using subgroup and supports the \"enable " |
| "chromium_experimental_subgroups\" directive in WGSL. Only used to investigate the semantic " |
| "of subgroups and should not be relied upon.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=464", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::ChromiumExperimentalSubgroupUniformControlFlow, |
| {"Experimental, supports VK_KHR_shader_subgroup_uniform_control_flow on Vulkan devices. Only " |
| "used to investigate the semantic of subgroups and should not be relied upon.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=464", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::ChromiumExperimentalReadWriteStorageTexture, |
| {"Experimental, supports ReadOnly and ReadWrite as storage texture access mode.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1972", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::DawnInternalUsages, |
| {"Add internal usages to resources to affect how the texture is allocated, but not " |
| "frontend validation. Other internal commands may access this usage.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "dawn_internal_usages.md", |
| FeatureInfo::FeatureState::Stable}}, |
| {Feature::DawnMultiPlanarFormats, |
| {"Import and use multi-planar texture formats with per plane views", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=551", FeatureInfo::FeatureState::Stable}}, |
| {Feature::MultiPlanarFormatExtendedUsages, |
| {"Enable creating multi-planar formatted textures directly without importing. Also allows " |
| "including CopyDst as texture's usage and per plane copies between a texture and a buffer.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=551", |
| FeatureInfo::FeatureState::Experimental}}, |
| // TODO(dawn:551): Merge the feature 'MultiPlanarFormatP010' to 'DawnMultiPlanarFormats' once it |
| // is implemented on all other missing backends. |
| {Feature::MultiPlanarFormatP010, |
| {"Import and use the P010 multi-planar texture format with per plane views", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=551", FeatureInfo::FeatureState::Stable}}, |
| {Feature::DawnNative, |
| {"WebGPU is running on top of dawn_native.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "dawn_native.md", |
| FeatureInfo::FeatureState::Stable}}, |
| {Feature::ImplicitDeviceSynchronization, |
| {"Public API methods (except encoding) will have implicit device synchronization. So they " |
| "will be safe to be used on multiple threads.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1662", FeatureInfo::FeatureState::Stable}}, |
| {Feature::SurfaceCapabilities, |
| {"Support querying Surface's capabilities such as supported usage flags. This feature also " |
| "enables swap chain to be created with usage other than RenderAttachment.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1760", FeatureInfo::FeatureState::Stable}}, |
| {Feature::TransientAttachments, |
| {"Support transient attachments that allow render pass operations to stay in tile memory, " |
| "avoiding VRAM traffic and potentially avoiding VRAM allocation for the textures.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1695", FeatureInfo::FeatureState::Stable}}, |
| {Feature::MSAARenderToSingleSampled, |
| {"Support multisampled rendering on single-sampled attachments efficiently.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1710", FeatureInfo::FeatureState::Stable}}, |
| {Feature::DualSourceBlending, |
| {"Support dual source blending. Enables Src1, OneMinusSrc1, Src1Alpha, and OneMinusSrc1Alpha " |
| "blend factors along with @index WGSL output attribute.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "dual_source_blending.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::D3D11MultithreadProtected, |
| {"Enable ID3D11Multithread protection for interop with external users of the D3D11 device.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1927", FeatureInfo::FeatureState::Stable}}, |
| {Feature::ANGLETextureSharing, |
| {"Enable ANGLE texture sharing to allow the OpenGL ES backend to share textures by external " |
| "OpenGL texture ID.", |
| "https://chromium.googlesource.com/angle/angle/+/refs/heads/main/extensions/" |
| "EGL_ANGLE_display_texture_share_group.txt", |
| FeatureInfo::FeatureState::Stable}}, |
| {Feature::PixelLocalStorageCoherent, |
| {"Supports passing information between invocation in a render pass that cover the same pixel." |
| "This helps more efficiently implement algorithms that would otherwise require ping-ponging" |
| "between render targets. The coherent version of this extension means that no barrier calls" |
| "are needed to prevent data races between fragment shaders on the same pixel.", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1704", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::PixelLocalStorageNonCoherent, |
| {"Supports passing information between invocation in a render pass that cover the same pixel." |
| "This helps more efficiently implement algorithms that would otherwise require ping-ponging" |
| "between render targets. The non-coherent version of this extension means that barrier calls" |
| "are needed to prevent data races between fragment shaders on the same pixels (note that " |
| "overlapping fragments from the same draw cannot be made data race free).", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1704", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::Norm16TextureFormats, |
| {"Supports R/RG/RGBA16 norm texture formats", |
| "https://bugs.chromium.org/p/dawn/issues/detail?id=1982", FeatureInfo::FeatureState::Stable}}, |
| {Feature::SharedTextureMemoryVkDedicatedAllocation, |
| {"Support specifying whether a Vulkan allocation for shared texture memory is a dedicated " |
| "memory allocation.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "shared_texture_memory.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedTextureMemoryAHardwareBuffer, |
| {"Support importing AHardwareBuffer as shared texture memory.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "shared_texture_memory.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedTextureMemoryDmaBuf, |
| {"Support importing DmaBuf as shared texture memory.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "shared_texture_memory.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedTextureMemoryOpaqueFD, |
| {"Support importing OpaqueFD as shared texture memory.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "shared_texture_memory.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedTextureMemoryZirconHandle, |
| {"Support importing ZirconHandle as shared texture memory.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "shared_texture_memory.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedTextureMemoryDXGISharedHandle, |
| {"Support importing DXGISharedHandle as shared texture memory.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "shared_texture_memory.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedTextureMemoryD3D11Texture2D, |
| {"Support importing D3D11Texture2D as shared texture memory.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "shared_texture_memory.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedTextureMemoryIOSurface, |
| {"Support importing IOSurface as shared texture memory.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "shared_texture_memory.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedTextureMemoryEGLImage, |
| {"Support importing EGLImage as shared texture memory.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "shared_texture_memory.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedFenceVkSemaphoreOpaqueFD, |
| {"Support for importing and exporting VkSemaphoreOpaqueFD used for GPU synchronization.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/shared_fence.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedFenceVkSemaphoreSyncFD, |
| {"Support for importing and exporting VkSemaphoreSyncFD used for GPU synchronization.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/shared_fence.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedFenceVkSemaphoreZirconHandle, |
| {"Support for importing and exporting VkSemaphoreZirconHandle used for GPU synchronization.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/shared_fence.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedFenceDXGISharedHandle, |
| {"Support for importing and exporting DXGISharedHandle used for GPU synchronization.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/shared_fence.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::SharedFenceMTLSharedEvent, |
| {"Support for importing and exporting MTLSharedEvent used for GPU synchronization.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/shared_fence.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| {Feature::HostMappedPointer, |
| {"Support creation of buffers from host-mapped pointers.", |
| "https://dawn.googlesource.com/dawn/+/refs/heads/main/docs/dawn/features/" |
| "host_mapped_pointer.md", |
| FeatureInfo::FeatureState::Experimental}}, |
| }; |
| |
| } // anonymous namespace |
| |
| void FeaturesSet::EnableFeature(Feature feature) { |
| DAWN_ASSERT(feature != Feature::InvalidEnum); |
| featuresBitSet.set(feature); |
| } |
| |
| void FeaturesSet::EnableFeature(wgpu::FeatureName feature) { |
| EnableFeature(FromAPI(feature)); |
| } |
| |
| bool FeaturesSet::IsEnabled(Feature feature) const { |
| DAWN_ASSERT(feature != Feature::InvalidEnum); |
| return featuresBitSet[feature]; |
| } |
| |
| bool FeaturesSet::IsEnabled(wgpu::FeatureName feature) const { |
| Feature f = FromAPI(feature); |
| return f != Feature::InvalidEnum && IsEnabled(f); |
| } |
| |
| size_t FeaturesSet::EnumerateFeatures(wgpu::FeatureName* features) const { |
| for (Feature f : IterateBitSet(featuresBitSet)) { |
| wgpu::FeatureName feature = ToAPI(f); |
| if (features != nullptr) { |
| *features = feature; |
| features += 1; |
| } |
| } |
| return featuresBitSet.count(); |
| } |
| |
| std::vector<const char*> FeaturesSet::GetEnabledFeatureNames() const { |
| std::vector<const char*> enabledFeatureNames(featuresBitSet.count()); |
| |
| uint32_t index = 0; |
| for (Feature feature : IterateBitSet(featuresBitSet)) { |
| DAWN_ASSERT(feature != Feature::InvalidEnum); |
| enabledFeatureNames[index] = kFeatureNameAndInfoList[feature].name; |
| ++index; |
| } |
| return enabledFeatureNames; |
| } |
| |
| } // namespace dawn::native |
| |
| #include "dawn/native/Features_autogen.inl" |