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

  
 
  

home | help
GENLIB_PLACE_ON.3(October 1, 1997)	      GENLIB_PLACE_ON.3(October 1, 1997)

NAME
     GENLIB_PLACE_ON  - place a physical instance in the current figure matching
     connectors

SYNOPSIS
     #include <genlib.h>
     void GENLIB_PLACE_ON(figname,ins1,con1,index1,symetry,ins2,con2,index2)
     char *figname, *ins1, *con1, *ins2, *con2;
     char symetry;
     long index1, index2;

PARAMETERS
     figname		 Name of the layout figure to be instantiated

     ins1		 Name to be given to the instance in the model

     con1		 Name of the connector of the instance to  be  used  for
			 placement

     index1		 Index of the connector, or reference, con1 of the model
			 to be used for placement

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

     ins2		 Name of the instance to be used for relative placement

     con2		 Name of the connector of the instance ins2 on which the
			 placement will take place

     index2		 Index of the connector con2 of the instance to be  used
			 for relative placement

DESCRIPTION
     PLACE_ON add an instance in the current layout cell. The bottom left corner
     of  the  instance	of the model modelname is placed, after being 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  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_ON 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_ON("gapg0_b","ins1", NOSYM, 0L, 0L);
	  GENLIB_PLACE_ON("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_ON.3(October 1, 1997)

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

home | help