# ApplyAcquisitionSettings3d

The ApplyAcquisitionSettings3d function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. allows you to modify the acquisition Acquisition is the process or result of the vision system acquiring a new image. settings of the vision system. The function supports a subset of the settings in the Acquisition panel.

When you change the settings using this function, the vision system immediately stops the ongoing acquisition to apply the new settings. When the vision system finishes the reconfiguration, it automatically resumes the acquisition. During the short time when the ongoing acquisition stops, the vision system discards all triggers and these triggers are not considered missed triggers. For this reason, Cognex recommends you to stop the production line when performing changes.

If you have more than one ApplyAcquisitionSettings3d functions in the spreadsheet, the vision system uses only the last updated value. For this reason, Cognex recommends to have only one ApplyAcquisitionSettings3d function enabled at a time.

The values of the field correction settings are temporary, and they do not affect the field correction values stored on the vision system. When you restart the vision system or change jobs, the original field correction value is restored. Additionally, when exporting the field correction to a file, the original field correction value is used instead of the value configured by the ApplyAcquisitionSettings3d function.

To use the function:

1. Drag and drop the ApplyAcquisitionSettings3d function to the selected cell or type ApplyAcquisitionSettings3d into the selected cell. The property sheet of the function then opens.

2. Check the checkbox next to the parameter you want to add and set the desired value.

3. Click OK to close the Property Sheet.

4. You can add cell references to the spreadsheet for any of the parameters by dragging and dropping the selected parameter to a cell.

   The following elements appear in the spreadsheet:

   - An ❒AcquisitionSettings data structure, acting as the setter for the selected parameter.
   - A label for the selected parameter for easy identification.
   - An edit control element to modify the value of the parameter from the spreadsheet.

Note:

- The label and the edit control of the parameter are populated only when you drag and drop the parameter from the ApplyAcquisitionSettings3d property sheet to the spreadsheet. If you insert the ApplyAcquisitionSettings3d function using other methods (such as typing ApplyAcquisitionSettings3d in a cell without checking and drag-and-dropping any parameters listed in the Property Sheet), only the ❒AcquisitionSettings data structure is created.
- If you uncheck a parameter in the Property Sheet, the associated edit control on the spreadsheet no longer overwrites the value of the parameter in the Acquisition panel.

Inputs

The settings parameters are grouped in the property sheet based on their position in the Acquisition panel.

### Trigger Settings

Parameter | Description
--- | ---
Time Trigger Delay (ms) | For more information, see Trigger Settings.
Acquisition Direction
Timeout (ms)
Distance Trigger Delay (mm)

### Profile Settings

Parameter | Description
Exposure | For more information, see Profile Settings.
HDR High Exposure Enable
HDR High Exposure (ms)
HDR Low Exposure Enable
HDR Low Exposure (ms)
Detection Zone Min Z (mm)
Detection Zone Max Z (mm)
Binning
Selected Peak
Sensitivity
Median Filter
Peak Width Enable
Peak Width

### Correction Settings

Parameter | Description
Motion Speed (mm/s) | For more information, see Correction Settings.

### Point Cloud Settings

Parameter | Description
--- | ---
Requested Scan Length (mm) | For more information, see Point Cloud Settings.
Requested Overlap Length (mm)
Y Resolution (mm)
Generate 2D Grey

### Filters Settings

Parameter | Description
--- | ---
Gap Filling Enable | For more information, see Filter Settings.
Gap Filling Mode
Gap Size (mm)
Z Discontinuity Threshold (mm)
Spike Removal Enable
Strength
Spike Hole Filling Enable
Spike Hole Filling Mode
Maximum Spike Size X (mm)
Minimum Spike Size Z (mm)

Outputs

When a supported parameter is dragged and dropped from the property sheet to the spreadsheet, the following elements are returned.

Returns | An ❒AcquisitionSettings data structure, acting as the setter for the selected parameter. A label for the selected parameter for easy identification. An edit control element to modify the value of the parameter from the spreadsheet.