class ImageAnalysis::ImageAnalysisResult

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

Reprezentuje wynik operacji analizy obrazów.

Zawsze zacznij od wywołania polecenia GetReason, aby określić, czy operacja analizy zakończyła się pomyślnie, czy nie. Gdy operacja analizy zakończy się pomyślnie, odpowiednie metody Get w tym obiekcie będą zwracać wyniki na podstawie wybranych funkcji (ImageAnalysisOptions::SetFeatures) lub niestandardowego modelu (ImageAnalysisOptions::SetModelName). Te wyniki są analizowane z odpowiedzi JSON usługi. Inne metody Get będą zwracać obiekty wyników dopuszczających wartość null bez wartości. Używamy klasy Null do przechowywania wyniku jako wygodnego kontenera, który może wskazywać, czy wynik ma wartość (zobacz Nullable::HasValue). Wywołaj metodę ImageAnalysisResultDetails::FromResult, aby uzyskać dostęp do dodatkowych informacji o wyniku, takich jak nieprzetworzona odpowiedź JSON. Gdy operacja analizy nie powiodła się, wywołaj metodę ImageAnalysisErrorDetails::FromResult, aby uzyskać dostęp do dodatkowych informacji o błędzie.

Elementy członkowskie

Właściwości

Składnia: public const ImageAnalysisResultProperties & Properties;

Pobiera kolekcję dodatkowych właściwości w wyniku.

~ImageAnalysisResult

Składnia: public ~ImageAnalysisResult ( ) = default;

Destrukuje wystąpienie klasy ImageAnalysisResult.

GetReason

Składnia: public inline ImageAnalysisResultReason GetReason ( ) const;

Pobiera wartość wskazującą, dlaczego ten wynik został wygenerowany.

Zwraca

Przyczyna tego wyniku.

GetModelVersion

Składnia: public inline Nullable< std::string > GetModelVersion ( );

Pobiera wersję modelu używaną przez usługę Image Analysis Service w celu utworzenia tego wyniku.

Zwraca

Wersja modelu.

GetImageHeight

Składnia: public inline Nullable< int32_t > GetImageHeight ( );

Pobiera wysokość w pikselach przeanalizowanego obrazu.

Zwraca

Obiekt dopuszczający wartość null zawierającą wartość int32_t reprezentującą wysokość lub pustą wartość

Wypełnione tylko wtedy, gdy obraz został pomyślnie przeanalizowany

GetImageWidth

Składnia: public inline Nullable< int32_t > GetImageWidth ( );

Pobiera szerokość w pikselach przeanalizowanego obrazu. Wypełnione tylko wtedy, gdy obraz został pomyślnie przeanalizowany.

Zwraca

Obiekt dopuszczający wartość null zawierającą wartość int32_t reprezentującą szerokość lub pustą wartość

GetCaption

Składnia: public inline Nullable< ContentCaption > GetCaption ( );

Pobiera wygenerowaną frazę opisową zawartości analizowanego obrazu.

Ten wynik zostanie wypełniony tylko wtedy, gdy właściwość ImageAnalysisFeature::Caption została uwzględniona podczas wywoływania elementu ImageAnalysisOptions::SetFeatures.

Zwraca

Obiekt dopuszczany do wartości null z wynikiem ContentCaption lub pustą wartością

GetDenseCaptions

Składnia: public inline Nullable< DenseCaptions > GetDenseCaptions ( );

Pobiera do 10 wygenerowanych fraz, pierwszy opisujący zawartość całego obrazu, a pozostałe opisujące zawartość różnych regionów obrazu.

Ten wynik zostanie wypełniony tylko wtedy, gdy parametr ImageAnalysisFeature::D enseCaptions został uwzględniony podczas wywoływania parametru ImageAnalysisOptions::SetFeatures.

Zwraca

Obiekt dopuszczany do wartości null z wynikiem DenseCaptions lub pustą wartością

GetObjects

Składnia: public inline Nullable< DetectedObjects > GetObjects ( );

Pobiera listę wykrytych obiektów z analizowanego obrazu.

Ten wynik zostanie wypełniony tylko wtedy, gdy element ImageAnalysisFeature::Objects został uwzględniony podczas wywoływania parametru ImageAnalysisOptions::SetFeatures.

Zwraca

Obiekt dopuszczalny do wartości null przechowujący wynik DetectedObjects lub pustą wartość

Zwraca

GetCustomObjects

Składnia: public inline Nullable< DetectedObjects > GetCustomObjects ( );

Pobiera listę wykrytych obiektów z analizowanego obrazu przy użyciu dostarczonego niestandardowego modelu wytrenowanego.

Ten wynik może zostać wypełniony, jeśli nazwa ImageAnalysisOptions::SetModelName została wywołana, a podany model niestandardowy został wytrenowany do wykrywania obiektów.

Zwraca

Obiekt dopuszczalny do wartości null przechowujący wynik DetectedObjects lub pustą wartość

Zwraca

GetText

Składnia: public inline Nullable< DetectedText > GetText ( );

Pobiera kolekcję wyodrębnionych wierszy tekstowych i wyrazów z analizowanego obrazu.

Ten wynik zostanie wypełniony tylko wtedy, gdy właściwość ImageAnalysisFeature::Text została uwzględniona podczas wywoływania elementu ImageAnalysisOptions::SetFeatures.

Zwraca

Obiekt dopuszczalny do wartości null przechowujący wynik DetectedText lub pustą wartość.

GetTags

Składnia: public inline Nullable< ContentTags > GetTags ( );

Pobiera listę wykrywania tagów zawartości z analizowanego obrazu.

Ten wynik zostanie wypełniony tylko wtedy, gdy właściwość ImageAnalysisFeature::Tags została uwzględniona podczas wywoływania elementu ImageAnalysisOptions::SetFeatures.

Zwraca

Obiekt dopuszczalny do wartości null z wynikiem ContentTags lub pustą wartością.

GetCustomTags

Składnia: public inline Nullable< ContentTags > GetCustomTags ( );

Pobiera listę wykrywania tagów zawartości z analizowanego obrazu przy użyciu dostarczonego niestandardowego modelu wytrenowanego.

Ten wynik może zostać wypełniony, jeśli nazwa imageAnalysisOptions::SetModelName została wywołana, a podany model niestandardowy został wytrenowany do wykrywania tagów.

Zwraca

Obiekt dopuszczalny do wartości null z wynikiem ContentTags lub pustą wartością.

GetPeople

Składnia: public inline Nullable< DetectedPeople > GetPeople ( );

Pobiera listę wykrytych osób z analizowanego obrazu.

Ten wynik zostanie wypełniony tylko wtedy, gdy parametr ImageAnalysisFeature::Osoby został uwzględniony podczas wywoływania parametru ImageAnalysisOptions::SetFeatures.

Zwraca

Obiekt dopuszczalny do wartości null z wynikiem DetectedPeople lub wartością pustą.

GetCropSuggestions

Składnia: public inline Nullable< CropSuggestions > GetCropSuggestions ( );

Pobiera listę sugerowanych operacji przycinania obrazu przeanalizowanego obrazu w żądanych współczynnikach proporcji (jeśli podano)

Wie również jako SmartCrops. Te sugestie przycinania zachowują jak najwięcej zawartości podczas osiągania określonych współczynników proporcji (jeśli podano).

Ten wynik zostanie wypełniony tylko wtedy, gdy parametr ImageAnalysisFeature::CropSuggestions został uwzględniony podczas wywoływania parametru ImageAnalysisOptions::SetFeatures.

Opcjonalnie określ co najmniej jeden żądany współczynnik proporcji przycinania, wywołując metodę ImageAnalysisOptions::SetCroppingAspectRatios. Jeśli właściwość CroppingAspectRatios nie jest ustawiona, usługa zwróci jedną sugestię przycinania z współczynnikiem proporcji, który widzi.

Zwraca

Obiekt dopuszczany do wartości null z wynikiem CropSuggestions lub pustą wartością.

GetSegmentationResult

Składnia: public inline Nullable< SegmentationResult > GetSegmentationResult ( );

Pobierz wynik operacji segmentacji obrazu.

Ten wynik zostanie wypełniony tylko wtedy, gdy element ImageAnalysisOptions::SetSegmentationMode() został wywołany za pomocą elementu ImageSegmentationMode::BackgroundRemoval lub ImageSegmentationMode::ForegroundMatting.

Zwraca

Obiekt dopuszczany do wartości null z wartością SegmentationResult lub pustą wartością.