142 lines
5.6 KiB
C++
142 lines
5.6 KiB
C++
// 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 <vector>
|
|
|
|
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<bool> 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<TextureBase> 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_
|