blob: 91b10e87bf7a9816c59a29252e4b573403f024f7 [file] [log] [blame]
/*
* Copyright 2017 Google Inc.
*
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
#ifndef SkSurfaceCharacterization_DEFINED
#define SkSurfaceCharacterization_DEFINED
#include "include/core/SkColorSpace.h"
#include "include/core/SkImageInfo.h"
#include "include/core/SkRefCnt.h"
#include "include/core/SkSurfaceProps.h"
class SkColorSpace;
#if SK_SUPPORT_GPU
#include "include/gpu/GrBackendSurface.h"
#include "include/gpu/GrContextThreadSafeProxy.h"
#include "include/gpu/GrTypes.h"
/** \class SkSurfaceCharacterization
A surface characterization contains all the information Ganesh requires to makes its internal
rendering decisions. When passed into a SkDeferredDisplayListRecorder it will copy the
data and pass it on to the SkDeferredDisplayList if/when it is created. Note that both of
those objects (the Recorder and the DisplayList) will take a ref on the
GrContextThreadSafeProxy and SkColorSpace objects.
*/
class SK_API SkSurfaceCharacterization {
public:
enum class Textureable : bool { kNo = false, kYes = true };
enum class MipMapped : bool { kNo = false, kYes = true };
enum class UsesGLFBO0 : bool { kNo = false, kYes = true };
// This flag indicates that the backing VkImage for this Vulkan surface will have the
// VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT set. This bit allows skia to handle advanced blends
// more optimally in a shader by being able to directly read the dst values.
enum class VkRTSupportsInputAttachment : bool { kNo = false, kYes = true };
// This flag indicates if the surface is wrapping a raw Vulkan secondary command buffer.
enum class VulkanSecondaryCBCompatible : bool { kNo = false, kYes = true };
SkSurfaceCharacterization()
: fCacheMaxResourceBytes(0)
, fOrigin(kBottomLeft_GrSurfaceOrigin)
, fSampleCnt(0)
, fIsTextureable(Textureable::kYes)
, fIsMipMapped(MipMapped::kYes)
, fUsesGLFBO0(UsesGLFBO0::kNo)
, fVulkanSecondaryCBCompatible(VulkanSecondaryCBCompatible::kNo)
, fIsProtected(GrProtected::kNo)
, fSurfaceProps(0, kUnknown_SkPixelGeometry) {
}
SkSurfaceCharacterization(SkSurfaceCharacterization&&) = default;
SkSurfaceCharacterization& operator=(SkSurfaceCharacterization&&) = default;
SkSurfaceCharacterization(const SkSurfaceCharacterization&) = default;
SkSurfaceCharacterization& operator=(const SkSurfaceCharacterization& other) = default;
bool operator==(const SkSurfaceCharacterization& other) const;
bool operator!=(const SkSurfaceCharacterization& other) const {
return !(*this == other);
}
/*
* Return a new surface characterization with the only difference being a different width
* and height
*/
SkSurfaceCharacterization createResized(int width, int height) const;
/*
* Return a new surface characterization with only a replaced color space
*/
SkSurfaceCharacterization createColorSpace(sk_sp<SkColorSpace>) const;
/*
* Return a new surface characterization with the backend format replaced. A colorType
* must also be supplied to indicate the interpretation of the new format.
*/
SkSurfaceCharacterization createBackendFormat(SkColorType colorType,
const GrBackendFormat& backendFormat) const;
/*
* Return a new surface characterization with just a different use of FBO0 (in GL)
*/
SkSurfaceCharacterization createFBO0(bool usesGLFBO0) const;
GrContextThreadSafeProxy* contextInfo() const { return fContextInfo.get(); }
sk_sp<GrContextThreadSafeProxy> refContextInfo() const { return fContextInfo; }
size_t cacheMaxResourceBytes() const { return fCacheMaxResourceBytes; }
bool isValid() const { return kUnknown_SkColorType != fImageInfo.colorType(); }
const SkImageInfo& imageInfo() const { return fImageInfo; }
const GrBackendFormat& backendFormat() const { return fBackendFormat; }
GrSurfaceOrigin origin() const { return fOrigin; }
SkISize dimensions() const { return fImageInfo.dimensions(); }
int width() const { return fImageInfo.width(); }
int height() const { return fImageInfo.height(); }
SkColorType colorType() const { return fImageInfo.colorType(); }
int sampleCount() const { return fSampleCnt; }
bool isTextureable() const { return Textureable::kYes == fIsTextureable; }
bool isMipMapped() const { return MipMapped::kYes == fIsMipMapped; }
bool usesGLFBO0() const { return UsesGLFBO0::kYes == fUsesGLFBO0; }
bool vkRTSupportsInputAttachment() const {
return VkRTSupportsInputAttachment::kYes == fVkRTSupportsInputAttachment;
}
bool vulkanSecondaryCBCompatible() const {
return VulkanSecondaryCBCompatible::kYes == fVulkanSecondaryCBCompatible;
}
GrProtected isProtected() const { return fIsProtected; }
SkColorSpace* colorSpace() const { return fImageInfo.colorSpace(); }
sk_sp<SkColorSpace> refColorSpace() const { return fImageInfo.refColorSpace(); }
const SkSurfaceProps& surfaceProps()const { return fSurfaceProps; }
// Is the provided backend texture compatible with this surface characterization?
bool isCompatible(const GrBackendTexture&) const;
private:
friend class SkSurface_Gpu; // for 'set' & 'config'
friend class GrVkSecondaryCBDrawContext; // for 'set' & 'config'
friend class GrContextThreadSafeProxy; // for private ctor
friend class SkDeferredDisplayListRecorder; // for 'config'
friend class SkSurface; // for 'config'
SkDEBUGCODE(void validate() const;)
SkSurfaceCharacterization(sk_sp<GrContextThreadSafeProxy> contextInfo,
size_t cacheMaxResourceBytes,
const SkImageInfo& ii,
const GrBackendFormat& backendFormat,
GrSurfaceOrigin origin,
int sampleCnt,
Textureable isTextureable,
MipMapped isMipMapped,
UsesGLFBO0 usesGLFBO0,
VkRTSupportsInputAttachment vkRTSupportsInputAttachment,
VulkanSecondaryCBCompatible vulkanSecondaryCBCompatible,
GrProtected isProtected,
const SkSurfaceProps& surfaceProps)
: fContextInfo(std::move(contextInfo))
, fCacheMaxResourceBytes(cacheMaxResourceBytes)
, fImageInfo(ii)
, fBackendFormat(backendFormat)
, fOrigin(origin)
, fSampleCnt(sampleCnt)
, fIsTextureable(isTextureable)
, fIsMipMapped(isMipMapped)
, fUsesGLFBO0(usesGLFBO0)
, fVkRTSupportsInputAttachment(vkRTSupportsInputAttachment)
, fVulkanSecondaryCBCompatible(vulkanSecondaryCBCompatible)
, fIsProtected(isProtected)
, fSurfaceProps(surfaceProps) {
if (fSurfaceProps.flags() & SkSurfaceProps::kDynamicMSAA_Flag) {
// Dynamic MSAA is not currently supported with DDL.
*this = {};
}
SkDEBUGCODE(this->validate());
}
void set(sk_sp<GrContextThreadSafeProxy> contextInfo,
size_t cacheMaxResourceBytes,
const SkImageInfo& ii,
const GrBackendFormat& backendFormat,
GrSurfaceOrigin origin,
int sampleCnt,
Textureable isTextureable,
MipMapped isMipMapped,
UsesGLFBO0 usesGLFBO0,
VkRTSupportsInputAttachment vkRTSupportsInputAttachment,
VulkanSecondaryCBCompatible vulkanSecondaryCBCompatible,
GrProtected isProtected,
const SkSurfaceProps& surfaceProps) {
if (surfaceProps.flags() & SkSurfaceProps::kDynamicMSAA_Flag) {
// Dynamic MSAA is not currently supported with DDL.
*this = {};
} else {
fContextInfo = contextInfo;
fCacheMaxResourceBytes = cacheMaxResourceBytes;
fImageInfo = ii;
fBackendFormat = backendFormat;
fOrigin = origin;
fSampleCnt = sampleCnt;
fIsTextureable = isTextureable;
fIsMipMapped = isMipMapped;
fUsesGLFBO0 = usesGLFBO0;
fVkRTSupportsInputAttachment = vkRTSupportsInputAttachment;
fVulkanSecondaryCBCompatible = vulkanSecondaryCBCompatible;
fIsProtected = isProtected;
fSurfaceProps = surfaceProps;
}
SkDEBUGCODE(this->validate());
}
sk_sp<GrContextThreadSafeProxy> fContextInfo;
size_t fCacheMaxResourceBytes;
SkImageInfo fImageInfo;
GrBackendFormat fBackendFormat;
GrSurfaceOrigin fOrigin;
int fSampleCnt;
Textureable fIsTextureable;
MipMapped fIsMipMapped;
UsesGLFBO0 fUsesGLFBO0;
VkRTSupportsInputAttachment fVkRTSupportsInputAttachment;
VulkanSecondaryCBCompatible fVulkanSecondaryCBCompatible;
GrProtected fIsProtected;
SkSurfaceProps fSurfaceProps;
};
#else// !SK_SUPPORT_GPU
class GrBackendFormat;
class SK_API SkSurfaceCharacterization {
public:
SkSurfaceCharacterization() : fSurfaceProps(0, kUnknown_SkPixelGeometry) { }
SkSurfaceCharacterization createResized(int width, int height) const {
return *this;
}
SkSurfaceCharacterization createColorSpace(sk_sp<SkColorSpace>) const {
return *this;
}
SkSurfaceCharacterization createBackendFormat(SkColorType, const GrBackendFormat&) const {
return *this;
}
SkSurfaceCharacterization createFBO0(bool usesGLFBO0) const {
return *this;
}
bool operator==(const SkSurfaceCharacterization& other) const { return false; }
bool operator!=(const SkSurfaceCharacterization& other) const {
return !(*this == other);
}
size_t cacheMaxResourceBytes() const { return 0; }
bool isValid() const { return false; }
int width() const { return 0; }
int height() const { return 0; }
int stencilCount() const { return 0; }
bool isTextureable() const { return false; }
bool isMipMapped() const { return false; }
bool usesGLFBO0() const { return false; }
bool vkRTSupportsAttachmentInput() const { return false; }
bool vulkanSecondaryCBCompatible() const { return false; }
SkColorSpace* colorSpace() const { return nullptr; }
sk_sp<SkColorSpace> refColorSpace() const { return nullptr; }
const SkSurfaceProps& surfaceProps()const { return fSurfaceProps; }
private:
SkSurfaceProps fSurfaceProps;
};
#endif
#endif