Using the Diagnostic Visualizer

This article describes the Leap Motion Diagnostic Visualizer tool that lets you view motion tracking data generated by the Leap Motion Controller. This article does not describe the consumer-facing visualizer.


The Visualizer application displays a variety of tracking data provided by the Leap Motion API and is a good way to get a feel for the data produced by the Leap. Start the Visualizer from the Troubleshooting page of the Leap Motion Settings dialog by clicking the Diagnostic Visualizer button.

Now move your hands in the Leap Motion controller’s field of view. You should see your fingers represented as colored arrows with trails following your finger tip locations.

General controls

You can control the Visualizer with key commands. Press H twice to display the available commands.

  • Esc — Quit the Visualizer.
  • H — Display the Visualizer framerate, Leap Motion framerate, and key commands.
  • S — Switch between windowed mode and fullscreen.
  • Z — Flip the positive and negative directions of the z-axis.
  • G — Toggle the coordinate grid.
  • J — Switch between black and blue or white and gray (Jony mode).
  • I — Toggle interpolation of finger tip trails.
  • Y — Toggle artistic drawing of finger tip trails.
  • L — Display tracking info, including labeled axes, field of view, finger tip coordinates, and processing latency.
  • T — Toggles the display of fingers and tools between lines and cylinders. In cylinder mode, the cylinders are colored differently depending on whether the Leap Motion software classifies the object as a tool or a finger. In line mode, a color is randomly assigned to each object when it is first recognized.
  • N — Cycles the display of palm tracking data between fingers only, palm plane, and hand ball modes.
  • F — Toggles the display of raw stereo images.
  • O — Toggles the display of gesture indicators.
  • P — Pauses and unpauses the visualization display.
  • B — Displays screen location visuals. Note that the Screen feature is not currently supported in the API.
  • . — Mirrors the screen contents in the visualizer window (screen location visuals must also be displayed for the mirrored monitor to be shown).
  • D — Toggles the touch emulation drawing mode.
  • Space - Clear the any drawing currently on screen.

Camera controls

The Visualizer displays finger tip trails in 3D space. You can control the camera with the following keys:

  • = — Zoom the camera in.
  • - — Zoom the camera out.
  • V — Cycle the camera between the view modes.
  • A — Automatically pan the camera to keep tracked fingers in view when they move near the edges.
  • C — Recenter the camera to place tracked fingers in the center of the view.
  • Left and right arrows — Start and stop view rotation in orthographic view.
  • Mouse click and drag — Rotate the camera in orthographic view.
  • Mouse right-click and drag — Pan the camera.

Tracking information

You can view additional information about the tracking data by pressing the L key.

The Leap Motion Visualizer showing additional tracking data.

In this mode:

  • Labeled axes are added to the grid, with scale measured in millimeters.
  • An inverted pyramid indicates the approximate field of view of the Leap Motion Controller.
  • The x, y, z coordinates of each detected finger tip’s position are shown, in millimeters.
  • A graph shows the amount of processing latency experienced over time, in milliseconds.