Editing Functions Previous Next Setting User Preferences

Chapter 5, Getting Familiar with Your Workspace
Hotkey Editor



The Hotkey Editor enables you to save different Hotkey Catalogs, and share these Catalogs with other users. Use the Hotkey Editor to manage hot keys (keyboard shortcuts).

The Hotkey Editor allows you to:

Hotkey Dispatching Top

The new hotkey dispatching mechanism ensures that local hotkeys are processed before any global ones. This removes your viewer from any unnecessary constraints, and will mimic the hotkey dispatching workflow of Autodesk IFFFS products.

Default Hotkeys and Domains Top
Default Hotkeys

Toxik now has only one file that contains all the default hotkeys. This file will be located in /resources/resTables/defaultHotkeys.xml. The default hotkeys will be grouped in domains.

For example:

Show full-size image

Hotkeys are composed of four elements.

Hotkey Domains

The default hotkeys file contains a list of domains each comprising a list of hotkeys.

Global Domain

The "Global" domain contains hotkey actions that are not bound to a specific context. When a hotkey is triggered, if the hotkey is not processed locally, then it will be treated as a global hotkey.

Local Domain

The "Local" domain contains hotkey actions that are bound to a specific module or context in Toxik. When a hotkey is triggered in the context of a tool or over a certain viewer for example, this hotkey will be processed by this local domain.

Local domains may contain sub domains. These sub domains allow you to create domains on the same level that will use or share common parent domain hotkeys. For example, in Toxik, hotkeys for different types of viewers are stored in the parent domain /local/viewers. The player and the schematic each have their own local domain under /Local/viewers/player, and /Local/viewers/schematic respectively. Any hotkey found in /Local/viewers will be inherited by these two sub domains. This is what we call hotkey sharing.

Hotkey Catalogs Top

Toxik introduces a new Hotkeys Catalog concept. Catalogs are place holders for user defined hotkeys. In other words, when a user modifies a hotkey through the Hotkey Editor, the hotkey entry is added to the active Catalog, keeping track of all customized hotkeys.

How Catalogs Work

Catalogs are stored in the Hotkey Catalogs subfolder of the user home folder. Catalogs can be subsequently moved to the /Project folder and shared with other users. Like Color Palettes, only one Catalog can be active at any time. The active Catalog can be chosen through the Hotkey Editor. When modifying hotkeys, if no Catalog exist for the current user, a new Catalog will be created automatically.

When starting Toxik, the default hotkeys are registered in the hotkey registry and organized into the specified domains. If you have a Hotkey Catalog active, the hotkeys in the registry will be overwritten by the hotkeys found in the Catalog. When resetting a hotkey or a hotkey domain, Toxik will remove these hotkeys from the active Catalog, and reset the hotkeys to the Toxik defaults from the default hotkeys resource file.

Managing Catalogs

Creation and deletion of Catalogs can be done through the Hotkey Catalogs subfolder of the user home folder found in the Library Browser. However, deleting a Catalog will not automatically reset all the hotkeys in the registry. Remember that a Catalog is simply a place holder of your user defined hotkeys.

Also, like any other database objects found in the user home folder, you can move Catalogs around, copy them, and archive them for sharing.

Show full-size image

Hotkey Editor Top

The Hotkey Editor allows you to modify all the hotkeys described in the default Toxik hotkey resource file.

Hotkey Editor Overview

The Hotkey Editor is a browser displaying all the hotkeys grouped into domains. Domains act as folders, and hotkeys as leafs of these domains.

Show full-size image

The hotkeys displayed are those found in the default Toxik hotkeys resource file and the current active Hotkey Catalog--see Hotkey Catalogs.

The active Hotkey Catalog is displayed in the Catalog menu at the bottom of the Hotkey Editor.

Note: You can manage the Catalogs from the Library Browser in the hotkeys subfolder of the user home folder, which is similar to how Color Palettes work.

The browser section of the Hotkey Editor is composed of four columns.

Accessing the Hotkey Editor

The Hotkey Editor can be accessed through the global hotkey Ctrl + H, which may also be changed by the user. The Hotkey Editor can also be accessed through the Toxik menu bar (Edit > Hotkeys).

Show full-size image

Editing a Hotkey

Editing hotkeys can be done two ways.

To edit a hotkey:
Conflicting Hotkeys

Conflicting hotkey rows in the Hotkey Editor are displayed in red.

To resolve a conflicting hotkey:
  1. Right-click a conflicting hotkey to see the "Go To Conflict" option.

  2. Choosing this option on the menu, or pressing the F3 hotkey will take you to the conflicting hotkey, select it, then turn the learning state ON. This allows you to edit a conflicting hotkey on the fly.

Hotkey Format

Toxik has a hotkey format standard that needs to be followed in order for a hotkey to be valid. When creating and editing hotkeys, the following keystroke conventions apply:

The formatting will be handled by Toxik automatically, meaning that as soon as you release the last key, the hotkey string is automatically generated, and entered in the value editor.

Resetting Hotkeys
To reset a hotkey:
  1. Right-click a hotkey in the Hotkey Editor.

  2. Select Reset.

    This will reset to the Toxik default and remove the hotkey entry from the active Catalog.

To reset all hotkeys:
  1. Right-click a hotkey in the Hotkey Editor.

  2. Select All.

  3. Select Reset.

    All Toxik hotkeys are reset and hotkey entries are removed from the active Catalog.

Previous Next