allocrdswindow(3) allocates a window structure

SYNOPSYS

#include "rwinnn.h"
 rdswindow *allocrdswindow()

PARAMETER

none

DESCRIPTION

The allocrdswindow allocates a window structure (rdswindow) which is used to create an 'object' window (see librwi). It contains fields information about the window's table and the pointer to the window's table. It's the head of windowing.

RETURN VALUE

The pointer to the rdswindow structure allocated 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"
        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 );
            . . .
          }