genlib_place_top(3) [xfree86 man page]

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

NAME

       GENLIB_PLACE_TOP - place a physical instance in the current figure on the top of the "reference instance"

SYNOPSYS

       #include <genlib.h>
       void GENLIB_PLACE_TOP(modelname, insname, symetry)
       char *modelname, *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

       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

DESCRIPTION

       PLACE_TOP add an instance of model modelname in the current layout 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 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		   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_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_PLACE_TOP impossible : No previous instance"
	      There are no instances placed in the current layout cell, so it's impossible to know where to place from. Use a PLACE call before.
       "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("dgl", "ins1", ROT_P, 0L, 0L);
	    GENLIB_PLACE_TOP("idv", "ins2", SY_RP);
	    /* Save all that on disk */
	    GENLIB_SAVE_PHFIG();
       }

SEE ALSO

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

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_PLACE_TOP.3(October 1, 1997)

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

NAME

       GENLIB_PLACE_TOP - place a physical instance in the current figure on the top of the "reference instance"

SYNOPSYS

       #include <genlib.h>
       void GENLIB_PLACE_TOP(modelname, insname, symetry)
       char *modelname, *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

       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

DESCRIPTION

       PLACE_TOP add an instance of model modelname in the current layout 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 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		   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_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_PLACE_TOP impossible : No previous instance"
	      There are no instances placed in the current layout cell, so it's impossible to know where to place from. Use a PLACE call before.
       "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("dgl", "ins1", ROT_P, 0L, 0L);
	    GENLIB_PLACE_TOP("idv", "ins2", SY_RP);
	    /* Save all that on disk */
	    GENLIB_SAVE_PHFIG();
       }

SEE ALSO

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

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_PLACE_TOP.3(October 1, 1997)