SceneAnalysisRecommendation Enum

Definition

Namespace:

Windows.Media.Core

Specifies the recommended image processing to improve image quality and fidelity of captured images based on the current capture conditions, as determined by the SceneAnalysisEffect.

public enum class SceneAnalysisRecommendation

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
enum class SceneAnalysisRecommendation

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
public enum SceneAnalysisRecommendation

var value = Windows.Media.Core.SceneAnalysisRecommendation.standard

Public Enum SceneAnalysisRecommendation

Inheritance

Enum

SceneAnalysisRecommendation

Attributes

ContractVersionAttribute

Windows requirements

Device family	Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v5.0)

Fields

Name	Value	Description
Standard	0	No image processing is recommended.
Hdr	1	High Dynamic Range (HDR) processing is recommended.
LowLight	2	Low-light processing is recommended.

Remarks

Get a value from this enumeration by implementing the SceneAnalysisEffect, registering a handler for the SceneAnalyzed event, and then checking the AnalysisRecommendation property of the SceneAnalysisEffectFrame passed in the event args. For more information on using the SceneAnalysisEffect, see Scene anlysis for MediaCapture.

If the effect recommends using HDR, you can do this in the following ways:

• Use the AdvancedPhotoCapture class to capture photos using the Windows built-in HDR processing algorithm. For more information, see High Dynamic Range (HDR) and low-light photo capture.
• Use the HdrVideoControl to capture video using the Windows built-in HDR processing algorithm. For more information, see Capture device controls for video capture.
• Use VariablePhotoSequenceCapture to capture a sequence of frames that you can then composite using a custom HDR implementation. For more information, see Variable photo sequence.

If the effect recomends low-light processing, you can implement this in the following ways:

• Use the AdvancedPhotoCapture class to capture photos using the Windows built-in low-light processing algorithm. For more information, see High Dynamic Range (HDR) and low-light photo capture.

• Use the LowLightFusion class to use the Windows built-in low-light processing algorithm on images that you capture without using AdvancedPhotoCapture.