// Copyright 2018 The SwiftShader Authors. All Rights Reserved. // // 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 VK_IMAGE_HPP_ #define VK_IMAGE_HPP_ #include "VkFormat.h" #include "VkObject.hpp" #ifdef __ANDROID__ # include // For VkSwapchainImageUsageFlagsANDROID and buffer_handle_t #endif namespace vk { class Buffer; class Device; class DeviceMemory; #ifdef __ANDROID__ struct BackingMemory { int stride = 0; bool externalMemory = false; buffer_handle_t nativeHandle = nullptr; VkSwapchainImageUsageFlagsANDROID androidUsage = 0; }; #endif class Image : public Object { public: Image(const VkImageCreateInfo *pCreateInfo, void *mem, Device *device); void destroy(const VkAllocationCallbacks *pAllocator); #ifdef __ANDROID__ VkResult prepareForExternalUseANDROID() const; #endif static size_t ComputeRequiredAllocationSize(const VkImageCreateInfo *pCreateInfo); const VkMemoryRequirements getMemoryRequirements() const; void getSubresourceLayout(const VkImageSubresource *pSubresource, VkSubresourceLayout *pLayout) const; void bind(DeviceMemory *pDeviceMemory, VkDeviceSize pMemoryOffset); void copyTo(Image *dstImage, const VkImageCopy &pRegion) const; void copyTo(Buffer *dstBuffer, const VkBufferImageCopy ®ion); void copyFrom(Buffer *srcBuffer, const VkBufferImageCopy ®ion); void blit(Image *dstImage, const VkImageBlit ®ion, VkFilter filter) const; void blitToBuffer(VkImageSubresourceLayers subresource, VkOffset3D offset, VkExtent3D extent, uint8_t *dst, int bufferRowPitch, int bufferSlicePitch) const; void resolve(Image *dstImage, const VkImageResolve ®ion) const; void clear(const VkClearValue &clearValue, const vk::Format &viewFormat, const VkRect2D &renderArea, const VkImageSubresourceRange &subresourceRange); void clear(const VkClearColorValue &color, const VkImageSubresourceRange &subresourceRange); void clear(const VkClearDepthStencilValue &color, const VkImageSubresourceRange &subresourceRange); VkImageType getImageType() const { return imageType; } const Format &getFormat() const { return format; } Format getFormat(VkImageAspectFlagBits aspect) const; uint32_t getArrayLayers() const { return arrayLayers; } uint32_t getMipLevels() const { return mipLevels; } VkImageUsageFlags getUsage() const { return usage; } uint32_t getLastLayerIndex(const VkImageSubresourceRange &subresourceRange) const; uint32_t getLastMipLevel(const VkImageSubresourceRange &subresourceRange) const; VkSampleCountFlagBits getSampleCountFlagBits() const { return samples; } VkExtent3D getMipLevelExtent(VkImageAspectFlagBits aspect, uint32_t mipLevel) const; int rowPitchBytes(VkImageAspectFlagBits aspect, uint32_t mipLevel) const; int slicePitchBytes(VkImageAspectFlagBits aspect, uint32_t mipLevel) const; void *getTexelPointer(const VkOffset3D &offset, const VkImageSubresourceLayers &subresource) const; bool isCube() const; bool is3DSlice() const; uint8_t *end() const; VkDeviceSize getLayerSize(VkImageAspectFlagBits aspect) const; VkDeviceSize getMipLevelSize(VkImageAspectFlagBits aspect, uint32_t mipLevel) const; bool canBindToMemory(DeviceMemory *pDeviceMemory) const; void prepareForSampling(const VkImageSubresourceRange &subresourceRange); const Image *getSampledImage(const vk::Format &imageViewFormat) const; #ifdef __ANDROID__ void setBackingMemory(BackingMemory &bm) { backingMemory = bm; } bool hasExternalMemory() const { return backingMemory.externalMemory; } VkDeviceMemory getExternalMemory() const; #endif private: void copy(Buffer *buffer, const VkBufferImageCopy ®ion, bool bufferIsSource); VkDeviceSize getStorageSize(VkImageAspectFlags flags) const; VkDeviceSize getMultiSampledLevelSize(VkImageAspectFlagBits aspect, uint32_t mipLevel) const; VkDeviceSize getLayerOffset(VkImageAspectFlagBits aspect, uint32_t mipLevel) const; VkDeviceSize getMemoryOffset(VkImageAspectFlagBits aspect, uint32_t mipLevel) const; VkDeviceSize getMemoryOffset(VkImageAspectFlagBits aspect, uint32_t mipLevel, uint32_t layer) const; VkDeviceSize texelOffsetBytesInStorage(const VkOffset3D &offset, const VkImageSubresourceLayers &subresource) const; VkDeviceSize getMemoryOffset(VkImageAspectFlagBits aspect) const; VkExtent3D imageExtentInBlocks(const VkExtent3D &extent, VkImageAspectFlagBits aspect) const; VkOffset3D imageOffsetInBlocks(const VkOffset3D &offset, VkImageAspectFlagBits aspect) const; VkExtent2D bufferExtentInBlocks(const VkExtent2D &extent, const VkBufferImageCopy ®ion) const; VkFormat getClearFormat() const; void clear(void *pixelData, VkFormat pixelFormat, const vk::Format &viewFormat, const VkImageSubresourceRange &subresourceRange, const VkRect2D &renderArea); int borderSize() const; void decodeETC2(const VkImageSubresourceRange &subresourceRange) const; void decodeBC(const VkImageSubresourceRange &subresourceRange) const; void decodeASTC(const VkImageSubresourceRange &subresourceRange) const; const Device *const device = nullptr; DeviceMemory *deviceMemory = nullptr; VkDeviceSize memoryOffset = 0; VkImageCreateFlags flags = 0; VkImageType imageType = VK_IMAGE_TYPE_2D; Format format; VkExtent3D extent = { 0, 0, 0 }; uint32_t mipLevels = 0; uint32_t arrayLayers = 0; VkSampleCountFlagBits samples = VK_SAMPLE_COUNT_1_BIT; VkImageTiling tiling = VK_IMAGE_TILING_OPTIMAL; VkImageUsageFlags usage = (VkImageUsageFlags)0; Image *decompressedImage = nullptr; #ifdef __ANDROID__ BackingMemory backingMemory = {}; #endif VkExternalMemoryHandleTypeFlags supportedExternalMemoryHandleTypes = (VkExternalMemoryHandleTypeFlags)0; }; static inline Image *Cast(VkImage object) { return Image::Cast(object); } } // namespace vk #endif // VK_IMAGE_HPP_