viewrdsins(3) [debian man page]

VIEWRDSINS(3)						      RDS PHYSICAL FUNCTIONS						     VIEWRDSINS(3)

NAME

       viewrdsins - Displays caracteristics of an instance

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

SYNOPSYS

	#include "rdsnnn.h"
	  void viewrdsins( Instance )
	   rdsins_list *Instance;

PARAMETERS

       Instance 	   Instance to display.

DESCRIPTION

       The viewrdsins function displays caracteristics of the instance pointed by 'Instance' and its items.

       instance's parameters displayed :

	      INSNAME		  name of the instance.

	      FIGNAME		  model's name of the instance.

	      X,Y		  position of the lower left corner of the instance.

	      TRANSF		  transformation applied to the instance.

	      SIZE		  size of the user structure added to the rdsrec_list structure.
       This function displays also rectangles of the instance (see viewrdsrec() function).

RETURN VALUE

       nothing

ERRORS

       none

EXAMPLE

	       #include "mutnnn.h"
	       #include "rdsnnn.h"
	       #include "rtlnnn.h"
	       typedef struct UserStruct
		{
		  char *STRING;
		  void *USER1;
		} UserStruct;
		main()
		 {
		   rdsfig_list *Figure;
		   rdsrec_list *Rectangle;
		   rdsins_list *Instance;
		   mbkenv();
		   rdsenv();
		   loadrdsparam();
		   Figure = addrdsfig ("core",sizeof ( UserStruct ) );
		   Instance  = addrdsins (Figure,"na2_y","and2",RDS_NOSYM,8,6);
		   Rectangle =
		    addrdsinsrec(Instance,"Alu1",RDS_ALU1,2,4,12,1);
		   /*
		     visualization of the instance and its rectangle
		   */
		   /* */ viewrdsins ( Instance );
		 }

SEE ALSO

       librds, viewrdsfig, viewrdsrec

BUG REPORT

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

ASIM
/LIP6							  October 1, 1997						     VIEWRDSINS(3)

ADDRDSINS(3)						      RDS PHYSICAL FUNCTIONS						      ADDRDSINS(3)

NAME

	addrdsins - adds an instance to a figure

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

SYNOPSYS

       #include "rdsnnn.h"
       rdsins_list *addrdsins( Figure, Model, Name, Sym, X, Y )
	    rdsfig_list *Figure;
	    char	*Model;
	    char	*Name;
	    char	 Sym;
	    long	 X;
	    long	 Y;

PARAMETER

       Figure		   figure which contains the instance.

       Model		   Name of the model of the instance.

       Name		   Name of the instance in the figure at which it belongs.

       Sym		   Symmetry applied to the instance.

			   possible values :

			   RDS_NOSYM	       no symmetry.

			   RDS_ROT_P	       90 degrees rotation counter clockwise.

			   RDS_SYMXY	       symmetry with regard to a horizontal and vertical axis.

			   RDS_ROT_M	       90 degrees rotation clockwise.

			   RDS_SYM_X	       symmetry with regard to a vertical axis.

			   RDS_SY_RM	       symmetry with regard to a vertical axis and 90 degrees clockwise.

			   RDS_SYM_Y	       symmetry with regard to a horizontal axis.

			   RDS_SY_RP	       symmetry with regard to a horizontal axis and 90 degrees rotation counter clockwise.

       X,Y		   position of the lower left corner of the instance in the figure after symmetry.

DESCRIPTION

       The addrdsins function adds an instance to the head of instances's list in the figure described	in  function  parameter.  Some	fields	of
       rdsins_list structure are modified as follows :
       The field FIGNAME is set to Model
       The field INSNAME is set to Name
       The field X is set to X
       The field Y is set to Y
       The field TRANSF is set to Sym
       The field SIZE is set to Figure->SIZE

RETURN VALUE

       addrdsins returns a pointer to the newly created instance which is head of instances's list of the figure.

ERRORS

       "Rds202: rdsalloc error, can't continue !"
	      it's impossible to allocate the memory size desired.

EXAMPLE

       #include "mutnnn.h"
       #include "rdsnnn.h"
       #include "rtlnnn.h"
	       typedef struct UserStruct
		{
		  char *STRING;
		  void *USER1;
		} UserStruct;
		main()
		 {
		   rdsfig_list *RdsFigure;
		   rdsins_list *Instance;
		   mbkenv();
		   rdsenv();
		   loadrdsparam();
		   RdsFigure = addrdsfig ("core",sizeof ( UserStruct ) );
		   Instance = addrdsins (RdsFigure,"na2_y","and2",RDS_NOSYM,8,6);
		   printf("(RdsFigure->INSTANCE)->NAME = %s
",
			   (RdsFigure->INSTANCE)->NAME);
		   /* Instance is head of instance list of the figure */
		   printf("Instance->NAME = %s
", Instance->NAME);
		 }

SEE ALSO

       librds, delrdsins, viewrdsins

BUG REPORT

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

ASIM
/LIP6							  October 1, 1997						      ADDRDSINS(3)