allocrdswindow(3alc)

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

NAME

6       allocrdswindow - allocates a window structure
7

SYNOPSIS

9       #include "rwinnn.h"
10        rdswindow ∗allocrdswindow()
11

PARAMETER

13       none
14

DESCRIPTION

16       The  allocrdswindow  allocates  a window structure (rdswindow) which is
17       used to create an ´object´ window  (see  librwi).  It  contains  fields
18       information  about  the  window's table and the pointer to the window's
19       table. It's the head of windowing.
20

RETURN VALUE

22       The pointer to the rdswindow structure allocated is returned.
23

ERRORS

25       "Rds202: rdsalloc error, can't continue !"
26              it's impossible to allocate the memory size desired.
27

EXAMPLE

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