NAME

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

SYNOPSYS

       #include <genlib.h>
       void GENLIB_SC_TOP(insname, symetry)
       char ∗insname;
       char symetry;

PARAMETERS

       insname             Name to be given to the instance on the model

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

DESCRIPTION

       SC_TOP  add an instance in the current cell. The bottom left corner of the abutment box of
       the instance is placed, after beeing symetrized and/or rotated, toward the top left corner
       of  the  abutment  box  of the "reference instance". The newly placed instance becomes the
       "reference instance".  The placement takes place only if the netlist is up to day, because
       the model of the instance is seeked there, in order to ensure consistency.

       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

ERRORS

       "GENLIB_SC_TOP 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.
       "GENLIB_SC_TOP impossible : missing GENLIB_DEF_LOFIG"
              The  current  netlist figure is not define, so SC_TOP doesn't know where to pick up
              the model. A DEF_LOFIG or a DEF_PHSC is to be performed to avoid this error.
       "GENLIB_SC_TOP impossible : no logical instance insname"
              The instance insname does not exist in the netlist representation of the  cell.  It
              may  lead  us  to  believe  that  there  is  a  consistency problem between the two
              representation of this cell.
       "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_PHSC("cell");
            /∗ Place two instances ∗/
            GENLIB_SC_PLACE("ins1", NOSYM, 0L, 0L);
            GENLIB_SC_TOP("ins2", SYM_X);
            /∗ Save all that on disk ∗/
            GENLIB_SAVE_PHSC();
       }

SEE ALSO

       genlib(1),       GENLIB_DEF_PHSC(3),       GENLIB_SAVE_PHSC(3),        GENLIB_SC_PLACE(3),
       GENLIB_SC_RIGHT(3),     GENLIB_SC_BOTTOM(3),    GENLIB_SC_LEFT(3),    GENLIB_DEF_PHINS(3),
       GENLIB_FLATTEN_PHFIG(3), GENLIB_FLATTEN_ALL_PHINS(3), GENLIB_LOINS(3).