Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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"

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

PARAMETERS
     modelname		 Name of the layout figure to be instantiated

     insname		 Name to be given to the instance on the model

     symetry		 Geometrical operation to be performed on  the	instance
			 before being 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
     being 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 mem-
     ory.  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), GEN-
     LIB_PLACE_RIGHT(3),      GENLIB_PLACE_BOTTOM(3),	   GENLIB_PLACE_LEFT(3),
     MBK_CATA_LIB(1), MBK_WORK_LIB(1), MBK_IN_PH(1).

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

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=GENLIB_PLACE_TOP&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help