Share via


Main Window [Kinect Studio]

Kinect for Windows 1.5, 1.6, 1.7, 1.8

The Main window controls all operations, including live preview, recording, and playback.

Figure 1.  The main window with a connected application and an active selection

Hh855400.k4w_studio_data_selection(en-us,IEB.10).png

Sections

  • Application Menus
  • Toolbar
  • Timeline
  • Status Bar

Application Menus

Kinect Studio provides the following menus:

File

The File menu provides the following commands:

View

The View menu provides the following commands:

Timeline

The Timeline menu provides the following commands:

  • Select Range
    Allows you to set the start time and duration of the playback range, in milliseconds.
  • Clear Selection (ESC)
    Resets the playback range to the entire timeline.
  • Save Range As
    Saves the selected range of the timeline to an Xbox event data file. For more information about saving data, see Saving Event Data for a Kinect-Enabled Application [Kinect Studio].
  • Set Suspend Point
    Opens the Suspend Point dialog box, which allows you to add a suspend point to a stream. Playback will be suspended when it reaches the event with the specified timestamp. For more information about suspending playback, see Playing Event Data for a Kinect-Enabled Application [Kinect Studio].
  • Clear Suspend Point
    Clears the current suspend point.

Tools

The Tools menu provides the following commands:

  • Options
    Opens the Options dialog box, which allows you to set up a directory where you can save temporary event data files.

Help

The Help menu provides the following commands:

  • Contents (F1)
    Opens the SDK documentation.
  • About Kinect Studio
    Shows version and copyright information.

Toolbar

The toolbar contains the following tools:

  • Hh855400.k4w_studio_open(en-us,IEB.10).jpg Open (CTRL+O)
         Opens an event data file (.xed).
  • Hh855400.k4w_studio_save(en-us,IEB.10).jpg Save (CTRL+S)
         Saves the current recording to an event data file. For more information about saving data, see Saving Event Data for a Kinect-Enabled Application [Kinect Studio].
  • Hh855400.k4w_studio_connect(en-us,IEB.10).jpg Connect/Disconnect
         Connects Kinect Studio with a Kinect application that is using a Kinect sensor. If you already have a connection, clicking the button will disconnect the application/sensor pair. The button is green when connected and red when disconnected.
  • Hh855400.k4w_studio_preview(en-us,IEB.10).jpg Live Preview (CTRL+L)
         Puts Kinect Studio into live preview mode. For more information about live preview mode and playback mode, see Viewing Event Data for a Kinect-Enabled Application [Kinect Studio] and Playing Event Data for a Kinect-Enabled Application [Kinect Studio].
  • Hh855400.k4w_studio_play_app(en-us,IEB.10).jpg Play in Application
         Plays data in the application. For more information about playback, see Playing Event Data for a Kinect-Enabled Application [Kinect Studio].
  • Hh855400.k4w_studio_loop(en-us,IEB.10).jpg Loop (CTRL+P)
         Continuously loops playback of the timeline or of the selected range of the timeline.
  • Hh855400.k4w_studio_first_event(en-us,IEB.10).jpg First Event (HOME)
         Moves the current position of the timeline to the first event.
  • Hh855400.k4w_studio_previous_event(en-us,IEB.10).jpg Previous Event (LEFT ARROW)
         Moves the current position of the timeline to the previous event.
  • Hh855400.k4w_studio_play(en-us,IEB.10).jpg Play/Pause (F5)
         Starts or pauses playback of recorded event data. For more information about playback, see Playing Event Data for a Kinect-Enabled Application [Kinect Studio].
  • Hh855400.k4w_studio_stop(en-us,IEB.10).jpg Stop (SHIFT+F5)
         Stops recording or playback. Stopping playback resets the cursor to the beginning of the playback range.
  • Hh855400.k4w_studio_record(en-us,IEB.10).jpg Record (CTRL+R)
         Starts recording the data from the sensor array. For more information about recording data, see Recording Event Data for a Kinect-Enabled Application [Kinect Studio].
  • Hh855400.k4w_studio_next_event(en-us,IEB.10).jpg Next Event (RIGHT ARROW)
         Moves the current position of the timeline to the next event.
  • Hh855400.k4w_studio_last_event(en-us,IEB.10).jpg Last Event (END)
         Moves the current position of the timeline to the last event.
  • Hh855400.k4w_studio_single_step(en-us,IEB.10).jpg Single Step (F10)
         Advances the current position of each stream by a single event.

The toolbar also shows time information about the file. While recording, it shows the elapsed time since recording began. During playback of data, it shows the elapsed time from the beginning of the data as well as the total length of the data. If you select a range of the timeline, it also shows the time of the start and end of the selected range.

Timeline

The timeline shows information about the .xed file opened in Kinect Studio. It shows timing information for all events in the data streams received from the sensor array. It also shows and controls the current position of playback of the file, and allows you to specify a range of events for playback. Identity events that are part of the same identity operation are grouped together in the timeline.

The timeline contains a grid that allows you to specify which streams to view, record, play back, and single step. Kinect Studio saves the stream options for a local connection separately from the options for a remote connection.

You can select a range for playback by dragging on the timeline. During playback, only this range will be played. For more information about selecting and deselecting a playback range, see Playing Event Data for a Kinect-Enabled Application [Kinect Studio].

The timeline has two cursors:

  • The inspection cursor follows the position of the mouse cursor. It controls which position in the timeline is displayed in the viewer windows when playback is stopped.
  • You can move the playback cursor by clicking the timeline. It controls the location at which playback will begin when playing sensor array data. It also tracks the current position in the timeline during playback. If a range is selected in the timeline, clicking outside of the range will clear the selection.

Note

When you are moving the inspection cursor, a viewer window can be empty if that part of the timeline does not contain an event for the related data. This is expected behavior.

By default, the timeline shows the entire file. To view more detailed timing information for the events received in each data stream from the sensor array, you can control the zoom factor of the timeline by using the horizontal zoom controls or by rotating the mouse wheel forward or backward.

Stream Grid

The stream grid determines how color and depth data is used for each of the stream types:

Live Preview Recording Playback Single Step
Show color/depth in live preview Record color/depth Playback color/depth Show color/depth in playback

For keyboard accessibility, navigate to each of the color and depth checkboxes using the numeric keys 1, 2, 3, and 4 to select the first, second, third or fourth column in the color row; click the same numeric key a second time to select a checkbox in the depth row. Toggle the space bar to check/uncheck the checkbox.

Hh855400.k4w_studio_stream_grid(en-us,IEB.10).png

Timeline Zoom Controls

The zoom controls for the timeline are located to the right of the horizontal scroll bar. The following controls are provided:

  • Hh855400.xboxstudio_button_zoomtoselection(en-us,IEB.10).png Zoom to Selection
         Zooms the timeline so that the selected range always fills the window, even as you resize it. If there is not a selected range, the timeline zooms so that the entire timeline is displayed.
  • Hh855400.xboxstudio_button_zoomout(en-us,IEB.10).png Horizontal Zoom Out (-)
         Zooms out on the timeline.
  • Hh855400.xboxstudio_button_zoomin(en-us,IEB.10).png Horizontal Zoom In (+)
         Zooms in on the timeline.

Status Bar

The status bar shows the information listed in the following table.

Information Description
Connection status Indicates whether Kinect Studio is connected as well as the connected application.
Current operation Shows the operation that Kinect Studio is performing.