- Generated on Wed Dec 18 2024 18:47:54
|
Impact Acquire SDK GUI Applications
|
ImpactControlCenter supports various command-line parameters allowing to control the start-up behavior and the appearance of the application.
The following table lists the available command-line parameters:
| Parameter | Description |
allowFullDeviceFileAccess | Grants full access to files which are hidden by default (such as the device firmware) through the file up- and download wizard. Be sure you know what you are doing when using this parameter. You might damage your device! Example: allowFullDeviceFileAccess=1 |
autoSwitchingPeriod or asp | Allows to define a period (in milliseconds) that when expired will switch to the next device in use. This parameter should be combined with live=1 since otherwise the results might be confusing. See Opening Multiple Devices With Automatic Switching as well.
|
debuginfo or di | Will display debug information in the property grid. |
device or d | Will directly open a device with a particular serial number. '*' can be used as a wildcard, just * will take the first unused device. Multiple devices to open can be specified. A custom string that shall be used as a device specific overlay when displaying the data can be specified as well by separating the serial number token and the custom string by a semi-colon. See Examples for possibilities. |
dic | Will display invisible (currently shadowed) components in the property grid. |
displayCountX or dcx | Defines the number of images displayed in horizontal direction. |
displayCountY or dcy | Defines the number of images displayed in vertical direction. |
fulltree or ft | Will display the complete property tree (including the data not meant to be accessed by the user) in the property grid. Example (Tree will be shown): fulltree=1 |
fullscreen or fs | Will directly switch to full-screen mode. Make sure to select a device as well and configure it for live acquisition. Example: ImpactControlCenter device=VD000001 live=1 fullscreen=1 |
height or h | Defines the startup height of ImpactControlCenter. Example: height=460 |
interfaceConfiguration | Will directly launch the interface configuration and driver information dialog. Example: interfaceConfiguration=1 |
live | Will directly start live acquisition from the device opened via device or d directly. Example (will start the live acquisition): live=1 |
propgridwidth or pgw | Defines the startup width of the property grid. |
qsw | Will forcefully hide or show the Quick Setup Wizard, regardless of the default settings. Example (Quick Setup Wizard will be shown): qsw=1 |
width or w | Defines the startup width of ImpactControlCenter. Example: width=640 |
xpos or x | Defines the startup x position of ImpactControlCenter. |
ypos or y | Defines the startup x position of ImpactControlCenter. |
To open an image file from hard disk just pass the full path to the image as a command-line parameter.
F1 after the application is running will also display a detailed list of available command-line options as well as keyboard shortcuts and some other useful information!ImpactControlCenter d=* fulltree=1 qsw=0
This will open the first available device, will hide the Quick Setup Wizard and will display the complete property tree.
ImpactControlCenter d=GX* d=GX* autoSwitchingPeriod=5000 live=1 qsw=0
This will open the first 2 devices with serial numbers that start with GX, will hide the Quick Setup Wizard, start a continuous acquisition for all devices which have been opened and switch from one device to the next every 5 seconds. This works because whenever the wildcard character is used with the device parameter then the application will try to find the first unused device thus assuming there are 2 or more unused devices with a serial number starting with GX then initially the first device is used and when the next device parameter is encountered the next one will be opened since the first one is already in use.
live=1 here is possible, but the result might be confusing since then most of the controls will be disabled, the switching takes place, but no images will be acquired and displayed.qsw=0 can be omitted here and has only been added to point out that in fact the Quick Setup Wizard will not be started when automatic device switching is active since the result would be confusing.ImpactControlCenter d=GX* "d=GX*;A custom overlay" autoSwitchingPeriod=5000 live=1 qsw=0
This will open the first 2 devices with serial numbers that start with GX, will hide the Quick Setup Wizard, start a continuous acquisition for all devices which have been opened and switch from one device to the next every 5 seconds. This works because whenever the wildcard character is used with the device parameter then the application will try to find the first unused device thus assuming there are 2 or more unused devices with a serial number starting with GX then initially the first device is used and when the next device parameter is encountered the next one will be opened since the first one is already in use. In addition to that a custom overlay string has been specified for the second device. The double quotes enclosing the second device parameter are needed when whitespaces shall be used within the custom overlay string. See Custom Overlay for how to make use of this custom overlay string.
live=1 here is possible, but the result might be confusing since then most of the controls will be disabled, the switching takes place, but no images will be acquired and displayed.qsw=0 can be omitted here and has only been added to point out that in fact the Quick Setup Wizard will not be started when automatic device switching is active since the result would be confusing.