VdfIsolatedSubnetwork Class Reference

#include <isolatedSubnetwork.h>

Public Types
using	ConnectionSet = pxr_tsl::robin_set< VdfConnection *, TfHash >
	A set of isolated connections. More...
using	EditFilter = TfFunctionRef< bool(const VdfNode *)>

Public Member Functions
	VdfIsolatedSubnetwork (const VdfIsolatedSubnetwork &)=delete
VdfIsolatedSubnetwork &	operator= (const VdfIsolatedSubnetwork &)=delete
VDF_API	~VdfIsolatedSubnetwork ()
VDF_API bool	AddIsolatedBranch (VdfConnection *connection, EditFilter canDelete)
VDF_API bool	AddIsolatedBranch (VdfNode *node, EditFilter canDelete)
VDF_API void	RemoveIsolatedObjectsFromNetwork ()
const std::vector< VdfNode * > &	GetIsolatedNodes () const
	Returns the set of isolated nodes. More...
const ConnectionSet &	GetIsolatedConnections () const
	Returns the set of isolated nodes. More...

Static Public Member Functions
static VDF_API std::unique_ptr < VdfIsolatedSubnetwork >	IsolateBranch (VdfConnection *connection, EditFilter canDelete)
static VDF_API std::unique_ptr < VdfIsolatedSubnetwork >	IsolateBranch (VdfNode *node, EditFilter canDelete)
static VDF_API std::unique_ptr < VdfIsolatedSubnetwork >	New (VdfNetwork *network)

Detailed Description

A VdfIsolatedSubnetwork builds a collection of VdfNodes and VdfConnections that are disconnected from the owning network.

Building an isolated subnetwork proceeds in three phases:

1. A traversal starts from one or more nodes or connections and proceeds in the input direction, and identifies all reachable objects that are not otherwise connected to the network. I.e., the traversal stops at nodes that have output connections that are not part of the isolated subnetwork.
2. Isolated objects are removed from the network, which causes WillDelete notices to be sent, out even though objects have not yet been deleted. This process transfers ownership of network objects from the VdfNetwork to the VdfIsolatedSubnetwork.
3. The objects are deleted when the VdfIsolatedSubnetwork is deleted.

Definition at line 48 of file isolatedSubnetwork.h.

Member Typedef Documentation

using VdfIsolatedSubnetwork::ConnectionSet = pxr_tsl::robin_set<VdfConnection *, TfHash>

A set of isolated connections.

Definition at line 58 of file isolatedSubnetwork.h.

using VdfIsolatedSubnetwork::EditFilter = TfFunctionRef<bool(const VdfNode *)>

A function that returns true if the given node is allowed to be isolated and deleted.

Definition at line 62 of file isolatedSubnetwork.h.

Constructor & Destructor Documentation

VdfIsolatedSubnetwork::VdfIsolatedSubnetwork ( const VdfIsolatedSubnetwork &  )

delete

VDF_API VdfIsolatedSubnetwork::~VdfIsolatedSubnetwork

(

)

Member Function Documentation

VDF_API bool VdfIsolatedSubnetwork::AddIsolatedBranch	(	VdfConnection *	connection,
		EditFilter	canDelete
	)

Isolates all nodes and connections reachable via input connections from connection that are not connected via additional output connections to other parts of the network.

Note that connection is added to the set of isolated objects.

The canDelete object is used to prune the traversal.

Note

Isolated objects are not immediately removed from the network. See RemoveIsolatedObjectsFromNetwork.

VDF_API bool VdfIsolatedSubnetwork::AddIsolatedBranch	(	VdfNode *	node,
		EditFilter	canDelete
	)

Isolates all nodes and connections reachable via input connections from node that are not connected via additional output connections to other parts of the network.

The canDelete object is used to prune the traversal.

Note

If node has output connections or canDelete returns false for node, no objects are added to the isolated subnetwork and false is returned.

Isolated objects are not immediately removed from the network. See RemoveIsolatedObjectsFromNetwork.

const ConnectionSet& VdfIsolatedSubnetwork::GetIsolatedConnections ( ) const

inline

Returns the set of isolated nodes.

Definition at line 159 of file isolatedSubnetwork.h.

const std::vector<VdfNode *>& VdfIsolatedSubnetwork::GetIsolatedNodes ( ) const

inline

Returns the set of isolated nodes.

Definition at line 154 of file isolatedSubnetwork.h.

static VDF_API std::unique_ptr<VdfIsolatedSubnetwork> VdfIsolatedSubnetwork::IsolateBranch ( VdfConnection *  connection, EditFilter  canDelete  )

static

Isolates all nodes and connections reachable via input connections from connection that are not connected via additional output connections to other parts of the network.

Note that connection is added to the set of isolated objects.

The canDelete object is used to prune the traversal.

Removes the isolated objects from the network and returns a unique pointer to the isolated network object that holds onto the isolated nodes and connections. When the isolated network object is deleted, the isolated nodes and connections are deleted.

static VDF_API std::unique_ptr<VdfIsolatedSubnetwork> VdfIsolatedSubnetwork::IsolateBranch ( VdfNode *  node, EditFilter  canDelete  )

static

Isolates all nodes and connections reachable via input connections from node that are not connected via additional output connections to other parts of the network.

The canDelete object is used to prune the traversal.

Removes the isolated objects from the network and returns a strong reference to the isolated network object that holds onto the isolated nodes and connections. When the isolated network object is deleted, the isolated nodes and connections are deleted.

Note

An error is emitted if node has output connections.

static VDF_API std::unique_ptr<VdfIsolatedSubnetwork> VdfIsolatedSubnetwork::New ( VdfNetwork *  network )

static

Creates an empty isolated subnetwork.

The subnetwork can be populated via calls to the AddIsolatedBranch methods.

VdfIsolatedSubnetwork& VdfIsolatedSubnetwork::operator= ( const VdfIsolatedSubnetwork &  )

delete

VDF_API void VdfIsolatedSubnetwork::RemoveIsolatedObjectsFromNetwork

(

)

Removes all isolated objects from the network.

This method is called upon destruction, if it isn't called before then.

---

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

• pxr/exec/vdf/isolatedSubnetwork.h