ATI Remote Wonder Key Mapper

Introduction

The Key Mapper plug-in for the ATI Remote Wonder allows you to set the function of every button on the remote control. Additionally, you can have things happen when certain sequences of buttons are pressed. The plug-in has not been tested much, so it's likely to be buggy.

Download Key Mapper v 1.1.0.1 Plug-In

Configuration Screen: Main Dialog

1. Control Set Selector: Use this to select the control set to edit. The control set selected here when you click OK will become the active control set.
2. New Set Button: Use this to create a new control set.
3. Delete Set Button: Use this to delete a control set (you cannot delete the Default control set).
4. Edit Processes Button: Use this to edit which processes map to which control sets.
5. Buttons Tab: Allows you to edit the functions of the various buttons on the Remote Wonder.
6. Sequences Tab: Allows you to assign functions to various sequences of button presses.
7. Page Tabs: Use these to switch among the available pages of buttons or sequences.
8. Enable Checkbox: If the checkbox is not checked, the Key Mapper ignores the particular button event, allowing other plug-ins or the Remote Wonder itself to handle the event.
9. This depends on the tab selected:
   1. (Buttons Tab) Button Event Label: Indicates the button event on which to perform the desired action. There are three events for each button:
      • Released: The particular button has been let up by the user.
      • Pushed: The particular button has been pushed down by the user.
      • Held: This event repeats every so often (determined by the Remote Wonder's settings) for as long as the button is held down.
   2. (Sequences Tab) Sequence Editbox (Not Pictured): The sequence for which you wish to assign an action goes in this editbox. Each button in the sequence is separated by a comma. Here is a list of button names for use in sequences.
10. Action Selector: Use this to select the action to perform (more on those later). After making a selection, a dialog will appear allowing you to provide information for the action.
11. Action Description: A brief description of the action to be performed.
12. Edit Button: Clicking this will bring up the dialog for the selected action. The effect is identical to reselecting the action in the Action Selector.
13. OK Button: Click this to save changes and exit the configuration screen.
14. Cancel Button: Click this to discard changes and exit the configuration screen.
15. Settings Button: Use this to edit the settings of the currently selected control set.

Sequences

Now, let me provide a few notes about sequences:

• A list of button names for use in sequences can be found here.
• Only the action of the first sequence matched to the button presses will be performed. So if you had sequences 1,2,3 and 1,2,3,4, the sequence 1,2,3,4 would never be matched because 1,2,3 would always be matched first.
• Depending on your settings, when any button of sequence is pressed or when just the final button of a sequence is pressed, actions for the button events of that button press may or may not be performed. This only applies to the Pushed events.
• To remove a sequence from the Key Mapper, simply leave its Sequence Editbox blank.

Settings

1. Sequence: Timeout: This specifies the maximum number of milliseconds to wait between button presses in a sequence. If the the time between presses is greater than this value, the program discards the previous button presses in any current sequences.
2. Sequence: Disable button action (Note: This option only affects Pushed events. Released and Held events are uneffected.)
   • Never: Sequences have no effect on whether or not the actions of any button events are executed.
   • When a sequence is completed: When a button event completes a sequence, the action for that event is not executed. For example, if you have the sequence 1,2,3, then the actions for the button event for 1 and 2 will be executed but the button event for 3 will not be.
   • When part of a sequence is matched: When a button event continues or begins a sequence, the actions for that event is not executed. For example, if you have the sequence 1,2,3, then the actions for the button event for 1, 2, and 3 will NOT be executed.
3. OK Button: Save changes and close the dialog.
4. Cancel Button: Discard changes and close the dialog.

Control Sets

A control set is simply a paired button map and sequence map, so each control set has both a Buttons tab and a Sequences tab. Only one control set may be in use at any given time. There is one special control set called the Default control set. If it is not the active control set, then any button events or sequence matches ignored by the active control set may be acted upon by the Default control set.

There are two ways to set the active control set: through an action or by selecting the control set on the configuration screen and clicking OK.

Processes Map

1. Process: The process being mapped to a control set. This must match the end of the path to the process.
2. Control Set: When the "Control Set: Activate based on focus" action occurs and if a window of the corresponding process has focus, this control set is activated.
3. Add Button: Add a new process to control set map entry.
4. Edit Button: Edit the selected entry.
5. Delete Button: Delete the selected entry.
6. OK Button: Save changes and close the dialog.
7. Cancel Button: Discard changes and close the dialog.

Actions

• No Action: The Key Mapper prevents anything from being done for this event, even by other plug-ins or the Remote Wonder itself.
• Run Program: Executes the specified program.
• Use Keyboard: Simulates the pressing or holding of keys on the keyboard.
• Use Mouse: NOT IMPLEMENTED
• Control Set: This can be used perform an action involving control sets. Those actions are as follows:
  1. Activate: Activates the specified control set.
  2. Defer To: Performs the action of the button event or sequence of the specified control set.
  3. Activate based on focus: Activates a control set based on the process of the window with focus. It uses the process to control set map (Edit Processes Button) to select the control set to actiuvate. If the process is not in the list, the Defaul control set is activated.
• Window Message: Sends a message to the desired window. I have compiled a list of useful messages for certain applications. There are a few ways to specify the desired window:
  1. Window with focus: Sends a message to owner window of the window with focus.
  2. Window that determined last control set activation: Sends a message to the owner window of the window that had focus the last time a "Control Set: Activate based on focus" was successfully performed.

List of Button Names

Back to Bumderland