xfree86 man page for genlib_get_con_y

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

NAME
       GENLIB_GET_CON_Y - retrieve the x coordinate of an instance connector

SYNOPSYS
       long GENLIB_GET_CON_Y(insname, conname, index)
       char *insname, *conname;
       long index;

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
       insname		   Name of the instance in the which the connector is to be searched for

       conname		   Name of the connector

       index		   Connector index

DESCRIPTION
       GET_CON_Y looks for the connector, conname, in the instance called insname.  Then it computes its absolute coordinates in the  figure,  and
       gives back the y coordinate.

RETURN VALUE
       The function returns a long int beeing the y position of the connector in the current figure

ERRORS
       "GENLIB_GET_CON_Y 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 getphins : instance called insname does not exist"
	      No instance called insname exists in the current figure.
       "illegal getphcon : connectors conname, index index does not exist"
	      No connector called conname exists in the model of the instance insname.

EXAMPLE
       #include <genlib.h>
       main()
       {
       long x, y;
	    /* Create a figure to work on  */
	    GENLIB_DEF_PHFIG("cell");
	    GENLIB_PLACE("gaci0_b", "r1", NOSYM, 23L, 54L);
	    /* Get a connector */
	    y = GENLIB_GET_CON_Y("r1", "a", 1);
	    .
	    .
	    GENLIB_PHVIA(x, y, CONT_VIA);
	    /* Save that on disk */
	    GENLIB_SAVE_PHFIG();
       }

SEE ALSO
       genlib(1), GENLIB_DEF_PHFIG(3), GENLIB_SAVE_PHFIG(3), GENLIB_PHCON(3), GENLIB_PHSEG(3),	GENLIB_COPY_UP_CON(3),	GENLIB_COPY_UP_ALL_CON(3),
       GENLIB_GET_CON_X(3), GENLIB_GET_REF_X(3), GENLIB_GET_REF_Y(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_GET_CON_Y.3(October 1, 1997)