SkRectClipBlitter Class Reference

#include <SkBlitter.h>

Inheritance diagram for SkRectClipBlitter:

Public Member Functions
void	init (SkBlitter *blitter, const SkIRect &clipRect)
void	blitH (int x, int y, int width) override
	Blit a horizontal run of one or more pixels. More...
void	blitAntiH (int x, int y, const SkAlpha[], const int16_t runs[]) override
void	blitV (int x, int y, int height, SkAlpha alpha) override
	Blit a vertical run of pixels with a constant alpha value. More...
void	blitRect (int x, int y, int width, int height) override
	Blit a solid rectangle one or more pixels wide. More...
void	blitAntiRect (int x, int y, int width, int height, SkAlpha leftAlpha, SkAlpha rightAlpha) override
void	blitMask (const SkMask &, const SkIRect &clip) override
int	requestRowsPreserved () const override
void *	allocBlitMemory (size_t sz) override
Public Member Functions inherited from SkBlitter
virtual	~SkBlitter ()
virtual void	blitH (int x, int y, int width)=0
	Blit a horizontal run of one or more pixels. More...
virtual void	blitAntiH (int x, int y, const SkAlpha antialias[], const int16_t runs[])=0
virtual void	blitV (int x, int y, int height, SkAlpha alpha)
	Blit a vertical run of pixels with a constant alpha value. More...
virtual void	blitRect (int x, int y, int width, int height)
	Blit a solid rectangle one or more pixels wide. More...
virtual void	blitAntiRect (int x, int y, int width, int height, SkAlpha leftAlpha, SkAlpha rightAlpha)
void	blitFatAntiRect (const SkRect &rect)
virtual void	blitMask (const SkMask &, const SkIRect &clip)
virtual void	blitAntiH2 (int x, int y, U8CPU a0, U8CPU a1)
virtual void	blitAntiV2 (int x, int y, U8CPU a0, U8CPU a1)
virtual bool	isNullBlitter () const
virtual int	requestRowsPreserved () const
virtual void *	allocBlitMemory (size_t sz)
void	blitRectRegion (const SkIRect &rect, const SkRegion &clip)
void	blitRegion (const SkRegion &clip)

Additional Inherited Members
Static Public Member Functions inherited from SkBlitter
static bool	UseLegacyBlitter (const SkPixmap &, const SkPaint &, const SkMatrix &)
static SkBlitter *	Choose (const SkPixmap &dst, const SkMatrix &ctm, const SkPaint &paint, SkArenaAlloc *, bool drawCoverage, sk_sp< SkShader > clipShader, const SkSurfaceProps &props)
static SkBlitter *	ChooseSprite (const SkPixmap &dst, const SkPaint &, const SkPixmap &src, int left, int top, SkArenaAlloc *, sk_sp< SkShader > clipShader)
Protected Attributes inherited from SkBlitter
SkAutoMalloc	fBlitMemory

Detailed Description

Wraps another (real) blitter, and ensures that the real blitter is only called with coordinates that have been clipped by the specified clipRect. This means the caller need not perform the clipping ahead of time.

Definition at line 182 of file SkBlitter.h.

Member Function Documentation

allocBlitMemory()

void * SkRectClipBlitter::allocBlitMemory ( size_t  sz )

inlineoverridevirtual

This function allocates memory for the blitter that the blitter then owns. The memory can be used by the calling function at will, but it will be released when the blitter's destructor is called. This function returns nullptr if no persistent memory is needed by the blitter.

Reimplemented from SkBlitter.

Definition at line 202 of file SkBlitter.h.

                                              {
        return fBlitter->allocBlitMemory(sz);
    }

blitAntiH()

void SkRectClipBlitter::blitAntiH ( int  x, int  y, const  antialias[], const int16_t  runs[]  )

overridevirtual

Blit a horizontal run of antialiased pixels; runs[] is a sparse zero-terminated run-length encoding of spans of constant alpha values. The runs[] and antialias[] work together to represent long runs of pixels with the same alphas. The runs[] contains the number of pixels with the same alpha, and antialias[] contain the coverage value for that number of pixels. The runs[] (and antialias[]) are encoded in a clever way. The runs array is zero terminated, and has enough entries for each pixel plus one, in most cases some of the entries will not contain valid data. An entry in the runs array contains the number of pixels (np) that have the same alpha value. The next np value is found np entries away. For example, if runs[0] = 7, then the next valid entry will by at runs[7]. The runs array and antialias[] are coupled by index. So, if the np entry is at runs[45] = 12 then the alpha value can be found at antialias[45] = 0x88. This would mean to use an alpha value of 0x88 for the next 12 pixels starting at pixel 45.

Implements SkBlitter.

Definition at line 379 of file SkBlitter.cpp.

                                                              {
    SkAlpha* aa = const_cast<SkAlpha*>(const_aa);
    int16_t* runs = const_cast<int16_t*>(const_runs);
 
    if (!y_in_rect(y, fClipRect) || left >= fClipRect.fRight) {
        return;
    }
 
    int x0 = left;
    int x1 = left + compute_anti_width(runs);
 
    if (x1 <= fClipRect.fLeft) {
        return;
    }
 
    SkASSERT(x0 < x1);
    if (x0 < fClipRect.fLeft) {
        int dx = fClipRect.fLeft - x0;
        SkAlphaRuns::BreakAt((int16_t*)runs, (uint8_t*)aa, dx);
        runs += dx;
        aa += dx;
        x0 = fClipRect.fLeft;
    }
 
    SkASSERT(x0 < x1 && runs[x1 - x0] == 0);
    if (x1 > fClipRect.fRight) {
        x1 = fClipRect.fRight;
        SkAlphaRuns::BreakAt((int16_t*)runs, (uint8_t*)aa, x1 - x0);
        ((int16_t*)runs)[x1 - x0] = 0;
    }
 
    SkASSERT(x0 < x1 && runs[x1 - x0] == 0);
    SkASSERT(compute_anti_width(runs) == x1 - x0);
 
    fBlitter->blitAntiH(x0, y, aa, runs);
}

blitAntiRect()

void SkRectClipBlitter::blitAntiRect ( int  x, int  y, int  width, int  height, SkAlpha  leftAlpha, SkAlpha  rightAlpha  )

overridevirtual

Blit a rectangle with one alpha-blended column on the left, width (zero or more) opaque pixels, and one alpha-blended column on the right. The result will always be at least two pixels wide.

Default implementation doesn't check for easy optimizations such as alpha == 255; also uses blitV(), which some subclasses may not support.

Reimplemented from SkBlitter.

Definition at line 448 of file SkBlitter.cpp.

                                                                            {
    SkIRect    r;
 
    // The *true* width of the rectangle blitted is width+2:
    r.setLTRB(left, y, left + width + 2, y + height);
    if (r.intersect(fClipRect)) {
        if (r.fLeft != left) {
            SkASSERT(r.fLeft > left);
            leftAlpha = 255;
        }
        if (r.fRight != left + width + 2) {
            SkASSERT(r.fRight < left + width + 2);
            rightAlpha = 255;
        }
        if (255 == leftAlpha && 255 == rightAlpha) {
            fBlitter->blitRect(r.fLeft, r.fTop, r.width(), r.height());
        } else if (1 == r.width()) {
            if (r.fLeft == left) {
                fBlitter->blitV(r.fLeft, r.fTop, r.height(), leftAlpha);
            } else {
                SkASSERT(r.fLeft == left + width + 1);
                fBlitter->blitV(r.fLeft, r.fTop, r.height(), rightAlpha);
            }
        } else {
            fBlitter->blitAntiRect(r.fLeft, r.fTop, r.width() - 2, r.height(),
                                   leftAlpha, rightAlpha);
        }
    }
}

blitH()

void SkRectClipBlitter::blitH ( int  x, int  y, int  width  )

overridevirtual

Blit a horizontal run of one or more pixels.

Implements SkBlitter.

Definition at line 357 of file SkBlitter.cpp.

                                                        {
    SkASSERT(width > 0);
 
    if (!y_in_rect(y, fClipRect)) {
        return;
    }
 
    int right = left + width;
 
    if (left < fClipRect.fLeft) {
        left = fClipRect.fLeft;
    }
    if (right > fClipRect.fRight) {
        right = fClipRect.fRight;
    }
 
    width = right - left;
    if (width > 0) {
        fBlitter->blitH(left, y, width);
    }
}

blitMask()

void SkRectClipBlitter::blitMask ( const SkMask &  mask, const SkIRect &  clip  )

overridevirtual

Blit a pattern of pixels defined by a rectangle-clipped mask; typically used for text.

Reimplemented from SkBlitter.

Definition at line 479 of file SkBlitter.cpp.

                                                                        {
    SkASSERT(mask.fBounds.contains(clip));
 
    SkIRect    r = clip;
 
    if (r.intersect(fClipRect)) {
        fBlitter->blitMask(mask, r);
    }
}

blitRect()

void SkRectClipBlitter::blitRect ( int  x, int  y, int  width, int  height  )

overridevirtual

Blit a solid rectangle one or more pixels wide.

Reimplemented from SkBlitter.

Definition at line 439 of file SkBlitter.cpp.

                                                                       {
    SkIRect    r;
 
    r.setLTRB(left, y, left + width, y + height);
    if (r.intersect(fClipRect)) {
        fBlitter->blitRect(r.fLeft, r.fTop, r.width(), r.height());
    }
}

blitV()

void SkRectClipBlitter::blitV ( int  x, int  y, int  height, SkAlpha  alpha  )

overridevirtual

Blit a vertical run of pixels with a constant alpha value.

Reimplemented from SkBlitter.

Definition at line 417 of file SkBlitter.cpp.

                                                                     {
    SkASSERT(height > 0);
 
    if (!x_in_rect(x, fClipRect)) {
        return;
    }
 
    int y0 = y;
    int y1 = y + height;
 
    if (y0 < fClipRect.fTop) {
        y0 = fClipRect.fTop;
    }
    if (y1 > fClipRect.fBottom) {
        y1 = fClipRect.fBottom;
    }
 
    if (y0 < y1) {
        fBlitter->blitV(x, y0, y1 - y0, alpha);
    }
}

init()

void SkRectClipBlitter::init ( SkBlitter *  blitter, const SkIRect &  clipRect  )

inline

Definition at line 184 of file SkBlitter.h.

                                                           {
        SkASSERT(!clipRect.isEmpty());
        fBlitter = blitter;
        fClipRect = clipRect;
    }

requestRowsPreserved()

int SkRectClipBlitter::requestRowsPreserved ( ) const

inlineoverridevirtual

Special methods for blitters that can blit more than one row at a time. This function returns the number of rows that this blitter could optimally process at a time. It is still required to support blitting one scanline at a time.

Reimplemented from SkBlitter.

Definition at line 198 of file SkBlitter.h.

                                              {
        return fBlitter->requestRowsPreserved();
    }

---

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

• third_party/skia/src/core/SkBlitter.h
• third_party/skia/src/core/SkBlitter.cpp