buildrdswindow(3) [debian man page]

BUILDRDSWINDOW(3)					      RDS PHYSICAL FUNCTIONS						 BUILDRDSWINDOW(3)

NAME

       buildrdswindow - builds windowing of 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 "rwinnn.h"
	rdswindow *buildrdswindow( Figure )
	   rdsfig_list *Figure;

PARAMETER

       Figure		   The figure where has to be built the windowing.

DESCRIPTION

       The buildrdswindow function permits to build windowing on the figure named 'Figure'.

RETURN VALUE

       The pointer to the windowing structure "rdswindow".

ERRORS

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

EXAMPLE

	       #include "mphnnn.h"
	       #include "mutnnn.h"
	       #include "rdsnnn.h"
	       #include "rfmnnn.h"
	       #include "rwinnn.h"
	       #include "rtlnnn.h"
	       main()
		 {
		   phfig_list	  *MbkFigure;
		   rdsfig_list	  *RdsFigure;
		   rdswindow	  *Window;
		   long 	   X,Y,Offset;
		   rdswin_list	  *Win;
		   rdswinrec_list *WinRec;
		   rdsrec_list	  *ScanRec;
		   char 	   Layer;
		   char 	   Index;
		   mbkenv();
		   rdsenv();
		   loadrdsparam();
		   MbkFigure = getphfig("na2_y",'A');
		   RdsFigure = figmbkrds(MbkFigure,0,0);
		   Window    =	buildrdswindow ( RdsFigure );
		   /* gets each window of the table */
		   for ( X = 0 ; X < Window->DX ; X ++ )
		    for ( Y = 0 ; Y < Window->DY ; Y ++ )
		     {
		       printf("WINDOW (%ld,%ld)
",X,Y);
		       Offset = Y * Window->DX + X;
		       Win = Window->WINTAB + Offset;
		       /* gets all rectangles of a window */
		       for ( Layer = 0 ; Layer < RWI_MAX_LAYER ; Layer ++ )
			{
			  printf("LAYER = %s
",RDS_LAYER_NAME[Layer]);
			  for ( WinRec	= Win->LAYERTAB[ Layer ];
				WinRec != (rdswinrec_list *)NULL;
				WinRec	= WinRec->NEXT )
			   {
			     for (
				   Index = 0;
				   Index < RWI_MAX_REC;
				   Index++
				 )
			      {
			       ScanRec = WinRec->RECTAB[ Index ];
			       /* prints dimensions of each rectangle */
			       if ( ScanRec != NULL )
			       printf("X=%ld, Y=%ld, DX=%ld, DY=%ld
",
				      ScanRec->X,ScanRec->Y,ScanRec->DX,
				      ScanRec->DY);
			       else break;
			      }
			   }
			}
		     }
		   . . .
		 }

SEE ALSO

       librwi, allocrdswindow, destroyrdswindow, viewrdswindow

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						 BUILDRDSWINDOW(3)

ADDRDSFIGREC(3) 					      RDS PHYSICAL FUNCTIONS						   ADDRDSFIGREC(3)

NAME

	addrdsfigrec - adds a rectangle 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"
       rdsrec_list *addrdsfigrec( Figure, Name, Layer, X, Y, Dx, Dy )
		      rdsfig_list *Figure;
		      char	  *Name;
		      char	   Layer;
		      long	   X;
		      long	   Y;
		      long	   Dx;
		      long	   Dy;

PARAMETER

       Figure		   figure which contains the rectangle to add.

       Name		   name of the rectangle to add.

       Layer		   Layer of the rectangle to add.

       X,Y,DX,DY	   Dimensions of the rectangle to add.

DESCRIPTION

       addrdsfigrec creates an adds a rectangle in the figure called Figure.  The size of  the	user  structure  to  add  next	to  the  structure
       rdsrec_list  (if it exists) is defined by the field SIZE of the figure who has to contain the rectangle. The rectangle is added in front of
       the list, and becomes itself the list head associated to the defined layer in parameters of the function.   The	fields	of  the  rectangle
       structure are modified as follows :
       The field NAME is set to Name.
       The field X is set to X.
       The field Y is set to Y.
       The field DX is set to Dx.
       The field DY is set to Dy.
       The field FLAGS is modified with the value Layer.

RETURN VALUE

       addrdsfigrec returns a pointer to the newly added rectangle.

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;
	       # define POINTER_STRING(R)				 
									 
		 (((UserStruct *)((char *)(R)+sizeof(rdsrec_list)))->STRING )
		main()
		 {
		   rdsfig_list *RdsFigure;
		   rdsrec_list *Rectangle;
		   char Layer;
		   rdsrec_list *ScanRec;
		   mbkenv();
		   rdsenv();
		   loadrdsparam();
		   RdsFigure = addrdsfig ("core",sizeof ( UserStruct ) );
		   Rectangle = addrdsfigrec (RdsFigure,
						   "Alu1",RDS_ALU1,
						   2,4,12,1);
		   POINTER_STRING(Rectangle) = namealloc ("rectangle_alu1");
		   ...
		   /*
		      print caracteristics of all rectangles of the Rds figure
		   */
		   for ( Layer = 0 ; Layer < RDS_MAX_LAYER ; Layer ++ )
		    {
		      for (
			     ScanRec  = RdsFigure->LAYERTAB[Layer] ;
			     ScanRec != (rdsrec_list *) NULL	 ;
			     ScanRec  = ScanRec->NEXT
			  )
		       {
			 printf("Rectangle->LAYER = %s
",
			    RDS_LAYER_NAME[GetRdsLayer(ScanRec)]);
			 printf("Rectangle->NAME   = %s
",ScanRec->NAME);
			 printf("Rectangle->X	   = %ld
",ScanRec->X);
			 printf("Rectangle->Y	   = %ld
",ScanRec->Y);
			 printf("Rectangle->DX	   = %ld
",ScanRec->DX);
			 printf("Rectangle->DY	   = %ld
",ScanRec->DY);
			 printf("Rectangle->STRING = %s
",POINTER_STRING(ScanRec));
		       }
		    }
		 }

SEE ALSO

       librds, delrdsfigrec, viewrdsfig

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						   ADDRDSFIGREC(3)