SkBigPicture Class Reference

#include <SkBigPicture.h>

Inheritance diagram for SkBigPicture:

Classes
class	SnapshotArray

Public Member Functions
	SkBigPicture (const SkRect &cull, sk_sp< SkRecord >, std::unique_ptr< SnapshotArray >, sk_sp< SkBBoxHierarchy >, size_t approxBytesUsedBySubPictures)
void	playback (SkCanvas *, AbortCallback *) const override
SkRect	cullRect () const override
int	approximateOpCount (bool nested) const override
size_t	approximateBytesUsed () const override
const SkBigPicture *	asSkBigPicture () const override
const SkBBoxHierarchy *	bbh () const
const SkRecord *	record () const
Public Member Functions inherited from SkPicture
	~SkPicture () override
virtual void	playback (SkCanvas *canvas, AbortCallback *callback=nullptr) const =0
virtual SkRect	cullRect () const =0
uint32_t	uniqueID () const
sk_sp< SkData >	serialize (const SkSerialProcs *procs=nullptr) const
void	serialize (SkWStream *stream, const SkSerialProcs *procs=nullptr) const
virtual int	approximateOpCount (bool nested=false) const =0
virtual size_t	approximateBytesUsed () const =0
sk_sp< SkShader >	makeShader (SkTileMode tmx, SkTileMode tmy, SkFilterMode mode, const SkMatrix *localMatrix, const SkRect *tileRect) const
sk_sp< SkShader >	makeShader (SkTileMode tmx, SkTileMode tmy, SkFilterMode mode) const
Public Member Functions inherited from SkRefCntBase
	SkRefCntBase ()
virtual	~SkRefCntBase ()
bool	unique () const
void	ref () const
void	unref () const

Additional Inherited Members
Static Public Member Functions inherited from SkPicture
static sk_sp< SkPicture >	MakeFromStream (SkStream *stream, const SkDeserialProcs *procs=nullptr)
static sk_sp< SkPicture >	MakeFromData (const SkData *data, const SkDeserialProcs *procs=nullptr)
static sk_sp< SkPicture >	MakeFromData (const void *data, size_t size, const SkDeserialProcs *procs=nullptr)
static sk_sp< SkPicture >	MakePlaceholder (SkRect cull)

Detailed Description

Definition at line 27 of file SkBigPicture.h.

Constructor & Destructor Documentation

SkBigPicture()

SkBigPicture::SkBigPicture	(	const SkRect &	cull,
		sk_sp< SkRecord >	record,
		std::unique_ptr< SnapshotArray >	drawablePicts,
		sk_sp< SkBBoxHierarchy >	bbh,
		size_t	approxBytesUsedBySubPictures
	)

Definition at line 19 of file SkBigPicture.cpp.

    : fCullRect(cull)
    , fApproxBytesUsedBySubPictures(approxBytesUsedBySubPictures)
    , fRecord(std::move(record))
    , fDrawablePicts(std::move(drawablePicts))
    , fBBH(std::move(bbh))
{}

Member Function Documentation

approximateBytesUsed()

size_t SkBigPicture::approximateBytesUsed ( ) const

overridevirtual

Returns the approximate byte size of SkPicture. Does not include large objects referenced by SkPicture.

Returns

approximate size

example: https://fiddle.skia.org/c/@Picture_approximateBytesUsed

Implements SkPicture.

Definition at line 69 of file SkBigPicture.cpp.

                                                {
    size_t bytes = sizeof(*this) + fRecord->bytesUsed() + fApproxBytesUsedBySubPictures;
    if (fBBH) { bytes += fBBH->bytesUsed(); }
    return bytes;
}

approximateOpCount()

int SkBigPicture::approximateOpCount ( bool  nested ) const

overridevirtual

Returns the approximate number of operations in SkPicture. Returned value may be greater or less than the number of SkCanvas calls recorded: some calls may be recorded as more than one operation, other calls may be optimized away.

Parameters

nested

if true, include the op-counts of nested pictures as well, else just return count the ops in the top-level picture.

Returns

approximate operation count

example: https://fiddle.skia.org/c/@Picture_approximateOpCount

Implements SkPicture.

Definition at line 58 of file SkBigPicture.cpp.

                                                      {
    if (nested) {
        NestedApproxOpCounter visitor;
        for (int i = 0; i < fRecord->count(); i++) {
            fRecord->visit(i, visitor);
        }
        return visitor.fCount;
    } else {
        return fRecord->count();
    }
}

asSkBigPicture()

const SkBigPicture * SkBigPicture::asSkBigPicture ( ) const

inlineoverridevirtual

Reimplemented from SkPicture.

Definition at line 54 of file SkBigPicture.h.

{ return this; }

bbh()

const SkBBoxHierarchy * SkBigPicture::bbh ( ) const

inline

Definition at line 57 of file SkBigPicture.h.

{ return fBBH.get(); }

cullRect()

SkRect SkBigPicture::cullRect ( ) const

overridevirtual

Returns cull SkRect for this picture, passed in when SkPicture was created. Returned SkRect does not specify clipping SkRect for SkPicture; cull is hint of SkPicture bounds.

SkPicture is free to discard recorded drawing commands that fall outside cull.

Returns

bounds passed when SkPicture was created

example: https://fiddle.skia.org/c/@Picture_cullRect

Implements SkPicture.

Definition at line 57 of file SkBigPicture.cpp.

{ return fCullRect; }

playback()

void SkBigPicture::playback ( SkCanvas *  canvas, AbortCallback *  callback  ) const

overridevirtual

Replays the drawing commands on the specified canvas. In the case that the commands are recorded, each command in the SkPicture is sent separately to canvas.

To add a single command to draw SkPicture to recording canvas, call SkCanvas::drawPicture instead.

Parameters

canvas	receiver of drawing commands
callback	allows interruption of playback

example: https://fiddle.skia.org/c/@Picture_playback

Implements SkPicture.

Definition at line 31 of file SkBigPicture.cpp.

                                                                           {
    SkASSERT(canvas);
 
    // If the query contains the whole picture, don't bother with the BBH.
    const bool useBBH = !canvas->getLocalClipBounds().contains(this->cullRect());
 
    SkRecordDraw(*fRecord,
                 canvas,
                 this->drawablePicts(),
                 nullptr,
                 this->drawableCount(),
                 useBBH ? fBBH.get() : nullptr,
                 callback);
}

record()

const SkRecord * SkBigPicture::record ( ) const

inline

Definition at line 58 of file SkBigPicture.h.

{ return fRecord.get(); }

---

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

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