#include <BKE_grease_pencil.hh>

Inherits GreasePencilLayerTreeGroup.

Public Member Functions
	LayerGroup ()

	LayerGroup (StringRefNull name)

	LayerGroup (const LayerGroup &other)

	~LayerGroup ()

LayerGroup &	operator= (const LayerGroup &other)

const TreeNode &	as_node () const

TreeNode &	as_node ()

bool	is_empty () const

int64_t	num_direct_nodes () const

int64_t	num_nodes_total () const

Span< const TreeNode * >	nodes () const

Span< TreeNode * >	nodes_for_write ()

Span< const Layer * >	layers () const

Span< Layer * >	layers_for_write ()

Span< const LayerGroup * >	groups () const

Span< LayerGroup * >	groups_for_write ()

const TreeNode *	find_node_by_name (StringRefNull name) const

TreeNode *	find_node_by_name (StringRefNull name)

void	print_nodes (StringRefNull header) const

void	prepare_for_dna_write ()

void	update_from_dna_read ()

Public Attributes
	TREENODE_COMMON_METHODS

Public Attributes inherited from GreasePencilLayerTreeGroup
GreasePencilLayerTreeNode	base

ListBase	children

int8_t	color_tag

char	_pad [7]

GreasePencilLayerGroupRuntimeHandle *	runtime

Protected Member Functions
TreeNode &	add_node (TreeNode &node)

void	add_node_before (TreeNode &node, TreeNode &link)

void	add_node_after (TreeNode &node, TreeNode &link)

void	move_node_up (TreeNode &node, int step=1)

void	move_node_down (TreeNode &node, int step=1)

void	move_node_top (TreeNode &node)

void	move_node_bottom (TreeNode &node)

bool	unlink_node (TreeNode &link, bool keep_children=false)

Friends
struct	::GreasePencil

Detailed Description

A LayerGroup is a grouping of zero or more Layers.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 646 of file BKE_grease_pencil.hh.

Constructor & Destructor Documentation

◆ LayerGroup() [1/3]

blender::bke::greasepencil::LayerGroup::LayerGroup ( )

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1513 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::base, BLI_listbase_clear(), GreasePencilLayerTreeGroup::children, GreasePencilLayerTreeGroup::color_tag, GP_LAYER_TREE_GROUP, LAYERGROUP_COLOR_NONE, and GreasePencilLayerTreeGroup::runtime.

Referenced by operator=().

◆ LayerGroup() [2/3]

blender::bke::greasepencil::LayerGroup::LayerGroup ( StringRefNull name )

explicit

Definition at line 1523 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::base, and GP_LAYER_TREE_GROUP.

◆ LayerGroup() [3/3]

blender::bke::greasepencil::LayerGroup::LayerGroup ( const LayerGroup & other )

Definition at line 1528 of file grease_pencil.cc.

References add_node(), blender::bke::greasepencil::Layer::as_node(), as_node(), GreasePencilLayerTreeGroup::base, GreasePencilLayerTreeGroup::color_tag, GP_LAYER_TREE_GROUP, GP_LAYER_TREE_LEAF, and LISTBASE_FOREACH.

◆ ~LayerGroup()

blender::bke::greasepencil::LayerGroup::~LayerGroup ( )

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1552 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::base, GreasePencilLayerTreeGroup::children, GP_LAYER_TREE_GROUP, GP_LAYER_TREE_LEAF, LISTBASE_FOREACH_MUTABLE, and GreasePencilLayerTreeGroup::runtime.

Referenced by operator=().

Member Function Documentation

◆ add_node()

TreeNode & blender::bke::greasepencil::LayerGroup::add_node ( TreeNode & node )

protected

Adds an existing node at the end of this group.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1587 of file grease_pencil.cc.

References BLI_addtail(), GreasePencilLayerTreeGroup::children, and node.

Referenced by LayerGroup().

◆ add_node_after()

void blender::bke::greasepencil::LayerGroup::add_node_after	(	TreeNode &	node,
		TreeNode &	link )

protected

Adds an existing node after link of this group.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1601 of file grease_pencil.cc.

References BLI_assert, BLI_findindex(), BLI_insertlinkafter(), and GreasePencilLayerTreeGroup::children.

◆ add_node_before()

void blender::bke::greasepencil::LayerGroup::add_node_before	(	TreeNode &	node,
		TreeNode &	link )

protected

Adds an existing node before link of this group.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1594 of file grease_pencil.cc.

References BLI_assert, BLI_findindex(), BLI_insertlinkbefore(), and GreasePencilLayerTreeGroup::children.

◆ as_node() [1/2]

TreeNode & blender::bke::greasepencil::LayerGroup::as_node ( )

inline

Definition at line 851 of file BKE_grease_pencil.hh.

◆ as_node() [2/2]

const TreeNode & blender::bke::greasepencil::LayerGroup::as_node ( ) const

inline

Returns: the group as a TreeNode.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 847 of file BKE_grease_pencil.hh.

Referenced by BKE_grease_pencil_copy_layer_group_parameters(), blender::ui::greasepencil::LayerGroupViewItem::create_drop_target(), blender::ed::greasepencil::grease_pencil_layer_group_add_exec(), and LayerGroup().

◆ find_node_by_name() [1/2]

TreeNode * blender::bke::greasepencil::LayerGroup::find_node_by_name ( StringRefNull name )

Definition at line 1741 of file grease_pencil.cc.

References node, and nodes_for_write().

◆ find_node_by_name() [2/2]

const TreeNode * blender::bke::greasepencil::LayerGroup::find_node_by_name ( StringRefNull name ) const

Returns a pointer to the node with name. If no such node was found, returns nullptr.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1731 of file grease_pencil.cc.

References node, and nodes().

◆ groups()

Span< const LayerGroup * > blender::bke::greasepencil::LayerGroup::groups ( ) const

Returns a Span of pointers to all the LayerGroupss in this group.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1719 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::runtime.

◆ groups_for_write()

Span< LayerGroup * > blender::bke::greasepencil::LayerGroup::groups_for_write ( )

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1725 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::runtime.

Referenced by blender::ed::greasepencil::grease_pencil_merge_layer_exec().

◆ is_empty()

bool blender::bke::greasepencil::LayerGroup::is_empty ( ) const

inline

Returns true if the group is empty.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 855 of file BKE_grease_pencil.hh.

References BLI_listbase_is_empty(), and GreasePencilLayerTreeGroup::children.

Referenced by unlink_node().

◆ layers()

Span< const Layer * > blender::bke::greasepencil::LayerGroup::layers ( ) const

Returns a Span of pointers to all the Layers in this group.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1707 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::runtime.

◆ layers_for_write()

Span< Layer * > blender::bke::greasepencil::LayerGroup::layers_for_write ( )

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1713 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::runtime.

◆ move_node_bottom()

void blender::bke::greasepencil::LayerGroup::move_node_bottom ( TreeNode & node )

protected

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1625 of file grease_pencil.cc.

References BLI_insertlinkbefore(), BLI_remlink(), GreasePencilLayerTreeGroup::children, and ListBase::first.

◆ move_node_down()

void blender::bke::greasepencil::LayerGroup::move_node_down	(	TreeNode &	node,
		int	step = 1 )

protected

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1614 of file grease_pencil.cc.

References BLI_listbase_link_move(), and GreasePencilLayerTreeGroup::children.

◆ move_node_top()

void blender::bke::greasepencil::LayerGroup::move_node_top ( TreeNode & node )

protected

Move child node to the top/bottom.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1619 of file grease_pencil.cc.

References BLI_insertlinkafter(), BLI_remlink(), GreasePencilLayerTreeGroup::children, and ListBase::last.

◆ move_node_up()

void blender::bke::greasepencil::LayerGroup::move_node_up	(	TreeNode &	node,
		int	step = 1 )

protected

Move child node up/down by step.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1609 of file grease_pencil.cc.

References BLI_listbase_link_move(), and GreasePencilLayerTreeGroup::children.

◆ nodes()

Span< const TreeNode * > blender::bke::greasepencil::LayerGroup::nodes ( ) const

Returns a Span of pointers to all the TreeNodes in this group.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1695 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::runtime.

Referenced by blender::ed::greasepencil::copy_layer_group_content(), and find_node_by_name().

◆ nodes_for_write()

Span< TreeNode * > blender::bke::greasepencil::LayerGroup::nodes_for_write ( )

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1701 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::runtime.

Referenced by find_node_by_name().

◆ num_direct_nodes()

int64_t blender::bke::greasepencil::LayerGroup::num_direct_nodes ( ) const

Returns the number of direct nodes in this group.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1632 of file grease_pencil.cc.

References BLI_listbase_count(), and GreasePencilLayerTreeGroup::children.

Referenced by blender::ed::greasepencil::grease_pencil_layer_move_poll().

◆ num_nodes_total()

int64_t blender::bke::greasepencil::LayerGroup::num_nodes_total ( ) const

Returns the total number of nodes in this group.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1637 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::runtime.

◆ operator=()

LayerGroup & blender::bke::greasepencil::LayerGroup::operator= ( const LayerGroup & other )

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1575 of file grease_pencil.cc.

References LayerGroup(), and ~LayerGroup().

◆ prepare_for_dna_write()

void blender::bke::greasepencil::LayerGroup::prepare_for_dna_write ( )

Prepare the DNA GreasePencilLayerTreeGroup data before blend-file writing.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1820 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::children, GP_LAYER_TREE_GROUP, GP_LAYER_TREE_LEAF, and LISTBASE_FOREACH.

◆ print_nodes()

void blender::bke::greasepencil::LayerGroup::print_nodes ( StringRefNull header ) const

Print the nodes. For debugging purposes.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1751 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::children, blender::Stack< T, InlineBufferCapacity, Allocator >::is_empty(), LISTBASE_FOREACH_BACKWARD, node, blender::Stack< T, InlineBufferCapacity, Allocator >::pop(), and blender::Stack< T, InlineBufferCapacity, Allocator >::push().

◆ unlink_node()

bool blender::bke::greasepencil::LayerGroup::unlink_node	(	TreeNode &	link,
		bool	keep_children = false )

protected

Unlink the node from the list of nodes in this group.

Returns: true, if the node was successfully unlinked.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1643 of file grease_pencil.cc.

References blender::bke::greasepencil::TreeNode::as_group(), BLI_findindex(), BLI_listbase_clear(), BLI_remlink_safe(), GreasePencilLayerTreeGroup::children, ListBase::first, is_empty(), blender::bke::greasepencil::TreeNode::is_group(), ListBase::last, LISTBASE_FOREACH, GreasePencilLayerTreeNode::next, GreasePencilLayerTreeNode::parent, and GreasePencilLayerTreeNode::prev.

◆ update_from_dna_read()

void blender::bke::greasepencil::LayerGroup::update_from_dna_read ( )

Update from DNA GreasePencilLayerTreeGroup data after blend-file reading.

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1836 of file grease_pencil.cc.

References GreasePencilLayerTreeGroup::children, GP_LAYER_TREE_GROUP, GP_LAYER_TREE_LEAF, and LISTBASE_FOREACH.

Friends And Related Symbol Documentation

◆ ::GreasePencil

friend struct ::GreasePencil

friend

Definition at line 647 of file BKE_grease_pencil.hh.

Member Data Documentation

◆ TREENODE_COMMON_METHODS

blender::bke::greasepencil::LayerGroup::TREENODE_COMMON_METHODS

Examples: /usr/src/RPM/BUILD/blender-4.3.0/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 659 of file BKE_grease_pencil.hh.

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

Public Member Functions

Public Attributes

Protected Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ LayerGroup() [1/3]

◆ LayerGroup() [2/3]

◆ LayerGroup() [3/3]

◆ ~LayerGroup()

Member Function Documentation

◆ add_node()

◆ add_node_after()

◆ add_node_before()

◆ as_node() [1/2]

◆ as_node() [2/2]

◆ find_node_by_name() [1/2]

◆ find_node_by_name() [2/2]

◆ groups()

◆ groups_for_write()

◆ is_empty()

◆ layers()

◆ layers_for_write()

◆ move_node_bottom()

◆ move_node_down()

◆ move_node_top()

◆ move_node_up()

◆ nodes()

◆ nodes_for_write()

◆ num_direct_nodes()

◆ num_nodes_total()

◆ operator=()

◆ prepare_for_dna_write()

◆ print_nodes()

◆ unlink_node()

◆ update_from_dna_read()

Friends And Related Symbol Documentation

◆ ::GreasePencil

Member Data Documentation

◆ TREENODE_COMMON_METHODS