NAME

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

SEE ALSO

       librwi, buildrdswindow, destroyrdswindow, viewrdswindow