src/video/SDL_sysvideo.h
changeset 2303 d87417504c75
parent 2268 4baee598306d
child 2360 96411dcd2267
child 2540 56cf872c723a
child 2669 e27bdcc80744
     1.1 --- a/src/video/SDL_sysvideo.h	Mon Feb 04 17:25:33 2008 +0000
     1.2 +++ b/src/video/SDL_sysvideo.h	Tue Feb 05 07:19:23 2008 +0000
     1.3 @@ -257,45 +257,6 @@
     1.4       */
     1.5      void (*PumpEvents) (_THIS);
     1.6  
     1.7 -    /* Get the layout key code corresponding to the given physical key code
     1.8 -     * according to the OS' current keyboard layout.
     1.9 -     *
    1.10 -     * - For character keys, this should return the Unicode code point of the
    1.11 -     * character that is generated when the key is pressed without shift or
    1.12 -     * any other modifiers.
    1.13 -     * - For non-character keys, this should return one of the SDLK_* constants
    1.14 -     * (usually the argument itself since these keys are typically layout-
    1.15 -     * independent). Make sure that all of these values returned by this
    1.16 -     * function have a suitable name defined, either the default from
    1.17 -     * SDL_keynames.h, or one set using SDL_SetKeyName() in VideoInit(). In
    1.18 -     * particular, if this function can return any of the codes whose default
    1.19 -     * names start with "SDLK_" (usually, it shouldn't, since these are layout-
    1.20 -     * dependent character keys), these names should be replaced by proper
    1.21 -     * user-readable names.
    1.22 -     * - If there are keys that cannot be adequately described by either a
    1.23 -     * single Unicode character or an SDLK_* constant, this function may return
    1.24 -     * a code with SDL_KEY_LAYOUT_SPECIAL_BIT set in the most significant byte
    1.25 -     * and an arbitrary value in the less significant 3 bytes. The
    1.26 -     * GetSpecialKeyName() function must then be implemented to take this code
    1.27 -     * and return a human-readable key name for it.
    1.28 -     * If the argument is not a physical key code or if translation of the key
    1.29 -     * code by the OS' keyboard layout fails for any reason, the argument must
    1.30 -     * be returned unchanged.
    1.31 -     *
    1.32 -     * On platforms that don't have the notion of a user-configurable keyboard
    1.33 -     * layout, this may be left unimplemented. The default implementation of
    1.34 -     * SDL_GetLayoutKey() then acts as the identity. The note about defining
    1.35 -     * key names above particularly applies in this case.
    1.36 -     */
    1.37 -      SDLKey(*GetLayoutKey) (_THIS, SDLKey physicalKey);
    1.38 -
    1.39 -    /* Get a human-readable name for a special layout key code.
    1.40 -     * This only needs to be implemented if this driver's implementation of
    1.41 -     * GetLayoutKey() generates such codes (with SDL_KEY_LAYOUT_SPECIAL_BIT
    1.42 -     * set) - see above.
    1.43 -     */
    1.44 -    const char *(*GetSpecialKeyName) (_THIS, SDLKey layoutKey);
    1.45 -
    1.46      /* * * */
    1.47      /* Data common to all drivers */
    1.48      int num_displays;