RegionsOfInterestControl RegionsOfInterestControl RegionsOfInterestControl RegionsOfInterestControl Class

Definition

Provides functionality to mange the regions of interest on a device.

public : sealed class RegionsOfInterestControl : IRegionsOfInterestControl
public sealed class RegionsOfInterestControl : IRegionsOfInterestControl
Public NotInheritable Class RegionsOfInterestControl Implements IRegionsOfInterestControl
// This class does not provide a public constructor.
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

The region of interest specifies the rectangular area of preview that functions such as focus and exposure are computed over. This enables scenarios such as tap to focus.

You can access the RegionsOfInterestControl for the capture device through the MediaCapture.VideoDeviceController.

For how-to guidance for using the RegionOfInterest object, see Effects for analyzing camera frames.

Properties

AutoExposureSupported AutoExposureSupported AutoExposureSupported AutoExposureSupported

Gets a value that specifies if auto exposure is supported on the capture device.

public : Platform::Boolean AutoExposureSupported { get; }
public bool AutoExposureSupported { get; }
Public ReadOnly Property AutoExposureSupported As bool
var bool = regionsOfInterestControl.autoExposureSupported;
Value
Platform::Boolean bool bool bool

true if auto exposure is supported; otherwise, false.

AutoFocusSupported AutoFocusSupported AutoFocusSupported AutoFocusSupported

Gets a value that specifies if auto focus is supported on the capture device.

public : Platform::Boolean AutoFocusSupported { get; }
public bool AutoFocusSupported { get; }
Public ReadOnly Property AutoFocusSupported As bool
var bool = regionsOfInterestControl.autoFocusSupported;
Value
Platform::Boolean bool bool bool

true if auto focus is supported; otherwise, false.

AutoWhiteBalanceSupported AutoWhiteBalanceSupported AutoWhiteBalanceSupported AutoWhiteBalanceSupported

Gets a value that specifies if auto white balance is supported on the capture device.

public : Platform::Boolean AutoWhiteBalanceSupported { get; }
public bool AutoWhiteBalanceSupported { get; }
Public ReadOnly Property AutoWhiteBalanceSupported As bool
var bool = regionsOfInterestControl.autoWhiteBalanceSupported;
Value
Platform::Boolean bool bool bool

true if auto white balance is supported; otherwise, false.

MaxRegions MaxRegions MaxRegions MaxRegions

Gets the maximum number of regions of interest that can be specified.

public : unsigned int MaxRegions { get; }
public uint MaxRegions { get; }
Public ReadOnly Property MaxRegions As uint
var uint = regionsOfInterestControl.maxRegions;
Value
unsigned int uint uint uint

The maximum number of regions of interest.

Methods

ClearRegionsAsync() ClearRegionsAsync() ClearRegionsAsync() ClearRegionsAsync()

Asynchronously clears the regions of interests.

public : IAsyncAction ClearRegionsAsync()
public IAsyncAction ClearRegionsAsync()
Public Function ClearRegionsAsync() As IAsyncAction
Windows.Media.Devices.RegionsOfInterestControl.clearRegionsAsync().done( /* Your success and error handlers */ );
Returns

The object that is used to control the asynchronous operation.

SetRegionsAsync(IIterable) SetRegionsAsync(IIterable) SetRegionsAsync(IIterable) SetRegionsAsync(IIterable)

Asynchronously sets the regions of interest.

public : IAsyncAction SetRegionsAsync(IIterable<RegionOfInterest> regions)
public IAsyncAction SetRegionsAsync(IEnumerable<RegionOfInterest> regions)
Public Function SetRegionsAsync(regions As IEnumerable<RegionOfInterest>) As IAsyncAction
Windows.Media.Devices.RegionsOfInterestControl.setRegionsAsync(regions).done( /* Your success and error handlers */ );
Parameters
regions
IIterable<RegionOfInterest> IEnumerable<RegionOfInterest> IEnumerable<RegionOfInterest> IEnumerable<RegionOfInterest>

The regions of interest.

Returns

The object that is used to control the asynchronous operation.

See Also

SetRegionsAsync(IIterable, Boolean) SetRegionsAsync(IIterable, Boolean) SetRegionsAsync(IIterable, Boolean) SetRegionsAsync(IIterable, Boolean)

Asynchronously sets the regions of interest and specifies if the values should be locked.

public : IAsyncAction SetRegionsAsync(IIterable<RegionOfInterest> regions, bool lockValues)
public IAsyncAction SetRegionsAsync(IEnumerable<RegionOfInterest> regions, Boolean lockValues)
Public Function SetRegionsAsync(regions As IEnumerable<RegionOfInterest>, lockValues As Boolean) As IAsyncAction
Windows.Media.Devices.RegionsOfInterestControl.setRegionsAsync(regions, lockValues).done( /* Your success and error handlers */ );
Parameters
regions
IIterable<RegionOfInterest> IEnumerable<RegionOfInterest> IEnumerable<RegionOfInterest> IEnumerable<RegionOfInterest>

The regions of interests.

lockValues
bool Boolean Boolean Boolean

Specifies if the values should be locked.

Returns

The object that is used to control the asynchronous operation.

See Also

See Also