GENLIB_PLACE.3alc - Man Page
place a physical instance in the current figure at absolute coordinates
Synopsis
#include <genlib.h> void GENLIB_PLACE(modelname, insname, symetry, x, y) char ∗modelname, ∗insname; char symetry; long x,y;
Parameters
- modelname
Name of the layout figure to be instantiated
- insname
Name to be given to the instance on the model
- symetry
Geometrical operation to be performed on the instance before being placed
- x, y
Coordinates of the lower left corner of the abutment box on the instance in the current figure
Description
PLACE add an instance in the current layout cell. The bottom left corner of the instance of the model modelname is placed, after being symetrized and/or rotated, at (x, y) coordinates. The placed instance becomes the new "reference instance", used in the relative placement functions.
The insname is the name given to the instance and must be unique at a given hierarchy level.
The symetry argument can take eight legal values :
- NOSYM
no geometrical operation is performed
- SYM_Y
Y becomes -Y, that means toward X axe symetry
- SYM_X
X becomes -X, that means toward Y axe symetry
- SYMXY
X becomes -X, Y becomes -Y
- ROT_P
a positive 90 degrees rotation take place
- ROT_M
a negative 90 degrees rotation take place
- SY_RP
Y becomes -Y, and then a positive 90 degrees rotation take place
- SY_RM
Y becomes -Y, and then a negative 90 degrees rotation take place
The model of the figure to be placed must be available, on disk or in memory. The path to the library is specified in the MBK_CATA_LIB (1) and MBK_WORK_LIB (1) environment variables, and its format is given by the MBK_IN_PH (1) environment variable.
Errors
"GENLIB_PLACE impossible : missing GENLIB_DEF_PHFIG"
No figure has been yet specified by a call to DEF_PHFIG. So it isn't possible to place an instance inside it. you must call DEF_PHFIG before any other layout action.
"illegal addphins : transformation is x in insname"
The symetry parameter is not one of the define given, but has the integer value x.
Example
#include <genlib.h>
main()
{
/∗ Create a figure to work on ∗/
GENLIB_DEF_PHFIG("cell");
/∗ Place two instances ∗/
GENLIB_PLACE("gapg0_b","ins1", NOSYM, 0L, 0L);
GENLIB_PLACE("gapg8_b","ins2", SYM_X, 80L, 100L);
/∗ Save all that on disk ∗/
GENLIB_SAVE_PHFIG();
}See Also
genlib(1), GENLIB_DEF_PHFIG(3), GENLIB_SAVE_PHFIG(3), GENLIB_PLACE_TOP(3), GENLIB_PLACE_BOTTOM(3), GENLIB_PLACE_LEFT(3), GENLIB_PLACE_RIGHT(3), MBK_CATA_LIB(1), MBK_WORK_LIB(1), MBK_IN_PH(1).
Referenced By
genlib.1alc(1), GENLIB_DEF_PHINS.3alc(3), GENLIB_FLATTEN_ALL_PHINS.3alc(3), GENLIB_PLACE_BOTTOM.3alc(3), GENLIB_PLACE_LEFT.3alc(3), GENLIB_PLACE_RIGHT.3alc(3), GENLIB_PLACE_TOP.3alc(3).