xfree86 man page for genlib_get_ref_y

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

NAME
       GENLIB_GET_REF_Y - retrieve the y coordinate of an instance reference

SYNOPSYS
       long GENLIB_GET_REF_Y(insname, refname)
       char *insname, *refname;

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 reference is to be searched for

       refname		   Name of the reference

DESCRIPTION
       GET_REF_Y looks for the reference, refname, 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 reference in the current figure

ERRORS
       "GENLIB_GET_REF_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 reference 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 getphref : references called refname does not exist"
	      No reference called refname 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 reference */
	    y = GENLIB_GET_REF_Y("r1", "a_0");
	    .
	    .
	    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_PHREF(3), GENLIB_PHSEG(3),	GENLIB_COPY_UP_REF(3),	GENLIB_COPY_UP_ALL_REF(3),
       GENLIB_GET_CON_X(3), GENLIB_GET_CON_Y(3), GENLIB_GET_REF_X(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_REF_Y.3(October 1, 1997)