Graphviz: attributes

Searching...

No Matches

Collaboration diagram for attributes:

Modules
	records
	These records are attached by client programs dynamically at runtime.

Files
file	attr.c
	implementation of dynamic attributes

Data Structures
struct	Agattr_s
	string attribute container More...

struct	Agsym_s
	string attribute descriptor symbol in Agattr_s.dict More...

struct	Agdatadict_s

Functions
Agdatadict_t *	agdatadict (Agraph_t *g, bool cflag)

Agattr_t *	agattrrec (void *obj)

void	agraphattr_init (Agraph_t *g)

int	agraphattr_delete (Agraph_t *g)

void	agnodeattr_init (Agraph_t g, Agnode_t n)

void	agnodeattr_delete (Agnode_t *n)

void	agedgeattr_init (Agraph_t g, Agedge_t e)

void	agedgeattr_delete (Agedge_t *e)

Agsym_t *	agattr (Agraph_t g, int kind, char name, const char *value)
	creates or looks up attributes of a graph

Agsym_t *	agattrsym (void obj, char name)
	looks up a string attribute for a graph object given as an argument

Agsym_t *	agnxtattr (Agraph_t g, int kind, Agsym_t attr)
	permits traversing the list of attributes of a given type

int	agcopyattr (void oldobj, void newobj)
	copies all of the attributes from one object to another

char *	agget (void obj, char name)

char *	agxget (void obj, Agsym_t sym)

int	agset (void obj, char name, const char *value)

int	agxset (void obj, Agsym_t sym, const char *value)

int	agsafeset (void obj, char name, const char value, const char def)
	ensures the given attribute is declared before setting it locally on an object

Detailed Description

Programmer-defined values may be dynamically attached to graphs, subgraphs, nodes, and edges. Such values are either character string data (see agattr) (for I/O) or uninterpreted binary records (for implementing algorithms efficiently).

String attributes are handled automatically in reading and writing graph files. A string attribute is identified by name and by an internal symbol table entry (Agsym_t) created by Libcgraph. Attributes of nodes, edges, and graphs (with their subgraphs) have separate namespaces. The contents of an Agsym_t have a char* name for the attribute's name, a char* defval field for the attribute's default value, and an int id field containing the index of the attribute's specific value for an object in the object's array of attribute values.

Function Documentation

◆ agattr()

Agsym_t * agattr	(	Agraph_t *	g,
		int	kind,
		char *	name,
		const char *	value
	)

Parameters

g	graph. When is NULL, the default is set for all graphs created subsequently.
kind	may be AGRAPH, AGNODE, or AGEDGE.
value	default value. When is (char*)0, the request is to search for an existing attribute of the given kind and name.

If the attribute already exists, its default for creating new objects is set to the given value; if it does not exist, a new attribute is created with the given default value, and the default is applied to all pre-existing objects of the given kind

Definition at line 341 of file attr.c.

References agopen(), getattr(), kind, ProtoDesc, ProtoGraph, and setattr().

Referenced by addRevEdge(), agedgeattr(), agnodeattr(), agraphattr(), agsafeset(), attach_edge_colors(), attached_clustering(), attrstmt(), attrstmt(), bindattrs(), bindattrs(), bindedgeattr(), cloneDfltAttrs(), cloneGraph(), cloneGraph(), clust_in_layer(), color(), constrainY(), copy_attr(), copyAttr(), copyAttr(), deselect_all(), doApply(), dot_sameports(), Dot_SetClusterColor(), dotneato_args_initialize(), emit_graph(), export_dot(), fdp_init_graph(), fdp_init_node_edge(), fdp_initParams(), get_checkbox_widget_to_attribute(), get_color_button_widget_to_attribute(), get_combobox_widget_to_attribute(), get_scalebtn_widget_to_attribute(), get_spinbtn_widget_to_attribute(), get_text_widget_to_attribute(), getAttrBool(), getAttrFloat(), getAttrInt(), getAttrStr(), getDfltAttr(), getv(), getv(), getval(), global_def(), graph_init(), graphRecord(), gvContext(), gvContextPlugins(), gvplugin_graph(), Import_coord_clusters_from_dot(), Import_dot_splines(), init_info(), init_nop(), initGraphAttrs(), initialPositions(), layout(), loadGraph(), lookup(), makeDotGraph(), makeGraphData(), mkport(), mkport(), neatoModel(), nxtAttr(), on_attrAddBtn_clicked(), patchwork_init_graph(), plot_dot_map(), posOf(), post(), pre(), safe_dcl(), scan_graph_mode(), select_edge(), select_node(), set_visibility(), setattr(), setAttr(), setDfltAttr(), setedgeattributes(), setgraphattributes(), setnodeattributes(), setState(), setv(), setv(), SparseMatrix_import_dot(), twopi_layout(), update_graph_params(), updateRecord(), write_hdr(), and writeHdr().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ agattrrec()

Agattr_t * agattrrec ( void * obj )

Definition at line 229 of file attr.c.

References AgDataRecName, and aggetrec().

Referenced by addattr(), agattrsym(), agedgeattr_delete(), agedgeattr_init(), agget(), agnodeattr_delete(), agnodeattr_init(), agraphattr_delete(), agxget(), agxset(), irrelevant_subgraph(), not_default_attrs(), write_nondefault_attrs(), and writeNondefaultAttr().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ agattrsym()

Agsym_t * agattrsym	(	void *	obj,
		char *	name
	)

Definition at line 156 of file attr.c.

References agattrrec(), agdictsym(), and NULL.

Referenced by agcopyattr(), agget(), agset(), copyAttr(), getval(), lookup(), post(), and setattr().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ agcopyattr()

int agcopyattr	(	void *	oldobj,
		void *	newobj
	)

Returns: fails and returns non-zero if argument objects are different kinds, or if all of the attributes of the source object have not been declared for the target object

Definition at line 552 of file attr.c.

References agattrsym(), aghtmlstr(), agmarkhtmlstr(), agnxtattr(), agraphof(), AGTYPE, agxget(), agxset(), and Agsym_s::name.

Referenced by addRevEdge(), cloneEdge(), cloneEdge(), cloneNode(), and projectG().

Here is the call graph for this function:

Here is the caller graph for this function: