genlib_get_con_y.3 (3)

NAME
SYNOPSYS
PARAMETERS
DESCRIPTION
RETURN VALUE
ERRORS
EXAMPLE
SEE ALSO

NAME

GENLIB_GET_CON_Y - retrieve the x coordinate of an instance connector

SYNOPSYS

long GENLIB_GET_CON_Y(insname, conname, index)
char *insname, *conname;
long index;

PARAMETERS

insname: Name of the instance in the which the connector is to be searched for
conname: Name of the connector
index: Connector index

DESCRIPTION

GET_CON_Y looks for the connector, conname, 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 connector in the current figure

ERRORS

"GENLIB_GET_CON_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.

"illegal getphcon : connectors conname, index index does not exist"

: No connector called conname 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 connector */
        y = GENLIB_GET_CON_Y("r1", "a", 1);
        .
        .
        GENLIB_PHVIA(x, y, CONT_VIA);
        /* Save that on disk */
        GENLIB_SAVE_PHFIG();
}