GENLIB_GET_INS_X

Langue: en

Version: ASIM/LIP6 (fedora - 05/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

GENLIB_GET_INS_X - retrieve the x coordinate of an instance

SYNOPSYS

 long GENLIB_GET_INS_X(insname)
 char *insname;
 
man2html: unable to open or read file man1/alc_origin.1

PARAMETER

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

DESCRIPTION

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.

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

SEE ALSO

genlib(1), GENLIB_DEF_PHFIG(3), GENLIB_SAVE_PHFIG(3), PHINS(3), GENLIB_GET_INS_Y(3), GENLIB_GET_CON_X(3), GENLIB_GET_CON_Y(3). GENLIB_GET_REF_X(3), GENLIB_GET_REF_Y(3).
man2html: unable to open or read file man1/alc_bug_report.1