Enum KeyboardIgnoreModifiers 

pub enum KeyboardIgnoreModifiers {
    None,
    AbcKeyCode,
}

Settings for whether to ignore modifiers and use standard keyboard layouts instead.

This does not affect piston::input::TextEvent.

Piston uses the same key codes as in SDL2. The problem is that without knowing the keyboard layout, there is no coherent way of generating key codes.

This option choose different tradeoffs depending on need.

Variants

None

Keep the key codes that are affected by modifiers.

This is a good default for most applications. However, make sure to display understandable information to the user.

If you experience user problems among gamers, then you might consider allowing other options in your game engine. Some gamers might be used to how stuff works in other traditional game engines and struggle understanding this configuration, depending on how you use keyboard layout.

AbcKeyCode

Assume the user’s keyboard layout is standard English ABC.

In some non-English speaking countries, this might be more user friendly for some gamers.

This might sound counter-intuitive at first, so here is the reason:

Gamers can customize their keyboard layout without needing to understand scan codes. When gamers want physically accuracy with good default options, they can simply use standard English ABC.

In other cases, this option displays understandable information for game instructions. This information makes it easier for users to correct the problem themselves.

Most gaming consoles use standard controllers. Typically, the only device that might be problematic for users is the keyboard. Instead of solving this problem in your game engine, let users do it in the OS.

This option gives more control to users and is also better for user data privacy. Detecting keyboard layout is usually not needed. Instead, provide options for the user where they can modify the keys. If users want to switch layout in the middle of a game, they can do it through the OS.

Trait Implementations

impl Clone for KeyboardIgnoreModifiers

fn clone(&self) -> KeyboardIgnoreModifiers

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for KeyboardIgnoreModifiers

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for KeyboardIgnoreModifiers

fn eq(&self, other: &KeyboardIgnoreModifiers) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for KeyboardIgnoreModifiers

impl Eq for KeyboardIgnoreModifiers

impl StructuralPartialEq for KeyboardIgnoreModifiers