Regions​Of​Interest​Control Regions​Of​Interest​Control Regions​Of​Interest​Control Class

Definition

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

public sealed class RegionsOfInterestControl : IRegionsOfInterestControlpublic sealed class RegionsOfInterestControl : IRegionsOfInterestControlPublic NotInheritable Class RegionsOfInterestControl Implements IRegionsOfInterestControl
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

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

public bool AutoExposureSupported { get; }public bool AutoExposureSupported { get; }Public ReadOnly Property AutoExposureSupported As bool
Value
bool bool bool

true if auto exposure is supported; otherwise, false.

Attributes

AutoFocusSupported AutoFocusSupported AutoFocusSupported

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

public bool AutoFocusSupported { get; }public bool AutoFocusSupported { get; }Public ReadOnly Property AutoFocusSupported As bool
Value
bool bool bool

true if auto focus is supported; otherwise, false.

Attributes

AutoWhiteBalanceSupported AutoWhiteBalanceSupported AutoWhiteBalanceSupported

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

public bool AutoWhiteBalanceSupported { get; }public bool AutoWhiteBalanceSupported { get; }Public ReadOnly Property AutoWhiteBalanceSupported As bool
Value
bool bool bool

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

Attributes

MaxRegions MaxRegions MaxRegions

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

public uint MaxRegions { get; }public uint MaxRegions { get; }Public ReadOnly Property MaxRegions As uint
Value
uint uint uint

The maximum number of regions of interest.

Attributes

Methods

ClearRegionsAsync() ClearRegionsAsync() ClearRegionsAsync()

Asynchronously clears the regions of interests.

public IAsyncAction ClearRegionsAsync()public IAsyncAction ClearRegionsAsync()Public Function ClearRegionsAsync() As IAsyncAction
Returns

The object that is used to control the asynchronous operation.

Attributes

SetRegionsAsync(IIterable<RegionOfInterest>) SetRegionsAsync(IIterable<RegionOfInterest>) SetRegionsAsync(IIterable<RegionOfInterest>)

Asynchronously sets the regions of interest.

public IAsyncAction SetRegionsAsync(IIterable<RegionOfInterest> regions)public IAsyncAction SetRegionsAsync(IIterable<RegionOfInterest> regions)Public Function SetRegionsAsync(regions As IIterable<RegionOfInterest>) As IAsyncAction
Parameters
regions

The regions of interest.

Returns

The object that is used to control the asynchronous operation.

Attributes

SetRegionsAsync(IIterable<RegionOfInterest>, Boolean) SetRegionsAsync(IIterable<RegionOfInterest>, Boolean) SetRegionsAsync(IIterable<RegionOfInterest>, Boolean)

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

public IAsyncAction SetRegionsAsync(IIterable<RegionOfInterest> regions, Boolean lockValues)public IAsyncAction SetRegionsAsync(IIterable<RegionOfInterest> regions, Boolean lockValues)Public Function SetRegionsAsync(regions As IIterable<RegionOfInterest>, lockValues As Boolean) As IAsyncAction
Parameters
regions

The regions of interests.

lockValues
System.Boolean System.Boolean System.Boolean

Specifies if the values should be locked.

Returns

The object that is used to control the asynchronous operation.

Attributes

See Also