1GENLIB_COPY_UP_ALL_CON.3(October 1, 19G9E7N)LIB_COPY_UP_ALL_CON.3(October 1, 1997)
2
3
4

NAME

6       GENLIB_COPY_UP_ALL_CON  -  copy  all physical connectors of an instance
7       face in the current figure
8

SYNOPSIS

10       #include <genlib.h>
11       void GENLIB_COPY_UP_ALL_CON(face, insname, concatenate)
12       char face, concatenate;
13       char ∗insname;
14

PARAMETERS

16       face                Face of the instance
17
18       insname             Name of the instance the connector belongs to
19
20       concatenate         Indicates whether or not  to  concatenate  instance
21                           connectors names with instance name
22

DESCRIPTION

24       COPY_UP_ALL_CON  copies all instance connectors of the face face of the
25       placed instance called insname into the current layout.   The  concate‐
26       nate argument may take two values:
27
28       YES                 then  the resulting name of a connector in the cur‐
29                           rent figure is the concatenation of the insname and
30                           the  conname.  It warranties the unicity of name at
31                           the figure level, and is to be  used  most  of  the
32                           time.
33
34       NO                  implies  a  direct copy of the connector name.  The
35                           user must take care of  the  unicity  of  connector
36                           name by itself.
37                           Two  behaviour  are  expected, depending on each of
38                           the  instance  connectors  location  regarding  the
39                           abutment box of the current figure.
40
41       Connector on the abutment box
42                           The  figure  connector  is  place  right  over  the
43                           instance connector. The single connector is  dupli‐
44                           cated.
45
46       Connector inside the abutment box
47                           The instance connector face is computed in the fig‐
48                           ure, and then, the connector is duplicated  on  the
49                           given face, at the right coordinates for this face.
50                           Then a wire is drawn between the instance connector
51                           and the figure connector in the connector layer.
52

ERRORS

54       "GENLIB_COPY_UP_ALL_CON impossible : missing GENLIB_DEF_PHFIG"
55              No  figure  has been yet specified by a call to DEF_PHFIG. So it
56              isn't possible to place a connector inside it.   you  must  call
57              DEF_PHFIG before any other layout action.
58       "***  genlib  error  ***  GENLIB_COPY_UP_ALL_CON impossible : connector
59       conname face face of instance insname, current figure doesn't exist"
60              No connector matches both the conname and the face arguments.
61

EXAMPLE

63       #include <genlib.h>
64       main()
65       {
66            /∗ Create a figure to work on  ∗/
67            GENLIB_DEF_PHFIG("cell");
68            .
69            .
70            GENLIB_PLACE_LEFT("gaer0_f", "insN", SYMXY);
71            .
72            .
73            GENLIB_DEF_AB(0L, 0L, 0L, 0L);
74            /∗ Copy all connectors ∗/
75            GENLIB_COPY_UP_ALL_CON(NORTH, "insN", YES);
76            /∗ Save that on disk ∗/
77            GENLIB_SAVE_PHFIG();
78       }
79

SEE ALSO

81       genlib(1),     GENLIB_DEF_PHFIG(3),     GENLIB_SAVE_PHFIG(3),      GEN‐
82       LIB_COPY_UP_CON(3),  GENLIB_COPY_UP_CON_FACE(3),  GENLIB_PHCON(3), GEN‐
83       LIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3).
84
85
86
87
88
89
90PROCEDURAL GENERATION LANGUAGE     ASIGME/NLLIIPB6_COPY_UP_ALL_CON.3(October 1, 1997)
Impressum