package oxbow

  1. Overview
  2. Docs
Dynamic window manager for the river Wayland compositor

Install

dune-project
 Dependency

Authors

Maintainers

Sources

v0.1.0.tar.gz
md5=a637acaa0e19046cd65fff733874eb97
sha512=76230cbecd7510de7a05b5d1f335915ef7b6c4aa557d8dbfd23591606618d2cfa25082d17b93f2f4b53a118d1cbf6a80e4ad51cf0f099b4921fb83d6df0c9801

doc/src/oxbow.river/river_layer_shell_v1_server.ml.html

Source file river_layer_shell_v1_server.ml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
(* This file was generated automatically by wayland-scanner-ocaml *)

[@@@ocaml.warning "-27-34"]
open struct
  module Imports = struct
    include River_layer_shell_v1_proto
    include River_window_management_v1_proto
  end
  
  module Proxy = Wayland.Proxy
  module Msg = Wayland.Msg
  module Fixed = Wayland.Fixed
  module Iface_reg = Wayland.Iface_reg
  module S = Wayland.S
end


(** River layer shell global interface.
    
    This global interface should only be advertised to the client if the
    river_window_manager_v1 global is also advertised. Binding this interface
    indicates that the window manager supports layer shell.
    
    If the window manager does not bind this interface, the compositor should
    not allow clients to map layer surfaces. This can be achieved by
    closing layer surfaces immediately. *)
module River_layer_shell_v1 = struct
  type 'v t = ([`River_layer_shell_v1], 'v, [`Server]) Proxy.t
  module Error = River_layer_shell_v1_proto.River_layer_shell_v1.Error
  
  (** {2 Version 1} *)
  
  (**/**)
  class virtual ['v] _handlers_unsafe = object (_self : (_, 'v, _) #Proxy.Handler.t)
    method user_data = S.No_data
    method metadata = (module River_layer_shell_v1_proto.River_layer_shell_v1)
    method max_version = 1l
    
    method private virtual on_destroy : [> ] t -> unit
    
    method private virtual on_get_output : [> ] t -> ([`River_layer_shell_output_v1], 'v, [`Server]) Proxy.t ->
                                           output:([`River_output_v1], [> Imports.River_output_v1.versions], [`Server]) Proxy.t ->
                                           unit
    
    method private virtual on_get_seat : [> ] t -> ([`River_layer_shell_seat_v1], 'v, [`Server]) Proxy.t ->
                                         seat:([`River_seat_v1], [> Imports.River_seat_v1.versions], [`Server]) Proxy.t ->
                                         unit
    
    
    method dispatch (_proxy : 'v t) _msg =
      let _proxy = Proxy.cast_version _proxy in
      match Msg.op _msg with
      | 0 ->
        Proxy.shutdown_recv _proxy;
        _self#on_destroy _proxy 
      | 1 ->
        let id : ([`River_layer_shell_output_v1], _, _) Proxy.t =
          Msg.get_int _msg |> Proxy.Handler.accept_new _proxy (module Imports.River_layer_shell_output_v1) in
        let output : ([`River_output_v1], _, _) Proxy.t =
          let Proxy.Proxy p = Msg.get_int _msg |> Proxy.lookup_other _proxy in
          match Proxy.ty p with
          | Imports.River_output_v1.T -> p
          | _ -> Proxy.wrong_type ~parent:_proxy ~expected:"river_output_v1" p
          in
        _self#on_get_output _proxy id ~output
      | 2 ->
        let id : ([`River_layer_shell_seat_v1], _, _) Proxy.t =
          Msg.get_int _msg |> Proxy.Handler.accept_new _proxy (module Imports.River_layer_shell_seat_v1) in
        let seat : ([`River_seat_v1], _, _) Proxy.t =
          let Proxy.Proxy p = Msg.get_int _msg |> Proxy.lookup_other _proxy in
          match Proxy.ty p with
          | Imports.River_seat_v1.T -> p
          | _ -> Proxy.wrong_type ~parent:_proxy ~expected:"river_seat_v1" p
          in
        _self#on_get_seat _proxy id ~seat
      | _ -> assert false
  end
  (**/**)
  
  (** {2 Handlers}
      Note: Servers will always want to use [v1].
   *)
  
  
  (** Handler for a proxy with version >= 1. *)
  class virtual ['v] v1 = object (_ : (_, 'v, _) #Proxy.Service_handler.t)
    (**/**)
    inherit [[< `V1] as 'v] _handlers_unsafe
    (**/**)
    method private virtual on_destroy : [> `V1] t -> unit
    
    (** Destroy the river_layer_shell_v1 object.
        
        This request indicates that the client will no longer use the
        river_layer_shell_v1 object. *)
    
    method private virtual on_get_output : [> `V1] t -> ([`River_layer_shell_output_v1], 'v, [`Server]) Proxy.t ->
                                           output:([`River_output_v1], [> Imports.River_output_v1.versions], [`Server]) Proxy.t ->
                                           unit
    
    (** Get layer shell output state.
        
        It is a protocol error to make this request more than once for a given
        river_output_v1 object. *)
    
    method private virtual on_get_seat : [> `V1] t -> ([`River_layer_shell_seat_v1], 'v, [`Server]) Proxy.t ->
                                         seat:([`River_seat_v1], [> Imports.River_seat_v1.versions], [`Server]) Proxy.t ->
                                         unit
    
    (** Get layer shell seat state.
        
        It is a protocol error to make this request more than once for a given
        river_seat_v1 object. *)
    
    method min_version = 1l
    method bind_version : [`V1] = `V1
  end
end

(** Layer shell output state.
    
    The lifetime of this object is tied to the corresponding river_output_v1.
    This object is made inert when the river_output_v1.removed event is sent
    and should be destroyed. *)
module River_layer_shell_output_v1 = struct
  type 'v t = ([`River_layer_shell_output_v1], 'v, [`Server]) Proxy.t
  
  (** {2 Version 1} *)
  
  (** Area left after subtracting exclusive zones.
      
      This event indicates the area of the output remaining after subtracting
      the exclusive zones of layer surfaces. Exclusive zones are a hint, the
      window manager is free to ignore this area hint if it wishes.
      
      The x and y values are in the global coordinate space, not relative to
      the position of the output.
      
      This event will be followed by a manage_start event after all other new
      state has been sent by the server. *)
  let non_exclusive_area (_t:([< `V1] as 'v) t) ~x ~y ~width ~height =
    let _msg = Proxy.alloc _t ~op:0 ~ints:4 ~strings:[] ~arrays:[] in
    Msg.add_int _msg x;
    Msg.add_int _msg y;
    Msg.add_int _msg width;
    Msg.add_int _msg height;
    Proxy.send _t _msg
  
  (**/**)
  class virtual ['v] _handlers_unsafe = object (_self : (_, 'v, _) #Proxy.Handler.t)
    method user_data = S.No_data
    method metadata = (module River_layer_shell_v1_proto.River_layer_shell_output_v1)
    method max_version = 1l
    
    method private virtual on_destroy : [> ] t -> unit
    
    method private virtual on_set_default : [> ] t -> unit
    
    
    method dispatch (_proxy : 'v t) _msg =
      let _proxy = Proxy.cast_version _proxy in
      match Msg.op _msg with
      | 0 ->
        Proxy.shutdown_recv _proxy;
        _self#on_destroy _proxy 
      | 1 ->
        _self#on_set_default _proxy 
      | _ -> assert false
  end
  (**/**)
  
  (** {2 Handlers}
      Note: Servers will always want to use [v1].
   *)
  
  
  (** Handler for a proxy with version >= 1. *)
  class virtual ['v] v1 = object (_ : (_, 'v, _) #Proxy.Service_handler.t)
    (**/**)
    inherit [[< `V1] as 'v] _handlers_unsafe
    (**/**)
    method private virtual on_destroy : [> `V1] t -> unit
    
    (** Destroy the object.
        
        This request indicates that the client will no longer use the
        river_layer_shell_output_v1 object and that it may be safely destroyed.
        
        This request should be made after the river_output_v1.removed event is
        received to complete destruction of the output. *)
    
    method private virtual on_set_default : [> `V1] t -> unit
    
    (** Set default output for layer surfaces.
        
        Mark this output as the default for new layer surfaces which do not
        request a specific output themselves. This request overrides any
        previous set_default request on any river_layer_shell_output_v1 object.
        
        If no set_default request is made or if the default output is destroyed,
        the default output is undefined until the next set_default request.
        
        This request modifies window management state and may only be made as
        part of a manage sequence, see the river_window_manager_v1 description. *)
    
    method min_version = 1l
  end
end

(** Layer shell seat state.
    
    The lifetime of this object is tied to the corresponding river_seat_v1.
    This object is made inert when the river_seat_v1.removed event is sent and
    should be destroyed. *)
module River_layer_shell_seat_v1 = struct
  type 'v t = ([`River_layer_shell_seat_v1], 'v, [`Server]) Proxy.t
  
  (** {2 Version 1} *)
  
  (** No layer shell surface has focus.
      
      No layer shell surface will have keyboard focus at the end of the manage
      sequence in which this event is sent. The window manager may want to
      return focus to whichever window last had focus, for example.
      
      This event will be followed by a manage_start event after all other new
      state has been sent by the server. *)
  let focus_none (_t:([< `V1] as 'v) t)  =
    let _msg = Proxy.alloc _t ~op:2 ~ints:0 ~strings:[] ~arrays:[] in
    Proxy.send _t _msg
  
  (** Layer shell surface wants non-exclusive focus.
      
      A layer shell surface will be given non-exclusive keyboard focus at the
      end of the manage sequence in which this event is sent. The window
      manager may want to update window decorations or similar to indicate
      that no window is focused.
      
      The window manager continues to control focus and may choose to focus a
      different window/shell surface at any time. If the window manager sets
      focus during the same manage sequence in which this event is sent, the
      layer surface will not be focused.
      
      If the layer surface with non-exclusive focus is closed or the window
      manager chooses to move focus away from the layer surface, a focus_none
      event will be sent in the next manage sequence.
      
      This event will be followed by a manage_start event after all other new
      state has been sent by the server. *)
  let focus_non_exclusive (_t:([< `V1] as 'v) t)  =
    let _msg = Proxy.alloc _t ~op:1 ~ints:0 ~strings:[] ~arrays:[] in
    Proxy.send _t _msg
  
  (** Layer shell surface has exclusive focus.
      
      A layer shell surface will be given exclusive keyboard focus at the end
      of the manage sequence in which this event is sent. The window manager
      may want to update window decorations or similar to indicate that no
      window is focused.
      
      Until the focus_non_exclusive or focus_none event is sent, all window
      manager requests to change focus are ignored.
      
      This event will be followed by a manage_start event after all other new
      state has been sent by the server. *)
  let focus_exclusive (_t:([< `V1] as 'v) t)  =
    let _msg = Proxy.alloc _t ~op:0 ~ints:0 ~strings:[] ~arrays:[] in
    Proxy.send _t _msg
  
  (**/**)
  class virtual ['v] _handlers_unsafe = object (_self : (_, 'v, _) #Proxy.Handler.t)
    method user_data = S.No_data
    method metadata = (module River_layer_shell_v1_proto.River_layer_shell_seat_v1)
    method max_version = 1l
    
    method private virtual on_destroy : [> ] t -> unit
    
    
    method dispatch (_proxy : 'v t) _msg =
      let _proxy = Proxy.cast_version _proxy in
      match Msg.op _msg with
      | 0 ->
        Proxy.shutdown_recv _proxy;
        _self#on_destroy _proxy 
      | _ -> assert false
  end
  (**/**)
  
  (** {2 Handlers}
      Note: Servers will always want to use [v1].
   *)
  
  
  (** Handler for a proxy with version >= 1. *)
  class virtual ['v] v1 = object (_ : (_, 'v, _) #Proxy.Service_handler.t)
    (**/**)
    inherit [[< `V1] as 'v] _handlers_unsafe
    (**/**)
    method private virtual on_destroy : [> `V1] t -> unit
    
    (** Destroy the object.
        
        This request indicates that the client will no longer use the
        river_layer_shell_seat_v1 object and that it may be safely destroyed.
        
        This request should be made after the river_seat_v1.removed event is
        received to complete destruction of the seat. *)
    
    method min_version = 1l
  end
end