GENLIB_GET_REF_X.3alc - Man Page
retrieve the x coordinate of an instance reference
Synopsis
long GENLIB_GET_REF_X(insname, refname) char ∗insname, ∗refname;
Parameters
- insname
Name of the instance in the which the reference is to be searched for
- refname
Name of the reference
Description
GET_REF_X looks for the reference, refname, in the instance called insname.
Return Value
The function returns a long int being the x position of the reference in the current figure
Errors
- "GENLIB_GET_REF_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 reference inside it. you must call DEF_PHFIG before any other layout action.
- "GENLIB_GET_REF_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 reference inside it. you must call DEF_PHFIG before any other layout action.
- "GENLIB_GET_REF_X impossible : no abutment box"
The current figure does not have an abutment box. Use DEF_AB(3) before this function.
- "illegal GENLIB_GET_REF_X : orientation is XX"
The face parameter does not have a legal value, but XX.
"illegal getphins : instance called insname does not exist"
No instance called insname exists in the current figure
"illegal getphref : references called refname does not exist"
No reference called refname exists in the model of the instance insname.
Example
#include <genlib.h>
main()
{
/∗ Create a figure to work on ∗/
GENLIB_DEF_PHFIG("cell");
GENLIB_PLACE("gaci0_b", "r1", NOSYM, 23L, 54L);
/∗ Put a reference ∗/
GENLIB_GET_REF_X("r1", "a_0", ALU2, 2, NORTH);
/∗ Save that on disk ∗/
GENLIB_SAVE_PHFIG();
}See Also
genlib(1), GENLIB_DEF_PHFIG(3), GENLIB_SAVE_PHFIG(3), GENLIB_PHREF(3), GENLIB_PHSEG(3), GENLIB_COPY_UP_REF(3), GENLIB_COPY_UP_ALL_REF(3), GENLIB_GET_REF_X(3), GENLIB_GET_REF_X(3), GENLIB_GET_REF_X(3).
Referenced By
genlib.1alc(1), GENLIB_GET_CON_X.3alc(3), GENLIB_GET_CON_Y.3alc(3), GENLIB_GET_INS_X.3alc(3), GENLIB_GET_INS_Y.3alc(3), GENLIB_GET_REF_Y.3alc(3).