NAME

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

SYNOPSYS

       #include <genlib.h>
       void GENLIB_COPY_UP_CON_FACE(face, conname, insname, newname)
       long index;
       char ∗insname;
       char ∗conname;
       char ∗newname;

PARAMETERS

       face                Connector face in the instance

       conname             Name of the connector in the instance model

       insname             Name of the instance the connector belongs to

       newname             Name to be given to the connector in the current figure

DESCRIPTION

       COPY_UP_CON_FACE  copies a instance connector into the current layout figure, and gives to
       the new connector the name newname.  The face and conname arguments  are  not  suffiscient
       for  non ambiguiously identify a single connector.  So, if more than one connector matches
       these arguments, the behaviour described below is applied on all of them.
       Two behaviour are expected, depending on the instance  connector  location  regarding  the
       abutment box of the current figure.

       Connector on the abutment box
                           The  figure  connector is place right over the instance connector. The
                           single connector is duplicated.

       Connector inside the abutment box
                           The instance connector face is computed in the figure, and  then,  the
                           connector  is  duplicated  on the given face, at the right coordinates
                           for this face.  Then a wire is drawn between  the  instance  connector
                           and the figure connector in the connector layer.

ERRORS

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

EXAMPLE

       #include <genlib.h>
       main()
       {
            /∗ Create a figure to work on  ∗/
            GENLIB_DEF_PHFIG("cell");
            .
            .
            GENLIB_PLACE_LEFT("gaer0_f", "insN", SYMXY);
            .
            .
            GENLIB_DEF_AB(0L, 0L, 0L, 0L);
            /∗ Put a connector ∗/
            GENLIB_COPY_UP_CON_FACE("i0", 1, "insN", "inz0");
            /∗ Save that on disk ∗/
            GENLIB_SAVE_PHFIG();
       }

SEE ALSO

       genlib(1),    GENLIB_DEF_PHFIG(3),    GENLIB_SAVE_PHFIG(3),     GENLIB_COPY_UP_ALL_CON(3),
       GENLIB_COPY_UP_CON(3), GENLIB_PHCON(3), GENLIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3).