類別 ImageAnalysis::ImageAnalysisResult

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

表示影像分析作業的結果。

請一律從呼叫 GetReason 開始,以判斷分析作業是否成功。 當分析作業成功時,此物件中適用的 Get 方法會根據選取的功能傳回結果, (ImageAnalysisOptions::SetFeatures) 或自訂定型模型 (ImageAnalysisOptions::SetModelName) 。 這些結果會從服務 JSON 回應進行剖析。 其他 Get 方法會傳回沒有值的可為 Null 的結果物件。 我們使用 Nullable 類別來保存結果,作為方便的容器,指出結果是否有值 (請參閱 Nullable::HasValue) 。 呼叫 ImageAnalysisResultDetails::FromResult 以存取結果的其他資訊,例如原始 JSON 回應。 分析作業失敗時,呼叫 ImageAnalysisErrorDetails::FromResult 以存取錯誤的其他資訊。

成員

屬性

語法: public const ImageAnalysisResultProperties & Properties;

取得結果上其他屬性的集合。

~ImageAnalysisResult

語法: public ~ImageAnalysisResult ( ) = default;

解構 ImageAnalysisResult 類別的實例。

GetReason

語法: public inline ImageAnalysisResultReason GetReason ( ) const;

取得值,指出產生此結果的原因。

傳回

此結果的原因。

GetModelVersion

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

取得影像分析服務用來建立此結果的模型版本。

傳回

模型的版本。

GetImageHeight

語法: public inline Nullable< int32_t > GetImageHeight ( );

取得分析影像的高度,以圖元為單位。

傳回

可為 Null 的物件,其int32_t值代表高度或空值

只有在成功分析影像時,才會填入

GetImageWidth

語法: public inline Nullable< int32_t > GetImageWidth ( );

取得分析影像的寬度,以圖元為單位。 只有在成功分析影像時才會填入。

傳回

可為 Null 的物件,其int32_t值代表寬度或空值

GetCaption

語法: public inline Nullable< ContentCaption > GetCaption ( );

取得產生的片語,描述分析影像的內容。

只有在呼叫 ImageAnalysisOptions::SetFeatures 時包含 ImageAnalysisFeature::Caption 時,才會填入此結果。

傳回

保留 ContentCaption 結果或空白值的可為 Null 物件

GetDenseCaptions

語法: public inline Nullable< DenseCaptions > GetDenseCaptions ( );

取得最多 10 個產生的片語、第一個描述整個影像的內容,以及描述影像不同區域內容的其他人。

只有在呼叫 ImageAnalysisOptions::SetFeatures 時包含 ImageAnalysisFeature::D enseCaptions 時,才會填入此結果。

傳回

可為 Null 的物件,保存 DenseCaptions 結果或空值

GetObjects

語法: public inline Nullable< DetectedObjects > GetObjects ( );

從分析的影像取得偵測到的物件清單。

只有在呼叫 ImageAnalysisOptions::SetFeatures 時包含 ImageAnalysisFeature::Objects 時,才會填入此結果。

傳回

可為 Null 的物件,保存 DetectedObjects 結果或空值

傳回

GetCustomObjects

語法: public inline Nullable< DetectedObjects > GetCustomObjects ( );

使用提供的自訂定型模型,從分析的影像中取得偵測到的物件清單。

如果呼叫 ImageAnalysisOptions::SetModelName,且提供的自訂模型已定型以偵測物件,可能會填入此結果。

傳回

可為 Null 的物件,保存 DetectedObjects 結果或空值

傳回

GetText

語法: public inline Nullable< DetectedText > GetText ( );

從分析的影像中取得擷取的文字行和字組集合。

只有在呼叫 ImageAnalysisOptions::SetFeatures 時包含 ImageAnalysisFeature::Text 時,才會填入此結果。

傳回

可為 Null 的物件,保留 DetectedText 結果或空值。

GetTags

語法: public inline Nullable< ContentTags > GetTags ( );

從分析的影像取得內容標記偵測的清單。

只有在呼叫 ImageAnalysisOptions::SetFeatures 時包含 ImageAnalysisFeature::Tags 時,才會填入此結果。

傳回

保留 ContentTags 結果或空白值的可為 Null 物件。

GetCustomTags

語法: public inline Nullable< ContentTags > GetCustomTags ( );

使用提供的自訂定型模型,從分析的影像取得內容標記偵測清單。

如果呼叫 ImageAnalysisOptions::SetModelName,且提供的自訂模型已定型以偵測標記,可能會填入此結果。

傳回

保留 ContentTags 結果或空白值的可為 Null 物件。

GetPeople

語法: public inline Nullable< DetectedPeople > GetPeople ( );

從分析影像取得偵測到的人員清單。

只有在呼叫 ImageAnalysisOptions::SetFeatures 時包含 ImageAnalysisFeature::人員,才會填入此結果。

傳回

可為 Null 的物件,保存 DetectedPeople 結果或空值。

GetCropSuggestions

語法: public inline Nullable< CropSuggestions > GetCropSuggestions ( );

取得所分析影像的建議影像裁剪作業清單,如果提供) ,則會以所需的外觀比例 (

也知道 SmartCrops。 如果提供) ,這些裁剪建議會盡可能保留內容,同時達到指定的外觀比例 (。

只有在呼叫 ImageAnalysisOptions::SetFeatures 時包含 ImageAnalysisFeature::CropSuggestions 時,才會填入此結果。

選擇性地呼叫 ImageAnalysisOptions::SetCroppingAspectRatios 來指定一或多個所需的裁剪外觀比例。 如果未設定 CroppingAspectRatios,服務會傳回一個裁剪建議,並顯示其外觀比例。

傳回

保留 CropSuggestions 結果或空白值的可為 Null 物件。

GetSegmentationResult

語法: public inline Nullable< SegmentationResult > GetSegmentationResult ( );

取得影像分割作業的結果。

只有在使用 ImageSegmentationMode::BackgroundRemoval 或 ImageSegmentationMode::ForegroundMatting 呼叫 ImageAnalysisOptions::SetSegmentationMode () 時,才會填入此結果。

傳回

可為 Null 的物件,保存分割區或空值。