Enum VideoCaptureVendorAPIValueType

Namespace: VisioForge.Core.Types.VideoCapture

Assembly: VisioForge.Core.dll

Defines vendor-specific API values for controlling advanced features of video capture devices.

public enum VideoCaptureVendorAPIValueType

Fields

Logitech_Version_None = 0

No vendor-specific version or feature. Used as a default or placeholder value.

Logitech_FaceTracking_Off = 1

Disables face tracking functionality on Logitech cameras.

When disabled, the camera will not automatically track faces in the video stream. The camera position and zoom will remain fixed at their current settings.

Logitech_FaceTracking_Single = 2

Enables single-face tracking mode on Logitech cameras.

In this mode, the camera automatically tracks and follows a single person's face, adjusting pan, tilt, and zoom to keep the face centered in the frame. This corresponds to the "Follow me" option in the Logitech Webcam Software settings panel.

Logitech_FaceTracking_Multiple = 3

Enables multi-face tracking mode on Logitech cameras.

In this mode, the camera attempts to track multiple faces simultaneously, adjusting the field of view to include all detected faces. This corresponds to the "Follow two or more of us" option in the Logitech Webcam Software settings panel.

Logitech_LED_On = 4

Sets the camera LED to remain on continuously when streaming video.

This provides a clear visual indicator that the camera is active and capturing video.

Logitech_LED_Off = 5

Turns off the camera LED completely, even during video streaming.

This setting disables the LED indicator for privacy or aesthetic reasons. Users should be aware that there will be no visual indication when the camera is active.

Logitech_LED_Blinking = 6

Sets the camera LED to blink at a specified frequency during video streaming.

The blinking frequency is specified in units of 0.1 Hertz through an additional parameter. This frequency determines how often the LED state changes per second.

For example:

Value 5 = 0.5 Hz = one state change every 2 seconds
Value 10 = 1.0 Hz = one state change every second
Value 20 = 2.0 Hz = two state changes per second

The LED alternates between on and off states at the specified frequency. If the frequency value is 0, the current blinking frequency remains unchanged. The precision of the blinking frequency may vary depending on the camera model and system load.

Logitech_LED_Auto = 7

Sets the camera LED to automatic mode, controlled by the camera firmware.

In automatic mode, the LED typically turns on when the camera is streaming video and turns off when streaming stops. This is the default behavior for most Logitech cameras and provides standard visual feedback about camera status.

Logitech_FindFace_Mode_Off = 8

Turn off automatic centering of the user’s face when a widescreen video stream is initiated. Turning the feature off automatically performs a reset to the default position. Note that even when the feature is off you can still initiate a manual centering process by specifying the value 2 for the value1 field.

Logitech_FindFace_Mode_On = 9

Turn on automatic centering of the user’s face when a widescreen video stream is initiated.

Logitech_FindFace_Mode_NoChange = 10

Do not turn the feature on or off. This value should be used when an action is specified using Reset. Note, however, that specifying a reset action does not prevent you from enabling or disabling the feature at the same time.

Logitech_FindFace_Reset_None = 11

Do not perform any action. This is typically used when the feature should simply be turned on or off.

Logitech_FindFace_Reset_Default = 12

Reset the field of view to its default position, which is typically the center.

Logitech_FindFace_Reset_Face = 13

Re-center the field of view to the current position of the user’s face. Note that for this to work the face tracker must be able to locate the face. If this is not currently possible, the centering process is delayed until the face is locatable again.

Logitech_Zoom = 14

Configure zoom.

Logitech_Pan = 15

Logitech camera - configure pan.

Logitech_Tilt = 16

Logitech camera - configure tilt.

Examples

// Enable face tracking for a Logitech camera
camera.SetVendorAPIValue(VideoCaptureVendorAPIValueType.Logitech_FaceTracking_Single);

// Control LED behavior
camera.SetVendorAPIValue(VideoCaptureVendorAPIValueType.Logitech_LED_Blinking, 5); // 0.5 Hz

// Pan the camera
camera.SetVendorAPIValue(VideoCaptureVendorAPIValueType.Logitech_Pan, panValue);

Remarks

This enumeration provides access to vendor-specific features that are not part of standard DirectShow or Windows video capture APIs. Currently, it primarily supports Logitech webcam features including face tracking, LED control, automatic face centering, and PTZ (Pan-Tilt-Zoom) controls.

These values are used in conjunction with vendor-specific API calls to control advanced camera features that go beyond basic capture functionality. The availability of these features depends on the specific camera model and installed drivers.

Table of Contents

Enum VideoCaptureVendorAPIValueType

Fields

Examples

Remarks