klasse ImageAnalysis::ImageAnalysisResult

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

Vertegenwoordigt het resultaat van een afbeeldingsanalysebewerking.

Begin altijd met het aanroepen van GetReason om te bepalen of de analysebewerking is geslaagd of niet. Wanneer een analysebewerking is geslaagd, retourneren de toepasselijke Get-methoden in dit object resultaten op basis van de geselecteerde functies (ImageAnalysisOptions::SetFeatures) of een aangepast getraind model (ImageAnalysisOptions::SetModelName). Deze resultaten worden geparseerd vanuit het JSON-antwoord van de service. Andere Get-methoden retourneren een null-resultaatobject zonder waarde. We gebruiken de klasse Nullable om een resultaat te bewaren, als een handige container die kan aangeven of een resultaat een waarde heeft (zie Nullable::HasValue). Roep ImageAnalysisResultDetails::FromResult aan om toegang te krijgen tot aanvullende informatie over het resultaat, zoals het onbewerkte JSON-antwoord. Wanneer de analysebewerking is mislukt, roept u ImageAnalysisErrorDetails::FromResult aan om toegang te krijgen tot aanvullende informatie over de fout.

Leden

Eigenschappen

Syntaxis: public const ImageAnalysisResultProperties & Properties;

Hiermee haalt u een verzameling aanvullende eigenschappen op voor het resultaat.

~ImageAnalysisResult

Syntaxis: public ~ImageAnalysisResult ( ) = default;

Hiermee wordt een exemplaar van de klasse ImageAnalysisResult verwijderd.

GetReason

Syntaxis: public inline ImageAnalysisResultReason GetReason ( ) const;

Hiermee wordt een waarde opgehaald die aangeeft waarom dit resultaat is gegenereerd.

Retouren

Reden van dit resultaat.

GetModelVersion

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

Hiermee haalt u de modelversie op die door de Image Analysis Service wordt gebruikt om dit resultaat te maken.

Retouren

De versie van het model.

GetImageHeight

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

Hiermee wordt de hoogte, in pixels, van de geanalyseerde afbeelding opgehaald.

Retouren

Een null-object met een int32_t waarde die de hoogte vertegenwoordigt, of een lege waarde

Alleen ingevuld als de afbeelding is geanalyseerd

GetImageWidth

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

Hiermee wordt de breedte, in pixels, van de geanalyseerde afbeelding opgehaald. Alleen ingevuld als de afbeelding is geanalyseerd.

Retouren

Een null-object met een int32_t waarde die de breedte vertegenwoordigt, of een lege waarde

GetCaption

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

Hiermee haalt u een gegenereerde woordgroep op die de inhoud van de geanalyseerde afbeelding beschrijft.

Dit resultaat wordt alleen ingevuld als ImageAnalysisFeature::Caption is opgenomen tijdens het aanroepen van ImageAnalysisOptions::SetFeatures.

Retouren

Een null-object met het resultaat ContentCaption of een lege waarde

GetDenseCaptions

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

Hiermee worden maximaal 10 gegenereerde zinnen opgehaald, waarbij de eerste de inhoud van de hele afbeelding beschrijft en de andere die de inhoud van verschillende gebieden van de afbeelding beschrijven.

Dit resultaat wordt alleen ingevuld als ImageAnalysisFeature::D enseCaptions is opgenomen tijdens het aanroepen van ImageAnalysisOptions::SetFeatures.

Retouren

Een Nullable-object met het resultaat DenseCaptions of een lege waarde

GetObjects

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

Hiermee haalt u een lijst met gedetecteerde objecten op uit de geanalyseerde afbeelding.

Dit resultaat wordt alleen ingevuld als ImageAnalysisFeature::Objects is opgenomen tijdens het aanroepen van ImageAnalysisOptions::SetFeatures.

Retouren

Een null-object met het resultaat DetectedObjects of een lege waarde

Retouren

GetCustomObjects

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

Hiermee haalt u een lijst met gedetecteerde objecten op uit de geanalyseerde afbeelding met behulp van het opgegeven aangepaste model.

Dit resultaat kan worden ingevuld als ImageAnalysisOptions::SetModelName is aangeroepen en het opgegeven aangepaste model is getraind om objecten te detecteren.

Retouren

Een null-object met het resultaat DetectedObjects of een lege waarde

Retouren

Gettext

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

Hiermee haalt u een verzameling geëxtraheerde tekstregels en woorden op uit een geanalyseerde afbeelding.

Dit resultaat wordt alleen ingevuld als ImageAnalysisFeature::Text is opgenomen tijdens het aanroepen van ImageAnalysisOptions::SetFeatures.

Retouren

Een null-object met het resultaat DetectedText of een lege waarde.

GetTags

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

Hiermee haalt u een lijst met detecties van inhoudstags op uit de geanalyseerde afbeelding.

Dit resultaat wordt alleen ingevuld als ImageAnalysisFeature::Tags is opgenomen tijdens het aanroepen van ImageAnalysisOptions::SetFeatures.

Retouren

Een null-object met het resultaat ContentTags of een lege waarde.

GetCustomTags

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

Haalt een lijst met inhoudstagdetecties op van de geanalyseerde afbeelding met behulp van het opgegeven aangepaste getrainde model.

Dit resultaat kan worden ingevuld als ImageAnalysisOptions::SetModelName is aangeroepen en het opgegeven aangepaste model is getraind om tags te detecteren.

Retouren

Een null-object met het resultaat ContentTags of een lege waarde.

GetPeople

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

Hiermee haalt u een lijst met gedetecteerde personen op uit een geanalyseerde afbeelding.

Dit resultaat wordt alleen ingevuld als ImageAnalysisFeature::Mensen is opgenomen tijdens het aanroepen van ImageAnalysisOptions::SetFeatures.

Retouren

Een Nullable-object met het resultaat DetectedPeople of een lege waarde.

GetCropSuggesties

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

Hiermee haalt u een lijst op met voorgestelde bijsnijdbewerkingen van de geanalyseerde afbeelding met de gewenste hoogte-breedteverhoudingen (indien opgegeven)

Ook wel Bekend als SmartCrops. Met deze suggesties voor bijsnijden blijft zoveel mogelijk inhoud behouden terwijl de opgegeven hoogte-breedteverhoudingen worden bereikt (indien opgegeven).

Dit resultaat wordt alleen ingevuld als ImageAnalysisFeature::CropSuggestions is opgenomen tijdens het aanroepen van ImageAnalysisOptions::SetFeatures.

Geef desgewenst een of meer gewenste hoogte-breedteverhoudingen voor bijsnijden op door ImageAnalysisOptions::SetCroppingAspectRatios aan te roepen. Als CroppingAspectRatios niet is ingesteld, retourneert de service één bijsnijdsuggesties met een hoogte-breedteverhouding die geschikt is.

Retouren

Een null-object met het resultaat CropSuggestions of een lege waarde.

GetSegmentationResult

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

Haal het resultaat van de afbeeldingssegmentatiebewerking op.

Dit resultaat wordt alleen ingevuld als ImageAnalysisOptions::SetSegmentationMode() is aangeroepen met ImageSegmentationMode::BackgroundRemoval of ImageSegmentationMode::ForegroundMatting.

Retouren

Een null-object met segmentationResult of een lege waarde.