Edit

KSPROPERTY_CAMERACONTROL_PANTILT_RELATIVE

  • Article

The KSPROPERTY_CAMERACONTROL_PANTILT_RELATIVE property specifies horizontal or vertical rotation of the camera and can specify both simultaneously.

Usage Summary Table

Get Set Target Property descriptor type Property value type
Yes Yes Filter or node KSPROPERTY_CAMERACONTROL_NODE_S2 or KSPROPERTY_CAMERACONTROL_S2 depending on whether the request is for a filter or a node Pair of LONG integers

The property value (operation data) is a pair of LONG integers that specify a camera's relative pan and tilt settings. The size of the value represents the desired pan speed; a higher value represents a higher speed.

Value1 Description
0 Stop the horizontal motion of the camera.
Positive value Start panning to the right.
Negative value Start panning to the left.

The size of the value represents the desired tilt speed; a higher value represents a higher speed.

Value2 Description
0 Stop the vertical motion of the camera.
Positive value Start rotating the camera up.
Negative value Start rotating the camera down.

Remarks

When making a set request to pan the camera, the client should supply one of the values in the preceding table in Value1 member of the property descriptor structure.

Similarly, when making a set request to tilt the camera, the client supplies one of the values in the preceding table in Value2 member of the property descriptor structure.

When making a get request, the client receives the pan value in the Value1 member and the tilt value in the Value2 member of the KSPROPERTY_CAMERACONTROL_S2 or KSPROPERTY_CAMERACONTROL_NODE_S2 structure. The values indicate the current pan or tilt status of the camera.

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 pan or tilt speed. In this case, the sign of the Value1 or Value2 member indicates which direction to pan.

Requirements

Header: ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY_CAMERACONTROL_S2

KSPROPERTY_CAMERACONTROL_NODE_S2