allocrdswin(3alc)

1ALLOCRDSWIN(3)              RDS PHYSICAL FUNCTIONS              ALLOCRDSWIN(3)
2
3
4

NAME

6       allocrdswin - allocates window's table
7

SYNOPSIS

9       #include "rwinnn.h"
10        rdswin_list ∗allocrdswin( Number )
11           unsigned int Number;
12

PARAMETER

14       Number              Number of windows contained in the window's table.
15

DESCRIPTION

17       The  allocrdswin  allocates  a window's table. The number of windows is
18       specified by the parameter ´Number´ of the function. To  determine  the
19       size  of  the parameter ´Number´, the user has to multiplicate width by
20       height of his table in number of windows. Each item of the table  is  a
21       pointer  to a rdswin_list structure which contains rectangles sorted by
22       layer (see librwi).
23

RETURN VALUE

25       The pointer to the table is returned.
26

ERRORS

28       "Rds202: rdsalloc error, can't continue !"
29              it's impossible to allocate the memory size for the table
30

EXAMPLE

32               #include "mutnnn.h"
33               #include "rdsnnn.h"
34               #include "rwinnn.h"
35               #include "rtlnnn.h"
36               main()
37                 {
38                   rdswindow ∗RdsWindow;
39                   RdsWindow = allocrdswindow();
40                   RdsWindow->XMIN = -200;
41                   RdsWindow->YMIN = -200;
42                   RdsWindow->XMAX =  200;
43                   RdsWindow->YMAX =  200;
44                   RdsWindow->DX   =  4;
45                   RdsWindow->DY   =  4;
46                   RdsWindow->SIDE =  100;
47                   RdsWindow->SIZE =  RdsWindow->DX ∗ RdsWindow->DY ;
48                   RdsWindow->WINTAB = allocrdswin( RdsWindow->SIZE );
49                   . . .
50                 }
51