classe ImageAnalysis::ImageAnalysisResult

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

Rappresenta il risultato di un'operazione di analisi delle immagini.

Iniziare sempre chiamando GetReason per determinare se l'operazione di analisi è riuscita o meno. Quando un'operazione di analisi ha esito positivo, i metodi Get applicabili in questo oggetto restituiranno i risultati in base alle funzionalità selezionate (ImageAnalysisOptions::SetFeatures) o al modello con training personalizzato (ImageAnalysisOptions::SetModelName). Questi risultati vengono analizzati dalla risposta JSON del servizio. Altri metodi Get restituiranno oggetti risultato Nullable senza alcun valore. Si usa la classe Nullable per contenere un risultato, come contenitore pratico che può indicare se un risultato ha valore (vedere Nullable::HasValue). Chiamare ImageAnalysisResultDetails::FromResult per ottenere l'accesso a informazioni aggiuntive sul risultato, ad esempio la risposta JSON non elaborata. Quando l'operazione di analisi non è riuscita, chiamare ImageAnalysisErrorDetails::FromResult per ottenere l'accesso a informazioni aggiuntive sull'errore.

Membri

Proprietà

Sintassi: public const ImageAnalysisResultProperties & Properties;

Ottiene una raccolta di proprietà aggiuntive sul risultato.

~ImageAnalysisResult

Sintassi: public ~ImageAnalysisResult ( ) = default;

Elimina un'istanza della classe ImageAnalysisResult.

GetReason

Sintassi: public inline ImageAnalysisResultReason GetReason ( ) const;

Ottiene un valore che indica perché questo risultato è stato generato.

Restituisce

Motivo di questo risultato.

GetModelVersion

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

Ottiene la versione del modello usata dal servizio Analisi immagini per creare questo risultato.

Restituisce

Versione del modello.

GetImageHeight

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

Ottiene l'altezza, in pixel, dell'immagine analizzata.

Restituisce

Oggetto Nullable che contiene un valore int32_t che rappresenta l'altezza o un valore vuoto

Popolato solo se l'immagine è stata analizzata correttamente

GetImageWidth

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

Ottiene la larghezza, in pixel, dell'immagine analizzata. Popolato solo se l'immagine è stata analizzata correttamente.

Restituisce

Oggetto Nullable che contiene un valore int32_t che rappresenta la larghezza o un valore vuoto

GetCaption

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

Ottiene una frase generata che descrive il contenuto dell'immagine analizzata.

Questo risultato verrà popolato solo se ImageAnalysisFeature::Caption è stato incluso durante la chiamata di ImageAnalysisOptions::SetFeatures.

Restituisce

Oggetto Nullable che contiene il risultato ContentCaption o un valore vuoto

GetDenseCaptions

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

Ottiene fino a 10 frasi generate, la prima che descrive il contenuto dell'intera immagine e gli altri che descrivono il contenuto di diverse aree dell'immagine.

Questo risultato verrà popolato solo se ImageAnalysisFeature::D enseCaptions è stato incluso durante la chiamata di ImageAnalysisOptions::SetFeatures.

Restituisce

Oggetto Nullable che contiene il risultato DenseCaptions o un valore vuoto

GetObjects

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

Ottiene un elenco di oggetti rilevati dall'immagine analizzata.

Questo risultato verrà popolato solo se ImageAnalysisFeature::Objects è stato incluso durante la chiamata di ImageAnalysisOptions::SetFeatures.

Restituisce

Oggetto Nullable che contiene il risultato DetectedObjects o un valore vuoto

Restituisce

GetCustomObjects

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

Ottiene un elenco di oggetti rilevati dall'immagine analizzata usando il modello con training personalizzato specificato.

Questo risultato può essere popolato se ImageAnalysisOptions::SetModelName è stato chiamato e il modello personalizzato specificato è stato sottoposto a training per rilevare gli oggetti.

Restituisce

Oggetto Nullable che contiene il risultato DetectedObjects o un valore vuoto

Restituisce

GetText

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

Ottiene una raccolta di righe e parole testuali estratte da un'immagine analizzata.

Questo risultato verrà popolato solo se ImageAnalysisFeature::Text è stato incluso durante la chiamata di ImageAnalysisOptions::SetFeatures.

Restituisce

Oggetto Nullable che contiene il risultato DetectedText o un valore vuoto.

GetTags

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

Ottiene un elenco di rilevamenti di tag di contenuto dall'immagine analizzata.

Questo risultato verrà popolato solo se ImageAnalysisFeature::Tags è stato incluso durante la chiamata di ImageAnalysisOptions::SetFeatures.

Restituisce

Oggetto Nullable che contiene il risultato ContentTags o un valore vuoto.

GetCustomTags

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

Ottiene un elenco di rilevamenti di tag di contenuto dall'immagine analizzata usando il modello con training personalizzato specificato.

Questo risultato può essere popolato se ImageAnalysisOptions::SetModelName è stato chiamato e il modello personalizzato specificato è stato sottoposto a training per rilevare i tag.

Restituisce

Oggetto Nullable che contiene il risultato ContentTags o un valore vuoto.

GetPeople

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

Ottiene un elenco di persone rilevate da un'immagine analizzata.

Questo risultato verrà popolato solo se ImageAnalysisFeature::Persone è stato incluso durante la chiamata di ImageAnalysisOptions::SetFeatures.

Restituisce

Oggetto Nullable che contiene il risultato DetectedPeople o un valore vuoto.

GetCropSuggestions

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

Ottiene un elenco di operazioni di ritaglio delle immagini suggerite dell'immagine analizzata in corrispondenza delle proporzioni desiderate (se specificato)

Sa anche come SmartCrops. Questi suggerimenti di ritaglio mantengono il maggior numero possibile di contenuti durante il raggiungimento delle proporzioni specificate (se specificato).

Questo risultato verrà popolato solo se ImageAnalysisFeature::CropSuggestions è stato incluso durante la chiamata di ImageAnalysisOptions::SetFeatures.

Facoltativamente, specificare una o più proporzioni di ritaglio desiderate chiamando ImageAnalysisOptions::SetCroppingAspectRatios. Se CroppingAspectRatios non è impostato, il servizio restituirà un suggerimento di ritaglio con un rapporto di aspetto che vede adattarsi.

Restituisce

Oggetto Nullable che contiene il risultato CropSuggestions o un valore vuoto.