// 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 "dawn_native/Error.h" #include "dawn_native/Forward.h" #include "dawn_native/ObjectBase.h" #include "dawn_native/dawn_platform.h" #include namespace dawn_native { MaybeError ValidateTextureDescriptor(const DeviceBase* device, const TextureDescriptor* descriptor); MaybeError ValidateTextureViewDescriptor(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; static constexpr wgpu::TextureUsage kWritableTextureUsages = wgpu::TextureUsage::CopyDst | wgpu::TextureUsage::Storage | wgpu::TextureUsage::OutputAttachment; 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 GetArrayLayers() const; uint32_t GetNumMipLevels() const; uint32_t GetSampleCount() const; wgpu::TextureUsage GetUsage() const; TextureState GetTextureState() const; uint32_t GetSubresourceIndex(uint32_t mipLevel, uint32_t arraySlice) const; bool IsSubresourceContentInitialized(uint32_t baseMipLevel, uint32_t levelCount, uint32_t baseArrayLayer, uint32_t layerCount) const; void SetIsSubresourceContentInitialized(bool isInitialized, uint32_t baseMipLevel, uint32_t levelCount, uint32_t baseArrayLayer, uint32_t layerCount); 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; // Dawn API TextureViewBase* CreateView(const TextureViewDescriptor* descriptor); void Destroy(); protected: void DestroyInternal(); private: TextureBase(DeviceBase* device, ObjectBase::ErrorTag tag); virtual void DestroyImpl(); MaybeError ValidateDestroy() const; wgpu::TextureDimension mDimension; // TODO(cwallez@chromium.org): This should be deduplicated in the Device const Format& mFormat; Extent3D mSize; uint32_t mArrayLayerCount; uint32_t mMipLevelCount; uint32_t mSampleCount; wgpu::TextureUsage mUsage = wgpu::TextureUsage::None; TextureState mState; // TODO(natlee@microsoft.com): Use a more optimized data structure to save space std::vector mIsSubresourceContentInitializedAtIndex; }; class TextureViewBase : public ObjectBase { public: TextureViewBase(TextureBase* texture, const TextureViewDescriptor* descriptor); static TextureViewBase* MakeError(DeviceBase* device); const TextureBase* GetTexture() const; TextureBase* GetTexture(); const Format& GetFormat() const; wgpu::TextureViewDimension GetDimension() const; uint32_t GetBaseMipLevel() const; uint32_t GetLevelCount() const; uint32_t GetBaseArrayLayer() const; uint32_t GetLayerCount() const; private: TextureViewBase(DeviceBase* device, ObjectBase::ErrorTag tag); Ref mTexture; // TODO(cwallez@chromium.org): This should be deduplicated in the Device const Format& mFormat; wgpu::TextureViewDimension mDimension; uint32_t mBaseMipLevel; uint32_t mMipLevelCount; uint32_t mBaseArrayLayer; uint32_t mArrayLayerCount; }; } // namespace dawn_native #endif // DAWNNATIVE_TEXTURE_H_