NAME

SYNOPSIS

DESCRIPTION

The devid is provided by input devices and is thus discovered dynamically, but it can also be indirectly probed by sweeping negative indices in the way shown in the example further below.

The action can be one out of: TRANSLATION_CLEAR , TRANSLATION_SET and TRANSLATION_REMAP . TRANSLATION_CLEAR is to revert as close to as the initial state as possible. TRANSLATION_MAP is to set/override a complete map. TRANSLATION_REMAP is to add a specific remapping.

The set of string arguments following the action will be raw-forwarded to the input platform and is thus platform dependent.

The constant API_ENGINE_BUILD can be used to obtain which input platform is currently in use, which mutates the interpretation and effect of the various actions.

A false result means that the feature is not supported by the platform, and reason is set to some short error message.

NOTES

1

for the 'evdev' platform, the order and contents of the argument strings corresponds to xkb 'layout' -> 'model' -> 'variant' -> 'options'

2

EXAMPLE

function input_remap_translation0()
      if string.match(API_ENGINE_BUILD, "evdev") then
            local ind = -1
            while (input_remap_translation(ind, TRANSLATION_SET,
                  "us,cz,de", "logicordless", "basic", "grp:alt_shift_toggle")) do
                  ind = ind - 1
            end
      end
end

EXAMPLE

function input_remap_translation1()
      local err, msg = input_remap_translation(6666, TRANSLATION_CLEAR)
      if err then
            warning(msg)
      end
end

SEE ALSO: