/* * Copyright (c) Contributors to the Open 3D Engine Project. * For complete copyright and license terms please see the LICENSE at the root of this distribution. * * SPDX-License-Identifier: Apache-2.0 OR MIT * */ #include #include #include #include #include namespace UnitTest { AZ::RHI::ImageSubresourceLayout BuildSubImageLayout(AZ::u32 width, AZ::u32 height, AZ::u32 pixelSize) { AZ::RHI::ImageSubresourceLayout layout; layout.m_size = AZ::RHI::Size{ width, height, 1 }; layout.m_rowCount = width; layout.m_bytesPerRow = width * pixelSize; layout.m_bytesPerImage = width * height * pixelSize; return layout; } AZStd::vector BuildBasicImageData(AZ::u32 width, AZ::u32 height, AZ::u32 pixelSize, AZ::s32 seed) { const size_t imageSize = width * height * pixelSize; AZStd::vector image; image.reserve(imageSize); size_t value = 0; AZStd::hash_combine(value, seed); for (AZ::u32 x = 0; x < width; ++x) { for (AZ::u32 y = 0; y < height; ++y) { AZStd::hash_combine(value, x); AZStd::hash_combine(value, y); image.push_back(static_cast(value)); } } EXPECT_EQ(image.size(), imageSize); return image; } AZ::Data::Asset BuildBasicMipChainAsset(AZ::u16 mipLevels, AZ::u16 arraySize, AZ::u32 width, AZ::u32 height, AZ::u32 pixelSize, AZ::s32 seed) { using namespace AZ; RPI::ImageMipChainAssetCreator assetCreator; assetCreator.Begin(Data::AssetId(AZ::Uuid::CreateRandom()), mipLevels, arraySize); RHI::ImageSubresourceLayout layout = BuildSubImageLayout(width, height, pixelSize); assetCreator.BeginMip(layout); for (AZ::u32 arrayIndex = 0; arrayIndex < arraySize; ++arrayIndex) { AZStd::vector data = BuildBasicImageData(width, height, pixelSize, seed); assetCreator.AddSubImage(data.data(), data.size()); } assetCreator.EndMip(); Data::Asset asset; EXPECT_TRUE(assetCreator.End(asset)); EXPECT_TRUE(asset.IsReady()); EXPECT_NE(asset.Get(), nullptr); return asset; } AZStd::vector BuildSpecificPixelImageData(AZ::u32 width, AZ::u32 height, AZ::u32 pixelSize, AZ::u32 pixelX, AZ::u32 pixelY) { const size_t imageSize = width * height * pixelSize; AZStd::vector image; image.reserve(imageSize); const AZ::u8 pixelValue = 255; // Image data should be stored inverted on the y axis relative to our engine, so loop backwards through y. for (int y = static_cast(height) - 1; y >= 0; --y) { for (AZ::u32 x = 0; x < width; ++x) { if ((x == static_cast(pixelX)) && (y == static_cast(pixelY))) { image.push_back(pixelValue); } else { image.push_back(0); } } } EXPECT_EQ(image.size(), imageSize); return image; } AZ::Data::Asset BuildSpecificPixelMipChainAsset(AZ::u16 mipLevels, AZ::u16 arraySize, AZ::u32 width, AZ::u32 height, AZ::u32 pixelSize, AZ::u32 pixelX, AZ::u32 pixelY) { using namespace AZ; RPI::ImageMipChainAssetCreator assetCreator; assetCreator.Begin(Data::AssetId(AZ::Uuid::CreateRandom()), mipLevels, arraySize); RHI::ImageSubresourceLayout layout = BuildSubImageLayout(width, height, pixelSize); assetCreator.BeginMip(layout); for (AZ::u32 arrayIndex = 0; arrayIndex < arraySize; ++arrayIndex) { AZStd::vector data = BuildSpecificPixelImageData(width, height, pixelSize, pixelX, pixelY); assetCreator.AddSubImage(data.data(), data.size()); } assetCreator.EndMip(); Data::Asset asset; EXPECT_TRUE(assetCreator.End(asset)); EXPECT_TRUE(asset.IsReady()); EXPECT_NE(asset.Get(), nullptr); return asset; } AZ::Data::Asset CreateImageAsset(AZ::u32 width, AZ::u32 height, AZ::s32 seed) { auto randomAssetId = AZ::Data::AssetId(AZ::Uuid::CreateRandom()); auto imageAsset = AZ::Data::AssetManager::Instance().CreateAsset( randomAssetId, AZ::Data::AssetLoadBehavior::Default); const AZ::u32 arraySize = 1; const AZ::u32 mipCountTotal = 1; const auto format = AZ::RHI::Format::R8_UNORM; const AZ::u32 pixelSize = AZ::RHI::GetFormatComponentCount(format); AZ::Data::Asset mipChain = BuildBasicMipChainAsset(mipCountTotal, arraySize, width, height, pixelSize, seed); AZ::RPI::StreamingImageAssetCreator assetCreator; assetCreator.Begin(randomAssetId); AZ::RHI::ImageDescriptor imageDesc = AZ::RHI::ImageDescriptor::Create2DArray(AZ::RHI::ImageBindFlags::ShaderRead, width, height, arraySize, format); imageDesc.m_mipLevels = static_cast(mipCountTotal); assetCreator.SetImageDescriptor(imageDesc); assetCreator.AddMipChainAsset(*mipChain.Get()); EXPECT_TRUE(assetCreator.End(imageAsset)); EXPECT_TRUE(imageAsset.IsReady()); EXPECT_NE(imageAsset.Get(), nullptr); return imageAsset; } AZ::Data::Asset CreateSpecificPixelImageAsset(AZ::u32 width, AZ::u32 height, AZ::u32 pixelX, AZ::u32 pixelY) { auto randomAssetId = AZ::Data::AssetId(AZ::Uuid::CreateRandom()); auto imageAsset = AZ::Data::AssetManager::Instance().CreateAsset( randomAssetId, AZ::Data::AssetLoadBehavior::Default); const AZ::u32 arraySize = 1; const AZ::u32 mipCountTotal = 1; const auto format = AZ::RHI::Format::R8_UNORM; const AZ::u32 pixelSize = AZ::RHI::GetFormatComponentCount(format); AZ::Data::Asset mipChain = BuildSpecificPixelMipChainAsset(mipCountTotal, arraySize, width, height, pixelSize, pixelX, pixelY); AZ::RPI::StreamingImageAssetCreator assetCreator; assetCreator.Begin(randomAssetId); AZ::RHI::ImageDescriptor imageDesc = AZ::RHI::ImageDescriptor::Create2DArray(AZ::RHI::ImageBindFlags::ShaderRead, width, height, arraySize, format); imageDesc.m_mipLevels = static_cast(mipCountTotal); assetCreator.SetImageDescriptor(imageDesc); assetCreator.AddMipChainAsset(*mipChain.Get()); EXPECT_TRUE(assetCreator.End(imageAsset)); EXPECT_TRUE(imageAsset.IsReady()); EXPECT_NE(imageAsset.Get(), nullptr); return imageAsset; } void GradientSignalTestHelpers::CompareGetValueAndGetValues(AZ::EntityId gradientEntityId, float queryMin, float queryMax) { // Create a gradient sampler and run through a series of points to see if they match expectations. const AZ::Aabb queryRegion = AZ::Aabb::CreateFromMinMax(AZ::Vector3(queryMin), AZ::Vector3(queryMax)); const AZ::Vector2 stepSize(1.0f, 1.0f); GradientSignal::GradientSampler gradientSampler; gradientSampler.m_gradientId = gradientEntityId; const size_t numSamplesX = aznumeric_cast(ceil(queryRegion.GetExtents().GetX() / stepSize.GetX())); const size_t numSamplesY = aznumeric_cast(ceil(queryRegion.GetExtents().GetY() / stepSize.GetY())); // Build up the list of positions to query. AZStd::vector positions(numSamplesX * numSamplesY); size_t index = 0; for (size_t yIndex = 0; yIndex < numSamplesY; yIndex++) { float y = queryRegion.GetMin().GetY() + (stepSize.GetY() * yIndex); for (size_t xIndex = 0; xIndex < numSamplesX; xIndex++) { float x = queryRegion.GetMin().GetX() + (stepSize.GetX() * xIndex); positions[index++] = AZ::Vector3(x, y, 0.0f); } } // Get the results from GetValues AZStd::vector results(numSamplesX * numSamplesY); gradientSampler.GetValues(positions, results); // For each position, call GetValue and verify that the values match. for (size_t positionIndex = 0; positionIndex < positions.size(); positionIndex++) { GradientSignal::GradientSampleParams params; params.m_position = positions[positionIndex]; float value = gradientSampler.GetValue(params); // We use ASSERT_NEAR instead of EXPECT_NEAR because if one value doesn't match, they probably all won't, so there's no // reason to keep running and printing failures for every value. ASSERT_NEAR(value, results[positionIndex], 0.000001f); } } #ifdef HAVE_BENCHMARK void GradientSignalTestHelpers::FillQueryPositions(AZStd::vector& positions, float height, float width) { size_t index = 0; for (float y = 0.0f; y < height; y += 1.0f) { for (float x = 0.0f; x < width; x += 1.0f) { positions[index++] = AZ::Vector3(x, y, 0.0f); } } } void GradientSignalTestHelpers::RunEBusGetValueBenchmark(benchmark::State& state, const AZ::EntityId& gradientId, int64_t queryRange) { AZ_PROFILE_FUNCTION(Entity); GradientSignal::GradientSampleParams params; // Get the height and width ranges for querying from our benchmark parameters const float height = aznumeric_cast(queryRange); const float width = aznumeric_cast(queryRange); // Call GetValue() on the EBus for every height and width in our ranges. for (auto _ : state) { for (float y = 0.0f; y < height; y += 1.0f) { for (float x = 0.0f; x < width; x += 1.0f) { float value = 0.0f; params.m_position = AZ::Vector3(x, y, 0.0f); GradientSignal::GradientRequestBus::EventResult( value, gradientId, &GradientSignal::GradientRequestBus::Events::GetValue, params); benchmark::DoNotOptimize(value); } } } } void GradientSignalTestHelpers::RunEBusGetValuesBenchmark(benchmark::State& state, const AZ::EntityId& gradientId, int64_t queryRange) { AZ_PROFILE_FUNCTION(Entity); // Get the height and width ranges for querying from our benchmark parameters float height = aznumeric_cast(queryRange); float width = aznumeric_cast(queryRange); int64_t totalQueryPoints = queryRange * queryRange; // Call GetValues() for every height and width in our ranges. for (auto _ : state) { // Set up our vector of query positions. This is done inside the benchmark timing since we're counting the work to create // each query position in the single GetValue() call benchmarks, and will make the timing more directly comparable. AZStd::vector positions(totalQueryPoints); FillQueryPositions(positions, height, width); // Query and get the results. AZStd::vector results(totalQueryPoints); GradientSignal::GradientRequestBus::Event( gradientId, &GradientSignal::GradientRequestBus::Events::GetValues, positions, results); benchmark::DoNotOptimize(results); } } void GradientSignalTestHelpers::RunSamplerGetValueBenchmark(benchmark::State& state, const AZ::EntityId& gradientId, int64_t queryRange) { AZ_PROFILE_FUNCTION(Entity); // Create a gradient sampler to use for querying our gradient. GradientSignal::GradientSampler gradientSampler; gradientSampler.m_gradientId = gradientId; // Get the height and width ranges for querying from our benchmark parameters const float height = aznumeric_cast(queryRange); const float width = aznumeric_cast(queryRange); // Call GetValue() through the GradientSampler for every height and width in our ranges. for (auto _ : state) { for (float y = 0.0f; y < height; y += 1.0f) { for (float x = 0.0f; x < width; x += 1.0f) { GradientSignal::GradientSampleParams params; params.m_position = AZ::Vector3(x, y, 0.0f); float value = gradientSampler.GetValue(params); benchmark::DoNotOptimize(value); } } } } void GradientSignalTestHelpers::RunSamplerGetValuesBenchmark( benchmark::State& state, const AZ::EntityId& gradientId, int64_t queryRange) { AZ_PROFILE_FUNCTION(Entity); // Create a gradient sampler to use for querying our gradient. GradientSignal::GradientSampler gradientSampler; gradientSampler.m_gradientId = gradientId; // Get the height and width ranges for querying from our benchmark parameters const float height = aznumeric_cast(queryRange); const float width = aznumeric_cast(queryRange); const int64_t totalQueryPoints = queryRange * queryRange; // Call GetValues() through the GradientSampler for every height and width in our ranges. for (auto _ : state) { // Set up our vector of query positions. This is done inside the benchmark timing since we're counting the work to create // each query position in the single GetValue() call benchmarks, and will make the timing more directly comparable. AZStd::vector positions(totalQueryPoints); FillQueryPositions(positions, height, width); // Query and get the results. AZStd::vector results(totalQueryPoints); gradientSampler.GetValues(positions, results); benchmark::DoNotOptimize(results); } } void GradientSignalTestHelpers::RunGetValueOrGetValuesBenchmark(benchmark::State& state, const AZ::EntityId& gradientId) { switch (state.range(0)) { case GetValuePermutation::EBUS_GET_VALUE: RunEBusGetValueBenchmark(state, gradientId, state.range(1)); break; case GetValuePermutation::EBUS_GET_VALUES: RunEBusGetValuesBenchmark(state, gradientId, state.range(1)); break; case GetValuePermutation::SAMPLER_GET_VALUE: RunSamplerGetValueBenchmark(state, gradientId, state.range(1)); break; case GetValuePermutation::SAMPLER_GET_VALUES: RunSamplerGetValuesBenchmark(state, gradientId, state.range(1)); break; default: AZ_Assert(false, "Benchmark permutation type not supported."); } } #endif }