Video Displays


Creating a Video Display

When a video capture device is added to your system,  no display is created for it.  In order to see what the video, you need to create a video window and then add a plot.

You can create a video window from the Window menu on __prod_name's main window.





Video Window Overview

This section will give you a general overview of each of the parts of the video window.  There are more detailed descriptions of some of the sections after this overview.

1. Title Bar	The video window title bar will always display the name of the window along with the name of the video tracker that is displayed in this window.  Additional information can also be displayed in the window's title bar, such as whether or not the plot is frozen.
2. File Menu	This menu will expand to show some common window tasks.  See the detailed description of the video window's file menu.
3. Display Menu	This menu will expand to allow you to manipulate some of the display aspects of the video window.  See the detailed description of the video window's display menu.
4. Video Plot	Unlike the other types of plot windows, the video window can only contain a single plot. The entire window will be filled with the video image.  For more information on the video plot, see the video plot description .
4. PTZ Controls	Pan, Tilt and Zoom controls are available. The user can select the Left and Right arrows to pan the camera, the Up and Down arrows to tilt the camera and the + and - magnifying glasses to adjust the zoom. The small button in the corner of the panel will minimize the PTZ controls. Once the PTZ controls are minimized, the camera icon will appear. Pressing this icon will bring up the PTZ controls once again.
5. Close Window	Clicking on this X will close a window, exactly as it does for all Windows programs.  Closing a window will destroy the window.  This means that when you close a window, all of the display settings you have changed and plots you have added to the window will be lost.
6. Maximize Window	Clicking this button behaves the same as it does for all Windows programs on your system.
7. Minimize Window	Clicking this button will minimize this window to the bottom of the screen.  It will not minimize this window to the taskbar as it does with most Windows programs.

Video Window File Menu

1. Close Window	Clicking on tis menu option will close a window, exactly as it does for all Windows programs.  Closing a window will destroy the window.  This means that when you close a window, all of the display settings you have changed and plots you have added to the window will be lost.

Video Window Display Menu

1. Add Plot	Clicking this menu option will allow you to add a video tracker plot to this window.  Since the video window will only allow one plot per window, this option will not be available when there is already a plot in the window.  You must either remove the current plot and then add the new one, or add the plot to a new window.  When you select add plot, you will see the Acquisition Entity selection dialog.  This command can also be accessed by right clicking anywhere in the video window, if there is currently no plot in the window.
2. Remove Plot	This menu item will remove the current plot from the video window.  Once a plot is removed, nothing will be shown in the video window; since the video window can only show a single plot.  Removing a plot will erase all setting changes you have made to the plot.  If there are no plots in this window, this menu option will not be available.  This command can also be accessed by right clicking anywhere in the video window, if a plot is in the window.
3. Plot Type Selection	This menu item contains a sub menu listing the plot types available.   See Plot Type Selection under the Video Window and Plot Properties section for more details.
4. Clear Window	This will force the display to clear itself.  This is usually used when using overlay mode.  In addition to this menu command, you can press the C key with the window selected to clear the display.
5. Lock Window Size	When the window size is locked, you will see a check mark next to this option.  Locking the window size will disable resizing of the window.
6. Overlay	The overlay menu option will switch the window in and out of overlay mode.  When there is a check mark next to the menu item, this means the display is currently in overlay mode.  When in overlay mode, the window will show each subsequent video frame overlaid on top of previous frames.  Clearing the display or resizing the window will cause the window to restart frame overlay.  In addition to this menu command, you can press the O key  with this window selected to toggle overlay on and off.
7. Freeze Window	Selecting this menu option will freeze the currently displayed video frame in the window.  The work "frozen" will also appear in the title bar, after the acquisition entity name.  Clearing the display or resizing the window will cause the window to clear, but no new frames will be displayed until the window is no longer frozen.  There is also a check mark next to this option when the window is frozen.  Un-freezing the window will begin to draw new frames as they are received.  You will not see any of the frames that were captured while the window is frozen, but they all will be processed by __prod_name.  In addition to this menu command, you can press the Spacebar with this window selected to freeze and unfreeze the display.
8. Save Window to Image	This option is only available when the window is frozen.  It will allow you to save the current window display to a BMP, PNG or JPG raster image.
9. Window Properties	This will bring up the properties page and selects this window in the tree.  If the properties page is closed, __prod_name will open the properties page.  If the properties page is open, it will make sure the properties page is visible.  You can see a detailed description of video window properties for more information.