NAME

       allocrdsrecwin - 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;
                    . . . .
                 }

SEE ALSO

       librwi

ASIM/LIP6                                        October 1, 1997                               ALLOCRDSRECWIN(3)