0032433: Visualization, TKService - introduce Wasm_Window implementing Aspect_Window...
[occt.git] / src / Wasm / Wasm_Window.cxx
1 // Created by: Kirill Gavrilov
2 // Copyright (c) 2021 OPEN CASCADE SAS
3 //
4 // This file is part of Open CASCADE Technology software library.
5 //
6 // This library is free software; you can redistribute it and/or modify it under
7 // the terms of the GNU Lesser General Public License version 2.1 as published
8 // by the Free Software Foundation, with special exception defined in the file
9 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
10 // distribution for complete text of the license and disclaimer of any warranty.
11 //
12 // Alternatively, this file may be used under the terms of Open CASCADE
13 // commercial license or contractual agreement.
14
15 #include <Wasm_Window.hxx>
16
17 #include <Aspect_ScrollDelta.hxx>
18 #include <Aspect_WindowInputListener.hxx>
19
20 #if defined(__EMSCRIPTEN__)
21   #include <emscripten.h>
22   #include <emscripten/html5.h>
23   #include <emscripten/key_codes.h>
24 #endif
25
26 IMPLEMENT_STANDARD_RTTIEXT(Wasm_Window, Aspect_Window)
27
28 // =======================================================================
29 // function : Wasm_Window
30 // purpose  :
31 // =======================================================================
32 Wasm_Window::Wasm_Window (const TCollection_AsciiString& theCanvasId,
33                           const bool theToScaleBacking)
34 : myCanvasId (theCanvasId),
35   mySize (0),
36   myDevicePixelRatio (1.0),
37   myToScaleBacking (theToScaleBacking),
38   myIsMapped (true)
39 {
40 #if defined(__EMSCRIPTEN__)
41   myDevicePixelRatio = emscripten_get_device_pixel_ratio();
42   emscripten_get_canvas_element_size (myCanvasId.ToCString(), &mySize.x(), &mySize.y());
43   if (myToScaleBacking)
44   {
45     myDevicePixelRatio = emscripten_get_device_pixel_ratio();
46     Graphic3d_Vec2d aCssSize;
47     emscripten_get_element_css_size (myCanvasId.ToCString(), &aCssSize.x(), &aCssSize.y());
48     Graphic3d_Vec2i aCanvasSize = Graphic3d_Vec2i (aCssSize * myDevicePixelRatio);
49     if (aCanvasSize != mySize)
50     {
51       mySize = aCanvasSize;
52       emscripten_set_canvas_element_size (myCanvasId.ToCString(), aCanvasSize.x(), aCanvasSize.y());
53       emscripten_set_element_css_size    (myCanvasId.ToCString(), aCssSize.x(),    aCssSize.y());
54     }
55   }
56 #endif
57 }
58
59 // =======================================================================
60 // function : ~Wasm_Window
61 // purpose  :
62 // =======================================================================
63 Wasm_Window::~Wasm_Window()
64 {
65   //
66 }
67
68 // =======================================================================
69 // function : DoResize
70 // purpose  :
71 // =======================================================================
72 Aspect_TypeOfResize Wasm_Window::DoResize()
73 {
74   if (IsVirtual())
75   {
76     return Aspect_TOR_UNKNOWN;
77   }
78
79 #if defined(__EMSCRIPTEN__)
80   emscripten_get_canvas_element_size (myCanvasId.ToCString(), &mySize.x(), &mySize.y());
81   if (myToScaleBacking)
82   {
83     myDevicePixelRatio = emscripten_get_device_pixel_ratio();
84     Graphic3d_Vec2d aCssSize;
85     emscripten_get_element_css_size (myCanvasId.ToCString(), &aCssSize.x(), &aCssSize.y());
86     Graphic3d_Vec2i aCanvasSize = Graphic3d_Vec2i (aCssSize * myDevicePixelRatio);
87     if (aCanvasSize != mySize)
88     {
89       mySize = aCanvasSize;
90       emscripten_set_canvas_element_size (myCanvasId.ToCString(), aCanvasSize.x(), aCanvasSize.y());
91       emscripten_set_element_css_size    (myCanvasId.ToCString(), aCssSize.x(),    aCssSize.y());
92     }
93   }
94 #endif
95   return Aspect_TOR_UNKNOWN;
96 }
97
98 // =======================================================================
99 // function : Ratio
100 // purpose  :
101 // =======================================================================
102 Standard_Real Wasm_Window::Ratio() const
103 {
104   Graphic3d_Vec2i aCanvasSize = mySize;
105   if (!IsVirtual())
106   {
107   #if defined(__EMSCRIPTEN__)
108     emscripten_get_canvas_element_size (myCanvasId.ToCString(), &aCanvasSize.x(), &aCanvasSize.y());
109   #endif
110   }
111
112   return (aCanvasSize.x() != 0 && aCanvasSize.y() != 0)
113         ? Standard_Real(aCanvasSize.x()) / Standard_Real(aCanvasSize.y())
114         : 1.0;
115 }
116
117 // =======================================================================
118 // function : Position
119 // purpose  :
120 // =======================================================================
121 void Wasm_Window::Position (Standard_Integer& theX1, Standard_Integer& theY1,
122                             Standard_Integer& theX2, Standard_Integer& theY2) const
123 {
124   theX1 = 0;
125   theY1 = 0;
126   if (IsVirtual())
127   {
128     theX2 = mySize.x();
129     theY2 = mySize.y();
130     return;
131   }
132
133 #if defined(__EMSCRIPTEN__)
134   emscripten_get_canvas_element_size (myCanvasId.ToCString(), &theX2, &theY2);
135 #endif
136 }
137
138 // =======================================================================
139 // function : Size
140 // purpose  :
141 // =======================================================================
142 void Wasm_Window::Size (Standard_Integer& theWidth,
143                         Standard_Integer& theHeight) const
144 {
145   if (IsVirtual())
146   {
147     theWidth  = mySize.x();
148     theHeight = mySize.y();
149     return;
150   }
151
152 #if defined(__EMSCRIPTEN__)
153   emscripten_get_canvas_element_size (myCanvasId.ToCString(), &theWidth, &theHeight);
154 #endif
155 }
156
157 // =======================================================================
158 // function : SetSizeLogical
159 // purpose  :
160 // =======================================================================
161 void Wasm_Window::SetSizeLogical (const Graphic3d_Vec2d& theSize)
162 {
163   mySize = Graphic3d_Vec2i (theSize * myDevicePixelRatio);
164   if (IsVirtual())
165   {
166     return;
167   }
168
169 #if defined(__EMSCRIPTEN__)
170   emscripten_set_canvas_element_size (myCanvasId.ToCString(), mySize.x(),  mySize.y());
171   emscripten_set_element_css_size    (myCanvasId.ToCString(), theSize.x(), theSize.y());
172 #endif
173 }
174
175 // =======================================================================
176 // function : SetSizeBacking
177 // purpose  :
178 // =======================================================================
179 void Wasm_Window::SetSizeBacking (const Graphic3d_Vec2i& theSize)
180 {
181   mySize = theSize;
182   if (IsVirtual())
183   {
184     return;
185   }
186
187 #if defined(__EMSCRIPTEN__)
188   Graphic3d_Vec2i aCanvasSize = mySize;
189   Graphic3d_Vec2d aCssSize = Graphic3d_Vec2d (mySize) / myDevicePixelRatio;
190   emscripten_set_canvas_element_size (myCanvasId.ToCString(), aCanvasSize.x(), aCanvasSize.y());
191   emscripten_set_element_css_size    (myCanvasId.ToCString(), aCssSize.x(),    aCssSize.y());
192 #endif
193 }
194
195 // =======================================================================
196 // function : InvalidateContent
197 // purpose  :
198 // =======================================================================
199 void Wasm_Window::InvalidateContent (const Handle(Aspect_DisplayConnection)& )
200 {
201   //
202 }
203
204 // =======================================================================
205 // function : ProcessMessage
206 // purpose  :
207 // =======================================================================
208 bool Wasm_Window::ProcessMessage (Aspect_WindowInputListener& theListener,
209                                   int theEventType, const void* theEvent)
210 {
211 #if defined(__EMSCRIPTEN__)
212   switch (theEventType)
213   {
214     case EMSCRIPTEN_EVENT_MOUSEMOVE:
215     case EMSCRIPTEN_EVENT_MOUSEDOWN:
216     case EMSCRIPTEN_EVENT_MOUSEUP:
217     case EMSCRIPTEN_EVENT_CLICK:
218     case EMSCRIPTEN_EVENT_DBLCLICK:
219     case EMSCRIPTEN_EVENT_MOUSEENTER:
220     case EMSCRIPTEN_EVENT_MOUSELEAVE:
221     {
222       return ProcessMouseEvent (theListener, theEventType, (const EmscriptenMouseEvent* )theEvent);
223     }
224     case EMSCRIPTEN_EVENT_TOUCHSTART:
225     case EMSCRIPTEN_EVENT_TOUCHMOVE:
226     case EMSCRIPTEN_EVENT_TOUCHEND:
227     case EMSCRIPTEN_EVENT_TOUCHCANCEL:
228     {
229       return ProcessTouchEvent (theListener, theEventType, (const EmscriptenTouchEvent* )theEvent);
230     }
231     case EMSCRIPTEN_EVENT_WHEEL:
232     {
233       return ProcessWheelEvent (theListener, theEventType, (const EmscriptenWheelEvent* )theEvent);
234     }
235     case EMSCRIPTEN_EVENT_KEYDOWN:
236     case EMSCRIPTEN_EVENT_KEYUP:
237     case EMSCRIPTEN_EVENT_KEYPRESS:
238     {
239       return ProcessKeyEvent (theListener, theEventType, (const EmscriptenKeyboardEvent* )theEvent);
240     }
241     case EMSCRIPTEN_EVENT_RESIZE:
242     case EMSCRIPTEN_EVENT_CANVASRESIZED:
243     {
244       return ProcessUiEvent (theListener, theEventType, (const EmscriptenUiEvent* )theEvent);
245     }
246   }
247   return false;
248 #else
249   (void )theListener;
250   (void )theEventType;
251   (void )theEvent;
252   return false;
253 #endif
254 }
255
256 // =======================================================================
257 // function : ProcessMouseEvent
258 // purpose  :
259 // =======================================================================
260 bool Wasm_Window::ProcessMouseEvent (Aspect_WindowInputListener& theListener,
261                                      int theEventType, const EmscriptenMouseEvent* theEvent)
262 {
263 #if defined(__EMSCRIPTEN__)
264   const Graphic3d_Vec2d aNewPos2d = ConvertPointToBacking (Graphic3d_Vec2d (theEvent->targetX, theEvent->targetY));
265   const Graphic3d_Vec2i aNewPos2i = Graphic3d_Vec2i (aNewPos2d + Graphic3d_Vec2d (0.5));
266   Aspect_VKeyFlags aFlags = 0;
267   if (theEvent->ctrlKey  == EM_TRUE) { aFlags |= Aspect_VKeyFlags_CTRL;  }
268   if (theEvent->shiftKey == EM_TRUE) { aFlags |= Aspect_VKeyFlags_SHIFT; }
269   if (theEvent->altKey   == EM_TRUE) { aFlags |= Aspect_VKeyFlags_ALT;   }
270   if (theEvent->metaKey  == EM_TRUE) { aFlags |= Aspect_VKeyFlags_META;  }
271
272   const bool isEmulated = false;
273   const Aspect_VKeyMouse aButtons = Wasm_Window::MouseButtonsFromNative (theEvent->buttons);
274   switch (theEventType)
275   {
276     case EMSCRIPTEN_EVENT_MOUSEMOVE:
277     {
278       if ((aNewPos2i.x() < 0 || aNewPos2i.x() > mySize.x()
279         || aNewPos2i.y() < 0 || aNewPos2i.y() > mySize.y())
280         && theListener.PressedMouseButtons() == Aspect_VKeyMouse_NONE)
281       {
282         return false;
283       }
284       if (theListener.UpdateMousePosition (aNewPos2i, aButtons, aFlags, isEmulated))
285       {
286         theListener.ProcessInput();
287       }
288       break;
289     }
290     case EMSCRIPTEN_EVENT_MOUSEDOWN:
291     case EMSCRIPTEN_EVENT_MOUSEUP:
292     {
293       if (aNewPos2i.x() < 0 || aNewPos2i.x() > mySize.x()
294        || aNewPos2i.y() < 0 || aNewPos2i.y() > mySize.y())
295       {
296         return false;
297       }
298       if (theListener.UpdateMouseButtons (aNewPos2i, aButtons, aFlags, isEmulated))
299       {
300         theListener.ProcessInput();
301       }
302       break;
303     }
304     case EMSCRIPTEN_EVENT_CLICK:
305     case EMSCRIPTEN_EVENT_DBLCLICK:
306     {
307       if (aNewPos2i.x() < 0 || aNewPos2i.x() > mySize.x()
308        || aNewPos2i.y() < 0 || aNewPos2i.y() > mySize.y())
309       {
310         return false;
311       }
312       break;
313     }
314     case EMSCRIPTEN_EVENT_MOUSEENTER:
315     {
316       break;
317     }
318     case EMSCRIPTEN_EVENT_MOUSELEAVE:
319     {
320       // there is no SetCapture() support, so that mouse unclick events outside canvas will not arrive,
321       // so we have to forget current state...
322       if (theListener.UpdateMouseButtons (aNewPos2i, Aspect_VKeyMouse_NONE, aFlags, isEmulated))
323       {
324         theListener.ProcessInput();
325       }
326       break;
327     }
328   }
329   return true;
330 #else
331   (void )theListener;
332   (void )theEventType;
333   (void )theEvent;
334   return false;
335 #endif
336 }
337
338 // =======================================================================
339 // function : ProcessWheelEvent
340 // purpose  :
341 // =======================================================================
342 bool Wasm_Window::ProcessWheelEvent (Aspect_WindowInputListener& theListener,
343                                      int theEventType, const EmscriptenWheelEvent* theEvent)
344 {
345 #if defined(__EMSCRIPTEN__)
346   if (theEventType != EMSCRIPTEN_EVENT_WHEEL)
347   {
348     return false;
349   }
350
351   const Graphic3d_Vec2d aNewPos2d = ConvertPointToBacking (Graphic3d_Vec2d (theEvent->mouse.targetX, theEvent->mouse.targetY));
352   const Graphic3d_Vec2i aNewPos2i = Graphic3d_Vec2i (aNewPos2d + Graphic3d_Vec2d (0.5));
353   if (aNewPos2i.x() < 0 || aNewPos2i.x() > mySize.x()
354    || aNewPos2i.y() < 0 || aNewPos2i.y() > mySize.y())
355   {
356     return false;
357   }
358
359   double aDelta = 0.0;
360   switch (theEvent->deltaMode)
361   {
362     case DOM_DELTA_PIXEL:
363     {
364       aDelta = theEvent->deltaY / (5.0 * DevicePixelRatio());
365       break;
366     }
367     case DOM_DELTA_LINE:
368     {
369       aDelta = theEvent->deltaY * 8.0;
370       break;
371     }
372     case DOM_DELTA_PAGE:
373     {
374       aDelta = theEvent->deltaY >= 0.0 ? 24.0 : -24.0;
375       break;
376     }
377   }
378   aDelta /= 15.0;
379
380   if (theListener.UpdateMouseScroll (Aspect_ScrollDelta (aNewPos2i, -aDelta)))
381   {
382     theListener.ProcessInput();
383   }
384   return true;
385 #else
386   (void )theListener;
387   (void )theEventType;
388   (void )theEvent;
389   return false;
390 #endif
391 }
392
393 // =======================================================================
394 // function : ProcessTouchEvent
395 // purpose  :
396 // =======================================================================
397 bool Wasm_Window::ProcessTouchEvent (Aspect_WindowInputListener& theListener,
398                                      int theEventType, const EmscriptenTouchEvent* theEvent)
399 {
400   bool hasUpdates = false;
401 #if defined(__EMSCRIPTEN__)
402   if (theEventType != EMSCRIPTEN_EVENT_TOUCHSTART
403    && theEventType != EMSCRIPTEN_EVENT_TOUCHMOVE
404    && theEventType != EMSCRIPTEN_EVENT_TOUCHEND
405    && theEventType != EMSCRIPTEN_EVENT_TOUCHCANCEL)
406   {
407     return false;
408   }
409
410   for (int aTouchIter = 0; aTouchIter < theEvent->numTouches; ++aTouchIter)
411   {
412     const EmscriptenTouchPoint& aTouch = theEvent->touches[aTouchIter];
413     if (!aTouch.isChanged)
414     {
415       continue;
416     }
417
418     const Standard_Size aTouchId = (Standard_Size )aTouch.identifier;
419
420     const Graphic3d_Vec2d aNewPos2d = ConvertPointToBacking (Graphic3d_Vec2d (aTouch.targetX, aTouch.targetY));
421     const Graphic3d_Vec2i aNewPos2i = Graphic3d_Vec2i (aNewPos2d + Graphic3d_Vec2d (0.5));
422     switch (theEventType)
423     {
424       case EMSCRIPTEN_EVENT_TOUCHSTART:
425       {
426         if (aNewPos2i.x() >= 0 && aNewPos2i.x() < mySize.x()
427          && aNewPos2i.y() >= 0 && aNewPos2i.y() < mySize.y())
428         {
429           hasUpdates = true;
430           theListener.AddTouchPoint (aTouchId, aNewPos2d);
431         }
432         break;
433       }
434       case EMSCRIPTEN_EVENT_TOUCHMOVE:
435       {
436         const int anOldIndex = theListener.TouchPoints().FindIndex (aTouchId);
437         if (anOldIndex != 0)
438         {
439           hasUpdates = true;
440           theListener.UpdateTouchPoint (aTouchId, aNewPos2d);
441         }
442         break;
443       }
444       case EMSCRIPTEN_EVENT_TOUCHEND:
445       case EMSCRIPTEN_EVENT_TOUCHCANCEL:
446       {
447         if (theListener.RemoveTouchPoint (aTouchId))
448         {
449           hasUpdates = true;
450         }
451         break;
452       }
453     }
454   }
455   if (hasUpdates)
456   {
457     theListener.ProcessInput();
458   }
459 #else
460   (void )theEventType;
461   (void )theEvent;
462 #endif
463   return hasUpdates || theListener.HasTouchPoints();
464 }
465
466 // =======================================================================
467 // function : ProcessKeyEvent
468 // purpose  :
469 // =======================================================================
470 bool Wasm_Window::ProcessKeyEvent (Aspect_WindowInputListener& theListener,
471                                    int theEventType, const EmscriptenKeyboardEvent* theEvent)
472 {
473 #if defined(__EMSCRIPTEN__)
474   if (theEventType != EMSCRIPTEN_EVENT_KEYDOWN
475    && theEventType != EMSCRIPTEN_EVENT_KEYUP
476    && theEventType != EMSCRIPTEN_EVENT_KEYPRESS)
477   {
478     return false;
479   }
480
481   const double aTimeStamp = theListener.EventTime();
482   const Aspect_VKey aVKey = Wasm_Window::VirtualKeyFromNative (theEvent->keyCode);
483   if (aVKey == Aspect_VKey_UNKNOWN)
484   {
485     return false;
486   }
487
488   switch (theEventType)
489   {
490     case EMSCRIPTEN_EVENT_KEYDOWN:
491     {
492       if (theEvent->repeat == EM_TRUE)
493       {
494         return false;
495       }
496
497       theListener.KeyDown (aVKey, aTimeStamp);
498       theListener.ProcessInput();
499       return false;
500     }
501     case EMSCRIPTEN_EVENT_KEYUP:
502     {
503       theListener.KeyUp (aVKey, aTimeStamp);
504       theListener.ProcessInput();
505       return false;
506     }
507   }
508 #else
509   (void )theListener;
510   (void )theEventType;
511   (void )theEvent;
512 #endif
513   return false;
514 }
515
516 // =======================================================================
517 // function : ProcessUiEvent
518 // purpose  :
519 // =======================================================================
520 bool Wasm_Window::ProcessUiEvent (Aspect_WindowInputListener& theListener,
521                                   int theEventType, const EmscriptenUiEvent* )
522 {
523 #if defined(__EMSCRIPTEN__)
524   if (theEventType != EMSCRIPTEN_EVENT_RESIZE
525    && theEventType != EMSCRIPTEN_EVENT_CANVASRESIZED)
526   {
527     return false;
528   }
529 #else
530   (void )theEventType;
531 #endif
532   theListener.ProcessConfigure (true);
533   return true;
534 }
535
536 // =======================================================================
537 // function : MouseButtonsFromNative
538 // purpose  :
539 // =======================================================================
540 Aspect_VKeyMouse Wasm_Window::MouseButtonsFromNative (unsigned short theButtons)
541 {
542   Aspect_VKeyMouse aButtons = Aspect_VKeyMouse_NONE;
543   if ((theButtons & 0x1) != 0)
544   {
545     aButtons |= Aspect_VKeyMouse_LeftButton;
546   }
547   if ((theButtons & 0x2) != 0)
548   {
549     aButtons |= Aspect_VKeyMouse_RightButton;
550   }
551   if ((theButtons & 0x4) != 0)
552   {
553     aButtons |= Aspect_VKeyMouse_MiddleButton;
554   }
555   return aButtons;
556 }
557
558 // =======================================================================
559 // function : VirtualKeyFromNative
560 // purpose  :
561 // =======================================================================
562 Aspect_VKey Wasm_Window::VirtualKeyFromNative (Standard_Integer theKey)
563 {
564 #if defined(__EMSCRIPTEN__)
565   if (theKey >= DOM_VK_0
566    && theKey <= DOM_VK_9)
567   {
568     // numpad keys
569     return Aspect_VKey((theKey - DOM_VK_0) + Aspect_VKey_0);
570   }
571   if (theKey >= DOM_VK_A
572    && theKey <= DOM_VK_Z)
573   {
574     // main latin alphabet keys
575     return Aspect_VKey((theKey - DOM_VK_A) + Aspect_VKey_A);
576   }
577   if (theKey >= DOM_VK_F1
578    && theKey <= DOM_VK_F24)
579   {
580     // special keys
581     if (theKey <= DOM_VK_F12)
582     {
583       return Aspect_VKey((theKey - DOM_VK_F1) + Aspect_VKey_F1);
584     }
585     return Aspect_VKey_UNKNOWN;
586   }
587   if (theKey >= DOM_VK_NUMPAD0
588    && theKey <= DOM_VK_NUMPAD9)
589   {
590     // numpad keys
591     return Aspect_VKey((theKey - DOM_VK_NUMPAD0) + Aspect_VKey_Numpad0);
592   }
593
594   switch (theKey)
595   {
596     case DOM_VK_CANCEL:
597     case DOM_VK_HELP:
598       return Aspect_VKey_UNKNOWN;
599     case DOM_VK_BACK_SPACE:
600       return Aspect_VKey_Backspace;
601     case DOM_VK_TAB:
602       return Aspect_VKey_Tab;
603     case DOM_VK_CLEAR:
604       return Aspect_VKey_UNKNOWN;
605     case DOM_VK_RETURN:
606     case DOM_VK_ENTER:
607       return Aspect_VKey_Enter;
608     case DOM_VK_SHIFT:
609       return Aspect_VKey_Shift;
610     case DOM_VK_CONTROL:
611       return Aspect_VKey_Control;
612     case DOM_VK_ALT:
613       return Aspect_VKey_Alt;
614     case DOM_VK_PAUSE:
615     case DOM_VK_CAPS_LOCK:
616     case DOM_VK_KANA:
617     //case DOM_VK_HANGUL:
618     case DOM_VK_EISU:
619     case DOM_VK_JUNJA:
620     case DOM_VK_FINAL:
621     case DOM_VK_HANJA:
622     //case DOM_VK_KANJI:
623       return Aspect_VKey_UNKNOWN;
624     case DOM_VK_ESCAPE:
625       return Aspect_VKey_Escape;
626     case DOM_VK_CONVERT:
627     case DOM_VK_NONCONVERT:
628     case DOM_VK_ACCEPT:
629     case DOM_VK_MODECHANGE:
630       return Aspect_VKey_UNKNOWN;
631     case DOM_VK_SPACE:
632       return Aspect_VKey_Space;
633     case DOM_VK_PAGE_UP:
634       return Aspect_VKey_PageUp;
635     case DOM_VK_PAGE_DOWN:
636       return Aspect_VKey_PageDown;
637     case DOM_VK_END:
638       return Aspect_VKey_End;
639     case DOM_VK_HOME:
640       return Aspect_VKey_Home;
641     case DOM_VK_LEFT:
642       return Aspect_VKey_Left;
643     case DOM_VK_UP:
644       return Aspect_VKey_Up;
645     case DOM_VK_RIGHT:
646       return Aspect_VKey_Right;
647     case DOM_VK_DOWN:
648       return Aspect_VKey_Down;
649     case DOM_VK_SELECT:
650     case DOM_VK_PRINT:
651     case DOM_VK_EXECUTE:
652     case DOM_VK_PRINTSCREEN:
653     case DOM_VK_INSERT:
654       return Aspect_VKey_UNKNOWN;
655     case DOM_VK_DELETE:
656       return Aspect_VKey_Delete;
657     case DOM_VK_COLON:
658       return Aspect_VKey_Comma;
659     case DOM_VK_SEMICOLON:
660       return Aspect_VKey_Semicolon;
661     case DOM_VK_LESS_THAN:
662       return Aspect_VKey_UNKNOWN;
663     case DOM_VK_EQUALS:
664       return Aspect_VKey_Equal;
665     case DOM_VK_GREATER_THAN:
666       return Aspect_VKey_UNKNOWN;
667     case DOM_VK_QUESTION_MARK:
668       return Aspect_VKey_Slash;
669     case DOM_VK_AT: // @ key
670       return Aspect_VKey_UNKNOWN;
671     case DOM_VK_WIN:
672       return Aspect_VKey_Meta;
673     case DOM_VK_CONTEXT_MENU:
674     case DOM_VK_SLEEP:
675       return Aspect_VKey_UNKNOWN;
676     case DOM_VK_MULTIPLY:
677       return Aspect_VKey_NumpadMultiply;
678     case DOM_VK_ADD:
679       return Aspect_VKey_NumpadAdd;
680     case DOM_VK_SEPARATOR:
681       return Aspect_VKey_UNKNOWN;
682     case DOM_VK_SUBTRACT:
683       return Aspect_VKey_NumpadSubtract;
684     case DOM_VK_DECIMAL:
685       return Aspect_VKey_UNKNOWN;
686     case DOM_VK_DIVIDE:
687       return Aspect_VKey_NumpadDivide;
688     case DOM_VK_NUM_LOCK:
689       return Aspect_VKey_Numlock;
690     case DOM_VK_SCROLL_LOCK:
691       return Aspect_VKey_Scroll;
692     case DOM_VK_WIN_OEM_FJ_JISHO:
693     case DOM_VK_WIN_OEM_FJ_MASSHOU:
694     case DOM_VK_WIN_OEM_FJ_TOUROKU:
695     case DOM_VK_WIN_OEM_FJ_LOYA:
696     case DOM_VK_WIN_OEM_FJ_ROYA:
697     case DOM_VK_CIRCUMFLEX:
698       return Aspect_VKey_UNKNOWN;
699     case DOM_VK_EXCLAMATION:
700     case DOM_VK_DOUBLE_QUOTE:
701     //case DOM_VK_HASH:
702     case DOM_VK_DOLLAR:
703     case DOM_VK_PERCENT:
704     case DOM_VK_AMPERSAND:
705     case DOM_VK_UNDERSCORE:
706     case DOM_VK_OPEN_PAREN:
707     case DOM_VK_CLOSE_PAREN:
708     case DOM_VK_ASTERISK:
709       return Aspect_VKey_UNKNOWN;
710     case DOM_VK_PLUS:
711       return Aspect_VKey_Plus;
712     case DOM_VK_PIPE:
713     case DOM_VK_HYPHEN_MINUS:
714       return Aspect_VKey_UNKNOWN;
715     case DOM_VK_OPEN_CURLY_BRACKET:
716       return Aspect_VKey_BracketLeft;
717     case DOM_VK_CLOSE_CURLY_BRACKET:
718       return Aspect_VKey_BracketRight;
719     case DOM_VK_TILDE:
720       return Aspect_VKey_Tilde;
721     case DOM_VK_VOLUME_MUTE:
722       return Aspect_VKey_VolumeMute;
723     case DOM_VK_VOLUME_DOWN:
724       return Aspect_VKey_VolumeDown;
725     case DOM_VK_VOLUME_UP:
726       return Aspect_VKey_VolumeUp;
727     case DOM_VK_COMMA:
728       return Aspect_VKey_Comma;
729     case DOM_VK_PERIOD:
730       return Aspect_VKey_Period;
731     case DOM_VK_SLASH:
732       return Aspect_VKey_Slash;
733     case DOM_VK_BACK_QUOTE:
734       return Aspect_VKey_UNKNOWN;
735     case DOM_VK_OPEN_BRACKET:
736       return Aspect_VKey_BracketLeft;
737     case DOM_VK_BACK_SLASH:
738       return Aspect_VKey_Backslash;
739     case DOM_VK_CLOSE_BRACKET:
740       return Aspect_VKey_BracketRight;
741     case DOM_VK_QUOTE:
742       return Aspect_VKey_UNKNOWN;
743     case DOM_VK_META:
744       return Aspect_VKey_Meta;
745     case DOM_VK_ALTGR:
746       return Aspect_VKey_Alt;
747     case DOM_VK_WIN_ICO_HELP:
748     case DOM_VK_WIN_ICO_00:
749     case DOM_VK_WIN_ICO_CLEAR:
750     case DOM_VK_WIN_OEM_RESET:
751     case DOM_VK_WIN_OEM_JUMP:
752     case DOM_VK_WIN_OEM_PA1:
753     case DOM_VK_WIN_OEM_PA2:
754     case DOM_VK_WIN_OEM_PA3:
755     case DOM_VK_WIN_OEM_WSCTRL:
756     case DOM_VK_WIN_OEM_CUSEL:
757     case DOM_VK_WIN_OEM_ATTN:
758     case DOM_VK_WIN_OEM_FINISH:
759     case DOM_VK_WIN_OEM_COPY:
760     case DOM_VK_WIN_OEM_AUTO:
761     case DOM_VK_WIN_OEM_ENLW:
762     case DOM_VK_WIN_OEM_BACKTAB:
763     case DOM_VK_ATTN:
764     case DOM_VK_CRSEL:
765     case DOM_VK_EXSEL:
766     case DOM_VK_EREOF:
767       return Aspect_VKey_UNKNOWN;
768     case DOM_VK_PLAY:
769       return Aspect_VKey_MediaPlayPause;
770     case DOM_VK_ZOOM:
771     case DOM_VK_PA1:
772     case DOM_VK_WIN_OEM_CLEAR:
773       return Aspect_VKey_UNKNOWN;
774   }
775 #else
776   (void )theKey;
777 #endif
778   return Aspect_VKey_UNKNOWN;
779 }