1ADDPHREF(3)                 MBK PHYSICAL FUNCTIONS                 ADDPHREF(3)
2
3
4

NAME

6       addphref - create a physical reference
7

SYNOPSIS

9       #include "mph.h"
10       phref_list ∗addphref(ptfig, type, name, x, y)
11       phfig_list ∗ptfig;
12       char ∗type;
13       char ∗name;
14       long x, y;
15

PARAMETERS

17       ptfig               Pointer to the figure in which the reference should
18                           be added
19
20       type                Reference type
21
22       name                Reference name
23
24       x, y                Coordinates of the center of the reference.
25

DESCRIPTION

27       addphref creates a new reference whose center is at the  given  coordi‐
28       nates,   and   adds  it  to  the  list  of  references  pointed  to  by
29       ptfig->PHREF. The new reference is added in  front  of  the  list,  and
30       becomes itself the list head.
31       The  parameters type, name, x and y fill respectivly the FIGNAME, NAME,
32       XREF and YREF fields of the phref structure.
33       The types may have any value, but only two type are now  recognized  by
34       tools based upon mbk :
35
36       "ref_con"           for multi-access connectors
37
38       "ref_ref"           for cell programming
39
40       For details on the structure, see phref(3).
41

RETURN VALUE

43       addphref returns a pointer to the newly created reference.
44

EXAMPLE

46       #include "mph.h"
47       phref_list ∗ref_dup(pfd, pfs) /∗ duplicate refs ∗/
48       phfig_list ∗pfd, ∗pfs;
49       {
50       phref_list ∗pr;
51          for (pr = pfs->phref; pr != NULL; pr = pr->NEXT)
52             addphref(pfd, pr->FIGNAME, pr->NAME, pr->XREF, pr->YREF);
53          return pfd->PHREF;
54       }
55

SEE ALSO

57       mbk(1), phfig(3), phref(3), getphref(3), delphref(3).
58
59
60
61
62
63
64ASIM/LIP6                       October 1, 1997                    ADDPHREF(3)