Enosoft Enhanced DV Decoder Help

Using the Enosoft Enhanced DV Decoder Configuration Utility

Main Configuration Dialog Box

Hint: You can click on an item in the above image to get more information or scroll down to the item of interest.

See Also Main Configuration Context Menu and Position Control Dialog Box

The Enosoft Enhanced DV Decoder Configuration Utility is used to provide real-time control of the behavior of the decoder. When more than one instance of the decoder is running, each instance can be independently configured. The configuration data are stored in the operating system's registry. Furthermore, different configurations are stored for different applications that use the decoder.

The above figure shows the main configuration dialog box. This is accessed from the Enosoft Enhanced DV Decoder program group on the computer's Start Menu. The dialog box responds to standard Windows mouse and keyboard input. The various buttons are activated by clicking on the button once with the left mouse button. Alternatively, the keyboard's Tab key can be used to cycle through all the buttons one at a time and the Space Bar pressed once to activate the appropriate button. Some of the buttons also respond to a single right-click of the mouse by presenting a context menu.

Record Date Record Time Time Code Audio Info Video Info Camera Info Color Space Global Disable Help About Combo Box Minimize Close

Combo Box

The combo box lists all of the current (active) instances of the Enosoft Enhanced DV Decoder running ob the system. To configure a specific instance, simply select it from the list. To configure all instances at the same time, enable the Global Mode.

Note The contents of the list are updated only when the drop-down arrow is pressed.

See Also Understanding Instances

Top

Show/Hide Record Date Button

The Record Date button causes the record date to be shown or hidden. The button will be blue when the date is to be displayed. Clicking the button while it is blue will turn off the date display. Clicking the button while it is grey will turn on the date display. The opacity of the background of the displayed text and the format (DD/MM/YY, MM/DD/YY or YY/MM/DD) can be selected by right-clicking on the Record Date button and activating the context menu.

Top Position Control

Show/Hide Record Time Button

The Record Time button causes the record time to be shown or hidden. The button will be blue when the time is to be displayed. Clicking the button while it is blue will turn off the time display. Clicking the button while it is grey will turn on the time display. The opacity of the background of the displayed text can be selected by right-clicking on the Record Time button and activating the context menu.

Top Position Control

Show/Hide Time Code Button

The Time Code button causes the time code to be shown or hidden. The button will be blue when the time code is to be displayed. Clicking the button while it is blue will turn off the time code display. Clicking the button while it is grey will turn on the time code display. The opacity of the background of the displayed text can be selected by right-clicking on the Time Code button and activating the context menu.

Top Position Control

Show/Hide Audio Information Button

The Audio Information button causes the audio information to be shown or hidden. The button will be blue when the audio information is to be displayed. Clicking the button while it is blue will turn off the audio information display. Clicking the button while it is grey will turn on the audio information display. The opacity of the background of the displayed text can be selected by right-clicking on the Audio Information button and activating the context menu.

Top Position Control

Show/Hide Video Information Button

The Video Information button causes the video information to be shown or hidden. The button will be blue when the video information is to be displayed. Clicking the button while it is blue will turn off the video information display. Clicking the button while it is grey will turn on the video information display. The opacity of the background of the displayed text can be selected by right-clicking on the Video Information button and activating the context menu.

Top Position Control

Show/Hide Camera Information Button

The Camera Information button causes the camera information to be shown or hidden. The button will be blue when the camera information is to be displayed. Clicking the button while it is blue will turn off the camera information display. Clicking the button while it is grey will turn on the camera information display. The opacity of the background of the displayed text can be selected by right-clicking on the Camera Information button and activating the context menu. Mapping of the Shutter Speed and Gain values can be enabled/disabled via the context menu, too.

Top Position Control

Show/Hide Color Space Information Button

The Color Space Information button causes the color space information to be shown or hidden. The button will be blue when the color space information is to be displayed. Clicking the button while it is blue will turn off the color space information display. Clicking the button while it is grey will turn on the color space information display. The opacity of the background of the displayed text can be selected by right-clicking on the Color Space Information button and activating the context menu.

Top Position Control

Enable/Disable Global Configuration Button

The Global button causes the Configuration Utility to either apply configuration changes to the selected instance of the decoder only or all instances of the decoder. The button will be blue to indicate that the global mode is enabled. Clicking the button while it is blue will turn off the global mode. Clicking the button while it is grey will turn on the global mode.

Top

Disable/Enable Text Overlay Button

The Text Overlay button allows the display of all enabled text items to be turned on or off. The button will be red to indicate that the text overlay is disabled. Clicking the button while it is red will enable the text overlay. Clicking the button while it is grey will disable the text overlay. The settings for the individual items are not affected. Hence, toggling the button will simply toggle the visibility of the text overlay.

Top

Show Help Button

The Help button displays the on-line help for the Enosoft Enhanced DV Decoder (i.e., this file).

Top

About/Information Button

The About/Information button displays a dialog box that contains information about the Enosoft Enhanced DV Decoder, including version, copyright and licensing details. For further information on licensing, see Purchasing the Software.

Top

Minimize Button

The Minimize button collapses the Configuration Utility to the computer's Task Bar.

Top

Close Button

The Close button closes the Configuration Utility. This does not affect any applications currently using the decoder.

Top

Main Configuration Context Menu

Background Menu Show Position Dialog Show Help Select Opaque Background Select Semi-Transparent Background Select Transparent Background

Right-clicking with the mouse once on the button for Record Date, Record Time, Time Code, Audio Information, Video Information, Camera Information or Color Space Information causes the context menu shown in the above picture to be displayed.

The context menu for Record Date includes an extra menu item to set the date format:

The context menu for Camera Information includes two extra menu items to enable or disable the mapping of shutter speeds and gain codes:

See Mapping Values in the Registry for more information.

Background

Choosing the Background menu item displays the sub-menu of background options. The current setting is indicated with the large, solid bullet point. Left-click once on one of the three options to choose the desired setting.

Position...

Choosing the Position menu item displays the Position Control Dialog Box.

Help...

Choosing the Help menu item displays the on-line help.

Top

Position Control Dialog Box

Vertical Position Slider Horizontal Position Slider OK Button Cancel Button Apply Button Show Help Button NTSC/PAL Selector Preview Check Box Item Selection Buttons Layout Panel Active Item Inactive Item Inactive Item Inactive Item Inactive Item Inactive Item Active Item Co-ordinates

Hint: You can click on an item in the above image to get more information or scroll down to the item of interest.

The position of each of the supported text overlay items is adjusted using the Position Control Dialog Box. The upper-left corner of the text is mapped onto the co-ordinate space of the decoded video frame. The upper-left corner of the video frame is co-ordinate (0, 0). The upper-right corner is (719, 0). For NTSC-based video, the lower-left and lower-right corners are (0, 479) and (719, 479), respectively. For PAL-based video, the corresponding co-ordinates are (0, 575) and (719, 575).

The co-ordinates of the active item can be adjusted either by using the slider controls or by dragging it with the mouse in the layout panel.

Layout Panel

The image of the color bars represents the decoded video frame. The current positions of the supported text overlay items are shown by appropriately-scaled examples of each item. All items are visible on the layout panel, irrespective of their display mode from the main dialog box. There is always one active item in the layout panel and is indicated by a yellow border. The co-ordinates of the active item are displayed directly below the layout panel. The position of the active item can be adjusted using the slider controls or by dragging the item with the mouse while holding down the left mouse button.

Left-clicking on an inactive item causes it to become the active item. Selecting a new active item is also possible by using the item selection buttons in the lower part of the dialog box.

Item Selection Buttons

When the Position Control Dialog Box is opened, the active item is determined by the button that was pressed in the Main Configuration Dialog Box to access the Context Menu. Accordingly, one of the Item Selection Buttons in the lower part of the Position Control Dialog Box is highlighted (blue) and the remaining ones are shown in grey. Left-clicking once on one of the grey buttons selects a new active item. The active item is shown with a yellow border in the Layout Panel.

Active Item

At any given time, one item is active. The active item is shown with a yellow border in the Layout Panel and the corresponding Item Selection Button is shown in blue. The position of the active item is adjustable via the slider controls or by dragging it in the layout panel with the mouse while holding down the left mouse button.

Active Item Co-ordinates

The co-ordinate of upper-left corner of the active item is shown below the layout panel. The upper-left corner of the video frame is co-ordinate (0, 0). The upper-right corner is (719, 0). For NTSC-based video, the lower-left and lower-right corners are (0, 479) and (719, 479), respectively. For PAL-based video, the corresponding co-ordinates are (0, 575) and (719, 575).

Note Adjustment of the active item's position by dragging with the mouse is limited to a resolution of 5 pixels in both the horizontal and vertical directions. To position the active item with single pixel accuracy, use the slider controls. It is recommended that the rough position of the item be set by dragging the item within the Layout Panel first and fine adjustment then made with the slider controls.

Inactive Items

At any given time, one item is active. The other items are shown without a highlighting border in the Layout Panel and the corresponding Item Selection Buttons are shown in grey.

Slider Controls

The two slider controls are used to adjust the vertical and horizontal positions of the active item. The slider controls respond to standard Windows mouse and keyboard commands. When using mouse control, the adjustment resolution is limited to approx. 4 or 5 pixels. The keyboard must be used to obtain finer adjustment. The following keyboard commands apply to both the vertical and horizontal sliders.

Left or Up Arrow Key Decrease by 1
Right or Down Arrow Key Increase by 1
Page Up Key Decrease by 10
Page Down Key Increase by 10
Home Key Set to minimum value
End Key Set to maximum value

Vertical Slider Control

Controls the vertical position of the active item. See Slider Controls for more information.

Horizontal Slider Control

Controls the horizontal position of the active item. See Slider Controls for more information.

NTSC/PAL Selector

This determines the maximum vertical ordinate (575 for PAL, 479 for NTSC).

Note The software stores the co-ordinates in a system-independent format. Specifically, vertical ordinates greater than half the maximum value are stored as negative values relative to the bottom of the frame. e.g., for NTSC, a vertical ordinate of 469 is stored internally as -10. The advantage of this is that the same configuration information can apply to both NTSC and PAL systems.

Preview Check Box

Checking the Preview Check Box causes any changes made to the position of the text overlay items to be sent to the currently selected instance of the decoder immediately (or, if the Global Mode is enabled, all instances), thereby removing the need to press the Apply button. Any changes made will come into effect when the next video frame is decoded. For example, if a DV video is being played in a media player application, the changes will appear immediately. However, if playback is paused, the changes will not appear immediately but rather when playback resumes.

Note Changes made only become permanent if the Position Control Dialog Box is closed by using the OK button. Using the Cancel button or any other means of closing the window (e.g., pressing the Escape key) causes the previous settings to be restored.

OK Button

The OK button closes the Position Control Dialog Box. Any changes made to the position of the text overlay items remain in effect.

Cancel Button

The Cancel button closes the Position Control Dialog Box. Any changes made to the position of the text overlay items are undone.

Apply Button

The Apply button updates the configuration of the currently selected instance of the decoder (or, if the Global Mode is enabled, all instances). Any changes made will come into effect when the next video frame is decoded. For example, if a DV video is being played in a media player application, the changes will appear immediately. However, if playback is paused, the changes will not appear immediately but rather when playback resumes.

Note Changes made only become permanent if the Position Control Dialog Box is closed by using the OK button. Using the Cancel button or any other means of closing the window (e.g., pressing the Escape key) causes the previous settings to be restored.

Show Help Button

The Help button displays the on-line help for the Enosoft Enhanced DV Decoder
(i.e., this file).

Top

Topics

  • Introduction to the Enosoft Enhanced DV Decoder
  • Getting Started
  • Practical Examples
  • Understanding Instances
  • Supported Parameters
  • Enabling and Disabling the Enosoft Enhanced DV Decoder
  • Using the Enosoft Enhanced DV Decoder Configuration Utility
  • Mapping Values in the Registry
  • Purchasing the Software
  • Getting Support
  • Uninstalling the Software

  • Last Updated on Thursday, May 25, 2006.

    © 2005-2006 Enosoft, Hillsborough, NC. All rights reserved.