RegionOfInterest RegionOfInterest RegionOfInterest RegionOfInterest Class

Definition

Namespace:: Windows.Media.Devices Windows.Media.Devices Windows.Media.Devices Windows.Media.Devices

Edit

Represents a region of interest which is a rectangular region on the image which is used for functions such as focus and exposure.

public : sealed class RegionOfInterest : IRegionOfInterest, IRegionOfInterest2public sealed class RegionOfInterest : IRegionOfInterest, IRegionOfInterest2Public NotInheritable Class RegionOfInterest Implements IRegionOfInterest, IRegionOfInterest2// You can use this class in JavaScript.

Attributes: ActivatableAttribute ContractVersionAttribute DualApiPartitionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 10 requirements

Device family	Windows 10 (introduced v10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

Get an instance of this class by accessing the RegionOfInterest property.

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.

Constructors

RegionOfInterest() RegionOfInterest() RegionOfInterest() RegionOfInterest()

Edit

Creates a new instance of the RegionOfInterest control.

public : RegionOfInterest()public RegionOfInterest()Public Sub New()// You can use this method in JavaScript.

Properties

AutoExposureEnabled AutoExposureEnabled AutoExposureEnabled AutoExposureEnabled

Edit

Gets or sets a value that specifies if auto exposure is enabled.

public : PlatForm::Boolean AutoExposureEnabled { get; set; }public bool AutoExposureEnabled { get; set; }Public ReadWrite Property AutoExposureEnabled As bool// You can use this property in JavaScript.

Value: PlatForm::Boolean bool bool bool

true if auto exposure is enabled; otherwise, false.

AutoFocusEnabled AutoFocusEnabled AutoFocusEnabled AutoFocusEnabled

Edit

Gets or sets a value that specifies if auto focus is enabled.

public : PlatForm::Boolean AutoFocusEnabled { get; set; }public bool AutoFocusEnabled { get; set; }Public ReadWrite Property AutoFocusEnabled As bool// You can use this property in JavaScript.

Value: PlatForm::Boolean bool bool bool

true if auto focus is enabled; otherwise, false.

AutoWhiteBalanceEnabled AutoWhiteBalanceEnabled AutoWhiteBalanceEnabled AutoWhiteBalanceEnabled

Edit

Gets or sets a value that specifies if auto white balance is enabled.

public : PlatForm::Boolean AutoWhiteBalanceEnabled { get; set; }public bool AutoWhiteBalanceEnabled { get; set; }Public ReadWrite Property AutoWhiteBalanceEnabled As bool// You can use this property in JavaScript.

Value: PlatForm::Boolean bool bool bool

true if auto white balance; otherwise, false.

Bounds Bounds Bounds Bounds

Edit

Gets or sets the rectangle that defines the region of focus.

public : Rect Bounds { get; set; }public Rect Bounds { get; set; }Public ReadWrite Property Bounds As Rect// You can use this property in JavaScript.

Value: Rect Rect Rect Rect

The rectangle that defines the region of focus.

Remarks

To specify a point with non-normalized coordinates, meaning the BoundsNormalized property is not set or set to FALSE, you should specify a rectangle with width of 1 and height of 1.

To specify a point with normalized coordinates, meaning BoundsNormalized is set to TRUE, you should specify a rectangle with width of FLT_EPSILON and height of FLT_EPSILON.

If the region of interest specified by the developer is smaller than what is supported by the hardware, the driver will default to the smallest supported rectangle possible that fully contains the specified region.

BoundsNormalized BoundsNormalized BoundsNormalized BoundsNormalized

Edit

Gets or sets a value indicating whether the Bounds Rect is in pixels or is mapped to a range of 0 to 1.0.

public : PlatForm::Boolean BoundsNormalized { get; set; }public bool BoundsNormalized { get; set; }Public ReadWrite Property BoundsNormalized As bool// You can use this property in JavaScript.

Value: PlatForm::Boolean bool bool bool

A value indicating whether the Bounds Rect is in pixels or is mapped to a range of 0 to 1.0.

Remarks

For information on how this property affects the bounds of the region of interest, see the Bounds property.

Type Type Type Type

Edit

Gets or sets the type of region represented by the RegionOfInterest object.

public : RegionOfInterestType Type { get; set; }public RegionOfInterestType Type { get; set; }Public ReadWrite Property Type As RegionOfInterestType// You can use this property in JavaScript.

Value: RegionOfInterestType RegionOfInterestType RegionOfInterestType RegionOfInterestType

The type of region represented by the RegionOfInterest object.

Weight Weight Weight Weight

Edit

Gets or sets the weight of the region of interest.

public : unsigned int Weight { get; set; }public uint Weight { get; set; }Public ReadWrite Property Weight As uint// You can use this property in JavaScript.

Value: unsigned int uint uint uint

Gets or sets the weight of the region of interest which is a value from 0-100.