| // 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 <vector> |
| |
| #include "dawn/native/Features.h" |
| #include "dawn/native/Instance.h" |
| #include "dawn/native/Toggles.h" |
| #include "dawn/native/null/DeviceNull.h" |
| #include "gtest/gtest.h" |
| |
| class FeatureTests : public testing::Test { |
| public: |
| FeatureTests() |
| : testing::Test(), |
| mInstanceBase(dawn::native::InstanceBase::Create()), |
| mAdapterBase(mInstanceBase.Get()), |
| mUnsafeAdapterBase( |
| mInstanceBase.Get(), |
| dawn::native::TogglesState(dawn::native::ToggleStage::Adapter) |
| .SetForTesting(dawn::native::Toggle::DisallowUnsafeAPIs, false, false)) {} |
| |
| std::vector<wgpu::FeatureName> GetAllFeatureNames() { |
| std::vector<wgpu::FeatureName> allFeatureNames(kTotalFeaturesCount); |
| for (size_t i = 0; i < kTotalFeaturesCount; ++i) { |
| allFeatureNames[i] = FeatureEnumToAPIFeature(static_cast<dawn::native::Feature>(i)); |
| } |
| return allFeatureNames; |
| } |
| |
| static constexpr size_t kTotalFeaturesCount = |
| static_cast<size_t>(dawn::native::Feature::EnumCount); |
| |
| protected: |
| // By default DisallowUnsafeAPIs is enabled in this instance. |
| Ref<dawn::native::InstanceBase> mInstanceBase; |
| // The adapter that inherit toggles states from the instance, also have DisallowUnsafeAPIs |
| // enabled. |
| dawn::native::null::Adapter mAdapterBase; |
| // The adapter that override DisallowUnsafeAPIs to disabled in toggles state. |
| dawn::native::null::Adapter mUnsafeAdapterBase; |
| }; |
| |
| // Test the creation of a device will fail if the requested feature is not supported on the |
| // Adapter. |
| TEST_F(FeatureTests, AdapterWithRequiredFeatureDisabled) { |
| const std::vector<wgpu::FeatureName> kAllFeatureNames = GetAllFeatureNames(); |
| for (size_t i = 0; i < kTotalFeaturesCount; ++i) { |
| dawn::native::Feature notSupportedFeature = static_cast<dawn::native::Feature>(i); |
| |
| std::vector<wgpu::FeatureName> featureNamesWithoutOne = kAllFeatureNames; |
| featureNamesWithoutOne.erase(featureNamesWithoutOne.begin() + i); |
| |
| // Test that the adapter with unsafe apis disallowed validate features as expected. |
| { |
| mAdapterBase.SetSupportedFeaturesForTesting(featureNamesWithoutOne); |
| dawn::native::Adapter adapterWithoutFeature(&mAdapterBase); |
| |
| wgpu::DeviceDescriptor deviceDescriptor; |
| wgpu::FeatureName featureName = FeatureEnumToAPIFeature(notSupportedFeature); |
| deviceDescriptor.requiredFeatures = &featureName; |
| deviceDescriptor.requiredFeaturesCount = 1; |
| |
| WGPUDevice deviceWithFeature = adapterWithoutFeature.CreateDevice( |
| reinterpret_cast<const WGPUDeviceDescriptor*>(&deviceDescriptor)); |
| ASSERT_EQ(nullptr, deviceWithFeature); |
| } |
| |
| // Test that the adapter with unsafe apis allowed validate features as expected. |
| { |
| mUnsafeAdapterBase.SetSupportedFeaturesForTesting(featureNamesWithoutOne); |
| dawn::native::Adapter adapterWithoutFeature(&mUnsafeAdapterBase); |
| |
| wgpu::DeviceDescriptor deviceDescriptor; |
| wgpu::FeatureName featureName = FeatureEnumToAPIFeature(notSupportedFeature); |
| deviceDescriptor.requiredFeatures = &featureName; |
| deviceDescriptor.requiredFeaturesCount = 1; |
| |
| WGPUDevice deviceWithFeature = adapterWithoutFeature.CreateDevice( |
| reinterpret_cast<const WGPUDeviceDescriptor*>(&deviceDescriptor)); |
| ASSERT_EQ(nullptr, deviceWithFeature); |
| } |
| } |
| } |
| |
| // Test creating device requiring a supported feature can succeed (with DisallowUnsafeApis adapter |
| // toggle disabled for experimental features), and Device.GetEnabledFeatures() can return the names |
| // of the enabled features correctly. |
| TEST_F(FeatureTests, RequireAndGetEnabledFeatures) { |
| dawn::native::Adapter adapter(&mAdapterBase); |
| dawn::native::Adapter unsafeAdapter(&mUnsafeAdapterBase); |
| dawn::native::FeaturesInfo featuresInfo; |
| |
| for (size_t i = 0; i < kTotalFeaturesCount; ++i) { |
| dawn::native::Feature feature = static_cast<dawn::native::Feature>(i); |
| wgpu::FeatureName featureName = FeatureEnumToAPIFeature(feature); |
| |
| wgpu::DeviceDescriptor deviceDescriptor; |
| deviceDescriptor.requiredFeatures = &featureName; |
| deviceDescriptor.requiredFeaturesCount = 1; |
| |
| // Test with the adapter with DisallowUnsafeApis adapter toggles not disabled. |
| { |
| dawn::native::DeviceBase* deviceBase = dawn::native::FromAPI(adapter.CreateDevice( |
| reinterpret_cast<const WGPUDeviceDescriptor*>(&deviceDescriptor))); |
| |
| // Creating a device with experimental feature requires the adapter disables |
| // DisallowUnsafeApis, otherwise a validation error. |
| if (featuresInfo.GetFeatureInfo(featureName)->featureState == |
| dawn::native::FeatureInfo::FeatureState::Experimental) { |
| ASSERT_EQ(nullptr, deviceBase); |
| } else { |
| // Requiring stable features should succeed. |
| ASSERT_NE(nullptr, deviceBase); |
| ASSERT_EQ(1u, deviceBase->APIEnumerateFeatures(nullptr)); |
| wgpu::FeatureName enabledFeature; |
| deviceBase->APIEnumerateFeatures(&enabledFeature); |
| EXPECT_EQ(enabledFeature, featureName); |
| deviceBase->APIRelease(); |
| } |
| } |
| |
| // Test with the adapter with DisallowUnsafeApis toggles disabled, creating device should |
| // always succeed. |
| { |
| dawn::native::DeviceBase* deviceBase = dawn::native::FromAPI(unsafeAdapter.CreateDevice( |
| reinterpret_cast<const WGPUDeviceDescriptor*>(&deviceDescriptor))); |
| |
| ASSERT_NE(nullptr, deviceBase); |
| ASSERT_EQ(1u, deviceBase->APIEnumerateFeatures(nullptr)); |
| wgpu::FeatureName enabledFeature; |
| deviceBase->APIEnumerateFeatures(&enabledFeature); |
| EXPECT_EQ(enabledFeature, featureName); |
| deviceBase->APIRelease(); |
| } |
| } |
| } |