This repository has been archived by the owner on Feb 11, 2021. It is now read-only.
/
SDL_windowsevents.c
696 lines (614 loc) · 20.5 KB
1
/*
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Simple DirectMedia Layer
Copyright (C) 1997-2011 Sam Lantinga <slouken@libsdl.org>
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
20
*/
21
22
23
#include "SDL_config.h"
24
25
#include "SDL_windowsvideo.h"
#include "SDL_windowsshape.h"
26
27
28
#include "SDL_syswm.h"
#include "SDL_vkeys.h"
#include "../../events/SDL_events_c.h"
29
#include "../../events/SDL_touch_c.h"
30
31
32
33
/*#define WMMSG_DEBUG*/
34
#ifdef WMMSG_DEBUG
35
#include <stdio.h>
36
37
38
39
#include "wmmsg.h"
#endif
/* Masks for processing the windows KEYDOWN and KEYUP messages */
40
41
#define REPEATED_KEYMASK (1<<30)
#define EXTENDED_KEYMASK (1<<24)
42
43
#define VK_ENTER 10 /* Keypad Enter ... no VKEY defined? */
44
45
46
47
48
49
50
51
52
53
54
/* Make sure XBUTTON stuff is defined that isn't in older Platform SDKs... */
#ifndef WM_XBUTTONDOWN
#define WM_XBUTTONDOWN 0x020B
#endif
#ifndef WM_XBUTTONUP
#define WM_XBUTTONUP 0x020C
#endif
#ifndef GET_XBUTTON_WPARAM
#define GET_XBUTTON_WPARAM(w) (HIWORD(w))
#endif
55
56
57
#ifndef WM_INPUT
#define WM_INPUT 0x00ff
#endif
58
#ifndef WM_TOUCH
59
#define WM_TOUCH 0x0240
60
#endif
61
62
63
64
65
static WPARAM
RemapVKEY(WPARAM wParam, LPARAM lParam)
{
66
int i;
67
BYTE scancode = (BYTE) ((lParam >> 16) & 0xFF);
68
69
70
71
72
/* Windows remaps alphabetic keys based on current layout.
We try to provide USB scancodes, so undo this mapping.
*/
if (wParam >= 'A' && wParam <= 'Z') {
73
74
75
if (scancode != alpha_scancodes[wParam - 'A']) {
for (i = 0; i < SDL_arraysize(alpha_scancodes); ++i) {
if (scancode == alpha_scancodes[i]) {
76
77
78
79
80
81
wParam = 'A' + i;
break;
}
}
}
}
82
83
84
85
86
87
/* Keypad keys are a little trickier, we always scan for them.
Keypad arrow keys have the same scancode as normal arrow keys,
except they don't have the extended bit (0x1000000) set.
*/
if (!(lParam & 0x1000000)) {
88
89
90
91
92
93
94
95
if (wParam == VK_DELETE) {
wParam = VK_DECIMAL;
} else {
for (i = 0; i < SDL_arraysize(keypad_scancodes); ++i) {
if (scancode == keypad_scancodes[i]) {
wParam = VK_NUMPAD0 + i;
break;
}
96
}
97
98
99
}
}
100
101
102
return wParam;
}
103
104
105
106
LRESULT CALLBACK
WIN_WindowProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam)
{
SDL_WindowData *data;
107
LRESULT returnCode = -1;
108
109
/* Send a SDL_SYSWMEVENT if the application wants them */
110
if (SDL_GetEventState(SDL_SYSWMEVENT) == SDL_ENABLE) {
111
112
113
SDL_SysWMmsg wmmsg;
SDL_VERSION(&wmmsg.version);
114
wmmsg.subsystem = SDL_SYSWM_WINDOWS;
115
116
117
118
wmmsg.msg.win.hwnd = hwnd;
wmmsg.msg.win.msg = msg;
wmmsg.msg.win.wParam = wParam;
wmmsg.msg.win.lParam = lParam;
119
120
121
SDL_SendSysWMEvent(&wmmsg);
}
122
123
124
125
126
/* Get the window data for the window */
data = (SDL_WindowData *) GetProp(hwnd, TEXT("SDL_WindowData"));
if (!data) {
return CallWindowProc(DefWindowProc, hwnd, msg, wParam, lParam);
}
127
128
#ifdef WMMSG_DEBUG
129
130
{
FILE *log = fopen("wmmsg.txt", "a");
131
132
133
134
135
136
137
138
fprintf(log, "Received windows message: %p ", hwnd);
if (msg > MAX_WMMSG) {
fprintf(log, "%d", msg);
} else {
fprintf(log, "%s", wmtab[msg]);
}
fprintf(log, " -- 0x%X, 0x%X\n", wParam, lParam);
fclose(log);
139
140
}
#endif
141
142
143
if (IME_HandleMessage(hwnd, msg, wParam, &lParam, data->videodata))
return 0;
144
145
146
147
148
149
switch (msg) {
case WM_SHOWWINDOW:
{
if (wParam) {
150
SDL_SendWindowEvent(data->window, SDL_WINDOWEVENT_SHOWN, 0, 0);
151
} else {
152
SDL_SendWindowEvent(data->window, SDL_WINDOWEVENT_HIDDEN, 0, 0);
153
154
155
156
157
158
159
160
161
162
}
}
break;
case WM_ACTIVATE:
{
BOOL minimized;
minimized = HIWORD(wParam);
if (!minimized && (LOWORD(wParam) != WA_INACTIVE)) {
163
164
SDL_SendWindowEvent(data->window, SDL_WINDOWEVENT_SHOWN, 0, 0);
SDL_SendWindowEvent(data->window,
165
SDL_WINDOWEVENT_RESTORED, 0, 0);
166
#ifndef _WIN32_WCE /* WinCE misses IsZoomed() */
167
if (IsZoomed(hwnd)) {
168
SDL_SendWindowEvent(data->window,
169
170
SDL_WINDOWEVENT_MAXIMIZED, 0, 0);
}
171
#endif
172
173
if (SDL_GetKeyboardFocus() != data->window) {
SDL_SetKeyboardFocus(data->window);
174
}
175
176
177
178
/*
* FIXME: Update keyboard state
*/
WIN_CheckClipboardUpdate(data->videodata);
179
} else {
180
181
if (SDL_GetKeyboardFocus() == data->window) {
SDL_SetKeyboardFocus(NULL);
182
183
}
if (minimized) {
184
SDL_SendWindowEvent(data->window,
185
186
187
188
SDL_WINDOWEVENT_MINIMIZED, 0, 0);
}
}
}
189
190
returnCode = 0;
break;
191
192
case WM_MOUSEMOVE:
193
#ifdef _WIN32_WCE
194
195
196
/* transform coords for VGA, WVGA... */
{
SDL_VideoData *videodata = data->videodata;
197
if(videodata->CoordTransform) {
198
199
200
201
POINT pt;
pt.x = LOWORD(lParam);
pt.y = HIWORD(lParam);
videodata->CoordTransform(data->window, &pt);
202
SDL_SendMouseMotion(data->window, 0, pt.x, pt.y);
203
204
205
break;
}
}
206
#endif
207
SDL_SendMouseMotion(data->window, 0, LOWORD(lParam), HIWORD(lParam));
208
209
break;
210
case WM_LBUTTONDOWN:
211
SDL_SendMouseButton(data->window, SDL_PRESSED, SDL_BUTTON_LEFT);
212
213
break;
214
case WM_LBUTTONUP:
215
SDL_SendMouseButton(data->window, SDL_RELEASED, SDL_BUTTON_LEFT);
216
break;
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
case WM_RBUTTONDOWN:
SDL_SendMouseButton(data->window, SDL_PRESSED, SDL_BUTTON_RIGHT);
break;
case WM_RBUTTONUP:
SDL_SendMouseButton(data->window, SDL_RELEASED, SDL_BUTTON_RIGHT);
break;
case WM_MBUTTONDOWN:
SDL_SendMouseButton(data->window, SDL_PRESSED, SDL_BUTTON_MIDDLE);
break;
case WM_MBUTTONUP:
SDL_SendMouseButton(data->window, SDL_RELEASED, SDL_BUTTON_MIDDLE);
break;
case WM_XBUTTONDOWN:
SDL_SendMouseButton(data->window, SDL_PRESSED, SDL_BUTTON_X1 + GET_XBUTTON_WPARAM(wParam) - 1);
returnCode = TRUE;
break;
case WM_XBUTTONUP:
SDL_SendMouseButton(data->window, SDL_RELEASED, SDL_BUTTON_X1 + GET_XBUTTON_WPARAM(wParam) - 1);
returnCode = TRUE;
break;
case WM_MOUSEWHEEL:
{
int motion = (short) HIWORD(wParam);
SDL_SendMouseWheel(data->window, 0, motion);
break;
}
252
253
#ifdef WM_MOUSELEAVE
/* FIXME: Do we need the SDL 1.2 hack to generate WM_MOUSELEAVE now? */
254
case WM_MOUSELEAVE:
255
256
if (SDL_GetMouseFocus() == data->window) {
SDL_SetMouseFocus(NULL);
257
}
258
259
returnCode = 0;
break;
260
#endif /* WM_MOUSELEAVE */
261
262
263
264
case WM_SYSKEYDOWN:
case WM_KEYDOWN:
{
265
wParam = RemapVKEY(wParam, lParam);
266
267
268
269
270
271
272
273
274
275
switch (wParam) {
case VK_CONTROL:
if (lParam & EXTENDED_KEYMASK)
wParam = VK_RCONTROL;
else
wParam = VK_LCONTROL;
break;
case VK_SHIFT:
/* EXTENDED trick doesn't work here */
{
276
277
Uint8 *state = SDL_GetKeyboardState(NULL);
if (state[SDL_SCANCODE_LSHIFT] == SDL_RELEASED
278
279
&& (GetKeyState(VK_LSHIFT) & 0x8000)) {
wParam = VK_LSHIFT;
280
} else if (state[SDL_SCANCODE_RSHIFT] == SDL_RELEASED
281
282
283
284
&& (GetKeyState(VK_RSHIFT) & 0x8000)) {
wParam = VK_RSHIFT;
} else {
/* Probably a key repeat */
285
wParam = 256;
286
287
288
289
290
291
292
293
294
}
}
break;
case VK_MENU:
if (lParam & EXTENDED_KEYMASK)
wParam = VK_RMENU;
else
wParam = VK_LMENU;
break;
295
296
297
298
case VK_RETURN:
if (lParam & EXTENDED_KEYMASK)
wParam = VK_ENTER;
break;
299
}
300
if (wParam < 256) {
301
SDL_SendKeyboardKey(SDL_PRESSED,
302
303
data->videodata->key_layout[wParam]);
}
304
}
305
306
returnCode = 0;
break;
307
308
309
310
case WM_SYSKEYUP:
case WM_KEYUP:
{
311
wParam = RemapVKEY(wParam, lParam);
312
313
314
315
316
317
318
319
320
321
switch (wParam) {
case VK_CONTROL:
if (lParam & EXTENDED_KEYMASK)
wParam = VK_RCONTROL;
else
wParam = VK_LCONTROL;
break;
case VK_SHIFT:
/* EXTENDED trick doesn't work here */
{
322
323
Uint8 *state = SDL_GetKeyboardState(NULL);
if (state[SDL_SCANCODE_LSHIFT] == SDL_PRESSED
324
325
&& !(GetKeyState(VK_LSHIFT) & 0x8000)) {
wParam = VK_LSHIFT;
326
} else if (state[SDL_SCANCODE_RSHIFT] == SDL_PRESSED
327
328
329
330
&& !(GetKeyState(VK_RSHIFT) & 0x8000)) {
wParam = VK_RSHIFT;
} else {
/* Probably a key repeat */
331
wParam = 256;
332
333
334
335
336
337
338
339
340
}
}
break;
case VK_MENU:
if (lParam & EXTENDED_KEYMASK)
wParam = VK_RMENU;
else
wParam = VK_LMENU;
break;
341
342
343
344
case VK_RETURN:
if (lParam & EXTENDED_KEYMASK)
wParam = VK_ENTER;
break;
345
}
346
347
348
/* Windows only reports keyup for print screen */
if (wParam == VK_SNAPSHOT
349
350
&& SDL_GetKeyboardState(NULL)[SDL_SCANCODE_PRINTSCREEN] ==
SDL_RELEASED) {
351
SDL_SendKeyboardKey(SDL_PRESSED,
352
353
354
data->videodata->key_layout[wParam]);
}
if (wParam < 256) {
355
SDL_SendKeyboardKey(SDL_RELEASED,
356
data->videodata->key_layout[wParam]);
357
358
}
}
359
360
returnCode = 0;
break;
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
case WM_CHAR:
{
char text[4];
/* Convert to UTF-8 and send it on... */
if (wParam <= 0x7F) {
text[0] = (char) wParam;
text[1] = '\0';
} else if (wParam <= 0x7FF) {
text[0] = 0xC0 | (char) ((wParam >> 6) & 0x1F);
text[1] = 0x80 | (char) (wParam & 0x3F);
text[2] = '\0';
} else {
text[0] = 0xE0 | (char) ((wParam >> 12) & 0x0F);
text[1] = 0x80 | (char) ((wParam >> 6) & 0x3F);
text[2] = 0x80 | (char) (wParam & 0x3F);
text[3] = '\0';
}
380
SDL_SendKeyboardText(text);
381
}
382
383
returnCode = 0;
break;
384
385
#ifdef WM_INPUTLANGCHANGE
386
387
case WM_INPUTLANGCHANGE:
{
388
WIN_UpdateKeymap();
389
}
390
391
returnCode = 1;
break;
392
#endif /* WM_INPUTLANGCHANGE */
393
394
#ifdef WM_GETMINMAXINFO
395
396
397
398
399
400
401
case WM_GETMINMAXINFO:
{
MINMAXINFO *info;
RECT size;
int x, y;
int w, h;
int style;
402
BOOL menu;
403
404
/* If we allow resizing, let the resize happen naturally */
405
if(SDL_IsShapedWindow(data->window))
406
Win32_ResizeWindowShape(data->window);
407
if (SDL_GetWindowFlags(data->window) & SDL_WINDOW_RESIZABLE) {
408
409
returnCode = 0;
break;
410
411
412
413
414
415
416
417
}
/* Get the current position of our window */
GetWindowRect(hwnd, &size);
x = size.left;
y = size.top;
/* Calculate current size of our window */
418
SDL_GetWindowSize(data->window, &w, &h);
419
420
421
422
423
size.top = 0;
size.left = 0;
size.bottom = h;
size.right = w;
424
425
426
427
428
style = GetWindowLong(hwnd, GWL_STYLE);
#ifdef _WIN32_WCE
menu = FALSE;
#else
429
430
431
432
433
/* DJM - according to the docs for GetMenu(), the
return value is undefined if hwnd is a child window.
Aparently it's too difficult for MS to check
inside their function, so I have to do it here.
*/
434
435
436
menu = (style & WS_CHILDWINDOW) ? FALSE : (GetMenu(hwnd) != NULL);
#endif
AdjustWindowRectEx(&size, style, menu, 0);
437
438
439
440
441
442
443
444
445
446
447
448
449
450
w = size.right - size.left;
h = size.bottom - size.top;
/* Fix our size to the current size */
info = (MINMAXINFO *) lParam;
info->ptMaxSize.x = w;
info->ptMaxSize.y = h;
info->ptMaxPosition.x = x;
info->ptMaxPosition.y = y;
info->ptMinTrackSize.x = w;
info->ptMinTrackSize.y = h;
info->ptMaxTrackSize.x = w;
info->ptMaxTrackSize.y = h;
}
451
452
returnCode = 0;
break;
453
#endif /* WM_GETMINMAXINFO */
454
455
456
457
458
459
460
461
case WM_WINDOWPOSCHANGED:
{
RECT rect;
int x, y;
int w, h;
Uint32 window_flags;
462
463
464
465
if (!GetClientRect(hwnd, &rect) ||
(rect.right == rect.left && rect.bottom == rect.top)) {
break;
}
466
467
468
ClientToScreen(hwnd, (LPPOINT) & rect);
ClientToScreen(hwnd, (LPPOINT) & rect + 1);
469
window_flags = SDL_GetWindowFlags(data->window);
470
471
472
473
474
475
476
if ((window_flags & SDL_WINDOW_INPUT_GRABBED) &&
(window_flags & SDL_WINDOW_INPUT_FOCUS)) {
ClipCursor(&rect);
}
x = rect.left;
y = rect.top;
477
SDL_SendWindowEvent(data->window, SDL_WINDOWEVENT_MOVED, x, y);
478
479
480
w = rect.right - rect.left;
h = rect.bottom - rect.top;
481
SDL_SendWindowEvent(data->window, SDL_WINDOWEVENT_RESIZED, w,
482
483
484
485
486
487
h);
}
break;
case WM_SETCURSOR:
{
488
489
490
491
Uint16 hittest;
hittest = LOWORD(lParam);
if (hittest == HTCLIENT) {
492
SetCursor(SDL_cursor);
493
returnCode = TRUE;
494
}
495
496
497
498
499
500
501
502
503
}
break;
/* We were occluded, refresh our display */
case WM_PAINT:
{
RECT rect;
if (GetUpdateRect(hwnd, &rect, FALSE)) {
ValidateRect(hwnd, &rect);
504
SDL_SendWindowEvent(data->window, SDL_WINDOWEVENT_EXPOSED,
505
506
507
0, 0);
}
}
508
509
returnCode = 0;
break;
510
511
512
513
514
515
516
/* We'll do our own drawing, prevent flicker */
case WM_ERASEBKGND:
{
}
return (1);
517
#if defined(SC_SCREENSAVE) || defined(SC_MONITORPOWER)
518
519
520
521
522
case WM_SYSCOMMAND:
{
/* Don't start the screensaver or blank the monitor in fullscreen apps */
if ((wParam & 0xFFF0) == SC_SCREENSAVE ||
(wParam & 0xFFF0) == SC_MONITORPOWER) {
523
if (SDL_GetVideoDevice()->suspend_screensaver) {
524
525
526
527
528
return (0);
}
}
}
break;
529
#endif /* System has screensaver support */
530
531
532
case WM_CLOSE:
{
533
SDL_SendWindowEvent(data->window, SDL_WINDOWEVENT_CLOSE, 0, 0);
534
}
535
536
returnCode = 0;
break;
537
538
case WM_TOUCH:
539
540
541
{
UINT i, num_inputs = LOWORD(wParam);
PTOUCHINPUT inputs = SDL_stack_alloc(TOUCHINPUT, num_inputs);
542
if (data->videodata->GetTouchInputInfo((HTOUCHINPUT)lParam, num_inputs, inputs, sizeof(TOUCHINPUT))) {
543
RECT rect;
544
545
546
547
548
549
550
float x, y;
if (!GetClientRect(hwnd, &rect) ||
(rect.right == rect.left && rect.bottom == rect.top)) {
break;
}
ClientToScreen(hwnd, (LPPOINT) & rect);
551
552
553
554
555
556
557
558
ClientToScreen(hwnd, (LPPOINT) & rect + 1);
rect.top *= 100;
rect.left *= 100;
rect.bottom *= 100;
rect.right *= 100;
for (i = 0; i < num_inputs; ++i) {
PTOUCHINPUT input = &inputs[i];
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
SDL_TouchID touchId = (SDL_TouchID)input->hSource;
if (!SDL_GetTouch(touchId)) {
SDL_Touch touch;
touch.id = touchId;
touch.x_min = 0;
touch.x_max = 1;
touch.native_xres = touch.x_max - touch.x_min;
touch.y_min = 0;
touch.y_max = 1;
touch.native_yres = touch.y_max - touch.y_min;
touch.pressure_min = 0;
touch.pressure_max = 1;
touch.native_pressureres = touch.pressure_max - touch.pressure_min;
if (SDL_AddTouch(&touch, "") < 0) {
continue;
}
578
579
580
581
582
583
}
// Get the normalized coordinates for the window
x = (float)(input->x - rect.left)/(rect.right - rect.left);
y = (float)(input->y - rect.top)/(rect.bottom - rect.top);
584
if (input->dwFlags & TOUCHEVENTF_DOWN) {
585
586
SDL_SendFingerDown(touchId, input->dwID, SDL_TRUE, x, y, 1);
}
587
if (input->dwFlags & TOUCHEVENTF_MOVE) {
588
589
SDL_SendTouchMotion(touchId, input->dwID, SDL_FALSE, x, y, 1);
}
590
if (input->dwFlags & TOUCHEVENTF_UP) {
591
592
593
594
595
596
597
SDL_SendFingerDown(touchId, input->dwID, SDL_FALSE, x, y, 1);
}
}
}
SDL_stack_free(inputs);
data->videodata->CloseTouchInputHandle((HTOUCHINPUT)lParam);
598
return 0;
599
600
601
}
break;
}
602
603
604
605
606
607
608
609
/* If there's a window proc, assume it's going to handle messages */
if (data->wndproc) {
return CallWindowProc(data->wndproc, hwnd, msg, wParam, lParam);
} else if (returnCode >= 0) {
return returnCode;
} else {
return CallWindowProc(DefWindowProc, hwnd, msg, wParam, lParam);
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
}
}
void
WIN_PumpEvents(_THIS)
{
MSG msg;
while (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
static int app_registered = 0;
LPTSTR SDL_Appname = NULL;
Uint32 SDL_Appstyle = 0;
HINSTANCE SDL_Instance = NULL;
/* Register the class for this application */
int
SDL_RegisterApp(char *name, Uint32 style, void *hInst)
{
WNDCLASS class;
/* Only do this once... */
if (app_registered) {
++app_registered;
return (0);
}
if (!name && !SDL_Appname) {
name = "SDL_app";
641
#if defined(CS_BYTEALIGNCLIENT) || defined(CS_OWNDC)
642
SDL_Appstyle = (CS_BYTEALIGNCLIENT | CS_OWNDC);
643
#endif
644
645
646
647
648
649
650
651
652
653
654
SDL_Instance = hInst ? hInst : GetModuleHandle(NULL);
}
if (name) {
SDL_Appname = WIN_UTF8ToString(name);
SDL_Appstyle = style;
SDL_Instance = hInst ? hInst : GetModuleHandle(NULL);
}
/* Register the application class */
class.hCursor = NULL;
655
656
657
class.hIcon =
LoadImage(SDL_Instance, SDL_Appname, IMAGE_ICON, 0, 0,
LR_DEFAULTCOLOR);
658
659
660
661
662
class.lpszMenuName = NULL;
class.lpszClassName = SDL_Appname;
class.hbrBackground = NULL;
class.hInstance = SDL_Instance;
class.style = SDL_Appstyle;
663
class.lpfnWndProc = WIN_WindowProc;
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
class.cbWndExtra = 0;
class.cbClsExtra = 0;
if (!RegisterClass(&class)) {
SDL_SetError("Couldn't register application class");
return (-1);
}
app_registered = 1;
return (0);
}
/* Unregisters the windowclass registered in SDL_RegisterApp above. */
void
SDL_UnregisterApp()
{
WNDCLASS class;
/* SDL_RegisterApp might not have been called before */
if (!app_registered) {
return;
}
--app_registered;
if (app_registered == 0) {
/* Check for any registered window classes. */
if (GetClassInfo(SDL_Instance, SDL_Appname, &class)) {
UnregisterClass(SDL_Appname, SDL_Instance);
}
SDL_free(SDL_Appname);
SDL_Appname = NULL;
}
}
/* vi: set ts=4 sw=4 expandtab: */