debian man page for allocrdsrecwin

ALLOCRDSRECWIN(3)					      RDS PHYSICAL FUNCTIONS						 ALLOCRDSRECWIN(3)

NAME
       allocrdsrecwin - allocates a structure used to know windows which contains a rectangle.

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"
	rdsrecwin_list *allocrdsrecwin()

PARAMETER
       none

DESCRIPTION
       The allocrdsrecwin function allocates a rdsrecwin_list structure item. This structure contains a pointer to a window structure so  it  per-
       mits to chain all windows which contains a same rectangle (see librwi).

RETURN VALUE
       The pointer to the newly allocated structure is returned.

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

EXAMPLE
	       #include "mutnnn.h"
	       #include "rdsnnn.h"
	       #include "rwinnn.h"
	       #include "rtlnnn.h"
	       # define POINTER_WINDOW(R)				 
									 
		 (((UserStruct *)((char *)(R)+sizeof(rdsrec_list)))->WINDOW )
	       typedef struct UserStruct
		{
		  rdsrecwin_list *WINDOW;
		} UserStruct;
	       main()
		 {
		    rdsfig_list *Figure;
		    rdsrec_list *Rectangle;
		    rdswin_list *Window;
		    mbkenv();
		    rdsenv();
		    loadrdsparam();
		    Figure = addrdsfig( "core",sizeof ( UserStruct ) );
		    Rectangle =
		      addrdsfigrec(Figure,"Alu1",RDS_ALU1,2,4,5,1);
		    POINTER_WINDOW (Rectangle) = allocrdsrecwin();
		    . . . .
		    Window = ...
		    (POINTER_WINDOW (Rectangle))->WINDOW = Window;
		    . . . .
		 }

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