# Image

The Image application step of the EasyBuilder allows you to define the image source and configure trigger, profile, and point cloud A point cloud is a 3D structure that consists of the data points collected by a 3D vision system during acquisition. settings.

Section | Tool | Action
--- | --- | ---
Source | Camera | To create a job A job is a user-configured program in In-Sight 3D EasyBuilder consisting of functions and designed for specific applications. You can create and edit jobs using the In-Sight 3D EasyBuilder interface, and load them on a vision system for deployment in a live environment. based on the direct feed from your In-Sight vision system, select Camera under Source.
Image Folder | To create a job based on a set of images stored on your hard drive, click Image Folder under Source.
Trigger/Motion | Trigger Source | Specifies the trigger source for the acquisition Acquisition is the process or result of the vision system acquiring a new image.: Software - select this option if acquisition is manually performed, for example by clicking a button in the WebHMI The operator interface through which the operator interacts with the vision system. interface of the configured job. Input Line - select this option to trigger acquisition using an external hardware signal line generated by a triggering device.
Motion Input | Defines the acquisition driving logic for every profile: Time - profile acquisition is triggered at a fixed time interval by an internal clock generating fixed-frequency pulses. Encoder Single - profile acquisition is triggered by a single-channel physical encoder generating signals (or ticks) for acquisition. Single-channel encoders can only detect the presence of the motion, but not its direction. Encoder Dual - profile acquisition is triggered by a dual-channel physical encoder generating signals (or ticks) for acquisition. Dual-channel encoders can detect both the presence and the direction of the motion. Note: This setting affects field correction. Therefore, make sure to configure it before performing field correction on the device in the Correction Settings.
Positive Encoder (+) | Specifies how the encoder is physically connected to the vision system, affecting the motion direction that increases the Encoder Counter. Laser to Lens - the Encoder Counter increases if the motion direction is from the laser to the lens of the vision system. Lens to Laser - the Encoder Counter increases if the motion direction is from the lens of the vision system to the laser. If this setting is correctly configured, the Current Indicator correctly indicates the direction of movement. Otherwise, you must correct the value of the setting. This setting can only be configured before field correction is performed. After that, it is grayed out and can no longer be modified. Note: This setting is enabled only if Motion Input is set to Encoder Dual. In case of target field correction, this setting is automatically determined, therefore you do not need to configure it in advance. Tip: Make sure that the Encoder Direction is specified correctly, based on the physical setup of the vision system. Otherwise, the generated point cloud is mirrored along the motion direction.
Current Motion | Shows the currently applicable motion. If Motion Iput is set to Encoder Single, the parameter shows Stopped or Moving. If the Motion Input is set to Encoder Dual, the parameter shows Laser to Lens, Lens to Laser, or Stopped.
Profile | Exposure (ms) | To increase or decrease illumination intensity, use the Exposure slider or set a value below the slider. To automatically set the exposure based on current light settings, click Optimize. There is no exposure adjustment by default.
Detection Zone | Sets the lower and upper bounds for the measurement range of the vision system (in mm) in which shapes and surfaces are detected, and image data is generated. To automatically set the detection zone, place a part that spans the desired maximum and minimum height range in the vision system field of view, and click Optimize. To manually adjust the size, use the sliders or enter a specific value. The Z min value (specifying the lower bound of the working section) cannot be higher than the Z max value, and likewise, the Z max value (specifying the upper bound of the working section) cannot be lower than the Z min value. Tip: Decreasing the Detection Zone interval (that is, using Z min and Z max values that are closer to each other) speeds up acquisition, and increases the Max Profile Rate.
PointCloud A point cloud is a 3D structure that consists of the data points collected by a 3D vision system during acquisition. | Acquisition Direction | Specifies in which motion direction you want to acquire. This setting is independent of the Positive Encoder (+) setting. Laser to Lens - the vision system acquires image data if the motion direction is from the laser to the lens of the vision system. Use this setting when the object is approaching the vision system from the side where laser is located. Lens to Laser - the vision system acquires image data if the motion direction is from the lens of the vision system to the laser. Use this setting when the object is approaching the vision system from the opposite side where laser is located.
ScanLength | Specifies the desired point cloud length, that is the distance between the first and last profile acquisition (in mm). The value range is 0 – 5000, and the default value is 130. Note: This setting assumes good field correction. Incorrect Motion Speed or Encoder Resolution values negatively impact this setting.
YResolution | Specifies the desired distance (in mm) between consecutive profiles in the motion direction. The value range is 0.001 – 100, and the default value is 0.1. Note: When configuring the Y Resolution, consider that sometimes, the selected resolution value cannot actually be set by the system. This can occur because of 3 reasons: If encoder-based acquisition is used, the Requested Y Resolution must be a multiple of the encoder resolution. If this is not the case, then the Actual Y Resolution will be modified by the system to be a multiple of the Encoder Resolution that is closest to and smaller than the Requested Y Resolution. If time-based acquisition is used, the configured resolution may not be achievable if the sensor cannot acquire profiles fast enough to reach the requested resolution. The vision system can only acquire a maximum number of profiles. If the combination of the requested scan length and the requested resolution requires more profiles than the maximum allowed value, then the Y resolution will be adjusted accordingly.