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 的物件,保存分割區或空值。