allocrdswin(3) allocates window's table

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 ); 
            . . .
          }