allocrdswin(3)

NAME

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