debian man page for genlib_get_ins_y

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

NAME
       GENLIB_GET_INS_Y - retrieve the y coordinate of an instance

SYNOPSYS
       long GENLIB_GET_INS_Y(insname)
       char *insname;

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

PARAMETER
       insname		   Name of the instance which y coordinate is to be given back

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

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

ERRORS
       "GENLIB_GET_INS_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.

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);
	    GENLIB_PLACE_TOP("gaci0_b", "r2", SYM_Y);
	    GENLIB_PLACE_RIGHT("gaci0_b", "r3", SYM_Y);
	    /* Get a connector */
	    x = GENLIB_GET_INS_X("r3");
	    y = GENLIB_GET_INS_Y("r3");
	    .
	    .
	    /* Save that on disk */
	    GENLIB_SAVE_PHFIG();
       }

SEE ALSO
       genlib(1),  GENLIB_DEF_PHFIG(3),  GENLIB_SAVE_PHFIG(3),	PHINS(3),  GENLIB_GET_INS_X(3),  GENLIB_GET_CON_X(3),  GENLIB_GET_CON_Y(3).   GEN-
       LIB_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_INS_Y.3(October 1, 1997)