1GENLIB_COPY_UP_CON.3(October 1, 1997)    GENLIB_COPY_UP_CON.3(October 1, 1997)
2
3
4

NAME

6       GENLIB_COPY_UP_CON  - copy a physical connector from an instance in the
7       current figure
8

SYNOPSIS

10       #include <genlib.h>
11       void GENLIB_COPY_UP_CON(index, conname, insname, newname)
12       long index;
13       char ∗insname;
14       char ∗conname;
15       char ∗newname;
16

PARAMETERS

18       index               Connector index in the instance
19
20       conname             Name of the connector in the instance model
21
22       insname             Name of the instance the connector belongs to
23
24       newname             Name to be given to the connector  in  the  current
25                           figure
26

DESCRIPTION

28       COPY_UP_CON copies a instance connector into the current layout figure,
29       and gives to the new connector the name newname. The instance connector
30       is identified by its name, conname, and index, index.
31       Two  behaviour  are expected, depending on the instance connector loca‐
32       tion regarding the abutment box of the current figure.
33
34       Connector on the abutment box
35                           The  figure  connector  is  place  right  over  the
36                           instance  connector. The single connector is dupli‐
37                           cated.
38
39       Connector inside the abutment box
40                           The instance connector face is computed in the fig‐
41                           ure,  and  then, the connector is duplicated on the
42                           given face, at the right coordinates for this face.
43                           Then a wire is drawn between the instance connector
44                           and the figure connector in the connector layer.
45
46       If newname is NULL, then not connector is copied up, on the segment  is
47       drawn to the side of the abutment box.
48

ERRORS

50       "GENLIB_COPY_UP_CON impossible : missing GENLIB_DEF_PHFIG"
51              No  figure  has been yet specified by a call to DEF_PHFIG. So it
52              isn't possible to place a connector inside it.   you  must  call
53              DEF_PHFIG before any other layout action.
54       "*** genlib error *** GENLIB_COPY_UP_CON impossible : connector conname
55       index index of instance insname, current figure doesn't exist"
56              The given connector does not exist in the current figure.
57

EXAMPLE

59       #include <genlib.h>
60       main()
61       {
62            /∗ Create a figure to work on  ∗/
63            GENLIB_DEF_PHFIG("cell");
64            .
65            .
66            GENLIB_PLACE_LEFT("gaer0_f", "insN", SYMXY);
67            .
68            .
69            GENLIB_DEF_AB(0L, 0L, 0L, 0L);
70            /∗ Put a connector ∗/
71            GENLIB_COPY_UP_CON("i0", 1, "insN", "inz0");
72            /∗ Save that on disk ∗/
73            GENLIB_SAVE_PHFIG();
74       }
75

SEE ALSO

77       genlib(1),     GENLIB_DEF_PHFIG(3),     GENLIB_SAVE_PHFIG(3),      GEN‐
78       LIB_COPY_UP_ALL_CON(3),   GENLIB_COPY_UP_CON_FACE(3),  GENLIB_PHCON(3),
79       GENLIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3).
80
81
82
83
84
85
86PROCEDURAL GENERATION LANGUAGE     ASIM/LIGPE6NLIB_COPY_UP_CON.3(October 1, 1997)
Impressum