opensolaris man page for genlib_phcon

GENLIB_PHCON.3(October 1, 1997) 										   GENLIB_PHCON.3(October 1, 1997)

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;

ORIGIN

       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

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 com-
       puted 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 indexa-
       tion 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),  GEN-
       LIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3).

BUG REPORT

       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

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