Skip to main content
VideoDeviceController.Roll | roll property

Applies to Windows and Windows Phone

Gets or sets the camera's roll setting.

Syntax


var roll = videoDeviceController.roll;

public MediaDeviceControl Roll { get; }

Public ReadOnly Property Roll As MediaDeviceControl

public:
property MediaDeviceControl^ Roll { 
   MediaDeviceControl^ get();
}

Property value

Type: MediaDeviceControl

A MediaDeviceControl object that provides methods to get and set the roll.

Remarks

Roll is rotation around the camera's image-viewing axis. Roll is specified in degrees.

Examples

The following example shows how to get the value of this property.


// Get the step size, minimum value, and maximum value of the roll property to set
// values on a slider control.

function setRollSlider() {

    var videoDev = null;
    var bValue = null;

    var mediaDevice = new Windows.Media.Capture.MediaCapture();
    videoDev = mediaDevice.videoDeviceController;

    if (videoDev.roll.capabilities.step !== 0)
    {
        bValue = videoDev.roll.tryGetValue();
        document.getElementById("slRoll").value = bValue.value;
        document.getElementById("slRoll").min = videoDev.roll.capabilities.min;
        document.getElementById("slRoll").max = videoDev.roll.capabilities.max;
        document.getElementById("slRoll").step = videoDev.roll.capabilities.step;
    }
} 

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Media.Devices
Windows::Media::Devices [C++]

Metadata

Windows.winmd

See also

VideoDeviceController