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