KSPROPERTY_CAMERACONTROL_ROLL_RELATIVE

The KSPROPERTY_CAMERACONTROL_ROLL_RELATIVE property specifies camera rotation around the image viewing axis.

Usage Summary Table

Get Set Target Property descriptor type Property value type
Yes Yes Filter or node KSPROPERTY_CAMERACONTROL_S or KSPROPERTY_CAMERACONTROL_NODE_S LONG

The property value (operation data) is a LONG that specifies a camera's relative roll setting. The size of the value represents the desired rotation speed; a higher value represents a higher speed.

Value Description
0 Stop the roll.
Positive value Start rotating clockwise around the viewing axis.
Negative value Start rotating counterclockwise around the viewing axis.

Remarks

The Value member of the KSPROPERTY_CAMERACONTROL_NODE_S structure specifies the relative roll.

Note that a particular device might support only a certain speed range. To determine the range of speeds supported by the device, an application can issue a KSPROPERTY_TYPE_BASICSUPPORT request. You can specify KSPROPERTY_TYPE_BASICSUPPORT in the Flags member of the KSPROPERTY_ITEM structure.

Some devices support only a single rotation speed. In this case, the sign of the Value member indicates the direction of rotation.

When making a set request, the client should supply one of the values in the preceding table in the Value member of the KSPROPERTY_CAMERACONTROL_NODE_S structure.

When making a get request, the client receives one of the values in the preceding table in the Value member of the KSPROPERTY_CAMERACONTROL_NODE_S structure. The value indicates the current rotation status of the camera.

Requirements

Header: ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY_CAMERACONTROL_S

KSPROPERTY_CAMERACONTROL_NODE_S

KSPROPERTY_ITEM