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

NAME

6       GENLIB_PLACE - place a physical instance in the current figure at abso‐
7       lute coordinates
8

SYNOPSIS

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

PARAMETERS

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

DESCRIPTION

28       PLACE add an instance in the current layout cell. The bottom left  cor‐
29       ner  of  the  instance  of  the  model modelname is placed, after being
30       symetrized and/or rotated, at (x, y) coordinates.  The placed  instance
31       becomes  the  new  "reference instance", used in the relative placement
32       functions.
33       The insname is the name given to the instance and must be unique  at  a
34       given hierarchy level.
35       The symetry argument can take eight legal values :
36
37       NOSYM               no geometrical operation is performed
38
39       SYM_Y               Y becomes -Y, that means toward X axe symetry
40
41       SYM_X               X becomes -X, that means toward Y axe symetry
42
43       SYMXY               X becomes -X, Y becomes -Y
44
45       ROT_P               a positive 90 degrees rotation take place
46
47       ROT_M               a negative 90 degrees rotation take place
48
49       SY_RP               Y  becomes -Y, and then a positive 90 degrees rota‐
50                           tion take place
51
52       SY_RM               Y becomes -Y, and then a negative 90 degrees  rota‐
53                           tion take place
54
55       The  model  of the figure to be placed must be available, on disk or in
56       memory.  The path to the library is specified in the  MBK_CATA_LIB  (1)
57       and  MBK_WORK_LIB (1) environment variables, and its format is given by
58       the MBK_IN_PH (1) environment variable.
59

ERRORS

61       "GENLIB_PLACE impossible : missing GENLIB_DEF_PHFIG"
62              No figure has been yet specified by a call to DEF_PHFIG.  So  it
63              isn't  possible  to  place an instance inside it.  you must call
64              DEF_PHFIG before any other layout action.
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_PHFIG("cell");
75            /∗ Place two instances ∗/
76            GENLIB_PLACE("gapg0_b","ins1", NOSYM, 0L, 0L);
77            GENLIB_PLACE("gapg8_b","ins2", SYM_X, 80L, 100L);
78            /∗ Save all that on disk ∗/
79            GENLIB_SAVE_PHFIG();
80       }
81

SEE ALSO

83       genlib(1),      GENLIB_DEF_PHFIG(3),     GENLIB_SAVE_PHFIG(3),     GEN‐
84       LIB_PLACE_TOP(3),  GENLIB_PLACE_BOTTOM(3),  GENLIB_PLACE_LEFT(3),  GEN‐
85       LIB_PLACE_RIGHT(3), MBK_CATA_LIB(1), MBK_WORK_LIB(1), MBK_IN_PH(1).
86
87
88
89
90
91
92PROCEDURAL GENERATION LANGUAGE     ASIM/LIP6   GENLIB_PLACE.3(October 1, 1997)
Impressum