GENLIB_SC_LEFT.3(October 1, 1997)										 GENLIB_SC_LEFT.3(October 1, 1997)

NAME

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

SYNOPSYS

       #include <genlib.h>
       void GENLIB_SC_LEFT(insname, symetry)
       char *insname;
       char symetry;

ORIGIN

       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

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_LEFT add an instance in the current cell. The bottom right corner of the abutment box of the instance is placed, after beeing symetrized
       and/or  rotated, toward the bottom left corner of the abutment box of the "reference instance". The newly placed instance becomes the "ref-
       erence 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_LEFT 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_LEFT impossible : missing GENLIB_DEF_LOFIG"
	      The current netlist figure is not define, so SC_LEFT 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_LEFT 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);
	    /* negative placement values are allowed */
	    GENLIB_SC_LEFT("ins2", SYM_Y);
	    /* 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_TOP.3),  GENLIB_SC_BOTTOM.3),  GENLIB_SC_RIGHT.3),  GEN-
       LIB_DEF_PHINS(3), GENLIB_FLATTEN_PHFIG(3), GENLIB_FLATTEN_ALL_PHINS(3), GENLIB_LOINS.3).

BUG REPORT

       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

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