| // 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. |
| |
| #ifndef DAWNNATIVE_TEXTURE_H_ |
| #define DAWNNATIVE_TEXTURE_H_ |
| |
| #include "common/ityp_array.h" |
| #include "common/ityp_bitset.h" |
| #include "dawn_native/Error.h" |
| #include "dawn_native/Forward.h" |
| #include "dawn_native/ObjectBase.h" |
| #include "dawn_native/Subresource.h" |
| |
| #include "dawn_native/dawn_platform.h" |
| |
| #include <vector> |
| |
| namespace dawn_native { |
| |
| MaybeError ValidateTextureDescriptor(const DeviceBase* device, |
| const TextureDescriptor* descriptor); |
| MaybeError ValidateTextureViewDescriptor(const DeviceBase* device, |
| const TextureBase* texture, |
| const TextureViewDescriptor* descriptor); |
| TextureViewDescriptor GetTextureViewDescriptorWithDefaults( |
| const TextureBase* texture, |
| const TextureViewDescriptor* descriptor); |
| |
| bool IsValidSampleCount(uint32_t sampleCount); |
| |
| static constexpr wgpu::TextureUsage kReadOnlyTextureUsages = |
| wgpu::TextureUsage::CopySrc | wgpu::TextureUsage::Sampled | kReadOnlyStorageTexture; |
| |
| class TextureBase : public ObjectBase { |
| public: |
| enum class TextureState { OwnedInternal, OwnedExternal, Destroyed }; |
| enum class ClearValue { Zero, NonZero }; |
| TextureBase(DeviceBase* device, const TextureDescriptor* descriptor, TextureState state); |
| |
| static TextureBase* MakeError(DeviceBase* device); |
| |
| wgpu::TextureDimension GetDimension() const; |
| const Format& GetFormat() const; |
| const Extent3D& GetSize() const; |
| uint32_t GetWidth() const; |
| uint32_t GetHeight() const; |
| uint32_t GetDepth() const; |
| uint32_t GetArrayLayers() const; |
| uint32_t GetNumMipLevels() const; |
| SubresourceRange GetAllSubresources() const; |
| uint32_t GetSampleCount() const; |
| uint32_t GetSubresourceCount() const; |
| |
| // |GetUsage| returns the usage with which the texture was created using the base WebGPU |
| // API. The dawn-internal-usages extension may add additional usages. |GetInternalUsage| |
| // returns the union of base usage and the usages added by the extension. |
| wgpu::TextureUsage GetUsage() const; |
| wgpu::TextureUsage GetInternalUsage() const; |
| |
| TextureState GetTextureState() const; |
| uint32_t GetSubresourceIndex(uint32_t mipLevel, uint32_t arraySlice, Aspect aspect) const; |
| bool IsSubresourceContentInitialized(const SubresourceRange& range) const; |
| void SetIsSubresourceContentInitialized(bool isInitialized, const SubresourceRange& range); |
| |
| MaybeError ValidateCanUseInSubmitNow() const; |
| |
| bool IsMultisampledTexture() const; |
| |
| // For a texture with non-block-compressed texture format, its physical size is always equal |
| // to its virtual size. For a texture with block compressed texture format, the physical |
| // size is the one with paddings if necessary, which is always a multiple of the block size |
| // and used in texture copying. The virtual size is the one without paddings, which is not |
| // required to be a multiple of the block size and used in texture sampling. |
| Extent3D GetMipLevelPhysicalSize(uint32_t level) const; |
| Extent3D GetMipLevelVirtualSize(uint32_t level) const; |
| Extent3D ClampToMipLevelVirtualSize(uint32_t level, |
| const Origin3D& origin, |
| const Extent3D& extent) const; |
| |
| // Dawn API |
| TextureViewBase* APICreateView(const TextureViewDescriptor* descriptor = nullptr); |
| void APIDestroy(); |
| |
| protected: |
| void DestroyInternal(); |
| |
| private: |
| TextureBase(DeviceBase* device, ObjectBase::ErrorTag tag); |
| virtual void DestroyImpl(); |
| |
| MaybeError ValidateDestroy() const; |
| wgpu::TextureDimension mDimension; |
| const Format& mFormat; |
| Extent3D mSize; |
| uint32_t mMipLevelCount; |
| uint32_t mSampleCount; |
| wgpu::TextureUsage mUsage = wgpu::TextureUsage::None; |
| wgpu::TextureUsage mInternalUsage = wgpu::TextureUsage::None; |
| TextureState mState; |
| |
| // TODO(crbug.com/dawn/845): Use a more optimized data structure to save space |
| std::vector<bool> mIsSubresourceContentInitializedAtIndex; |
| }; |
| |
| class TextureViewBase : public ObjectBase { |
| public: |
| TextureViewBase(TextureBase* texture, const TextureViewDescriptor* descriptor); |
| |
| static TextureViewBase* MakeError(DeviceBase* device); |
| |
| const TextureBase* GetTexture() const; |
| TextureBase* GetTexture(); |
| |
| Aspect GetAspects() const; |
| const Format& GetFormat() const; |
| wgpu::TextureViewDimension GetDimension() const; |
| uint32_t GetBaseMipLevel() const; |
| uint32_t GetLevelCount() const; |
| uint32_t GetBaseArrayLayer() const; |
| uint32_t GetLayerCount() const; |
| const SubresourceRange& GetSubresourceRange() const; |
| |
| private: |
| TextureViewBase(DeviceBase* device, ObjectBase::ErrorTag tag); |
| |
| Ref<TextureBase> mTexture; |
| |
| const Format& mFormat; |
| wgpu::TextureViewDimension mDimension; |
| SubresourceRange mRange; |
| }; |
| |
| } // namespace dawn_native |
| |
| #endif // DAWNNATIVE_TEXTURE_H_ |