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).

PROCEDURAL GENERATION LANGUAGE                      ASIM/LIP6         GENLIB_COPY_UP_CON_FACE.3(October 1, 1997)