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
Sections
- Application Menus
- Toolbar
- Timeline
- Status Bar
Application Menus
Kinect Studio provides the following menus:
File
The File menu provides the following commands:
- Open (CTRL+O)
Opens an Xbox event data file (.xed). For more information about opening an .xed file, see Loading Event Data for a Kinect-Enabled Application [Kinect Studio]. - Close
Closes the current Xbox event data file. - Save (CTRL+S)
Saves the current recording to an Xbox event data file. For more information about saving data, see Saving Event Data for a Kinect-Enabled Application [Kinect Studio]. - Exit (ALT+F4)
Exits Kinect Studio.
View
The View menu provides the following commands:
- Color
Toggles display of the Color Viewer window. For more information, see Color Viewer Window [Kinect Studio]. - Depth
Toggles display of the Depth Viewer window. For more information, see Depth Viewer Window [Kinect Studio]. - 3D View
Toggles display of the 3D Viewer window. For more information, see 3D Viewer Window [Kinect Studio].
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:
Open (CTRL+O)
Opens an event data file (.xed).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].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.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].Play in Application
Plays data in the application. For more information about playback, see Playing Event Data for a Kinect-Enabled Application [Kinect Studio].Loop (CTRL+P)
Continuously loops playback of the timeline or of the selected range of the timeline.First Event (HOME)
Moves the current position of the timeline to the first event.Previous Event (LEFT ARROW)
Moves the current position of the timeline to the previous event.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].Stop (SHIFT+F5)
Stops recording or playback. Stopping playback resets the cursor to the beginning of the playback range.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].Next Event (RIGHT ARROW)
Moves the current position of the timeline to the next event.Last Event (END)
Moves the current position of the timeline to the last event.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.
Timeline Zoom Controls
The zoom controls for the timeline are located to the right of the horizontal scroll bar. The following controls are provided:
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.Horizontal Zoom Out (-)
Zooms out on the timeline.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. |