1GENLIB_COPY_UP_CON_FACE.3(October 1,G1E9N9L7I)B_COPY_UP_CON_FACE.3(October 1, 1997)
2
3
4

NAME

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

SYNOPSIS

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

PARAMETERS

18       face                Connector face 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_FACE  copies  a  instance connector into the current layout
29       figure, and gives to the new connector the name newname.  The face  and
30       conname  arguments  are not suffiscient for non ambiguiously identify a
31       single connector.  So, if more than one connector matches  these  argu‐
32       ments, the behaviour described below is applied on all of them.
33       Two  behaviour  are expected, depending on the instance connector loca‐
34       tion regarding the abutment box of the current figure.
35
36       Connector on the abutment box
37                           The  figure  connector  is  place  right  over  the
38                           instance  connector. The single connector is dupli‐
39                           cated.
40
41       Connector inside the abutment box
42                           The instance connector face is computed in the fig‐
43                           ure,  and  then, the connector is duplicated on the
44                           given face, at the right coordinates for this face.
45                           Then a wire is drawn between the instance connector
46                           and the figure connector in the connector layer.
47

ERRORS

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

EXAMPLE

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

SEE ALSO

76       genlib(1),      GENLIB_DEF_PHFIG(3),     GENLIB_SAVE_PHFIG(3),     GEN‐
77       LIB_COPY_UP_ALL_CON(3),  GENLIB_COPY_UP_CON(3),  GENLIB_PHCON(3),  GEN‐
78       LIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3).
79
80
81
82
83
84
85PROCEDURAL GENERATION LANGUAGE     ASGIEMN/LLIIBP_6COPY_UP_CON_FACE.3(October 1, 1997)
Impressum