Dela via


class ImageAnalysis::ImageAnalysisResult

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

Representerar resultatet av en bildanalysåtgärd.

Börja alltid med att anropa GetReason för att avgöra om analysåtgärden lyckades eller inte. När en analysåtgärd lyckas returnerar tillämpliga Get-metoder i det här objektet resultat baserat på de valda funktionerna (ImageAnalysisOptions::SetFeatures) eller anpassad tränad modell (ImageAnalysisOptions::SetModelName). Dessa resultat tolkas från JSON-svaret för tjänsten. Andra Get-metoder returnerar ett null-resultatobjekt utan värde. Vi använder klassen Nullable för att lagra ett resultat, som en praktisk container som kan indikera om ett resultat har ett värde (se Nullable::HasValue). Anropa ImageAnalysisResultDetails::FromResult för att få åtkomst till ytterligare information om resultatet, till exempel JSON-råsvaret. När analysåtgärden misslyckades anropar du ImageAnalysisErrorDetails::FromResult för att få åtkomst till ytterligare information om felet.

Medlemmar

Egenskaper

Syntax: public const ImageAnalysisResultProperties & Properties;

Hämtar en samling ytterligare egenskaper för resultatet.

~ImageAnalysisResult

Syntax: public ~ImageAnalysisResult ( ) = default;

Förstör en instans av klassen ImageAnalysisResult.

GetReason

Syntax: public inline ImageAnalysisResultReason GetReason ( ) const;

Hämtar ett värde som anger varför det här resultatet genererades.

Returer

Orsaken till det här resultatet.

GetModelVersion

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

Hämtar den modellversion som används av Image Analysis Service för att skapa det här resultatet.

Returer

Modellens version.

GetImageHeight

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

Hämtar höjden i bildpunkter för den analyserade bilden.

Returer

Ett null-objekt som innehåller ett int32_t värde som representerar höjden eller ett tomt värde

Fylls endast i om bilden har analyserats

GetImageWidth

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

Hämtar bredden i bildpunkter för den analyserade bilden. Fylls endast i om bilden har analyserats.

Returer

Ett null-objekt som innehåller ett int32_t värde som representerar bredden eller ett tomt värde

GetCaption

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

Hämtar en genererad fras som beskriver innehållet i den analyserade bilden.

Det här resultatet fylls bara i om ImageAnalysisFeature::Caption inkluderades när ImageAnalysisOptions::SetFeatures anropades.

Returer

Ett null-objekt som innehåller ContentCaption-resultatet eller ett tomt värde

GetDenseCaptions

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

Hämtar upp till 10 genererade fraser, den första som beskriver innehållet i hela bilden och de andra som beskriver innehållet i olika regioner i bilden.

Det här resultatet fylls bara i om ImageAnalysisFeature::D enseCaptions inkluderades när ImageAnalysisOptions::SetFeatures anropades.

Returer

Ett null-objekt med Resultatet DenseCaptions eller ett tomt värde

GetObjects

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

Hämtar en lista över identifierade objekt från den analyserade bilden.

Det här resultatet fylls bara i om ImageAnalysisFeature::Objects inkluderades när ImageAnalysisOptions::SetFeatures anropades.

Returer

Ett null-objekt som innehåller resultatet DetectedObjects eller ett tomt värde

Returer

GetCustomObjects

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

Hämtar en lista över identifierade objekt från den analyserade bilden med hjälp av den anpassade tränade modellen.

Det här resultatet kan fyllas i om ImageAnalysisOptions::SetModelName anropades och den angivna anpassade modellen tränades för att identifiera objekt.

Returer

Ett null-objekt som innehåller resultatet DetectedObjects eller ett tomt värde

Returer

Gettext

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

Hämtar en samling extraherade textrader och ord från en analyserad bild.

Det här resultatet fylls bara i om ImageAnalysisFeature::Text inkluderades när ImageAnalysisOptions::SetFeatures anropades.

Returer

Ett null-objekt som innehåller resultatet DetectedText eller ett tomt värde.

GetTags

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

Hämtar en lista över identifieringar av innehållstaggen från den analyserade bilden.

Det här resultatet fylls bara i om ImageAnalysisFeature::Tags inkluderades när ImageAnalysisOptions::SetFeatures anropades.

Returer

Ett null-objekt som innehåller ContentTags-resultatet eller ett tomt värde.

GetCustomTags

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

Hämtar en lista över identifieringar av innehållstaggen från den analyserade bilden med hjälp av den anpassade tränade modellen.

Det här resultatet kan fyllas i om ImageAnalysisOptions::SetModelName anropades och den angivna anpassade modellen tränades att identifiera taggar.

Returer

Ett null-objekt som innehåller ContentTags-resultatet eller ett tomt värde.

GetPeople

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

Hämtar en lista över identifierade personer från en analyserad bild.

Det här resultatet fylls bara i om ImageAnalysisFeature::Personer inkluderades när ImageAnalysisOptions::SetFeatures anropades.

Returer

Ett null-objekt som innehåller resultatet DetectedPeople eller ett tomt värde.

GetCropSuggestions

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

Hämtar en lista över föreslagna åtgärder för bildgrödor för den analyserade bilden vid önskade proportioner (om det tillhandahålls)

Även vet som SmartCrops. Dessa beskärningsförslag bevarar så mycket innehåll som möjligt samtidigt som de angivna proportionerna uppnås (om det tillhandahålls).

Det här resultatet fylls bara i om ImageAnalysisFeature::CropSuggestions inkluderades när ImageAnalysisOptions anropades::SetFeatures.

Du kan också ange en eller flera önskade beskärningsproportioner genom att anropa ImageAnalysisOptions::SetCroppingAspectRatios. Om CroppingAspectRatios inte har angetts returnerar tjänsten ett beskärningsförslag med ett proportioner som den anser lämpligt.

Returer

Ett null-objekt som innehåller CropSuggestions-resultatet eller ett tomt värde.

GetSegmentationResult

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

Hämta resultatet av avbildningssegmenteringsåtgärden.

Det här resultatet fylls bara i om ImageAnalysisOptions::SetSegmentationMode() anropades med antingen ImageSegmentationMode::BackgroundRemoval eller ImageSegmentationMode::ForegroundMatting.

Returer

Ett null-objekt som innehåller SegmentationResult eller ett tomt värde.