类 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 ( );

获取分析图像的高度(以像素为单位)。

返回

一个 Nullable 对象,包含表示高度的int32_t值或空值

仅在成功分析图像时填充

GetImageWidth

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

获取已分析图像的宽度(以像素为单位)。 仅在成功分析图像时填充。

返回

包含表示宽度的int32_t值的 Nullable 对象,或空值

GetCaption

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

获取一个生成的短语,该短语描述分析的图像的内容。

仅当在调用 ImageAnalysisOptions::SetFeatures 时包含 ImageAnalysisFeature::Caption 时,才会填充此结果。

返回

包含 ContentCaption 结果或空值的可为 Null 对象

GetDenseCaptions

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

获取最多 10 个生成的短语,第一个用于描述整个图像的内容,另一个用于描述图像不同区域的内容。

仅当在调用 ImageAnalysisOptions::SetFeatures 时包含 ImageAnalysisFeature::D enseCaptions 时,才会填充此结果。

返回

包含 DenseCaptions 结果或空值的可为 Null 对象

GetObjects

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

从分析的图像中获取检测到的对象的列表。

仅当在调用 ImageAnalysisOptions::SetFeatures 时包含 ImageAnalysisFeature::Objects 时,才会填充此结果。

返回

包含 DetectedObjects 结果或空值的可为 Null 对象

返回

GetCustomObjects

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

使用提供的自定义训练模型从分析图像中获取检测到的对象的列表。

如果调用 ImageAnalysisOptions::SetModelName,并且已训练提供的自定义模型以检测对象,则可能会填充此结果。

返回

包含 DetectedObjects 结果或空值的可为 Null 对象

返回

GetText

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

从分析的图像中获取提取的文本行和单词的集合。

仅当在调用 ImageAnalysisOptions::SetFeatures 时包含 ImageAnalysisFeature::Text 时,才会填充此结果。

返回

包含 DetectedText 结果或空值的可为 Null 对象。

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::人员 时,才会填充此结果。

返回

包含 DetectedPeople 结果或空值的可为 Null 对象。

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 的对象,该对象包含 SegmentationResult 或空值。