addphvia(3alc)

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

NAME

6       addphvia - create a physical via
7

SYNOPSIS

9       #include "mph.h"
10       phvia_list ∗addphvia(ptfig, viatype, x, y)
11       phfig_list ∗ptfig;
12       char viatype;
13       long x, y;
14

PARAMETERS

16       ptfig               Pointer  to  the  figure in which the via should be
17                           added
18
19       viatype             Contact type
20
21       x, y                Coordinates of the center of the via.
22

DESCRIPTION

24       addphvia creates a new via whose center is at  the  given  coordinates,
25       and adds it to the list of vias pointed to by ptfig->PHVIA. The new via
26       is added in front of the list, and becomes itself the list head.
27       The parameters viatype, x and y fill respectivly  the  TYPE,  XVIA  and
28       YVIA fields of the phvia structure.
29       For  a  list  of  valid  viatypes,  and  details  on the structure, see
30       phvia(3).
31

RETURN VALUE

33       addphvia returns a pointer to the newly created via.
34

ERRORS

36       "∗∗∗ mbk error ∗∗∗ illegal addphvia viatype : viatype at x, y"
37              The via type is not a predefined contact. For a  list  of  legal
38              via types, see phvia(3).
39

EXAMPLE

41       #include "mph.h"
42       phvia_list ∗via_dup(pfd, pfs) /∗ duplicate vias ∗/
43       phfig_list ∗pfd, ∗pfs;
44       {
45       phvia_list ∗pv;
46          for (pv = pfs->phvia; pv != NULL; pv = pv->NEXT)
47             addphvia(pfd, pv->TYPE, ps->XVIA, ps->YVIA);
48          return pfd->PHVIA;
49       }
50