GENLIB_GET_INS_X(3)

GENLIB_GET_INS_X3

Retrieve the x coordinate of an instance

Synopsys

long GENLIB_GET_INS_X(insname)
char ∗insname;

Parameter

insname

Name of the instance which x coordinate is to be given back

Overview

GET_INS_X looks for the instance called insname in the current figure. Then it computes its absolute coordinates in the figure, and gives back its x coordinate.

Return value

The function returns a long int beeing the x position of the instance in the current figure

Errors

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

Examples

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

Releases

4 releases since Debian 7 (Wheezy); the text changed 1 time.

  1. 7–8
  2. 9–10

From alliance 5.1.1-3 in Debian 10 (Buster). Parsed by carta from the page's man source.