allocrdsrecwin(3) allocates a structure used to know windows which contains a rectangle.

SYNOPSYS

#include "rwinnn.h"
 rdsrecwin_list *allocrdsrecwin()

PARAMETER

none

DESCRIPTION

The allocrdsrecwin function allocates a rdsrecwin_list structure item. This structure contains a pointer to a window structure so it permits to chain all windows which contains a same rectangle (see librwi).

RETURN VALUE

The pointer to the newly allocated structure 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"
        # define POINTER_WINDOW(R)                                \
                                                                  \
          (((UserStruct *)((char *)(R)+sizeof(rdsrec_list)))->WINDOW )
        typedef struct UserStruct
         {
           rdsrecwin_list *WINDOW;
         } UserStruct;
        main()
          {
             rdsfig_list *Figure;
             rdsrec_list *Rectangle;
             rdswin_list *Window;
             mbkenv();
             rdsenv();
             loadrdsparam();
             Figure = addrdsfig( "core",sizeof ( UserStruct ) );
             Rectangle =
               addrdsfigrec(Figure,"Alu1",RDS_ALU1,2,4,5,1);
             POINTER_WINDOW (Rectangle) = allocrdsrecwin();
             . . . .
             Window = ...
             (POINTER_WINDOW (Rectangle))->WINDOW = Window;
             . . . .
          }