ALLOCRDSWIN(3)						      RDS PHYSICAL FUNCTIONS						    ALLOCRDSWIN(3)

NAME

       allocrdswin - allocates window's table

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"
	rdswin_list *allocrdswin( Number )
	   unsigned int Number;

PARAMETER

       Number		   Number of windows contained in the window's table.

DESCRIPTION

       The allocrdswin allocates a window's table. The number of windows is specified by the parameter 'Number' of the function. To determine  the
       size of the parameter 'Number', the user has to multiplicate width by height of his table in number of windows. Each item of the table is a
       pointer to a rdswin_list structure which contains rectangles sorted by layer (see librwi).

RETURN VALUE

       The pointer to the table is returned.

ERRORS

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

EXAMPLE

	       #include "mutnnn.h"
	       #include "rdsnnn.h"
	       #include "rwinnn.h"
	       #include "rtlnnn.h"
	       main()
		 {
		   rdswindow *RdsWindow;
		   RdsWindow = allocrdswindow();
		   RdsWindow->XMIN = -200;
		   RdsWindow->YMIN = -200;
		   RdsWindow->XMAX =  200;
		   RdsWindow->YMAX =  200;
		   RdsWindow->DX   =  4;
		   RdsWindow->DY   =  4;
		   RdsWindow->SIDE =  100;
		   RdsWindow->SIZE =  RdsWindow->DX * RdsWindow->DY ;
		   RdsWindow->WINTAB = allocrdswin( RdsWindow->SIZE );
		   . . .
		 }

SEE ALSO

       librwi

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