NAME

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

SYNOPSYS

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

PARAMETERS

       index               Connector index 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  copies  a  instance connector into the current layout figure, and gives to the new connector
       the name newname. The instance connector is identified by its name, conname, and index, index.
       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.

       If newname is NULL, then not connector is copied up, on the segment is drawn to the side of the  abutment
       box.

ERRORS

       "GENLIB_COPY_UP_CON 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 impossible : connector conname index index of instance insname,
       current figure doesn't exist"
              The given connector does not exist in the current figure.

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("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_FACE(3), GENLIB_PHCON(3), GENLIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3).

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