include/rdp_keymap.h

   1
   2 /* ***** BEGIN LICENSE BLOCK *****
   3  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
   4  *
   5  * The contents of this file are subject to the Mozilla Public License Version
   6  * 1.1 (the "License"); you may not use this file except in compliance with
   7  * the License. You may obtain a copy of the License at
   8  * http://www.mozilla.org/MPL/
   9  *
  10  * Software distributed under the License is distributed on an "AS IS" basis,
  11  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  12  * for the specific language governing rights and limitations under the
  13  * License.
  14  *
  15  * The Original Code is libguac-client-rdp.
  16  *
  17  * The Initial Developer of the Original Code is
  18  * Michael Jumper.
  19  * Portions created by the Initial Developer are Copyright (C) 2011
  20  * the Initial Developer. All Rights Reserved.
  21  *
  22  * Contributor(s):
  23  *
  24  * Alternatively, the contents of this file may be used under the terms of
  25  * either the GNU General Public License Version 2 or later (the "GPL"), or
  26  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  27  * in which case the provisions of the GPL or the LGPL are applicable instead
  28  * of those above. If you wish to allow use of your version of this file only
  29  * under the terms of either the GPL or the LGPL, and not to allow others to
  30  * use your version of this file under the terms of the MPL, indicate your
  31  * decision by deleting the provisions above and replace them with the notice
  32  * and other provisions required by the GPL or the LGPL. If you do not delete
  33  * the provisions above, a recipient may use your version of this file under
  34  * the terms of any one of the MPL, the GPL or the LGPL.
  35  *
  36  * ***** END LICENSE BLOCK ***** */
  37
  38 #ifndef _GUAC_RDP_RDP_KEYMAP_H
  39 #define _GUAC_RDP_RDP_KEYMAP_H
  40
  41 /**
  42  * Represents a keysym-to-scancode mapping for RDP, with extra information
  43  * about the state of prerequisite keysyms.
  44  */
  45 typedef struct guac_rdp_scancode_map {
  46
  47     /**
  48      * The scancode this keysym maps to.
  49      */
  50     int scancode;
  51
  52     /**
  53      * Required RDP-specific flags
  54      */
  55     int flags;
  56
  57     /**
  58      * Null-terminated list of keysyms which must be down for this keysym
  59      * to be properly typed.
  60      */
  61     const int* set_keysyms;
  62
  63     /**
  64      * Null-terminated list of keysyms which must be up for this keysym
  65      * to be properly typed.
  66      */
  67     const int* clear_keysyms;
  68
  69 } guac_rdp_scancode_map;
  70
  71 /**
  72  * Represents the Alt-code which types a given keysym. This is used as a
  73  * fallback mapping, should a particular keymap not support a certain keysym.
  74  *
  75  * See: http://en.wikipedia.org/wiki/Alt_code
  76  */
  77 typedef struct guac_rdp_altcode_map {
  78
  79     /**
  80      * The 4-digit Alt-code which types this keysym.
  81      */
  82     const char* altcode;
  83
  84 } guac_rdp_altcode_map;
  85
  86 /**
  87  * Mapping from keysym to current state
  88  */
  89 typedef int guac_rdp_keysym_state_map[256][256];
  90
  91 /**
  92  * Static mapping from keysyms to scancodes.
  93  */
  94 typedef guac_rdp_scancode_map guac_rdp_keysym_scancode_map[256][256];
  95
  96 /**
  97  * Static mapping from keysyms to Alt-codes.
  98  */
  99 typedef guac_rdp_altcode_map guac_rdp_keysym_altcode_map[256][256];
 100
 101 /**
 102  * Map of X11 keysyms to RDP scancodes (US English).
 103  */
 104 extern const guac_rdp_keysym_scancode_map guac_rdp_keysym_scancode_en_us;
 105
 106 /**
 107  * Map of X11 keysyms to Windows Alt-codes.
 108  */
 109 extern const guac_rdp_keysym_altcode_map guac_rdp_keysym_altcode;
 110
 111 /**
 112  * Simple macro for referencing the mapped value of an altcode or scancode for a given keysym.
 113  */
 114 #define GUAC_RDP_KEYSYM_LOOKUP(keysym_mapping, keysym) ((keysym_mapping)[((keysym) & 0xFF00) >> 8][(keysym) & 0xFF])
 115
 116 /**
 117  * Keysym string containing only the left "shift" key.
 118  */
 119 extern const int GUAC_KEYSYMS_SHIFT[];
 120
 121 #endif
 122