Video Tracker Window Commands

These commands are for creation and manipulation of video tracker windows.

-AddPlot <Window Name> <Acq Ent Name> 
Adds a new plot to the specified window.  The type of the window determines what type of  plot may be added to the window.  Once a plot is added, the acquisition entity whose data is displayed in the plot cannot be changed.  All plots are displayed in the order that they are added to the window.  The display order of the plots can be changed through the Properties Dialog.  All data in the window will clear when a new plot is added to the window.  Each acquisition entity can be added to a window only once.

Example :   -AddPlot "SpikeWindow" SE1
Default: All plot windows are created with no plots.
Usage: This command can be used at any time.
Arguments
Window Name
The name of the window that will house the new plot.
Acq Ent Name The acquisition entity name that will be the data source of the plot.  The acquisition entity must  be of the appropriate type in order for it to be successfully added to the window.

Example: Assume a configuration file has the following two commands:
-CreatePlotWindow Spike "My Spike Window"
-AddPlot "My Spike Window" CSC1
If the acquisition entity CSC1 is a continuously sampled channel, it will not be able to be displayed in a Spike plot window, and the command will fail.

-CreatePlotWindow <Window Type> <Window Name> 
Creates a new plot window in __prod_name.  Once created, the window type cannot be changed.

Example :  -CreatePlotWindow Time "My Time Window"
Default: __prod_name starts with no plot windows.
Usage: This command can be used at any time.
Arguments
Window Type
Specifies the type of window you wish to be created.  This value must be one of the following:
  1. Spike: The window will only be able to display Spike plots..
  2. Time: The window will only be able to display Time plots.
  3. Video: The window will only be able to display Video plots.

For a more detailed description of each plot type, see the -SetPlotWindowPlotType command.
Window Name The name of the plot window you wish to create.  This name must be unique throughout the __prod_name system, otherwise the command will fail.  Window names can be changed after the window is created through the Properties Dialog.

-SetPlotWindowFrozen <Window Name> <Frozen>
This command works like a pause button on a DVD player.  It will lock in whatever is currently displayed in the window.  If an action is taken that will clear the window, the last data displayed will be cleared.  No data will be added to the window while it is frozen, but otherwise is processed normally.  It if a window is frozen before it is displayed, the window may contain garbage or a copy of whatever is displayed beneath the window.  Unfreezing and refreezing the window will allow it to clear normally.

Example :    -SetPlotWindowFrozen "My Spike Window" True
Default: All windows are created with frozen set to false.
Usage: This command can be used at any time.
Arguments
Window Name
The name of the window which will be modified.
Frozen The frozen value can be one of the following keywords:
  1. True: The entire window will be frozen and no new data will be plotted.  To begin plotting new data, reissue this command with Frozen set to false.
  2. False: The window will begin to plot new data.  If a window was frozen prior to this command being issued, all of the data visible in the frozen display will be cleared.

-SetPlotWindowOverlay <Window Name> <Value>
Sets a plot window's overlay mode.  Overlaid windows will not clear out old data before displaying new data.  This setting effects all plots in this window.

Example :    -SetPlotWindowOverlay "MyWindow" true
Default: Plot windows are created with overlay set to false.
Usage: This command can be used at any time.
Arguments
Window Name
The name of the window which will be modified.
Value This can be one of the following keywords:
  1. True: The window will not clear out any old data until either a clear command is issued, overlay is turned off, or the window is resized.
  2. False: The window will clear out old data according to the current plot type.  See -SetPlotWindowType for more information.

-SetPlotWindowPlotType <Window Name> <Plot Type> 
Sets the plot type that will be used for this window.  All plots in the window will be set to the same type.  All data in the window will clear when the plot type is changed.

Example :     -SetPlotWindowPlotType "SpikeWindow" Waveform
Default:
Window Type Default Plot Type
Spike WaveformFeature
Time Sweep
Video Live
Usage: This command can be used at any time.
Arguments
Window Name
The name of the window that will be modified.
Plot Type The options for a view are dependent upon the type of window that is being set.  If the specified plot type does not correspond to the type of the window (i.e. a plot type of Waveform for a Time window), the command will fail.

Spike Windows:
  1. Waveform: Shows the extracted waveform for a detected spike.  If more than one waveform is visible, this means more than one spike occurred since the last screen refresh.  The waveform seen in this plot is the exact waveform saved to the spike data records.
  2. Feature: Shows the calculated feature information in a XY scatter plot.  The features that are plotted can be changed by the -SetFeaturePlotSources command.  To change the features available for an acquisition entity, see the -SetWaveformFeature command.  The data seen in this plot is the exact data saved to the spike data records.
  3. WaveformFeature: Shows both the waveform and feature plots.

Time Windows :
  1. Flash: Displays the waveform for single record.  The data shown is indicative of the data that is written to the __prod_name data files. 
  2. Scroll: Similar to an oscilloscope, new waveform data will be shown on the right, and old data will scroll to the left.  The amount of time shown in this plot can be adjusted with the -SetPlotWindowTimeframe command.   The data shown is indicative of the data that is written to the __prod_name data files.
  3. Sweep: A cursor will move from left to right across the screen.  New data will be shown to the immediate left of the cursor.  Old data will be cleared as the cursor moves past it.   The data shown is indicative of the data that is written to the __prod_name data files
    .

Video Tracker Windows:
  1. Live :  The image displayed in the window is the live, unprocessed video image.  This is also the same image that will be written to a video output file (-SetVideoFileOutput) when  -SetVideoFileOutputEnabled is true.
  1. Threshold :  The image displayed in the window is a thresholded version of the live image.  This display mode takes into account the threshold settings for Red, Green, Blue and Intensity when displaying pixels.  This is  NOT representative of the data that is recorded to the Video Tracker record file, but is intended as a guide for setting thresholds.
  2. Record : Displays a thresholded image of the live video.  This display mode will only show pixels that are above the threshold for Red, Green, Blue and Intensity.  However, it will only display as many transitions as the video record can hold.  If the thresholds are set too low, the image may become saturated, and only the top few lines of the image will be visible. The image displayed is representative of the data stored into a Video Tracker record file.

-SetPlotWindowPosition <Window Name> <X Position> <Y Position> <Window Width> <Window Height> 
Set the position and size of the specified plot window.  All data in the window will clear when the window size or position is changed.

Example :   -SetPlotWindowPosition WindowName 200 300 800 600
Default: The position of new plot windows is determined by Windows.
Usage: This command can be used at any time.
Arguments
Window Name
The name of the window which will be modified.
X Position The position, in pixels, to place the left side of the specified window.  This value is relative to your desktop, and must be within the bounds of your desktop.  If a value is outside the bounds of your desktop, it will be adjusted to that the window is placed as close to your value as possible, while remaining completely visible.  If the width of the window is larger than the width of your desktop, __prod_name will set the x position to 0 and part of the window will not be visible.  Negative values are not allowed.

Example: You have your screen resolution set to 1600 x 1200, and the following command is processed by __prod_name:

-SetPlotWindowPosition "My Spike Window" 1600 100 800 600

Since putting the window with its left point at 1600 and top at 100 will place the window outside of your desktop, __prod_name will move the window left until it is completely visible.  The top position will not be changed since it is within the bounds of the desktop.  The final position of the window from the above command will be 800, 100.   
Y Position
The position, in pixels, to place the top of the specified dialog.  This value is relative to your desktop, and must be within the bounds of your desktop.  If a value is specified that is outside the bounds of your desktop, it will be adjusted to that the specified dialog is placed as close to your value as possible, while remaining completely visible.  If the height of the window is larger than the height of your desktop, __prod_name will set the y position to 0 and part of the window will not be visible. Negative values are not allowed.
Window Width
The width of the window in pixels. If the width value at the current x position would cause part of the window to be outside the bounds of your desktop, __prod_name will move the window left until either all the window is visible, or the x position is 0.  Negative values are not allowed.
Window Height
The height of the window in pixels. If the width value at the current x position would cause part of the window to be outside the bounds of your desktop, __prod_name will move the window left until either all the window is visible, or the x position is 0. Negative values are not allowed.