c4d.modules.graphview.GvNode¶

class c4d.modules.graphview.GvNode¶: Use GvNodeMaster.CreateNode() to create nodes.

The GvNode is a double BaseList2D node.

Warning

This type cannot be instantiated.

Note

Please use GvNode.GetOperatorContainer() to access most parameters.

A GvNode is a node which is stored in a GvNodeMaster.

A node contains ports represented by GvPort.

Parent Class:

c4d.BaseList2D

Overview¶

Node Overview
`GvNode.GetNodeMaster()`	Returns the GvNodeMaster where the node is attached to.
`GvNode.GetOperatorID()`	Returns the operator ID.
`GvNode.GetOwnerID()`	Returns the owner ID of the node.
`GvNode.IsGroupNode()`	Checks if the node is a group node.
`GvNode.Redraw()`	Redraws the node.
Operator Configuration
`GvNode.GetOpContainerInstance()`	Retrieves a pointer to the internal operator’s container.
`GvNode.GetOperatorContainer()`	Returns the settings container.
`GvNode.OperatorSetData()`	Sets data in the operator.
`GvNode.SetOperatorContainer()`	Set the settings container.
Port Access
`GvNode.GetInPort()`	Retrieves an inport by index.
`GvNode.GetInPortCount()`	Returns the count of the inports.
`GvNode.GetInPorts()`	Retrieves all inports of a node.
`GvNode.GetOutPort()`	Retrieves an outport by index.
`GvNode.GetOutPortCount()`	Returns the count of the outports.
`GvNode.GetOutPorts()`	Retrieves all outports of a node.
`GvNode.GetPort()`	Retrieves a port by sub ID.
`GvNode.GetPortIndex()`	Gets the index of a port by sub ID.
Ports And Connections
`GvNode.AddPort()`	Adds a port to the node.
`GvNode.AddPortIsOK()`	Checks if `AddPort()` would be successful.
`GvNode.RemoveConnections()`	Removes all connections of the node.
`GvNode.RemovePort()`	Removes a port from this node.
`GvNode.RemovePortIsOK()`	Checks if it is OK to remove a port from this node.
`GvNode.RemoveUnusedPorts()`	Removes all unused ports - Sends a message to the node.
`GvNode.ResetPortType()`	Changes the type of the port.
`GvNode.SetPortType()`	Changes the type of a port of this node.

Members¶

Node Overview¶

GvNode.GetNodeMaster(self)¶

Returns the GvNodeMaster where the node is attached to.

Return type: Optional[c4d.modules.graphview.GvNodeMaster]
Returns: The GvNodeMaster or None if there is no nodemaster.

GvNode.GetOperatorID(self)¶

Returns the operator ID.

Return type: int
Returns: The id.

GvNode.GetOwnerID(self)¶

Returns the owner ID of the node.

Return type

int

Returns

The id.

ID_GV_SYSTEM_OWNER	System.
ID_GV_GENERAL_OWNER	General.
ID_GV_IGNORE_OWNER	Ignore owner.

GvNode.IsGroupNode(self)¶

Checks if the node is a group node.

Return type: bool
Returns: True if the node is a group node, otherwise False.

GvNode.Redraw(self)¶: Redraws the node.

Operator Configuration¶

GvNode.GetOpContainerInstance(self)¶

Retrieves a pointer to the internal operator’s container.

This means that the container can be changed directly.

Return type: c4d.BaseContainer
Returns: The container.

GvNode.GetOperatorContainer(self)¶

Returns the settings container.

Return type: c4d.BaseContainer
Returns: The container.

GvNode.OperatorSetData(self, type, data, mode)¶

Sets data in the operator. Usually simulates dragging onto the node.

New in version R18.057.

Parameters

type (int) –

The data type:

GV_ATOMARRAY	list of `c4d.C4DAtom`	The active objects.
GV_ATOM	`c4d.C4DAtom`	The active object.
GV_DESCID	dict(‘did’: `c4d.DescID`, ‘arr’: list of `c4d.C4DAtom`)	The description ID and related active object(s).

data (any) – The data to set. Depends on type.

mode (int) –

The set data mode:

GV_OP_NOP	Ignore.
GV_OP_SET	Set the internal value to the parameter value. (The constant node uses this.)
GV_OP_DROP	An atom has been dropped over the node.
GV_OP_DROP_IN_BODY	An atom has been dropped over the body of the node.
GV_OP_DROP_IN_INDOCK	An atom has been dropped in the inport area of the node.
GV_OP_DROP_IN_OUTDOCK	An atom has been dropped in the outport area of the node.

Return type

bool

Returns

True if the data was set, otherwise False.

GvNode.SetOperatorContainer(self, bc)¶

Set the settings container.

Parameters: str – The container.

Port Access¶

GvNode.GetInPort(self, id)¶

Retrieves an inport by index.

Parameters: id (int) – the index
Return type: Optional[c4d.modules.graphview.GvPort]
Returns: The GvPort or None if no port was found.

GvNode.GetInPortCount(self)¶

Returns the count of the inports.

Return type: int
Returns: The count.

GvNode.GetInPorts(self, type=-1)¶

Retrieves all inports of a node.

Parameters

type (int) –

If type is set, just the ports with the given type will be returned.

Each port has its own type ID’s for the ports so check the C-header files of the node.

Return type

Optional[List[c4d.modules.graphview.GvPort]]

Returns

The GvPorts or None if no port was found.

GvNode.GetOutPort(self, id)¶

Retrieves an outport by index.

Parameters: id (int) – the index
Return type: Optional[c4d.modules.graphview.GvPort]
Returns: The GvPort or None if no port was found.

GvNode.GetOutPortCount(self)¶

Returns the count of the outports.

Return type: int
Returns: The count

GvNode.GetOutPorts(self, type=-1)¶

Retrieves all outports of a node.

Parameters

type (int) –

If type is set, just the ports with the given type will be returned.

Each port has its own type ID’s for the ports so check the C-header files of the node.

Return type

Optional[List[c4d.modules.graphview.GvPort]]

Returns

The GvPorts or None if no port was found.

GvNode.GetPort(self, sub_id)¶

Retrieves a port by sub ID.

Parameters: sub_id (int) – Port sub ID.
Return type: Optional[c4d.modules.graphview.GvPort]
Returns: The retrieved port, or None.

GvNode.GetPortIndex(self, id)¶

Gets the index of a port by sub ID.

Parameters: id (int) – Port sub ID.
Return type: int
Returns: Port index.

Ports And Connections¶

GvNode.AddPort(self, io, id, flag=1, message=False)¶

Adds a port to the node.

Note

To add a port for a user data parameter create the DescID of that parameter:

USERDATA_NUMBER = 1
nodeObjOut.AddPort(c4d.GV_PORT_OUTPUT, c4d.DescID(c4d.DescLevel(c4d.ID_USERDATA, c4d.DTYPE_SUBCONTAINER, 0), c4d.DescLevel(USERDATA_NUMBER)), message=True)

Parameters

io (int) –
The IO mode of the port to create:

GV_PORT_INVALID

Invalid.

GV_PORT_INPUT

Input.

GV_PORT_OUTPUT

Output.

GV_PORT_INPUT_OR_GEDATA

Input or GeData.
id (Union[int, c4d.DescID]) – The ID of the port to create.
flag (int) –
Flags:

GV_PORT_FLAG_NONE

No flag.

GV_PORT_FLAG_IS_VISIBLE

Visible port.

GV_PORT_FLAG_IS_ITERATE

Iteration port.
message (bool) – If True the operator receives a message when the port is added.

Return type

Optional[c4d.modules.graphview.GvPort]

Returns

The created port or None if creation failed.

GvNode.AddPortIsOK(self, io, id)¶

Checks if AddPort() would be successful.

Parameters

io (int) –
The port mode:

GV_PORT_INVALID

Invalid.

GV_PORT_INPUT

Input.

GV_PORT_OUTPUT

Output.

GV_PORT_INPUT_OR_GEDATA

Input or GeData.
id (int) – The type id of the port.

Return type

bool

Returns

True if adding the port would succeed, otherwise False.

GvNode.RemoveConnections(self)¶: Removes all connections of the node.

GvNode.RemovePort(self, port, message=False)¶

Removes a port from this node.

Parameters

port (c4d.modules.graphview.GvPort) – A port of this node to remove.
message (bool) – If this is True the operator receives a message when the port is removed.

GvNode.RemovePortIsOK(self, port)¶

Checks if it is OK to remove a port from this node.

Note

Used to check if a call to GvNode.RemovePort() would succeed.

Parameters: port (c4d.modules.graphview.GvPort) – A port of this node to remove.
Return type: bool
Returns: True if this port can be remove.

GvNode.RemoveUnusedPorts(self, message=True)¶

Removes all unused ports - Sends a message to the node.

Parameters: message (bool) – If this is True, the operator receives a message when the ports are removed.

GvNode.ResetPortType(self, id)¶

Changes the type of the port. Used to manage dynamic data ports.

Parameters: id (int) – The type.

GvNode.SetPortType(self, port, id)¶

Changes the type of a port of this node.

Parameters

port (c4d.modules.graphview.GvPort) – A port of this node.
id (int) – The new port ID.

Category	Option	Description
Query	Words and phrases	Search is case-insensitive. Put a phrase in quotes for an exact match. Quoted phrases require every word and disable fuzzy matching.
Terms	OR / AND	Choose whether to match any term or require all terms.
Fuzzy	On / Off	Toggle approximate and prefix matches. Quoted phrases always use strict matching.
Results	Sparse / Dense	Sparse groups multiple hits for one entity and hides its owned API members when the class or module itself matches. Dense lists each match separately.
Sort by	Type / Relevance	Group results by entity type then rank within each group, or rank all results by relevance.
Content	All / API / Manuals / Examples / Resources	Search all documentation, API documentation, manuals, the examples index, or the resources index. Code examples embedded in other sections retain their own content area.
Entity	All / Page / Module / Class / Function / Attribute / Description / Node / Symbol / Icon	Page covers results without a specific entity type. Resource entity types are available with All or Resources; API entity types are available with All or API.
Location	All / Text / Code / Name / Signature	Text covers everything outside code, names, and signatures. Name and Signature are available with All or API.

GV_PORT_INVALID	Invalid.
GV_PORT_INPUT	Input.
GV_PORT_OUTPUT	Output.
GV_PORT_INPUT_OR_GEDATA	Input or GeData.

GV_PORT_FLAG_NONE	No flag.
GV_PORT_FLAG_IS_VISIBLE	Visible port.
GV_PORT_FLAG_IS_ITERATE	Iteration port.