class ImageAnalysis::ImageAnalysisResult

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

Representa o resultado de uma operação de Análise de Imagens.

Comece sempre por chamar GetReason para determinar se a operação de análise foi bem-sucedida ou não. Quando uma operação de análise for bem-sucedida, os métodos Get aplicáveis neste objeto devolverão resultados com base nas funcionalidades selecionadas (ImageAnalysisOptions::SetFeatures) ou no modelo preparado personalizado (ImageAnalysisOptions::SetModelName). Estes resultados são analisados a partir da resposta JSON do serviço. Outros métodos Get devolverão objetos de resultado anuláveis sem valor. Utilizamos a classe Anuláveis para conter um resultado, como um contentor conveniente que pode indicar se um resultado tem valor (veja Anulável::HasValue). Chame ImageAnalysisResultDetails::FromResult para obter acesso a informações adicionais sobre o resultado, como a resposta JSON não processada. Quando a operação de análise falhou, chame ImageAnalysisErrorDetails::FromResult para obter acesso a informações adicionais sobre o erro.

Membros

Propriedades

Sintaxe: public const ImageAnalysisResultProperties & Properties;

Obtém uma coleção de propriedades adicionais no resultado.

~ImageAnalysisResult

Sintaxe: public ~ImageAnalysisResult ( ) = default;

Desestrui uma instância da classe ImageAnalysisResult.

GetReason

Sintaxe: public inline ImageAnalysisResultReason GetReason ( ) const;

Obtém um valor que indica o motivo pelo qual este resultado foi gerado.

Devoluções

Motivo deste resultado.

GetModelVersion

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

Obtém a versão do modelo utilizada pelo Image Analysis Service para criar este resultado.

Devoluções

A versão do modelo.

GetImageHeight

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

Obtém a altura, em píxeis, da imagem analisada.

Devoluções

Um objeto nulo que contém um valor int32_t que representa a altura ou um valor vazio

Apenas preenchida se a imagem tiver sido analisada com êxito

GetImageWidth

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

Obtém a largura, em píxeis, da imagem analisada. Apenas preenchido se a imagem tiver sido analisada com êxito.

Devoluções

Um objeto nulo que contém um valor int32_t que representa a largura ou um valor vazio

GetCaption

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

Obtém uma expressão gerada que descreve o conteúdo da imagem analisada.

Este resultado só será preenchido se ImageAnalysisFeature::Caption tiver sido incluído ao chamar ImageAnalysisOptions::SetFeatures.

Devoluções

Um objeto nulo que contém o resultado ContentCaption ou um valor vazio

GetDenseCaptions

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

Obtém até 10 expressões geradas, a primeira descreve o conteúdo de toda a imagem e as outras que descrevem o conteúdo de diferentes regiões da imagem.

Este resultado só será preenchido se ImageAnalysisFeature::D enseCaptions tiver sido incluído ao chamar ImageAnalysisOptions::SetFeatures.

Devoluções

Um objeto nulo que contém o resultado DenseCaptions ou um valor vazio

GetObjects

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

Obtém uma lista de objetos detetados da imagem analisada.

Este resultado só será preenchido se ImageAnalysisFeature::Objects tiver sido incluído ao chamar ImageAnalysisOptions::SetFeatures.

Devoluções

Um objeto nulo com o resultado DetectedObjects ou um valor vazio

Devoluções

GetCustomObjects

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

Obtém uma lista de objetos detetados da imagem analisada com o modelo personalizado fornecido.

Este resultado pode ser preenchido se ImageAnalysisOptions::SetModelName tiver sido chamado e o modelo personalizado fornecido tiver sido preparado para detetar objetos.

Devoluções

Um objeto nulo com o resultado DetectedObjects ou um valor vazio

Devoluções

GetText

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

Obtém uma coleção de linhas textuais extraídas e palavras de uma imagem analisada.

Este resultado só será preenchido se ImageAnalysisFeature::Text tiver sido incluído ao chamar ImageAnalysisOptions::SetFeatures.

Devoluções

Um objeto anulável com o resultado DetectedText ou um valor vazio.

GetTags

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

Obtém uma lista de deteções de etiquetas de conteúdo da imagem analisada.

Este resultado só será preenchido se ImageAnalysisFeature::Tags tiver sido incluído ao chamar ImageAnalysisOptions::SetFeatures.

Devoluções

Um objeto nulo que contém o resultado contentTags ou um valor vazio.

GetCustomTags

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

Obtém uma lista de deteções de etiquetas de conteúdo da imagem analisada com o modelo de preparação personalizada fornecido.

Este resultado pode ser preenchido se ImageAnalysisOptions::SetModelName tiver sido chamado e o modelo personalizado fornecido tiver sido preparado para detetar etiquetas.

Devoluções

Um objeto nulo que contém o resultado contentTags ou um valor vazio.

GetPeople

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

Obtém uma lista de pessoas detetadas a partir de uma imagem analisada.

Este resultado só será preenchido se ImageAnalysisFeature::Pessoas tiver sido incluído ao chamar ImageAnalysisOptions::SetFeatures.

Devoluções

Um objeto nulo que contém o resultado DetectedPeople ou um valor vazio.

GetCropSuggestions

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

Obtém uma lista de operações de recorte de imagens sugeridas da imagem analisada nas proporções pretendidas (se for fornecida)

Também é conhecido como SmartCrops. Estas sugestões de recorte preservam o máximo de conteúdo possível, ao mesmo tempo que alcançam as proporções especificadas (se for fornecido).

Este resultado só será preenchido se ImageAnalysisFeature::CropSuggestions tiver sido incluído ao chamar ImageAnalysisOptions::SetFeatures.

Opcionalmente, especifique uma ou mais proporções de recorte pretendidas ao chamar ImageAnalysisOptions::SetCroppingAspectRatios. Se CroppingAspectRatios não estiver definido, o Serviço devolverá uma sugestão de recorte com uma proporção que lhe parece adequada.

Devoluções

Um objeto nulo que contém o resultado CropSuggestions ou um valor vazio.

GetSegmentationResult

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

Obtenha o resultado da operação de segmentação de imagens.

Este resultado só será preenchido se ImageAnalysisOptions::SetSegmentationMode() tiver sido chamado com ImageSegmentationMode::BackgroundRemoval ou ImageSegmentationMode::ForegroundMatting.

Devoluções

Um objeto nulo que contém SegmentationResult ou um valor vazio.