GENLIB_SC_PLACE.3alc - Man Page
place an instance in the current figure at absolute coordinates
Synopsis
#include <genlib.h> void GENLIB_SC_PLACE(insname, symetry, x, y) char ∗insname; char symetry; long x,y;
Parameters
- 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 of the model in the current figure
Description
SC_PLACE add an instance in the current cell. The bottom left corner of the instance is placed, after being symetrized and/or rotated, at (x, y) coordinates. The placement takes place only if the netlist is up to day, because the model of the instance is seeked there, in order to ensure consistency. The placed instance becomes the new "reference instance", used in the relative placement functions.
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
Errors
- "GENLIB_SC_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.
- "GENLIB_SC_PLACE impossible : missing GENLIB_DEF_LOFIG"
The current netlist figure is not define, so SC_PLACE doesn't know where to pick up the model. A DEF_LOFIG or a DEF_PHSC is to be performed to avoid this error.
- "GENLIB_SC_PLACE impossible : no logical instance insname"
The instance insname does not exist in the netlist representation of the cell. It may lead us to believe that there is a consistency problem between the two representation of this cell.
- "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_PHSC("cell"); /∗ Place two instances ∗/ GENLIB_SC_PLACE("ins1", NOSYM, 0L, 0L); GENLIB_SC_PLACE("ins2", NOSYM, 80L, 100L); /∗ Save all that on disk ∗/ GENLIB_SAVE_PHSC(); }
See Also
genlib(1), GENLIB_DEF_PHSC(3), GENLIB_SAVE_PHSC(3), GENLIB_SC_TOP(3), GENLIB_SC_BOTTOM(3), GENLIB_SC_LEFT(3), GENLIB_SC_RIGHT(3), GENLIB_DEF_PHINS(3), GENLIB_FLATTEN_PHFIG(3), GENLIB_FLATTEN_ALL_PHINS(3), GENLIB_LOINS(3).
Referenced By
genlib.1alc(1), GENLIB_DEF_PHINS.3alc(3), GENLIB_DEF_PHSC.3alc(3), GENLIB_SC_BOTTOM.3alc(3), GENLIB_SC_LEFT.3alc(3), GENLIB_SC_RIGHT.3alc(3), GENLIB_SC_TOP.3alc(3).