man GENLIB_GET_INS_Y (1): retrieve the y coordinate of an instance

SYNOPSYS

long GENLIB_GET_INS_Y(insname)
char *insname;

man2html: unable to open or read file man1/alc_origin.1

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();
}