NAME

       GENLIB_GET_INS_Y - retrieve the y coordinate of an instance

SYNOPSYS

       long GENLIB_GET_INS_Y(insname)
       char ∗insname;

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).  GENLIB_GET_REF_X(3), GENLIB_GET_REF_Y(3).