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