1GENLIB_SC_TOP.3(October 1, 1997)              GENLIB_SC_TOP.3(October 1, 1997)
2
3
4

NAME

6       GENLIB_SC_TOP - place an instance in the current figure at the right of
7       the "reference instance"
8

SYNOPSIS

10       #include <genlib.h>
11       void GENLIB_SC_TOP(insname, symetry)
12       char ∗insname;
13       char symetry;
14

PARAMETERS

16       insname             Name to be given to the instance on the model
17
18       symetry             Geometrical  operation  to  be  performed  on   the
19                           instance before being placed
20

DESCRIPTION

22       SC_TOP  add  an instance in the current cell. The bottom left corner of
23       the abutment box of the instance  is  placed,  after  being  symetrized
24       and/or  rotated,  toward the top left corner of the abutment box of the
25       "reference instance". The newly placed instance becomes the  "reference
26       instance".  The placement takes place only if the netlist is up to day,
27       because the model of the instance is seeked there, in order  to  ensure
28       consistency.
29
30       The symetry argument can take eight legal values :
31
32       NOSYM               no geometrical operation is performed
33
34       SYM_Y               Y becomes -Y, that means toward X axe symetry
35
36       SYM_X               X becomes -X, that means toward Y axe symetry
37
38       SYMXY               X becomes -X, Y becomes -Y
39
40       ROT_P               a positive 90 degrees rotation take place
41
42       ROT_M               a negative 90 degrees rotation take place
43
44       SY_RP               Y  becomes -Y, and then a positive 90 degrees rota‐
45                           tion take place
46
47       SY_RM               Y becomes -Y, and then a negative 90 degrees  rota‐
48                           tion take place
49

ERRORS

51       "GENLIB_SC_TOP impossible : missing GENLIB_DEF_PHFIG"
52              No  figure  has been yet specified by a call to DEF_PHFIG. So it
53              isn't possible to place an instance inside it.   you  must  call
54              DEF_PHFIG before any other layout action.
55       "GENLIB_SC_TOP impossible : missing GENLIB_DEF_LOFIG"
56              The current netlist figure is not define, so SC_TOP doesn't know
57              where to pick up the model. A DEF_LOFIG or a DEF_PHSC is  to  be
58              performed to avoid this error.
59       "GENLIB_SC_TOP impossible : no logical instance insname"
60              The  instance  insname does not exist in the netlist representa‐
61              tion of the cell. It may lead us to believe that there is a con‐
62              sistency problem between the two representation of this cell.
63       "illegal addphins : transformation is x in insname"
64              The  symetry  parameter  is not one of the define given, but has
65              the integer value x.
66

EXAMPLE

68       #include <genlib.h>
69       main()
70       {
71            /∗ Create a figure to work on  ∗/
72            GENLIB_DEF_PHSC("cell");
73            /∗ Place two instances ∗/
74            GENLIB_SC_PLACE("ins1", NOSYM, 0L, 0L);
75            GENLIB_SC_TOP("ins2", SYM_X);
76            /∗ Save all that on disk ∗/
77            GENLIB_SAVE_PHSC();
78       }
79

SEE ALSO

81       genlib(1), GENLIB_DEF_PHSC(3), GENLIB_SAVE_PHSC(3), GENLIB_SC_PLACE(3),
82       GENLIB_SC_RIGHT(3),    GENLIB_SC_BOTTOM(3),   GENLIB_SC_LEFT(3),   GEN‐
83       LIB_DEF_PHINS(3), GENLIB_FLATTEN_PHFIG(3), GENLIB_FLATTEN_ALL_PHINS(3),
84       GENLIB_LOINS(3).
85
86
87
88
89
90
91PROCEDURAL GENERATION LANGUAGE     ASIM/LIP6  GENLIB_SC_TOP.3(October 1, 1997)