KSPROPERTY_CAMERACONTROL_ZOOM
用户模式客户端使用 KSPROPERTY_CAMERACONTROL_ZOOM 属性获取或设置相机的缩放设置。 此属性是可选的。
使用情况摘要表
获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
---|---|---|---|---|
是 | 是 | 筛选器或节点 | KSPROPERTY_CAMERACONTROL_S 或 KSPROPERTY_CAMERACONTROL_NODE_S | LONG |
操作数据) (属性值是指定相机缩放设置的 LONG。 此值以毫米表示。
注意
编写或测试应用时,应注意,实际上,某些驱动程序定义了一系列自定义缩放值和自定义步长值,这些值可能不基于典型单位。 驱动程序可能以物理方式或数字方式实现缩放控件。
注解
KSPROPERTY_CAMERACONTROL_S 结构的 Value 成员指定缩放。
支持此属性的每个视频捕获微型驱动程序都必须定义此属性的范围和默认值。 设备的范围为 10 到 600。 默认值必须为 10。
对于使用基于人脸的 3A 平台 DMFT 的相机,缩放控件会影响相机的输出窗口。 平台 DMFT 生成的人脸坐标将相对于此修改后的输出窗口,因此当 Zoom 控件修改当前视场时,相机负责将 ROI 坐标重新映射到相机的完整视野。 根据视图修改的发生位置,坐标映射可能需要是双向的。 例如,如果在驱动程序链中平台 DMFT 之后的组件中实现视图修改,则需要将应用程序提供的 ROI 坐标映射回整个视场,然后再向下发送到相机,在平台 DMFT 中计算的 ROI 坐标需要映射到修改后的视野,然后再发送到请求它们的应用。
要求
标头: ksmedia.h (包括 Ksmedia.h)