CAM_GETPARAM -- 获取参数

类型

图像采集相关

描述

使用参数名称,获取相机的参数值或扩展信息,结果为字符串。

支持扩展语法,即在名称后面加后缀如paramName: suffix ,参数名详情请参考附录II

语法

CAM_GETPARAM(paramName, max_len, tab_value)

参数:

name:参数名为字符串,可直接输参数名或参数名的扩展形式如下:

paramName : 参数名,支持扩展语法

max_lentab_value可使用的最大长度

tab_value:放置读取的参数值信息的TABLE起始索引

 

paramName解释如下:

paramName -- 参数名普通形式,获取参数名对应的值

paramName:Range -- 参数名以Range为后缀的扩展形式,获取参数的取值范围,Range后缀只支持整形、浮点型、布尔型、枚举型等参数。对于整形、浮点型参数值是以":"冒号分割开的,比如参数如果有步长限制的话则输出"minValue:maxValue:step"这种形式,若无步长限制则输出"minValue:maxValue"这种形式;对于布尔型参数值是以","逗号隔开的,如"0,1"这种形式;对于枚举型参数值也是以","逗号隔开的,如"enum1, enum2, enum3,..."这种形式

paramName:Num -- 参数名以Num为后缀的扩展形式,Num后缀只支持枚举类型参数,获取枚举值的数量

paramName:Len -- 参数名以Len为后缀的扩展形式,Len后缀只支持字符串类型参数,获取输出字符串的长度

paramName:Str -- 参数名以Str为后缀的扩展形式,Str后缀只支持枚举类型参数,获取枚举符号

paramName:Type -- 参数名以Type为后缀的扩展形式,Type后缀支持所有参数类型,获取参数的数据类型,如下表

Type

说明

-1

不支持或出错

0

布尔类型

1

整数类型

2

浮点数类型

3

字符串类型

4

枚举类型

5

命令类型

6

寄存器类型

适用控制器

支持ZV功能或者5系列以上的控制器

例子

列一:

获取整型参数"Width"的值,即图像的宽

DIM tmp(32)

CAM_GETPARAM("Width", 32, 0)  ‘如值为1280

DMCPY tmp(0), TABLE(0), 32

?"图像宽度 = "tmp

 

列二:

获取枚举型参数"TriggerMode "的枚举值的数量

DIM tmp(32)

CAM_GETPARAM("TriggerMode:Num", 20, 0)  ‘如值为2

DMCPY tmp(0), TABLE(0), 32

?"触发模式 = "tmp

 

列三:

获取浮点型参数" ExposureTime "的范围

DIM tmp(32)

CAM_GETPARAM("ExposureTime:Range", 32, 0)  ‘如值为1:1000000

DMCPY tmp(0), TABLE(0), 32

?"曝光时间 = "tmp

相关指令

CAM_SETPARAM(设置参数)