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

NAME

6       GENLIB_PLACE_LEFT  - place a physical instance in the current figure at
7       the left of the "reference instance"
8

SYNOPSIS

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

PARAMETERS

16       modelname           Name of the layout figure to be instantiated
17
18       insname             Name to be given to the instance on the model
19
20       symetry             Geometrical  operation  to  be  performed  on   the
21                           instance before being placed
22

DESCRIPTION

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

ERRORS

57       "GENLIB_PLACE_LEFT impossible : missing GENLIB_DEF_PHFIG"
58              No  figure  has been yet specified by a call to DEF_PHFIG. So it
59              isn't possible to place an instance inside it.   you  must  call
60              DEF_PHFIG before any other layout action.
61       "GENLIB_PLACE_LEFT impossible : No previous instance"
62              There  are  no  instances  placed in the current layout cell, so
63              it's impossible to know where to place from. Use  a  PLACE  call
64              before.
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("grbdo_3","ins1", NOSYM, 0L, 0L);
77            /∗ negative placement values are allowed ∗/
78            GENLIB_PLACE_LEFT("grxwh_k","ins2", SYMXY);
79            /∗ Save all that on disk ∗/
80            GENLIB_SAVE_PHFIG();
81       }
82

SEE ALSO

84       genlib(1), GENLIB_DEF_PHFIG(3), GENLIB_SAVE_PHFIG(3),  GENLIB_PLACE(3),
85       GENLIB_PLACE_TOP(3),   GENLIB_PLACE_BOTTOM(3),   GENLIB_PLACE_RIGHT(3),
86       MBK_CATA_LIB(1), MBK_WORK_LIB(1), MBK_IN_PH(1).
87
88
89
90
91
92
93PROCEDURAL GENERATION LANGUAGE     ASIM/LIPG6ENLIB_PLACE_LEFT.3(October 1, 1997)
Impressum