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

NAME

6       GENLIB_SC_PLACE  -  place an instance in the current figure at absolute
7       coordinates
8

SYNOPSIS

10       #include <genlib.h>
11       void GENLIB_SC_PLACE(insname, symetry, x, y)
12       char ∗insname;
13       char symetry;
14       long x,y;
15

PARAMETERS

17       insname             Name to be given to the instance on the model
18
19       symetry             Geometrical  operation  to  be  performed  on   the
20                           instance before being placed
21
22       x, y                Coordinates  of  the lower left corner of the abut‐
23                           ment box of the model in the current figure
24

DESCRIPTION

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

ERRORS

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

EXAMPLE

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

SEE ALSO

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