Configuration
The Initialization Commands tab consists of 3 areas, which are described individually below:
- Filter and controls
- Configuration list
- Properties window
Filter elements
With the help of filter elements, features can be found quickly and easily in the configuration tree and in the Initialization Commands list:
- Click on the symbol to expand all tree elements. All parameters are visible.
- Click on the -symbol to collapse all tree elements. Only the main groups are visible.
- Clicking the icon will filter the tree items and display only the lines with a change. The button is only enabled when changes are displayed.
- The search line filters the parameters by specific character strings or (hexadecimal) addresses. When entering a string, the background of the text box is white and an additional button for deleting or resetting the filter appears. If an entry has been confirmed by pressing Enter or clicking the filter button, the text box is also highlighted in green. This indicates whether the current string corresponds to the active filter and therefore the view of the tree elements.
Controls
The left group of buttons provides the basic functionality. The functions from left to right are:
Button | Description |
---|---|
Create and test the selected Initialization Commands | The Initialization Commands are created with the current values of the configuration list. The parameters are also written to the camera and read back for testing. |
Delete changes and Initialization Commands | The Initialization Commands created and stored in the TcCOM object are deleted. This also applies to all other changes that have been made to the list. This resets the entire list to its initial state. |
Apply generated Initialization Commands | The Initialization Commands created and stored in the TcCOM object are written to the camera. |
The right group of buttons provides special functionality that is only active for the entries under the Camera Register node. The functions from left to right are:
Button | Description |
---|---|
Select all features of the CameraRegister category | All entries below the Camera Register category are selected. |
Deselect all features of the CameraRegister category | All entries below the Camera Register category are deselected. |
Move element up | The selected element is moved up one list position. |
Move element down | The selected element is moved down one list position. |
Copy element | A copy of the selected element is created. The set value is also copied. The value of the copied entry cannot be changed later. |
Remove copied element | Removes a previously copied element. |
Rename copied element | Opens a window to rename the copied item. |
Configuration list
The configuration list contains three main groups:
- ForceIP: If this option is active, a ForceIp is performed when initializing the camera in the runtime. The CameraIPAddress from the Image Acquisition Module is used. Since the command is sent to the respective Mac address of the camera, the Initialization Commands must be regenerated with the changed address when the camera is replaced. The values used are only displayed here. Default: disabled.
- UserSet: Some cameras have a UserSet function that can be used to load an image of parameters stored in the camera in order to initialize the camera. If the camera provides this function, the desired UserSet can be selected here. If the option is active, the commands for selecting and loading the corresponding UserSet are written to the Initialization Commands. Default: disabled.
- Camera Features: This group lists all registers that are declared as writable in the read GenApi file and are available in the current camera configuration. This applies independently of the stored visibility, therefore also invisible registers are listed, which are displayed in the configuration tree only with the visibility level All. The initial order corresponds to the order in the GenApi file. If the Camera Features option is active, all registers selected below it are used for the creation of the Initialization Commands. It is possible to select and deselect the individual registers and changes are done with the corresponding operating elements. Registers that have the same address and differ only by masking are displayed only with a checkbox, because they cannot be written independently. Changes to the created Initialization Commands are identified in color and graphically. Default: activated. The Reset Value button can be used to reset individual value changes to the generated values. The Apply generated Initialization Commands button can be used to reset all values to the generated status.
When selecting or deselecting one of the groups or changing a setting below the groups, the Initialization Commands must be recreated. When using UserSets, the Initialization Commands contain the necessary UserSet commands instead of the parameters. The UserSet and CameraRegister options are mutually exclusive.
Camera Features Information
Three pieces of information about the Camera Features are displayed above the configuration list:
- Selected: Number of all currently selected Camera Features from the maximum number of available features. This is generally dependent on the current camera parameterization and therefore varies.
- Generated: Number of the most recently created Initialization Commands stored in the project.
- Changes: Total number of changes within the Camera Features list. This number is only displayed if there are changes, regardless of the active filter settings.
Selector Feature If Iterate Selectors automatically is active in the settings, there is a separate group for each value of a Selector feature. Within this group, all registers that are dependent on the selector value and are writable are displayed. Therefore, the group and register names can occur more than once, in which case the values or register addresses differ. If the setting is not active, there is only one entry per selector. |
Properties window
The Properties window displays the following information about the selected feature:
Property | Description |
---|---|
Name | Name of the parameter. |
Value | Local value of the parameter. If the local value differs from the Initialization Commands value created, the feature is displayed in orange. |
Address | Hexadecimal address of the parameter on the camera. |
Length | Size of the parameter in bytes. |
RegisterValue | Register value of the parameter. |
DisplayName | Feature display name. |
Description | Meaning of the parameter. |
Information | Information whether the value is different (orange), the feature is added (green) or removed (black, strikethrough). |