SceneAnalysisRecommendation Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 SceneAnalysisRecommendationvar value = Windows.Media.Core.SceneAnalysisRecommendation.standardPublic Enum SceneAnalysisRecommendation- Inheritance
-
SceneAnalysisRecommendation
- Attributes
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.