Camera Image Acquisition

## Camera Image Acquisition

Camera Image Acquisition module provides image source, you can choose simulation camera or physical camera.

## Module Principle
This module reads an image from the local hard disk or camera according to the parameter settings as the image input source for subsequent modules.

## Usage Method
This module is generally used as the first module in the flow to generate an image source for subsequent image processing and other operations.

## Successor Module
This module is generally used in conjunction with the Display Image module, in which the effect of the image output by this module can be seen.

## Parameter Configuration Description
* When simulation camera is checked in Camera Image Acquisition, images can be loaded from a specified local path. In this case, the following parameters need to be set:
  ### Image Format
  You can set the image format to monochrome image or color image.
  ### Load Single Image
  ![](/media/202601/单张图像按钮_1768392624.png) Load a single local image from a specified hard disk location.
  ### Load Folder Images
  ![](/media/202601/文件夹按钮_1768393002.png) Read no more than 200 images from a specified hard disk folder.
  ### Shortcut Button for Reading Folder Images
    ![](/media/202601/图像快捷操作按钮_1768392898.png)

* When simulation camera is not checked in Camera Image Acquisition, images can be acquired from a physical camera. In this case, the following parameters need to be set:
    ### Select Camera
    Associate the corresponding physical camera in the camera manager.
    ### Image Backup
    Backup the image acquired by the physical camera, mostly used in scenarios where the same physical camera acquires images multiple times for simultaneous detection or display.
    ### Trigger Mode
     You can set the trigger mode to self-trigger, software trigger, or hardware trigger.
     *  Self-trigger: In this mode, the camera is in a continuous image acquisition state. When running to this module, an image is read directly from the camera's image buffer.
     *  Software trigger: In this mode, the camera is in a state of waiting for a trigger signal. When running to this module, a trigger signal is first sent to the camera, and the camera starts acquiring images after receiving the trigger signal.
     *  Hardware trigger: In this mode, the camera is in a state of waiting for a trigger signal. When running to this module, it waits for an external device to send a trigger signal to the camera, and the camera starts acquiring images after receiving the trigger signal.
    ### Gain Multiplier
     In the case of not increasing the exposure value, the image brightness can be increased by increasing the gain multiplier.
    ### Camera Gamma
    You can change the brightness and contrast of the image by adjusting Gamma. The larger the Gamma value, the darker the image and the stronger the contrast.
    ### Exposure Time
    You can increase the brightness of the image by increasing the exposure.
    ### Save Path
    The hard disk location where the current camera acquired image is stored when clicking the Save Image button. This parameter is restored to the default value after closing the software.
    ### Image Count
    Display the number of images acquired by the camera when clicking the Continuous Acquisition button. This parameter is restored to the default value after reselecting the Camera Image Acquisition module.

![](/media/202601/光源控制_1768808324.png)
  ### Light Source Controller Selection
  Associate the corresponding light source device in the light source controller.
  ### Light Source Trigger Mode
  * Always On: The light source remains on.
  * Software Trigger: Turn on the light source before the camera acquires an image, and turn off the light source after the camera acquires the image.
  * Software Trigger During Test: Only in test mode, turn on the light source before the camera acquires an image, and turn off the light source after the camera acquires the image.
  * Input IO Level Trigger: Keep the light source on and off following the level signal input from the external device.
  * Input IO Edge Trigger: Turn on the light source following the rising edge of the signal input from the external device, keep it for a specified duration, and then turn off the light source.
  ### Time Earlier Than Photographing
   The time to turn on the light source in advance when the camera acquires an image. Since the light source has a duration from off to brightest, this value is generally not less than 50 milliseconds.
  ### Channel
  You can select the corresponding light source channel.
  ### Brightness
  You can control the light source brightness of the corresponding channel.

## Output Description
   ### Running Result
   Whether the camera image acquisition is successful.
   ### Monochrome Image or Color Image
   Current image information and image data.
   ### Image Name
   *   For physical camera, the image name is the name of the camera.
   *   For simulation camera, the image name is the name of the loaded local image.

## Precautions
  ### Settings to Prevent Network Camera from Failing to Acquire Images
  1. Turn off all types of firewalls on the computer, including public networks and private networks.
  2. Enable Jumbo Frames on the computer and set it to a static IP address.
  3. The computer network card cannot be an Intel I219 series chip.

---

Click here to jump to the corresponding Chinese manual page: [Camera Image Acquisition](/doc/33)