mappVision帮助助手 > 机器视觉帮助 > mapp Vision > 编程 > 视觉功能 > 图像采集

参数	类型	数值范围	说明	循环	非循环

UndervoltageError	BOOL	0 or 1	电源报警	R
SensorTemperature	SINT	-128 to +127	当前摄像机温度（°C	R
DigitalInput01	BOOL	0 or 1	状态数字输入（触发输入）	R
ImageAcquisitionReady	BOOL	0 or 1	摄像机可用状态	R
CameraStatus	UDINT	0x00000000 to 0xFFFFFFFF	此参数用于说明摄像机的状态。	R
CameraProcessingTime	UINT	0 to 65535	处理时间（毫秒	R
ReadGainLevel	USINT	0 to 255	当前增益等级	R
ReadFocus	UINT	0 to 65535	当前焦距设置（从 "MOD "到 "无限大"	R
ReadExposureTime	UDINT	1 to 16,777,216	当前传感器积分时间（微秒	R
ImageProcessingError	UDINT	0x00000000 to 0xFFFFFFFF	用于显示图像处理过程中发生的错误和警告的位模式。
AcceptedAcquisitionCnt	USINT	0 to 255	接受的图像采集计数器	R
CompletedAcquisitionCnt	USINT	0 to 255	已执行图像采集计数器	R
FailedAcquisitionCnt	USINT	0 to 255	图像采集失败计数器	R
LightWarningCnt	USINT	0 to 255	与照明有关的错误或警告计数器。	R
ImageNettime	DINT	-2,147,483,648 to 2,147,483,647	以微秒为单位的图像净时间	R
DigitalOutputStatus01	BOOL	0 or 1	数字输出 01 的状态	R

DigitalOutput01	BOOL	0 or 1	选择数字输出的操作模式	W
ImageAcquisition	BOOL	0 or 1	启用/禁用图像采集触发器	W
ResetAcquisition	BOOL	0 or 1	取消由 NetTime 触发的图像采集	W
SearchAcquisitionSettings	BOOL	0 or 1	启用/禁用传感器对焦和积分时间搜索	W
IRFilter	BOOL	0 or 1	启用/禁用红外滤光片	W
GainLevel	USINT	0 to 255	设置增益系数	W
SetFocus	UINT	0 to 65535	从 "MOD "到 "Infinity "设置焦距	W
StatusLED	USINT	0 to 4	选择 LED 状态指示条的模式和颜色	W
ExposureTime(n)	UDINT	1 to 16,777,216	以微秒为单位设置传感器的积分时间	W
DelayNetTime(n)	DINT	-2,147,483,648 to 2,147,483,647	以微秒为单位设置触发延迟或净时间	W
FlashColor(n)	USINT	0 to 255	选择板载 LED 照明的 LED 颜色	W
FlashSegment(n)	USINT	0 to 0x0F	启用/禁用 LED 段	W
CyclicLineScanNettime	DINT	-2,147,483,648 to 2,147,483,647	指定动态线路传感器模式的净时间。	W
CyclicLineScanPeriod	UDINT	0 to 4,294,967,295	动态行传感器操作中两次图像采集之间的时间。	W
ChromaticLock	BOOL	0 or 1	启用/禁用色度锁定	W

WidthMax

UINT

1 to 2592

图像宽度中所用传感器的最大像素数

HeightMax

UINT

1 to 2048

图像高度中所用传感器的最大像素数

Constants/常数
MultiCapture	USINT	1 to 10	图像采集次数	W
LinesensorMode	BOOL	0 or 1	切换线路传感器模式	W
配置参数
TriggerSource	BOOL	0 or 1	切换触发源（软件/硬件）	W
TriggerDelay	BOOL	0 or 1	切换触发延迟类型	W
TriggerEdge	BOOL	0 or 1	切换触发数字输入的边缘方向	W
Flip image horizontally	BOOL	0 or 1	启用/禁用传感器 x 轴的镜像功能	W
Flip image vertically	BOOL	0 or 1	启用/禁用传感器 Y 轴镜像	W
Binning	BOOL	0 or 1	启用/禁用 2x2 分档	W
Subsampling	BOOL	0 or 1	启用/禁用子采样	W
ImageWidth (area-based) LineWidth (line-based)	UINT	1 to sensor width	以像素为单位设置要采集图像的宽度	W
ImageHeight (area-based) LineHeight (line-based)	UINT	1 to sensor height	以像素为单位设置要获取图像的高度	W
ImageOffsetX (area-based) LineOffsetX (line-based)	UINT	0 to sensor width - 1	对于要获取的图像以像素为单位设置 x 轴的偏移量	W
ImageOffsetY (area-based) LineOffsetY (line-based)	UINT	0 to sensor height - 1	对于要获取的图像：以像素为单位设置 Y 轴的偏移量	W
Line sensor	BOOL	0 or 1	启用/禁用线性传感器模式	W
LinesPerImage	UINT	1 to 4096	线性传感器模式下的图像采集次数	W
LineScanPeriod	UDINT	1 to 4,294,967,295	线性传感器模式下两幅图像之间的时间间隔（以 ns 为单位	W
FocusScale	USINT	0 to 2	设置焦点缩放 0 = 步（原始数据） 1 = 毫米 2 = 10 µm（默认值）	W
VignettingCorrection	BOOL	0 or 1	启用/禁用渐晕校正	W
LEDTempDriftCorrection	BOOL	0 or 1	启用/禁用 LED 温漂校正	W

Filter	USINT	0 to 255	Selects the preprocessing filter	W
User filter Filter(n) 11- 33	SINT	-128 to 127	Value of a filter coefficient of the 3x3 filter matrix of a user-defined filter. Applied 9 times for each user filter.	W
User filter "Filter(n)" offset	SINT	-128 to 127	Offset value for the calculated pixel values from the 3x3 filtering. Applied for each user filter.	W
User filter Filter(n) gain	UINT	0 to 65535	Multiplier for the calculated pixel values from the 3x3 filtering. Applied for each user filter.	W

TriggerForwarding

BOOL

0 or 1

Operating mode "Digital output" on the camera

PreTriggerTime

UINT

0 to 65535

Digital output lead time value from 0 µs to 65.5 ms in 1 µs steps.

Parameters

Type

Range of values

Description

Cyclic

Acyclic

UndervoltageError	BOOL	0 or 1	Power supply alarm	R
SensorTemperature	SINT	-128 to +127	Current camera temperature in °C	R
DigitalInput01	BOOL	0 or 1	Status digital input (trigger input)	R
ImageAcquisitionReady	BOOL	0 or 1	Camera availability status	R
CameraStatus	UDINT	0x00000000 to 0xFFFFFFFF	This parameter specifies the status of the camera.	R
CameraProcessingTime	UINT	0 to 65535	Processing time in milliseconds	R
ReadGainLevel	USINT	0 to 255	Current GainLevel	R
ReadFocus	UINT	0 to 65535	Current focus setting from "MOD" to "Infinity"	R
ReadExposureTime	UDINT	1 to 16,777,216	Current integration time of the sensor in microseconds	R
ImageProcessingError	UDINT	0x00000000 to 0xFFFFFFFF	Bit pattern for displaying errors and warnings that occurred during image processing.
AcceptedAcquisitionCnt	USINT	0 to 255	Counter for accepted image acquisitions	R
CompletedAcquisitionCnt	USINT	0 to 255	Counter for performed image acquisitions	R
FailedAcquisitionCnt	USINT	0 to 255	Counter for failed image acquisitions	R
LightWarningCnt	USINT	0 to 255	Counter for errors or warnings that have occurred related to lighting.	R
ImageNettime	DINT	-2,147,483,648 to 2,147,483,647	NetTime of the image in microseconds	R
DigitalOutputStatus01	BOOL	0 or 1	Status of digital output 01	R

DigitalOutput01	BOOL	0 or 1	Selects the mode of operation of the digital output	W
ImageAcquisition	BOOL	0 or 1	Enables/Disables the trigger for the image acquisition	W
ResetAcquisition	BOOL	0 or 1	Cancels an image acquisition triggered by NetTime	W
SearchAcquisitionSettings	BOOL	0 or 1	Enables/Disables search for focus and integration time of the sensor	W
IRFilter	BOOL	0 or 1	Enables/Disables the infrared filter	W
GainLevel	USINT	0 to 255	Sets a gain factor	W
SetFocus	UINT	0 to 65535	Sets the focus from "MOD" to "Infinity"	W
StatusLED	USINT	0 to 4	Selects the mode and color of the LED status indicator bars	W
ExposureTime(n)	UDINT	1 to 16,777,216	Sets the integration time of the sensor in microseconds	W
DelayNetTime(n)	DINT	-2,147,483,648 to 2,147,483,647	Sets Delay or NetTime for the trigger in microseconds	W
FlashColor(n)	USINT	0 to 255	Selects LED colors of the onboard LED lighting	W
FlashSegment(n)	USINT	0 to 0x0F	Enables/Disables LED segments	W
CyclicLineScanNettime	DINT	-2,147,483,648 to 2,147,483,647	Specifies the NetTime for dynamic line sensor mode.	W
CyclicLineScanPeriod	UDINT	0 to 4,294,967,295	Time between 2 image acquisitions in dynamic line sensor operation.	W
ChromaticLock	BOOL	0 or 1	Enables/Disables ChromaticLock	W

WidthMax	UINT	1 to 2592	Maximum number of pixels of the used sensor in the image width		R
HeightMax	UINT	1 to 2048	Maximum number of pixels of the used sensor in the image height		R

WidthMax

UINT

1 to 2592

Maximum number of pixels of the used sensor in the image width

HeightMax

UINT

1 to 2048

Maximum number of pixels of the used sensor in the image height

Constants
MultiCapture	USINT	1 to 10	Number of image acquisitions	W
LinesensorMode	BOOL	0 or 1	Switches the line sensor mode	W
Configuration parameters
TriggerSource	BOOL	0 or 1	Switches the source of the trigger (software/hardware)	W
TriggerDelay	BOOL	0 or 1	Switches the type of trigger delay	W
TriggerEdge	BOOL	0 or 1	Switches the edge direction at the digital input for triggering	W
Flip image horizontally	BOOL	0 or 1	Enables/Disables mirroring of the x-axis of the sensor	W
Flip image vertically	BOOL	0 or 1	Enables/Disables mirroring of the y-axis of the sensor	W
Binning	BOOL	0 or 1	Enables/Disables 2x2 binning	W
Subsampling	BOOL	0 or 1	Enables/Disables subsampling	W
ImageWidth (area-based) LineWidth (line-based)	UINT	1 to sensor width	Sets the width of the image to be acquired in pixels	W
ImageHeight (area-based) LineHeight (line-based)	UINT	1 to sensor height	Sets the height of the image to be acquired in pixels	W
ImageOffsetX (area-based) LineOffsetX (line-based)	UINT	0 to sensor width - 1	For the image to be acquired: Sets the offset on the x-axis in pixels	W
ImageOffsetY (area-based) LineOffsetY (line-based)	UINT	0 to sensor height - 1	For the image to be acquired: Sets the offset on the y-axis in pixels	W
Line sensor	BOOL	0 or 1	Enables/Disables line sensor mode	W
LinesPerImage	UINT	1 to 4096	Number of image acquisitions in line sensor mode	W
LineScanPeriod	UDINT	1 to 4,294,967,295	Time between 2 images in line sensor mode in ns	W
FocusScale	USINT	0 to 2	Sets the focus scaling 0 = Steps (raw data) 1 = mm 2 = 10 µm (default)	W
VignettingCorrection	BOOL	0 or 1	Enables/Disables vignetting correction	W
LEDTempDriftCorrection	BOOL	0 or 1	Enables/Disables LED temperature drift correction	W

Filter	USINT	0 to 255	Selects the preprocessing filter	W
User filter Filter(n) 11- 33	SINT	-128 to 127	Value of a filter coefficient of the 3x3 filter matrix of a user-defined filter. Applied 9 times for each user filter.	W
User filter "Filter(n)" offset	SINT	-128 to 127	Offset value for the calculated pixel values from the 3x3 filtering. Applied for each user filter.	W
User filter Filter(n) gain	UINT	0 to 65535	Multiplier for the calculated pixel values from the 3x3 filtering. Applied for each user filter.	W

Filter

USINT

0 to 255

Selects the preprocessing filter

User filter Filter(n) 11- 33

SINT

-128 to 127

Value of a filter coefficient of the 3x3 filter matrix of a user-defined filter.

Applied 9 times for each user filter.

User filter "Filter(n)" offset

SINT

-128 to 127