Class Input

Gets an AEOutput device from the DeviceManager given its name or its capabilities. The capabilities list may include strings naming AEInput interfaces ("braille" and/or "system input" at present).

If neither is specified, the first available output device in the DeviceManager is returned.

Parameters:

• name (string) - Class (UIE) name of the AEInput device to get
• capabilities (list of string) - Names of capabilities required on the device

Returns: AEInput

The named output device

Raises:

• InvalidDeviceError - When the specified AEInput device is not found

Adds the given device code as a modifier on the named AEInput device. If the device doesn't support modifiers, ignores the error since it's a non-critical operation.

Parameters:

• dev (AEInput) - Reference to an input device
• codes (integer) - Action codes to add as modifiers

Removes the given device code as a modifier on the named AEInput device. If the device doesn't support modifiers, ignores the error since it's a non-critical operation.

Parameters:

• dev (AEInput) - Reference to an input device
• codes (integer) - Action codes to add as modifiers

Registers a Task in this Perk to be executed in response to an AEEvent indicating that the given action codes were input on the given AEInput device.

Parameters:

• dev (AEInput) - Device to monitor for input
• task_ident (string) - Name of the Task registered via Task.Tools.System.System.registerTask to execute when the input gesture is detected on the device
• propagate (boolean) - Should the input gesture be allowed to propagate to the OS after we receive it?
• codes (list of list of integer) - List of lists of action codes forming the AEInput.Gesture that will trigger the execution of the named Task. For example, codes=[[Keyboard.AEK_CTRL, Keyboard.AEK_TILDE]] indicates the single gesture of simultaneously pressing Ctrl and ~ on the keyboard device.

Raises:

• ValueError - When a Task with the given name is not registered
• InvalidDeviceError - When a AEInput device with the given name is not registered

Unregisters a Task set to execute in response to the given action codes on the given device from this Perk only.

Parameters:

• dev (AEInput) - Device to monitor for input
• codes (list of list of integer) - List of lists of action codes forming the AEInput.Gesture that will trigger the execution of the named Task. For example, codes=[[Keyboard.AEK_CTRL, Keyboard.AEK_TILDE]] indicates the single gesture of simultaneously pressing Ctrl and ~ on the keyboard device.

Raises:

• KeyError - When a AEInput.GestureList is not registered
• InvalidDeviceError - When a AEInput device with the given name is not registered