Ovis_Node_Mapping_Get()
Abstract
Retrieves the mapping callback for a node.
Syntax
Ovis_Node_Mapping_Get (node_hndl)
| Argument | Type | Description |
|---|---|---|
node_hndl |
EtsT_Obj_Handle or Objid |
Node handle |
Return Type
Mapping node callback
Header
ovis_mapping.h
Details
This function checks if the specified node instance has an associated mapping callback. If so, the callback is returned to be invoked appropriately to let the node perform its own mapping.
Example
OvisT_Mapping_Node_Proc node_proc;
Objid objid = op_topo_parent (op_id_self ());
/* Look for a mapping proc on node of current process; */
/* if found, use it to enable the mapping */
node_proc = Ovis_Node_Mapping_Get (objid);
if (node_proc != (OvisT_Mapping_Node_Proc)OVISC_NIL)
(*node_proc)(objid, OvisC_Mapping_Enable, OVISC_NIL, OVISC_NIL);
Errors
- Object ID (
<id>) is out-of-range. - Object ID (
<id>) refers to a restricted object. - Object
<hname>is not a fixed or mobile node or subnet.
Reference
- Use the function Ovis_Entity_Animation_Set() to specify how a node will appear in 3D Network Visualizer.