blob: 3bad023f1a79893d7d81a8176fe64b07562a541d [file] [log] [blame]
/*
* Copyright 2011 Google Inc.
*
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
#ifndef GrRenderTarget_DEFINED
#define GrRenderTarget_DEFINED
#include "include/core/SkRect.h"
#include "src/gpu/GrSurface.h"
class GrCaps;
class GrAttachment;
class GrBackendRenderTarget;
/**
* GrRenderTarget represents a 2D buffer of pixels that can be rendered to.
* A context's render target is set by setRenderTarget(). Render targets are
* created by a createTexture with the kRenderTarget_SurfaceFlag flag.
* Additionally, GrContext provides methods for creating GrRenderTargets
* that wrap externally created render targets.
*/
class GrRenderTarget : virtual public GrSurface {
public:
// Make manual MSAA resolve publicly accessible from GrRenderTarget.
using GrSurface::setRequiresManualMSAAResolve;
using GrSurface::requiresManualMSAAResolve;
virtual bool alwaysClearStencil() const { return false; }
// GrSurface overrides
GrRenderTarget* asRenderTarget() override { return this; }
const GrRenderTarget* asRenderTarget() const override { return this; }
/**
* Returns the number of samples/pixel in the color buffer (One if non-MSAA).
*/
int numSamples() const { return fSampleCnt; }
virtual GrBackendRenderTarget getBackendRenderTarget() const = 0;
GrAttachment* getStencilAttachment(bool useMSAASurface) const {
return (useMSAASurface) ? fMSAAStencilAttachment.get() : fStencilAttachment.get();
}
GrAttachment* getStencilAttachment() const {
return getStencilAttachment(this->numSamples() > 1);
}
// Checked when this object is asked to attach a stencil buffer.
virtual bool canAttemptStencilAttachment(bool useMSAASurface) const = 0;
void attachStencilAttachment(sk_sp<GrAttachment> stencil, bool useMSAASurface);
int numStencilBits(bool useMSAASurface) const;
/**
* Returns a unique key that identifies this render target's sample pattern. (Must be
* multisampled.)
*/
int getSamplePatternKey();
/**
* Retrieves the per-pixel HW sample locations for this render target, and, as a by-product, the
* actual number of samples in use. (This may differ from fSampleCnt.) Sample locations are
* returned as 0..1 offsets relative to the top-left corner of the pixel.
*/
const SkTArray<SkPoint>& getSampleLocations();
protected:
GrRenderTarget(GrGpu*, const SkISize&, int sampleCount, GrProtected, GrAttachment* = nullptr);
~GrRenderTarget() override;
// override of GrResource
void onAbandon() override;
void onRelease() override;
private:
// Allows the backends to perform any additional work that is required for attaching a
// GrAttachment. When this is called, the GrAttachment has already been put onto
// the GrRenderTarget. This function must return false if any failures occur when completing the
// stencil attachment.
virtual bool completeStencilAttachment(GrAttachment* stencil, bool useMSAASurface) = 0;
sk_sp<GrAttachment> fStencilAttachment;
sk_sp<GrAttachment> fMSAAStencilAttachment;
int fSampleCnt;
using INHERITED = GrSurface;
};
#endif