Navigation

Tokens

Last update: August 16th 2024

Tokens are visual representations of elements on the Board in Alkemion Studio. They serve as the graphical instances that you interact with during the creation and organization of your Modules. Each Token corresponds to an Asset on the Board: a Node, a Widget or an Anchor.

Screenshot of the BoardScreenshot of the BoardScreenshot of the Board

Multiple vs Unique Tokens

With the exception of Groups, Nodes can have several Tokens on the Board to represent them. In addition, each Token belonging to the same Node share the same image, but can have its own visual customization settings.

Group Nodes can only be represented once on the Board, through a single Token. This limitation is linked to their specific role as containers for other Tokens.

Screenshot of the Board's context menu

An Anchor can be represented by several Tokens on the Board, and just like Node Tokens, each can have its own visual customization settings.

A Widget is different in nature from a Node in that it is merely a decorative or illustrative element within a Board. This nature makes the Widget a Token in itself, and it exists only through its unique representation on the Board.

Adding a Widget to a Module imposes its presence on the Board via its unique Token. And deleting a Widget's Token from a Board means deleting the Widget from the Module.

Screenshot of multiple Tokens on a Board

Token Selection

To select a Token, click (or tap) on it.

To select multiple Tokens, hold down the Ctrl key, or click on the board and create a selection area by dragging the mouse. The same can be achieved on touch devices by tapping and dragging.

Screenshot of a node token's context menuScreenshot of a text widget's context menu

Once Tokens are selected, several actions can be performed: they can be deleted by pressing the Del key or dragged across the Board.

Additional actions are available in the Contextual Menus.


Contextual Menus

Right-clicking on a Token will display a contextual menu with various actions (or a long press on touch devices). Some of these actions can also be applied to a selection of Tokens (see Token Selection).

Screenshot of a node token's context menuScreenshot of a text widget's context menuScreenshot of an image widget's context menu

The details of the available actions are described below:

Lock Token and Unlock Token will respectively lock and unlock the Token. A locked Token cannot be moved or selected. A contextual menu with a limited set of actions can still be triggered on a locked Token.

Token Settings will open the Settings Panel for the Token. The panel offers visual customization options and link configurations that vary by Asset type; Node Tokens and Widget Tokens each provide different settings.

Duplicate Token will create a new Token with the exact same settings and position it right next to the original.

Bring to Front and Send to Back will change the display layer of the Token so that it appears on top of or below any overlapping Tokens.

Create a Template will open the Create Template dialog and let you create a new Template containing the Token (along with its parent Node), and any other selected Assets.

The following options are only available for Node Tokens:

Edit Node will open the Token's parent Node in the Editor.

Info Panel will open the parent Node's Information Panel in a floating window (or a modal window on small screens). This panel contains the essential information about the Node.

Link a Node and Unlink a Node will allow you to link the Token's parent Node to another Node or to remove one of the current links. The first action will open a Node selection modal, whereas the second will directly list the current links in a sub-menu.

Link a Random Table, Change Random Table and Unlink the Random Table: The first option will allow you to link the Node to a Random Table. A modal window will let you select one of the available Random Tables. The second option will let you change the linked Random Table with the same modal window. The third option will unlink the currently linked Random Table.

Featured Image will open the Image Browser and let you pick a new Featured Image for the Token's parent Node.

Delete Token will delete the Token, but it won't delete the parent Node.

The following options are only available for Widget Tokens:

Delete Widget will delete the Widget and its unique Token.

The following options are only available for Anchor Tokens:

Travel to Module will transport the Board to the Module set in the Anchor.

Delete Token will delete the Token, but it won't delete the parent Anchor.


Duplicating Tokens

To duplicate one or more Tokens, first select the Tokens you wish to duplicate (see Token Selection for more details about this).

Once selected, you can duplicate the Tokens in two ways:

  • Right-click to open the contextual menu and choose the 'Duplicate Tokens' option.
  • Use the keyboard shortcut Ctrl + D.

The duplicated Tokens will appear adjacent to the original ones and will retain all the same settings and properties as the originals.


Token Settings Window

The Token Settings Window, accessible via a Token's contextual menu, provides various customization options specific to the selected Token.

If a Node contains multiple Tokens, the settings will apply only to the currently selected one. Available customization options in this window depend on the Asset type.

Below are the options available to a Node Token:

Token Settings Window of a Node - General TabToken Settings Window of a Node - Links Tab

Below are the options available to a Widget Token:

Token Settings Window of a Widget

Below are the options available to an Anchor Token:

Token Settings Window of an Anchor