sksg::Group Class Reference

#include <SkSGGroup.h>

Inheritance diagram for sksg::Group:

Public Member Functions
void	addChild (sk_sp< RenderNode >)
void	removeChild (const sk_sp< RenderNode > &)
size_t	size () const
bool	empty () const
void	clear ()
Public Member Functions inherited from sksg::RenderNode
void	render (SkCanvas *, const RenderContext *=nullptr) const
const RenderNode *	nodeAt (const SkPoint &point) const
bool	isVisible () const
void	setVisible (bool)
Public Member Functions inherited from sksg::Node
const SkRect &	revalidate (InvalidationController *, const SkMatrix &)
void	invalidate (bool damage=true)
Public Member Functions inherited from SkRefCntBase
	SkRefCntBase ()
virtual	~SkRefCntBase ()
bool	unique () const
void	ref () const
void	unref () const

Static Public Member Functions
static sk_sp< Group >	Make ()
static sk_sp< Group >	Make (std::vector< sk_sp< RenderNode > > children)

Protected Member Functions
	Group ()
	Group (std::vector< sk_sp< RenderNode > >)
	~Group () override
void	onRender (SkCanvas *, const RenderContext *) const override
const RenderNode *	onNodeAt (const SkPoint &) const override
SkRect	onRevalidate (InvalidationController *, const SkMatrix &) override
Protected Member Functions inherited from sksg::RenderNode
	RenderNode (uint32_t inval_traits=0)
Protected Member Functions inherited from sksg::Node
	Node (uint32_t invalTraits)
	~Node () override
const SkRect &	bounds () const
bool	hasInval () const
void	observeInval (const sk_sp< Node > &)
void	unobserveInval (const sk_sp< Node > &)

Additional Inherited Members
Protected Types inherited from sksg::Node
enum	InvalTraits { kBubbleDamage_Trait = 1 << 0 , kOverrideDamage_Trait = 1 << 1 }

Detailed Description

Concrete node, grouping together multiple descendants.

Definition at line 29 of file SkSGGroup.h.

Constructor & Destructor Documentation

Group() [1/2]

sksg::Group::Group ( )

protecteddefault

Group() [2/2]

sksg::Group::Group ( std::vector< sk_sp< RenderNode > >  children )

explicitprotected

Definition at line 25 of file SkSGGroup.cpp.

    : fChildren(std::move(children)) {
    for (const auto& child : fChildren) {
        this->observeInval(child);
    }
}

~Group()

sksg::Group::~Group ( )

overrideprotected

Definition at line 32 of file SkSGGroup.cpp.

              {
    for (const auto& child : fChildren) {
        this->unobserveInval(child);
    }
}

Member Function Documentation

addChild()

void sksg::Group::addChild

(

sk_sp< RenderNode >

node

)

Definition at line 45 of file SkSGGroup.cpp.

                                           {
    // should we allow duplicates?
    for (const auto& child : fChildren) {
        if (child == node) {
            return;
        }
    }
 
    this->observeInval(node);
    fChildren.push_back(std::move(node));
 
    this->invalidate();
}

clear()

void sksg::Group::clear

(

)

Definition at line 38 of file SkSGGroup.cpp.

                  {
    for (const auto& child : fChildren) {
        this->unobserveInval(child);
    }
    fChildren.clear();
}

empty()

bool sksg::Group::empty ( ) const

inline

Definition at line 43 of file SkSGGroup.h.

{ return fChildren.empty(); }

Make() [1/2]

static sk_sp< Group > sksg::Group::Make ( )

inlinestatic

Definition at line 31 of file SkSGGroup.h.

                               {
        return sk_sp<Group>(new Group(std::vector<sk_sp<RenderNode>>()));
    }

Make() [2/2]

static sk_sp< Group > sksg::Group::Make ( std::vector< sk_sp< RenderNode > >  children )

inlinestatic

Definition at line 35 of file SkSGGroup.h.

                                                                    {
        return sk_sp<Group>(new Group(std::move(children)));
    }

onNodeAt()

const RenderNode * sksg::Group::onNodeAt ( const SkPoint &  p ) const

overrideprotectedvirtual

Implements sksg::RenderNode.

Definition at line 78 of file SkSGGroup.cpp.

                                                        {
    for (auto it = fChildren.crbegin(); it != fChildren.crend(); ++it) {
        if (const auto* node = (*it)->nodeAt(p)) {
            return node;
        }
    }
 
    return nullptr;
}

onRender()

void sksg::Group::onRender ( SkCanvas *  canvas, const RenderContext *  ctx  ) const

overrideprotectedvirtual

Implements sksg::RenderNode.

Definition at line 68 of file SkSGGroup.cpp.

                                                                     {
    const auto local_ctx = ScopedRenderContext(canvas, ctx).setIsolation(this->bounds(),
                                                                         canvas->getTotalMatrix(),
                                                                         fRequiresIsolation);
 
    for (const auto& child : fChildren) {
        child->render(canvas, local_ctx);
    }
}

onRevalidate()

SkRect sksg::Group::onRevalidate ( InvalidationController *  ic, const SkMatrix &  ctm  )

overrideprotectedvirtual

Implements sksg::Node.

Definition at line 88 of file SkSGGroup.cpp.

                                                                          {
    SkASSERT(this->hasInval());
 
    SkRect bounds = SkRect::MakeEmpty();
    fRequiresIsolation = false;
 
    for (size_t i = 0; i < fChildren.size(); ++i) {
        const auto child_bounds = fChildren[i]->revalidate(ic, ctm);
 
        // If any of the child nodes overlap, group effects require layer isolation.
        if (!fRequiresIsolation && i > 0 && child_bounds.intersects(bounds)) {
#if 1
            // Testing conservatively against the union of prev bounds is cheap and good enough.
            fRequiresIsolation = true;
#else
            // Testing exhaustively doesn't seem to increase the layer elision rate in practice.
            for (size_t j = 0; j < i; ++ j) {
                if (child_bounds.intersects(fChildren[i]->bounds())) {
                    fRequiresIsolation = true;
                    break;
                }
            }
#endif
        }
 
        bounds.join(child_bounds);
    }
 
    return bounds;
}

removeChild()

void sksg::Group::removeChild

(

const sk_sp< RenderNode > &

node

)

Definition at line 59 of file SkSGGroup.cpp.

                                                     {
    SkDEBUGCODE(const auto origSize = fChildren.size());
    fChildren.erase(std::remove(fChildren.begin(), fChildren.end(), node), fChildren.end());
    SkASSERT(fChildren.size() == origSize - 1);
 
    this->unobserveInval(node);
    this->invalidate();
}

size()

size_t sksg::Group::size ( ) const

inline

Definition at line 42 of file SkSGGroup.h.

{ return fChildren.size(); }

---

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

• third_party/skia/modules/sksg/include/SkSGGroup.h
• third_party/skia/modules/sksg/src/SkSGGroup.cpp