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

NAME

       GENLIB_GET_REF_X - retrieve the x coordinate of an instance reference

SYNOPSYS

       long GENLIB_GET_REF_X(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 SH DESCRIPTION GET_REF_X looks for the reference, refname, in the instance called insname.

RETURN VALUE

       The function returns a long int beeing the x position of the reference in the current figure

ERRORS

       "GENLIB_GET_REF_X 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.
       "GENLIB_GET_REF_X 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.
       "GENLIB_GET_REF_X impossible : no abutment box"
	      The current figure does not have an abutment box. Use DEF_AB(3) before this function.
       "illegal GENLIB_GET_REF_X : orientation is XX"
	      The face parameter does not have a legal value, but XX.
       "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()
       {
	    /* Create a figure to work on  */
	    GENLIB_DEF_PHFIG("cell");
	    GENLIB_PLACE("gaci0_b", "r1", NOSYM, 23L, 54L);
	    /* Put a reference */
	    GENLIB_GET_REF_X("r1", "a_0", ALU2, 2, NORTH);
	    /* 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_REF_X(3), GENLIB_GET_REF_X(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_X.3(October 1, 1997)