class ImageAnalysis::ImageAnalysisResult

class ImageAnalysis::ImageAnalysisResult
  : public Core::_detail::ResultBase< ImageAnalysisCoreResultReason, ImageAnalysisResultProperties >

Représente le résultat d’une opération d’analyse d’image.

Commencez toujours par appeler GetReason pour déterminer si l’opération d’analyse a réussi ou non. Lorsqu’une opération d’analyse réussit, les méthodes Get applicables dans cet objet retournent des résultats en fonction des fonctionnalités sélectionnées (ImageAnalysisOptions::SetFeatures) ou du modèle formé sur mesure (ImageAnalysisOptions::SetModelName). Ces résultats sont analysés à partir de la réponse JSON du service. D’autres méthodes Get retournent des objets de résultat Nullable sans valeur. Nous utilisons la classe Nullable pour contenir un résultat, en tant que conteneur pratique qui peut indiquer si un résultat a une valeur (voir Nullable::HasValue). Appelez ImageAnalysisResultDetails::FromResult pour accéder à des informations supplémentaires sur le résultat, telles que la réponse JSON brute. En cas d’échec de l’opération d’analyse, appelez ImageAnalysisErrorDetails::FromResult pour accéder à des informations supplémentaires sur l’erreur.

Membres

Propriétés

Syntaxe : public const ImageAnalysisResultProperties & Properties;

Obtient une collection de propriétés supplémentaires sur le résultat.

~ImageAnalysisResult

Syntaxe : public ~ImageAnalysisResult ( ) = default;

Détruit un instance de la classe ImageAnalysisResult.

GetReason

Syntaxe : public inline ImageAnalysisResultReason GetReason ( ) const;

Obtient une valeur indiquant pourquoi ce résultat a été généré.

Retours

Raison de ce résultat.

GetModelVersion

Syntaxe : public inline Nullable< std::string > GetModelVersion ( );

Obtient la version du modèle utilisée par image Analysis Service pour créer ce résultat.

Retours

Version du modèle.

GetImageHeight

Syntaxe : public inline Nullable< int32_t > GetImageHeight ( );

Obtient la hauteur, en pixels, de l’image analysée.

Retours

Objet Nullable contenant une valeur int32_t représentant la hauteur ou une valeur vide

Renseigné uniquement si l’image a été analysée avec succès

GetImageWidth

Syntaxe : public inline Nullable< int32_t > GetImageWidth ( );

Obtient la largeur, en pixels, de l’image analysée. Renseigné uniquement si l’image a été analysée correctement.

Retours

Objet Nullable contenant une valeur int32_t représentant la largeur ou une valeur vide

GetCaption

Syntaxe : public inline Nullable< ContentCaption > GetCaption ( );

Obtient une expression générée qui décrit le contenu de l’image analysée.

Ce résultat est renseigné uniquement si ImageAnalysisFeature::Caption a été inclus lors de l’appel de ImageAnalysisOptions::SetFeatures.

Retours

Objet Nullable contenant le résultat ContentCaption ou une valeur vide

GetDenseCaptions

Syntaxe : public inline Nullable< DenseCaptions > GetDenseCaptions ( );

Obtient jusqu’à 10 expressions générées, la première décrivant le contenu de l’image entière et les autres décrivant le contenu des différentes régions de l’image.

Ce résultat est renseigné uniquement si ImageAnalysisFeature::D enseCaptions a été inclus lors de l’appel de ImageAnalysisOptions::SetFeatures.

Retours

Objet Nullable contenant le résultat DenseCaptions ou une valeur vide

GetObjects

Syntaxe : public inline Nullable< DetectedObjects > GetObjects ( );

Obtient la liste des objets détectés à partir de l’image analysée.

Ce résultat est renseigné uniquement si ImageAnalysisFeature::Objects a été inclus lors de l’appel de ImageAnalysisOptions::SetFeatures.

Retours

Objet Nullable contenant le résultat DetectedObjects ou une valeur vide

Retours

GetCustomObjects

Syntaxe : public inline Nullable< DetectedObjects > GetCustomObjects ( );

Obtient la liste des objets détectés à partir de l’image analysée à l’aide du modèle personnalisé fourni.

Ce résultat peut être renseigné si ImageAnalysisOptions::SetModelName a été appelé et que le modèle personnalisé fourni a été entraîné pour détecter des objets.

Retours

Objet Nullable contenant le résultat DetectedObjects ou une valeur vide

Retours

GetText

Syntaxe : public inline Nullable< DetectedText > GetText ( );

Obtient une collection de lignes textuelles et de mots extraits à partir d’une image analysée.

Ce résultat est renseigné uniquement si ImageAnalysisFeature::Text a été inclus lors de l’appel de ImageAnalysisOptions::SetFeatures.

Retours

Objet Nullable contenant le résultat DetectedText ou une valeur vide.

GetTags

Syntaxe : public inline Nullable< ContentTags > GetTags ( );

Obtient la liste des détections de balise de contenu à partir de l’image analysée.

Ce résultat est renseigné uniquement si ImageAnalysisFeature::Tags a été inclus lors de l’appel de ImageAnalysisOptions::SetFeatures.

Retours

Objet Nullable contenant le résultat ContentTags ou une valeur vide.

GetCustomTags

Syntaxe : public inline Nullable< ContentTags > GetCustomTags ( );

Obtient une liste des détections de balise de contenu à partir de l’image analysée à l’aide du modèle entraîné personnalisé fourni.

Ce résultat peut être renseigné si ImageAnalysisOptions::SetModelName a été appelé et que le modèle personnalisé fourni a été entraîné pour détecter les balises.

Retours

Objet Nullable contenant le résultat ContentTags ou une valeur vide.

GetPeople

Syntaxe : public inline Nullable< DetectedPeople > GetPeople ( );

Obtient la liste des personnes détectées à partir d’une image analysée.

Ce résultat est renseigné uniquement si ImageAnalysisFeature::Personnes a été inclus lors de l’appel de ImageAnalysisOptions::SetFeatures.

Retours

Objet Nullable contenant le résultat DetectedPeople ou une valeur vide.

GetCropSuggestions

Syntaxe : public inline Nullable< CropSuggestions > GetCropSuggestions ( );

Obtient la liste des opérations de rognage d’image suggérées de l’image analysée aux proportions souhaitées (si elles sont fournies)

Est également connu sous le nom de SmartCrops. Ces suggestions de rognage conservent autant de contenu que possible tout en atteignant les proportions spécifiées (si elles sont fournies).

Ce résultat est renseigné uniquement si ImageAnalysisFeature::CropSuggestions a été inclus lors de l’appel de ImageAnalysisOptions::SetFeatures.

Si vous le souhaitez, spécifiez un ou plusieurs proportions de rognage souhaités en appelant ImageAnalysisOptions::SetCroppingAspectRatios. Si CroppingAspectRatios n’est pas défini, le service retourne une suggestion de rognage avec un rapport de proportions qu’il juge bon.

Retours

Objet Nullable contenant le résultat CropSuggestions ou une valeur vide.

GetSegmentationResult

Syntaxe : public inline Nullable< SegmentationResult > GetSegmentationResult ( );

Obtenez le résultat de l’opération de segmentation d’image.

Ce résultat n’est renseigné que si ImageAnalysisOptions::SetSegmentationMode() a été appelé avec ImageSegmentationMode::BackgroundRemoval ou ImageSegmentationMode::ForegroundMatting.

Retours

Objet Nullable contenant la valeur SegmentationResult ou une valeur vide.