NAME

       GENLIB_PLACE - place a physical instance in the current figure at absolute coordinates

SYNOPSYS

       #include <genlib.h>
       void GENLIB_PLACE(modelname, insname, symetry, x, y)
       char ∗modelname, ∗insname;
       char symetry;
       long x,y;

PARAMETERS

       modelname           Name of the layout figure to be instanciated

       insname             Name to be given to the instance on the model

       symetry             Geometrical operation to be performed on the instance before beeing placed

       x, y                Coordinates  of  the  lower  left  corner  of the abutment box on the instance in the
                           current figure

DESCRIPTION

       PLACE add an instance in the current layout cell. The bottom left corner of the  instance  of  the  model
       modelname  is placed, after beeing symetrized and/or rotated, at (x, y) coordinates.  The placed instance
       becomes the new "reference instance", used in the relative placement functions.
       The insname is the name given to the instance and must be unique at a given hierarchy level.
       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

       The model of the figure to be placed must be available, on disk or in memory.  The path to the library is
       specified in the MBK_CATA_LIB (1) and MBK_WORK_LIB (1) environment variables, and its format is given  by
       the MBK_IN_PH (1) environment variable.

ERRORS

       "GENLIB_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.
       "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_PHFIG("cell");
            /∗ Place two instances ∗/
            GENLIB_PLACE("gapg0_b","ins1", NOSYM, 0L, 0L);
            GENLIB_PLACE("gapg8_b","ins2", SYM_X, 80L, 100L);
            /∗ Save all that on disk ∗/
            GENLIB_SAVE_PHFIG();
       }

SEE ALSO

       genlib(1),   GENLIB_DEF_PHFIG(3),   GENLIB_SAVE_PHFIG(3),   GENLIB_PLACE_TOP(3),  GENLIB_PLACE_BOTTOM(3),
       GENLIB_PLACE_LEFT(3), GENLIB_PLACE_RIGHT(3), MBK_CATA_LIB(1), MBK_WORK_LIB(1), MBK_IN_PH(1).

PROCEDURAL GENERATION LANGUAGE                      ASIM/LIP6                    GENLIB_PLACE.3(October 1, 1997)