phref.3alc - Man Page

The phref structure is used to describe a reference belonging to a symbolic layout model, see phfig(3) for details. A reference allows to name a point anywhere in a given model. It may then be seen as a name, and not anymore as a couple of coordinates. References are mostly used for cell programming and multi-access connector representation.

The declarations needed to work on phref are available in the header file "/labo/include/mph402.h", where '402' is the actual mbk version.

The following C structure supports the description of the reference :

typedef struct phref {
	struct phref	∗NEXT;
	char	∗FIGNAME;
	char	∗NAME;
	long	XREF,YREF;
	struct ptype	∗USER;
} phref_list;

NEXT

Pointer to the next reference in the list.

FIGNAME

Kind of reference. Gives information about the possible uses of the object. Some FIGNAME are in use today :

"ref_con"

for multi-access connectors

"ref_ref"

for all other uses

NAME

Name of the reference. The reference is identified by its name, so it should be unique at a given hierarchical level.

XREF, YREF

Coordinates of the point being referenced.

USER

Pointer to a ptype list, see ptype(3) for details, that is a general purpose pointer used to share information on the reference.

mbk(1), addphref(3), getphref(3), delphref(3), phfig(3), ptype(3).

addphref.3alc(3), delphref.3alc(3), getphref.3alc(3), mphdebug.3alc(3), phcon.3alc(3), phfig.3alc(3), viewphref.3alc(3).