GENLIB_GET_CON_Y.3alc man page

GENLIB_GET_CON_Y

GENLIB_GET_CON_Y — retrieve the x coordinate of an instance connector

Synopsis

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

See Also

genlib(1), GENLIB_DEF_PHFIG(3), GENLIB_SAVE_PHFIG(3), GENLIB_PHCON(3), GENLIB_PHSEG(3), GENLIB_COPY_UP_CON(3), GENLIB_COPY_UP_ALL_CON(3), GENLIB_GET_CON_X(3), GENLIB_GET_REF_X(3), GENLIB_GET_REF_Y(3).

Referenced By

genlib.1alc(1), GENLIB_GET_CON_X.3alc(3), GENLIB_GET_INS_X.3alc(3), GENLIB_GET_INS_Y.3alc(3), GENLIB_GET_REF_Y.3alc(3).

ASIM/LIP6 PROCEDURAL GENERATION LANGUAGE