Tools

Tools & Modes to Create, Select, Edit and Modify

This page details the (separate) operation modes of user interface tools and devices (keyboard, mouse, 6DOF, etc.) You may also want to look at the general overview of User Commands.

Input Devices & Tool Mode

The tool mode determines what type of nodes are created, selected and modified. Each indicator works a little differently and independently. Currently, there are (*up to) 4 HUD items in the toolbar that display the tool mode:

• Keyboard & Mouse
  • [mode: (node type) ] - Type of nodes to operate on (Camera, Grid, Glyph...)
  • [tool: (tool type) ] - Tool type to use (described below).
    • Note that the keyboard (Game Mode) can directly access many tools, but certain tools change it's behavior (see below for details).
• [3Dmouse: (tool) ] - Used for modifying glyphs and navigation:
  • Camera - (Blue) Fly or Orbit (XYZ) the currently selected camera.
  • Glyph - (Red) Modify the actively selected glyphs (and grids).
• [zStylus: (tool) ] - Similar to the regular mouse tools with additional 6DOF interation.

*Note that the [3Dmouse: (tool) ] and [zStylus: (tool) ] are only visible when a SpaceMouse or zSpace device is installed.

The [mode: (node type) ] determines which node types to operate on:

• Camera - Navigates the scene (Fly, Orbit (XY/XZ), Look (XY)) .
• Grid - Allows selecting, modifying and creating new grids.
  • Changing to 'mode: Grid' does NOT select a grid, however if in Grid mode, pressing G key will select the next grid.
  • Note that grids are ONLY clickable in 'mode: Grid', though it is also possible to select a sub-grid by using the Arrow Keys to traverse hyperglyphs.
• Glyph - Allows selecting, modifying and creating new glyphs.
  • 3 fundamental glyph types:
    • Standard Glyph or just plain Glyph has a variety of topo types (solo or part of a hyperglyph tree), but excluding the special glyph types Link and Grid.
    • Link glyphs allow bridging across (hyperglyph) tree hierarchies, allowing any two glyphs in the scene to be connected.
    • Grid glyphs topo = grid, and it interacts differently with the user interface and also resets the branch level of it's child glyphs, starting with root glyphs level = 1.
• *We plan to add a mode for Lights & HUD (custom user interface).

Create

• Create - Tool (N key) will generate a new node based on the current mode and selection.
  • mode: Camera - Will generate a new camera attached to the root camera.
    • *Future feature - Camera's can be attached to sub-grids.
  • mode: Grid - Will generate a new sub-grid attached to the currently selected node (the parent can be either a glyph or grid).
  • mode: Glyph - If a root glyph is currently selected (or no glyphs at all) then a new root glyph (pin) with sub-torus is created and auto-distributed (based on number of siblings) onto the current (root or sub) grid. Otherwise a new glyph is attached as a child, with distribution and topo type based on the parent glyphs topo.
    • Note that if you wish to attach a child to a root glyph you need to press Shift+N key combo.

Select

• Allows you to select glyphs (or grids) by picking individual items, branches or selecting a region (with filters).

• [Link]

  • L-Click on the 'A' link end and then select the 'B' link end.
  • R-Click cancels and resets for picking the 'A' link end.

• [Combo]

  • L-Hold drags selected objects in XY (L-R & Forward-Back).
  • R-Hold scale objects up/down.

• [Move]

  • L-Hold moves objects in XY (L-R & Forward-Back).
  • R-Hold moves objects in XZ (L-R & Up-Down).

• [Rotate]

  • L-Hold rotates objects on X & Y axes (Heading, Tilt).
  • R-Hold rotates objects on Z axes (Roll)

• [Hide]

  • R-Click to Hide all sub-branches of selected node.
  • L-Click to un-Hide sub-branches.
  • See Keyboard Game Mode commands below for hiding per branch level, etc.

• [Topo], [Geometry], [Color], [Texture]

  • L-Click for next (topo type, index color, texture map, etc...).
  • R-Click for previous type.

• [Text Tag]

  • L-Click to select a glyph, and then use keyboard to modify or enter a new tag.
    • Repeating L-Click on the same glyph will change it's draw style (color, size).
  • R-Click will hide the tag (but the text will be retained).
  • You can exit Tag Console and return keyboard to Game Mode by pressing 'Esc'.
    • In Game Mode (with Text Tag tool) you can hide all tags with ` (left single quote).
    • Enter - will return you back to the Tag Console.

• Hidden Tools - accessible via scrollwheel

  • [Alpha] - Changes glyph opacity (transparency).
  • [Channel] - An animation channel subscribes selected nodes to tracks. Each node (glyph, camera, grid, etc.) can be subscribed to an input channel and a seperate *output channel. The channels are defined in the 'np_ch' table and map columns from the 'np_track' table directly to any node attribute. Multiple nodes can use the same input channel (*but only one node can write to an output channel.)
    • *Feature feature will support output channel ('ch_out' field in the 'np_node' table).
  • [Freeze] - Freezes animation and editing.
  • [Set High] - Restricts the max position of a glyph to current location.
  • [Set Low] - Restricts the minimum position (is specific to active axes X key).