NAME

       GENLIB_PHCON - place a physical connector in the current figure at absolute coordinates

SYNOPSYS

       #include <genlib.h>
       void GENLIB_PHCON(layer, width, name, orient, x, y)
       char layer;
       long width;
       char ∗name, orient;
       long x, y;

PARAMETERS

       layer               Layout layer of the connector

       width               Width of the connector

       name                Name to be given to the connector

       orient              Face of the cell on witch the connector belongs

       x, y                Absolute coordinates of the connector

DESCRIPTION

       PHCON  adds a connector in the current layout cell, at the specified coordinates, with the
       given attributs.  The layer argument can take the following legal values:

              NWELL

              PWELL

              NTIE

              PTIE

              NDIF

              PDIF

              NTRANS

              PTRANS

              POLY

              ALU1

              ALU2

              ALU3

              TPOLY

              TALU1

              TALU2

              TALU3

       The name argument is not enough of an information to non ambigiously identify a connector.
       In  order to be able to do so, an index is computed for each connector that has an already
       existing name, following a topological order.  Each time a connector is created, the index
       is  updated, regarding the name of the connector.  Since someone writting a tiler needs to
       know exactly what connector to access, the indexation algorithm must be known by the user.

       Connectors with a unique name:
                           Such connectors have the index 0

       Connectors with a name apearing many times:
                           The indexes are computed from left to right, and then from  bottom  to
                           top,  starting at 0.  If two connectors are on the same location, with
                           the same name, then the layer decides which one  is  has  the  greater
                           number, from lower level, NWELL to upper level, ALU3.

       The orient paramater may take the following values:

       NORTH               for a connector placed on the top of the cell.

       SOUTH               for a connector placed on the bottom of the cell.

       EAST                for a connector placed on the right side of the cell.

       WEST                for a connector placed on the left side of the cell.

       Remark:             Connectors  placed  on  corners  of  leaf  cells  are  given  the EAST
                           orientation if on  top/right  or  bottom/right  corner,  and  WEST  if
                           top/left or bottom/left.

ERRORS

       "GENLIB_PHCON 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.
       "illegal addphcon : orientation is XX in name"
              The orient parameter does not have a legal value, but XX.

EXAMPLE

       #include <genlib.h>
       main()
       {
            /∗ Create a figure to work on  ∗/
            GENLIB_DEF_PHFIG("cell");
            .
            .
            .
            GENLIB_DEF_AB(0L, 0L, 0L, 0L);
            /∗ Put a connector ∗/
            GENLIB_PHCON(ALU1, 1, "cin", SOUTH, 12L, 0L);
            /∗ 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_COPY_UP_CON_FACE(3),          GENLIB_THRU_CON_H(3),
       GENLIB_THRU_CON_V(3).