#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)

virtual void	onRender (SkCanvas , const RenderContext ) const =0

virtual const RenderNode *	onNodeAt (const SkPoint &p) const =0

Protected Member Functions inherited from sksg::Node
	Node (uint32_t invalTraits)

	~Node () override

const SkRect &	bounds () const

bool	hasInval () const

virtual SkRect	onRevalidate (InvalidationController *, const SkMatrix &ctm)=0

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.

43{ 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.

42{ 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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Group() [1/2]

◆ Group() [2/2]

◆ ~Group()

Member Function Documentation

◆ addChild()

◆ clear()

◆ empty()

◆ Make() [1/2]

◆ Make() [2/2]

◆ onNodeAt()

◆ onRender()

◆ onRevalidate()

◆ removeChild()

◆ size()