NAME

allocrdswin - allocates window's table

See the file buster/alliance/alc_origin.1.en.gz.

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


            . . .


          }