// Copyright 2017 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/Texture.h" #include #include "common/Assert.h" #include "common/Constants.h" #include "common/Math.h" #include "dawn_native/Device.h" #include "dawn_native/EnumMaskIterator.h" #include "dawn_native/PassResourceUsage.h" #include "dawn_native/ValidationUtils_autogen.h" namespace dawn_native { namespace { // TODO(jiawei.shao@intel.com): implement texture view format compatibility rule MaybeError ValidateTextureViewFormatCompatibility(const TextureBase* texture, const TextureViewDescriptor* descriptor) { if (texture->GetFormat().format != descriptor->format) { if (descriptor->aspect != wgpu::TextureAspect::All && texture->GetFormat().GetAspectInfo(descriptor->aspect).format == descriptor->format) { return {}; } return DAWN_VALIDATION_ERROR( "The format of texture view is not compatible to the original texture"); } return {}; } // TODO(jiawei.shao@intel.com): support validation on all texture view dimensions bool IsTextureViewDimensionCompatibleWithTextureDimension( wgpu::TextureViewDimension textureViewDimension, wgpu::TextureDimension textureDimension) { switch (textureViewDimension) { case wgpu::TextureViewDimension::e2D: case wgpu::TextureViewDimension::e2DArray: case wgpu::TextureViewDimension::Cube: case wgpu::TextureViewDimension::CubeArray: return textureDimension == wgpu::TextureDimension::e2D; case wgpu::TextureViewDimension::e3D: return textureDimension == wgpu::TextureDimension::e3D; case wgpu::TextureViewDimension::e1D: case wgpu::TextureViewDimension::Undefined: UNREACHABLE(); } } // TODO(jiawei.shao@intel.com): support validation on all texture view dimensions bool IsArrayLayerValidForTextureViewDimension( wgpu::TextureViewDimension textureViewDimension, uint32_t textureViewArrayLayer) { switch (textureViewDimension) { case wgpu::TextureViewDimension::e2D: case wgpu::TextureViewDimension::e3D: return textureViewArrayLayer == 1u; case wgpu::TextureViewDimension::e2DArray: return true; case wgpu::TextureViewDimension::Cube: return textureViewArrayLayer == 6u; case wgpu::TextureViewDimension::CubeArray: return textureViewArrayLayer % 6 == 0; case wgpu::TextureViewDimension::e1D: case wgpu::TextureViewDimension::Undefined: UNREACHABLE(); } } bool IsTextureSizeValidForTextureViewDimension( wgpu::TextureViewDimension textureViewDimension, const Extent3D& textureSize) { switch (textureViewDimension) { case wgpu::TextureViewDimension::Cube: case wgpu::TextureViewDimension::CubeArray: return textureSize.width == textureSize.height; case wgpu::TextureViewDimension::e2D: case wgpu::TextureViewDimension::e2DArray: case wgpu::TextureViewDimension::e3D: return true; case wgpu::TextureViewDimension::e1D: case wgpu::TextureViewDimension::Undefined: UNREACHABLE(); } } // TODO(jiawei.shao@intel.com): support more sample count. MaybeError ValidateSampleCount(const TextureDescriptor* descriptor, const Format* format) { if (!IsValidSampleCount(descriptor->sampleCount)) { return DAWN_VALIDATION_ERROR("The sample count of the texture is not supported."); } if (descriptor->sampleCount > 1) { if (descriptor->mipLevelCount > 1) { return DAWN_VALIDATION_ERROR( "The mipmap level count of a multisampled texture must be 1."); } // Multisampled 1D and 3D textures are not supported in D3D12/Metal/Vulkan. // Multisampled 2D array texture is not supported because on Metal it requires the // version of macOS be greater than 10.14. if (descriptor->dimension != wgpu::TextureDimension::e2D || descriptor->size.depthOrArrayLayers > 1) { return DAWN_VALIDATION_ERROR("Multisampled texture must be 2D with depth=1"); } // If a format can support multisample, it must be renderable. Because Vulkan // requires that if the format is not color-renderable or depth/stencil renderable, // sampleCount must be 1. if (!format->isRenderable) { return DAWN_VALIDATION_ERROR("This format cannot support multisample."); } // Compressed formats are not renderable. They cannot support multisample. ASSERT(!format->isCompressed); if (descriptor->usage & wgpu::TextureUsage::Storage) { return DAWN_VALIDATION_ERROR( "The sample counts of the storage textures must be 1."); } } return {}; } MaybeError ValidateTextureViewDimensionCompatibility( const TextureBase* texture, const TextureViewDescriptor* descriptor) { if (!IsArrayLayerValidForTextureViewDimension(descriptor->dimension, descriptor->arrayLayerCount)) { return DAWN_VALIDATION_ERROR( "The dimension of the texture view is not compatible with the layer count"); } if (!IsTextureViewDimensionCompatibleWithTextureDimension(descriptor->dimension, texture->GetDimension())) { return DAWN_VALIDATION_ERROR( "The dimension of the texture view is not compatible with the dimension of the" "original texture"); } if (!IsTextureSizeValidForTextureViewDimension(descriptor->dimension, texture->GetSize())) { return DAWN_VALIDATION_ERROR( "The dimension of the texture view is not compatible with the size of the" "original texture"); } return {}; } MaybeError ValidateTextureSize(const TextureDescriptor* descriptor, const Format* format) { ASSERT(descriptor->size.width != 0 && descriptor->size.height != 0 && descriptor->size.depthOrArrayLayers != 0); Extent3D maxExtent; switch (descriptor->dimension) { case wgpu::TextureDimension::e2D: maxExtent = {kMaxTextureDimension2D, kMaxTextureDimension2D, kMaxTextureArrayLayers}; break; case wgpu::TextureDimension::e3D: maxExtent = {kMaxTextureDimension3D, kMaxTextureDimension3D, kMaxTextureDimension3D}; break; case wgpu::TextureDimension::e1D: default: UNREACHABLE(); } if (descriptor->size.width > maxExtent.width || descriptor->size.height > maxExtent.height || descriptor->size.depthOrArrayLayers > maxExtent.depthOrArrayLayers) { return DAWN_VALIDATION_ERROR("Texture dimension (width, height or depth) exceeded"); } uint32_t maxMippedDimension = descriptor->size.width; if (descriptor->dimension != wgpu::TextureDimension::e1D) { maxMippedDimension = std::max(maxMippedDimension, descriptor->size.height); } if (descriptor->dimension == wgpu::TextureDimension::e3D) { maxMippedDimension = std::max(maxMippedDimension, descriptor->size.depthOrArrayLayers); } if (Log2(maxMippedDimension) + 1 < descriptor->mipLevelCount) { return DAWN_VALIDATION_ERROR("Texture has too many mip levels"); } ASSERT(descriptor->mipLevelCount <= kMaxTexture2DMipLevels); if (format->isCompressed) { const TexelBlockInfo& blockInfo = format->GetAspectInfo(wgpu::TextureAspect::All).block; if (descriptor->size.width % blockInfo.width != 0 || descriptor->size.height % blockInfo.height != 0) { return DAWN_VALIDATION_ERROR( "The size of the texture is incompatible with the texture format"); } } return {}; } MaybeError ValidateTextureUsage(const TextureDescriptor* descriptor, const Format* format) { DAWN_TRY(dawn_native::ValidateTextureUsage(descriptor->usage)); constexpr wgpu::TextureUsage kValidCompressedUsages = wgpu::TextureUsage::Sampled | wgpu::TextureUsage::CopySrc | wgpu::TextureUsage::CopyDst; if (format->isCompressed && !IsSubset(descriptor->usage, kValidCompressedUsages)) { return DAWN_VALIDATION_ERROR( "Compressed texture format is incompatible with the texture usage"); } if (!format->isRenderable && (descriptor->usage & wgpu::TextureUsage::RenderAttachment)) { return DAWN_VALIDATION_ERROR( "Non-renderable format used with RenderAttachment usage"); } if (!format->supportsStorageUsage && (descriptor->usage & wgpu::TextureUsage::Storage)) { return DAWN_VALIDATION_ERROR("Format cannot be used in storage textures"); } constexpr wgpu::TextureUsage kValidMultiPlanarUsages = wgpu::TextureUsage::Sampled; if (format->IsMultiPlanar() && !IsSubset(descriptor->usage, kValidMultiPlanarUsages)) { return DAWN_VALIDATION_ERROR("Multi-planar format doesn't have valid usage."); } return {}; } } // anonymous namespace MaybeError ValidateTextureDescriptor(const DeviceBase* device, const TextureDescriptor* descriptor) { if (descriptor->nextInChain != nullptr) { return DAWN_VALIDATION_ERROR("nextInChain must be nullptr"); } if (descriptor->dimension == wgpu::TextureDimension::e1D) { return DAWN_VALIDATION_ERROR("1D textures aren't supported (yet)."); } const Format* format; DAWN_TRY_ASSIGN(format, device->GetInternalFormat(descriptor->format)); DAWN_TRY(ValidateTextureUsage(descriptor, format)); DAWN_TRY(ValidateTextureDimension(descriptor->dimension)); DAWN_TRY(ValidateSampleCount(descriptor, format)); // TODO(jiawei.shao@intel.com): check stuff based on the dimension if (descriptor->size.width == 0 || descriptor->size.height == 0 || descriptor->size.depthOrArrayLayers == 0 || descriptor->mipLevelCount == 0) { return DAWN_VALIDATION_ERROR("Cannot create an empty texture"); } // Disallow 1D and 3D textures as unsafe until they are fully implemented. if (descriptor->dimension != wgpu::TextureDimension::e2D && device->IsToggleEnabled(Toggle::DisallowUnsafeAPIs)) { return DAWN_VALIDATION_ERROR( "1D and 3D textures are disallowed because they are not fully implemented"); } if (descriptor->dimension != wgpu::TextureDimension::e2D && format->isCompressed) { return DAWN_VALIDATION_ERROR("Compressed texture must be 2D"); } // Depth/stencil formats are valid for 2D textures only. Metal has this limit. And D3D12 // doesn't support depth/stencil formats on 3D textures. if (descriptor->dimension != wgpu::TextureDimension::e2D && (format->aspects & (Aspect::Depth | Aspect::Stencil)) != 0) { return DAWN_VALIDATION_ERROR("Depth/stencil formats are valid for 2D textures only"); } DAWN_TRY(ValidateTextureSize(descriptor, format)); return {}; } MaybeError ValidateTextureViewDescriptor(const DeviceBase* device, const TextureBase* texture, const TextureViewDescriptor* descriptor) { if (descriptor->nextInChain != nullptr) { return DAWN_VALIDATION_ERROR("nextInChain must be nullptr"); } // Parent texture should have been already validated. ASSERT(texture); ASSERT(!texture->IsError()); if (texture->GetTextureState() == TextureBase::TextureState::Destroyed) { return DAWN_VALIDATION_ERROR("Destroyed texture used to create texture view"); } DAWN_TRY(ValidateTextureViewDimension(descriptor->dimension)); if (descriptor->dimension == wgpu::TextureViewDimension::e1D) { return DAWN_VALIDATION_ERROR("1D texture views aren't supported (yet)."); } // Disallow 3D views as unsafe until they are fully implemented. if (descriptor->dimension == wgpu::TextureViewDimension::e3D && device->IsToggleEnabled(Toggle::DisallowUnsafeAPIs)) { return DAWN_VALIDATION_ERROR( "3D views are disallowed because they are not fully implemented"); } DAWN_TRY(ValidateTextureFormat(descriptor->format)); DAWN_TRY(ValidateTextureAspect(descriptor->aspect)); if (SelectFormatAspects(texture->GetFormat(), descriptor->aspect) == Aspect::None) { return DAWN_VALIDATION_ERROR("Texture does not have selected aspect for texture view."); } // TODO(jiawei.shao@intel.com): check stuff based on resource limits if (descriptor->arrayLayerCount == 0 || descriptor->mipLevelCount == 0) { return DAWN_VALIDATION_ERROR("Cannot create an empty texture view"); } if (uint64_t(descriptor->baseArrayLayer) + uint64_t(descriptor->arrayLayerCount) > uint64_t(texture->GetArrayLayers())) { return DAWN_VALIDATION_ERROR("Texture view array-layer out of range"); } if (uint64_t(descriptor->baseMipLevel) + uint64_t(descriptor->mipLevelCount) > uint64_t(texture->GetNumMipLevels())) { return DAWN_VALIDATION_ERROR("Texture view mip-level out of range"); } DAWN_TRY(ValidateTextureViewFormatCompatibility(texture, descriptor)); DAWN_TRY(ValidateTextureViewDimensionCompatibility(texture, descriptor)); return {}; } TextureViewDescriptor GetTextureViewDescriptorWithDefaults( const TextureBase* texture, const TextureViewDescriptor* descriptor) { ASSERT(texture); TextureViewDescriptor desc = {}; if (descriptor) { desc = *descriptor; } // The default value for the view dimension depends on the texture's dimension with a // special case for 2DArray being chosen automatically if arrayLayerCount is unspecified. if (desc.dimension == wgpu::TextureViewDimension::Undefined) { switch (texture->GetDimension()) { case wgpu::TextureDimension::e1D: desc.dimension = wgpu::TextureViewDimension::e1D; break; case wgpu::TextureDimension::e2D: if (texture->GetArrayLayers() > 1u && desc.arrayLayerCount == 0) { desc.dimension = wgpu::TextureViewDimension::e2DArray; } else { desc.dimension = wgpu::TextureViewDimension::e2D; } break; case wgpu::TextureDimension::e3D: desc.dimension = wgpu::TextureViewDimension::e3D; break; } } if (desc.format == wgpu::TextureFormat::Undefined) { // TODO(dawn:682): Use GetAspectInfo(aspect). desc.format = texture->GetFormat().format; } if (desc.arrayLayerCount == 0) { desc.arrayLayerCount = texture->GetArrayLayers() - desc.baseArrayLayer; } if (desc.mipLevelCount == 0) { desc.mipLevelCount = texture->GetNumMipLevels() - desc.baseMipLevel; } return desc; } bool IsValidSampleCount(uint32_t sampleCount) { switch (sampleCount) { case 1: case 4: return true; default: return false; } } // TextureBase TextureBase::TextureBase(DeviceBase* device, const TextureDescriptor* descriptor, TextureState state) : ObjectBase(device), mDimension(descriptor->dimension), mFormat(device->GetValidInternalFormat(descriptor->format)), mSize(descriptor->size), mMipLevelCount(descriptor->mipLevelCount), mSampleCount(descriptor->sampleCount), mUsage(descriptor->usage), mState(state) { uint32_t subresourceCount = mMipLevelCount * GetArrayLayers() * GetAspectCount(mFormat.aspects); mIsSubresourceContentInitializedAtIndex = std::vector(subresourceCount, false); // Add readonly storage usage if the texture has a storage usage. The validation rules in // ValidateSyncScopeResourceUsage will make sure we don't use both at the same time. if (mUsage & wgpu::TextureUsage::Storage) { mUsage |= kReadOnlyStorageTexture; } } static Format kUnusedFormat; TextureBase::TextureBase(DeviceBase* device, ObjectBase::ErrorTag tag) : ObjectBase(device, tag), mFormat(kUnusedFormat) { } // static TextureBase* TextureBase::MakeError(DeviceBase* device) { return new TextureBase(device, ObjectBase::kError); } wgpu::TextureDimension TextureBase::GetDimension() const { ASSERT(!IsError()); return mDimension; } // TODO(jiawei.shao@intel.com): return more information about texture format const Format& TextureBase::GetFormat() const { ASSERT(!IsError()); return mFormat; } const Extent3D& TextureBase::GetSize() const { ASSERT(!IsError()); return mSize; } uint32_t TextureBase::GetWidth() const { ASSERT(!IsError()); return mSize.width; } uint32_t TextureBase::GetHeight() const { ASSERT(!IsError()); ASSERT(mDimension != wgpu::TextureDimension::e1D); return mSize.height; } uint32_t TextureBase::GetDepth() const { ASSERT(!IsError()); ASSERT(mDimension == wgpu::TextureDimension::e3D); return mSize.depthOrArrayLayers; } uint32_t TextureBase::GetArrayLayers() const { ASSERT(!IsError()); // TODO(cwallez@chromium.org): Update for 1D textures when they are supported. ASSERT(mDimension != wgpu::TextureDimension::e1D); if (mDimension == wgpu::TextureDimension::e3D) { return 1; } return mSize.depthOrArrayLayers; } uint32_t TextureBase::GetNumMipLevels() const { ASSERT(!IsError()); return mMipLevelCount; } SubresourceRange TextureBase::GetAllSubresources() const { ASSERT(!IsError()); return {mFormat.aspects, {0, GetArrayLayers()}, {0, mMipLevelCount}}; } uint32_t TextureBase::GetSampleCount() const { ASSERT(!IsError()); return mSampleCount; } uint32_t TextureBase::GetSubresourceCount() const { ASSERT(!IsError()); return static_cast(mIsSubresourceContentInitializedAtIndex.size()); } wgpu::TextureUsage TextureBase::GetUsage() const { ASSERT(!IsError()); return mUsage; } TextureBase::TextureState TextureBase::GetTextureState() const { ASSERT(!IsError()); return mState; } uint32_t TextureBase::GetSubresourceIndex(uint32_t mipLevel, uint32_t arraySlice, Aspect aspect) const { ASSERT(arraySlice <= kMaxTextureArrayLayers); ASSERT(mipLevel <= kMaxTexture2DMipLevels); ASSERT(HasOneBit(aspect)); static_assert( kMaxTexture2DMipLevels <= std::numeric_limits::max() / kMaxTextureArrayLayers, "texture size overflows uint32_t"); return mipLevel + GetNumMipLevels() * (arraySlice + GetArrayLayers() * GetAspectIndex(aspect)); } bool TextureBase::IsSubresourceContentInitialized(const SubresourceRange& range) const { ASSERT(!IsError()); for (Aspect aspect : IterateEnumMask(range.aspects)) { for (uint32_t arrayLayer = range.baseArrayLayer; arrayLayer < range.baseArrayLayer + range.layerCount; ++arrayLayer) { for (uint32_t mipLevel = range.baseMipLevel; mipLevel < range.baseMipLevel + range.levelCount; ++mipLevel) { uint32_t subresourceIndex = GetSubresourceIndex(mipLevel, arrayLayer, aspect); ASSERT(subresourceIndex < mIsSubresourceContentInitializedAtIndex.size()); if (!mIsSubresourceContentInitializedAtIndex[subresourceIndex]) { return false; } } } } return true; } void TextureBase::SetIsSubresourceContentInitialized(bool isInitialized, const SubresourceRange& range) { ASSERT(!IsError()); for (Aspect aspect : IterateEnumMask(range.aspects)) { for (uint32_t arrayLayer = range.baseArrayLayer; arrayLayer < range.baseArrayLayer + range.layerCount; ++arrayLayer) { for (uint32_t mipLevel = range.baseMipLevel; mipLevel < range.baseMipLevel + range.levelCount; ++mipLevel) { uint32_t subresourceIndex = GetSubresourceIndex(mipLevel, arrayLayer, aspect); ASSERT(subresourceIndex < mIsSubresourceContentInitializedAtIndex.size()); mIsSubresourceContentInitializedAtIndex[subresourceIndex] = isInitialized; } } } } MaybeError TextureBase::ValidateCanUseInSubmitNow() const { ASSERT(!IsError()); if (mState == TextureState::Destroyed) { return DAWN_VALIDATION_ERROR("Destroyed texture used in a submit"); } return {}; } bool TextureBase::IsMultisampledTexture() const { ASSERT(!IsError()); return mSampleCount > 1; } Extent3D TextureBase::GetMipLevelVirtualSize(uint32_t level) const { Extent3D extent = {std::max(mSize.width >> level, 1u), 1u, 1u}; if (mDimension == wgpu::TextureDimension::e1D) { return extent; } extent.height = std::max(mSize.height >> level, 1u); if (mDimension == wgpu::TextureDimension::e2D) { return extent; } extent.depthOrArrayLayers = std::max(mSize.depthOrArrayLayers >> level, 1u); return extent; } Extent3D TextureBase::GetMipLevelPhysicalSize(uint32_t level) const { Extent3D extent = GetMipLevelVirtualSize(level); // Compressed Textures will have paddings if their width or height is not a multiple of // 4 at non-zero mipmap levels. if (mFormat.isCompressed) { // TODO(jiawei.shao@intel.com): check if there are any overflows. const TexelBlockInfo& blockInfo = mFormat.GetAspectInfo(wgpu::TextureAspect::All).block; extent.width = (extent.width + blockInfo.width - 1) / blockInfo.width * blockInfo.width; extent.height = (extent.height + blockInfo.height - 1) / blockInfo.height * blockInfo.height; } return extent; } Extent3D TextureBase::ClampToMipLevelVirtualSize(uint32_t level, const Origin3D& origin, const Extent3D& extent) const { const Extent3D virtualSizeAtLevel = GetMipLevelVirtualSize(level); uint32_t clampedCopyExtentWidth = (origin.x + extent.width > virtualSizeAtLevel.width) ? (virtualSizeAtLevel.width - origin.x) : extent.width; uint32_t clampedCopyExtentHeight = (origin.y + extent.height > virtualSizeAtLevel.height) ? (virtualSizeAtLevel.height - origin.y) : extent.height; return {clampedCopyExtentWidth, clampedCopyExtentHeight, extent.depthOrArrayLayers}; } TextureViewBase* TextureBase::APICreateView(const TextureViewDescriptor* descriptor) { DeviceBase* device = GetDevice(); Ref result; if (device->ConsumedError(device->CreateTextureView(this, descriptor), &result)) { return TextureViewBase::MakeError(device); } return result.Detach(); } void TextureBase::APIDestroy() { if (GetDevice()->ConsumedError(ValidateDestroy())) { return; } ASSERT(!IsError()); DestroyInternal(); } void TextureBase::DestroyImpl() { } void TextureBase::DestroyInternal() { DestroyImpl(); mState = TextureState::Destroyed; } MaybeError TextureBase::ValidateDestroy() const { DAWN_TRY(GetDevice()->ValidateObject(this)); return {}; } // TextureViewBase TextureViewBase::TextureViewBase(TextureBase* texture, const TextureViewDescriptor* descriptor) : ObjectBase(texture->GetDevice()), mTexture(texture), mFormat(GetDevice()->GetValidInternalFormat(descriptor->format)), mDimension(descriptor->dimension), mRange({ConvertViewAspect(mFormat, descriptor->aspect), {descriptor->baseArrayLayer, descriptor->arrayLayerCount}, {descriptor->baseMipLevel, descriptor->mipLevelCount}}) { } TextureViewBase::TextureViewBase(DeviceBase* device, ObjectBase::ErrorTag tag) : ObjectBase(device, tag), mFormat(kUnusedFormat) { } // static TextureViewBase* TextureViewBase::MakeError(DeviceBase* device) { return new TextureViewBase(device, ObjectBase::kError); } const TextureBase* TextureViewBase::GetTexture() const { ASSERT(!IsError()); return mTexture.Get(); } TextureBase* TextureViewBase::GetTexture() { ASSERT(!IsError()); return mTexture.Get(); } Aspect TextureViewBase::GetAspects() const { ASSERT(!IsError()); return mRange.aspects; } const Format& TextureViewBase::GetFormat() const { ASSERT(!IsError()); return mFormat; } wgpu::TextureViewDimension TextureViewBase::GetDimension() const { ASSERT(!IsError()); return mDimension; } uint32_t TextureViewBase::GetBaseMipLevel() const { ASSERT(!IsError()); return mRange.baseMipLevel; } uint32_t TextureViewBase::GetLevelCount() const { ASSERT(!IsError()); return mRange.levelCount; } uint32_t TextureViewBase::GetBaseArrayLayer() const { ASSERT(!IsError()); return mRange.baseArrayLayer; } uint32_t TextureViewBase::GetLayerCount() const { ASSERT(!IsError()); return mRange.layerCount; } const SubresourceRange& TextureViewBase::GetSubresourceRange() const { ASSERT(!IsError()); return mRange; } } // namespace dawn_native