GrPaint Class Reference

#include <GrPaint.h>

Public Member Functions
	GrPaint ()=default
	~GrPaint ()=default
void	setColor4f (const SkPMColor4f &color)
const SkPMColor4f &	getColor4f () const
void	setXPFactory (const GrXPFactory *xpFactory)
void	setPorterDuffXPFactory (SkBlendMode mode)
void	setCoverageSetOpXPFactory (SkRegion::Op, bool invertCoverage=false)
void	setColorFragmentProcessor (std::unique_ptr< GrFragmentProcessor > fp)
void	setCoverageFragmentProcessor (std::unique_ptr< GrFragmentProcessor > fp)
bool	hasColorFragmentProcessor () const
int	hasCoverageFragmentProcessor () const
int	numTotalFragmentProcessors () const
const GrXPFactory *	getXPFactory () const
GrFragmentProcessor *	getColorFragmentProcessor () const
GrFragmentProcessor *	getCoverageFragmentProcessor () const
bool	usesLocalCoords () const
bool	isConstantBlendedColor (SkPMColor4f *constantColor) const
bool	isTrivial () const

Static Public Member Functions
static GrPaint	Clone (const GrPaint &src)

Friends
class	GrProcessorSet
void	assert_alive (GrPaint &p)

Detailed Description

The paint describes how color and coverage are computed at each pixel by GrContext draw functions and the how color is blended with the destination pixel.

The paint allows installation of custom color and coverage stages. New types of stages are created by subclassing GrProcessor.

The primitive color computation starts with the color specified by setColor(). This color is the input to the first color stage. Each color stage feeds its output to the next color stage.

Fractional pixel coverage follows a similar flow. The GrGeometryProcessor (specified elsewhere) provides the initial coverage which is passed to the first coverage fragment processor, which feeds its output to next coverage fragment processor.

setXPFactory is used to control blending between the output color and dest. It also implements the application of fractional coverage from the coverage pipeline.

Definition at line 40 of file GrPaint.h.

Constructor & Destructor Documentation

GrPaint()

GrPaint::GrPaint ( )

default

~GrPaint()

GrPaint::~GrPaint ( )

default

Member Function Documentation

Clone()

static GrPaint GrPaint::Clone ( const GrPaint &  src )

inlinestatic

Definition at line 45 of file GrPaint.h.

{ return GrPaint(src); }

getColor4f()

const SkPMColor4f & GrPaint::getColor4f ( ) const

inline

Definition at line 51 of file GrPaint.h.

{ return fColor; }

getColorFragmentProcessor()

GrFragmentProcessor * GrPaint::getColorFragmentProcessor ( ) const

inline

Definition at line 91 of file GrPaint.h.

                                                           {
        return fColorFragmentProcessor.get();
    }

getCoverageFragmentProcessor()

GrFragmentProcessor * GrPaint::getCoverageFragmentProcessor ( ) const

inline

Definition at line 94 of file GrPaint.h.

                                                              {
        return fCoverageFragmentProcessor.get();
    }

getXPFactory()

const GrXPFactory * GrPaint::getXPFactory ( ) const

inline

Definition at line 89 of file GrPaint.h.

{ return fXPFactory; }

hasColorFragmentProcessor()

bool GrPaint::hasColorFragmentProcessor ( ) const

inline

Definition at line 82 of file GrPaint.h.

{ return fColorFragmentProcessor ? true : false; }

hasCoverageFragmentProcessor()

int GrPaint::hasCoverageFragmentProcessor ( ) const

inline

Definition at line 83 of file GrPaint.h.

{ return fCoverageFragmentProcessor ? true : false; }

isConstantBlendedColor()

bool GrPaint::isConstantBlendedColor

(

SkPMColor4f *

constantColor

)

const

Returns true if the paint's output color will be constant after blending. If the result is true, constantColor will be updated to contain the constant color. Note that we can conflate coverage and color, so the actual values written to pixels with partial coverage may still not seem constant, even if this function returns true.

Definition at line 36 of file GrPaint.cpp.

                                                                     {
    // This used to do a more sophisticated analysis but now it just explicitly looks for common
    // cases.
    static const GrXPFactory* kSrc = GrPorterDuffXPFactory::Get(SkBlendMode::kSrc);
    static const GrXPFactory* kClear = GrPorterDuffXPFactory::Get(SkBlendMode::kClear);
    if (kClear == fXPFactory) {
        *constantColor = SK_PMColor4fTRANSPARENT;
        return true;
    }
    if (this->hasColorFragmentProcessor()) {
        return false;
    }
    if (kSrc == fXPFactory || (!fXPFactory && fColor.isOpaque())) {
        *constantColor = fColor;
        return true;
    }
    return false;
}

isTrivial()

bool GrPaint::isTrivial ( ) const

inline

A trivial paint is one that uses src-over and has no fragment processors. It may have variable sRGB settings.

Definition at line 115 of file GrPaint.h.

{ return fTrivial; }

numTotalFragmentProcessors()

int GrPaint::numTotalFragmentProcessors ( ) const

inline

Definition at line 84 of file GrPaint.h.

                                           {
        return (this->hasColorFragmentProcessor() ? 1 : 0) +
               (this->hasCoverageFragmentProcessor() ? 1 : 0);
    }

setColor4f()

void GrPaint::setColor4f ( const SkPMColor4f &  color )

inline

The initial color of the drawn primitive. Defaults to solid white.

Definition at line 50 of file GrPaint.h.

{ fColor = color; }

setColorFragmentProcessor()

void GrPaint::setColorFragmentProcessor ( std::unique_ptr< GrFragmentProcessor >  fp )

inline

Sets a processor for color computation.

Definition at line 65 of file GrPaint.h.

                                                                          {
        SkASSERT(fp);
        SkASSERT(fColorFragmentProcessor == nullptr);
        fColorFragmentProcessor = std::move(fp);
        fTrivial = false;
    }

setCoverageFragmentProcessor()

void GrPaint::setCoverageFragmentProcessor ( std::unique_ptr< GrFragmentProcessor >  fp )

inline

Appends an additional coverage processor to the coverage computation.

Definition at line 75 of file GrPaint.h.

                                                                             {
        SkASSERT(fp);
        SkASSERT(fCoverageFragmentProcessor == nullptr);
        fCoverageFragmentProcessor = std::move(fp);
        fTrivial = false;
    }

setCoverageSetOpXPFactory()

void GrPaint::setCoverageSetOpXPFactory	(	SkRegion::Op	regionOp,
		bool	invertCoverage = false
	)

Definition at line 32 of file GrPaint.cpp.

                                                                                {
    this->setXPFactory(GrCoverageSetOpXPFactory::Get(regionOp, invertCoverage));
}

setPorterDuffXPFactory()

void GrPaint::setPorterDuffXPFactory

(

SkBlendMode

mode

)

Definition at line 28 of file GrPaint.cpp.

                                                     {
    this->setXPFactory(GrPorterDuffXPFactory::Get(mode));
}

setXPFactory()

void GrPaint::setXPFactory ( const GrXPFactory *  xpFactory )

inline

Definition at line 53 of file GrPaint.h.

                                                    {
        fXPFactory = xpFactory;
        fTrivial &= !SkToBool(xpFactory);
    }

usesLocalCoords()

bool GrPaint::usesLocalCoords ( ) const

inline

Definition at line 97 of file GrPaint.h.

                                 {
        // The sample coords for the top level FPs are implicitly the GP's local coords.
        return (fColorFragmentProcessor && fColorFragmentProcessor->usesSampleCoords()) ||
               (fCoverageFragmentProcessor && fCoverageFragmentProcessor->usesSampleCoords());
    }

Friends And Related Function Documentation

assert_alive

void assert_alive ( GrPaint &  p )

friend

Definition at line 117 of file GrPaint.h.

                                         {
        SkASSERT(p.fAlive);
    }

GrProcessorSet

friend class GrProcessorSet

friend

Definition at line 127 of file GrPaint.h.

---

The documentation for this class was generated from the following files:

• third_party/skia/src/gpu/ganesh/GrPaint.h
• third_party/skia/src/gpu/ganesh/GrPaint.cpp