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