VTSensor()

构造函数 | VTSensor 传感器类

📖 方法说明

实例化 VTSensor 类，用于操作纬钛视触觉传感器。该类提供了传感器初始化、数据采集、图像处理等核心功能。

---

📝 语法

from pyvitaisdk import VTSensor, VTSensorType

sensor = VTSensor(
    config=None, 
    marker_size=[9, 9], 
    marker_offsets=None，
    sensor_type=None
)

---

🔧 参数

参数名	类型	默认值	说明
config	VTSDeviceConfig | None	None	设备配置对象，通过 VTSDeviceFinder 获取。 离线数据处理时设置为 None
marker_size	int | List[int]	[9, 9]	Marker 点的行列数量 可以是整数（方形）或包含 2 个元素的列表 [rows, cols]
marker_offsets	List[int] | None	None	Marker 显示边界偏移参数 包含 4 个元素的列表：[上, 下, 左, 右]
sensor_type	VTSensorType | None	None	传感器类型，离线处理时需指定

---

📤 返回类型

VTSensor - VTSensor 传感器实例对象

---

💡 示例代码

在线数据采集（实时传感器）

from pyvitaisdk import VTSensor, VTSDeviceFinder

# 获取设备
finder = VTSDeviceFinder()
devices = finder.get_devices()

if devices:
    # 使用默认参数创建传感器实例
    sensor = VTSensor(devices[0])
    print("VTSensor 传感器已初始化（默认配置）")
    
    # 或使用自定义参数
    # sensor = VTSensor(
    #     config=devices[0],
    #     marker_size=[10, 10],
    #     marker_offsets=[5, 5, 5, 5]
    # )
    # print("VTSensor 传感器已初始化（自定义配置）")

    sensor.release() # 释放资源
else:
    print("未找到设备")

离线数据处理

from pyvitaisdk import VTSensor, VTSensorType

# 离线处理时，config 设置为 None
sensor = VTSensor(
    config=None,  # 离线模式
    marker_size=[9, 9],
    sensor_type=VTSensorType.GF225
)
print("VTSensor 传感器已初始化（离线处理模式）")
sensor.release()  # 释放资源

---

⚠️ 注意事项

设备配置

• 在线模式：config 参数必须是有效的 VTSDeviceConfig 对象
• 离线模式：config 参数设置为 None，用于处理已保存的图像数据，需设置sensor_type

Marker 配置建议

• marker_size：根据传感器表面的实际 Marker 点阵配置
• marker_offsets：用于调整可视化边界

---

🔗 相关方法

• VTSDeviceFinder() - 获取设备配置
• calibrate - 校准传感器
• collect_sensor_data - 采集传感器数据
• release - 释放传感器实例