Provided by: alliance_5.0-20120515-6_amd64 bug

NAME

       GENLIB_GET_REF_Y - retrieve the y coordinate of an instance reference

SYNOPSYS

       long GENLIB_GET_REF_Y(insname, refname)
       char ∗insname, ∗refname;

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).