class ImageAnalysis::ImageAnalysisResult

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

이미지 분석 작업의 결과를 나타냅니다.

항상 GetReason을 호출하여 분석 작업이 성공했는지 여부를 확인합니다. 분석 작업이 성공하면 이 개체의 해당 Get 메서드는 선택한 기능(ImageAnalysisOptions::SetFeatures) 또는 사용자 지정 학습 모델(ImageAnalysisOptions::SetModelName)에 따라 결과를 반환합니다. 이러한 결과는 서비스 JSON 응답에서 구문 분석됩니다. 다른 Get 메서드는 값이 없는 Nullable 결과 개체를 반환합니다. Nullable 클래스를 사용하여 결과에 값이 있는지 여부를 나타낼 수 있는 편리한 컨테이너로 결과를 저장합니다(Nullable::HasValue 참조). ImageAnalysisResultDetails::FromResult를 호출하여 원시 JSON 응답과 같은 결과에 대한 추가 정보에 액세스합니다. 분석 작업이 실패하면 ImageAnalysisErrorDetails::FromResult를 호출하여 오류에 대한 추가 정보에 액세스합니다.

멤버

속성

구문: public const ImageAnalysisResultProperties & Properties;

결과에 대한 추가 속성의 컬렉션을 가져옵니다.

~ImageAnalysisResult

구문: public ~ImageAnalysisResult ( ) = default;

ImageAnalysisResult 클래스의 instance 소멸합니다.

GetReason

구문: public inline ImageAnalysisResultReason GetReason ( ) const;

이 결과가 생성된 이유를 나타내는 값을 가져옵니다.

반환

이 결과의 이유입니다.

GetModelVersion

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

Image Analysis Service에서 이 결과를 만드는 데 사용하는 모델 버전을 가져옵니다.

반환

모델의 버전입니다.

GetImageHeight

구문: public inline Nullable< int32_t > GetImageHeight ( );

분석된 이미지의 높이(픽셀)를 가져옵니다.

반환

높이 또는 빈 값을 나타내는 int32_t 값을 포함하는 Nullable 개체

이미지가 성공적으로 분석된 경우에만 채워집니다.

GetImageWidth

구문: public inline Nullable< int32_t > GetImageWidth ( );

분석된 이미지의 너비를 픽셀 단위로 가져옵니다. 이미지가 성공적으로 분석된 경우에만 채워집니다.

반환

너비 또는 빈 값을 나타내는 int32_t 값을 포함하는 Nullable 개체

GetCaption

구문: public inline Nullable< ContentCaption > GetCaption ( );

분석된 이미지의 내용을 설명하는 생성된 구를 가져옵니다.

이 결과는 ImageAnalysisOptions::SetFeatures를 호출하는 동안 ImageAnalysisFeature::Caption이 포함된 경우에만 채워집니다.

반환

ContentCaption 결과 또는 빈 값을 포함하는 Nullable 개체

GetDenseCaptions

구문: public inline Nullable< DenseCaptions > GetDenseCaptions ( );

생성된 구를 최대 10개까지 가져오며, 첫 번째는 전체 이미지의 콘텐츠를 설명하고 다른 구는 이미지의 다른 영역의 콘텐츠를 설명합니다.

이 결과는 ImageAnalysisOptions::SetFeatures를 호출하는 동안 ImageAnalysisFeature::D enseCaptions가 포함된 경우에만 채워집니다.

반환

DenseCaptions 결과 또는 빈 값을 포함하는 Nullable 개체

GetObjects

구문: public inline Nullable< DetectedObjects > GetObjects ( );

분석된 이미지에서 검색된 개체의 목록을 가져옵니다.

이 결과는 ImageAnalysisOptions::SetFeatures를 호출하는 동안 ImageAnalysisFeature::Objects가 포함된 경우에만 채워집니다.

반환

DetectedObjects 결과 또는 빈 값을 포함하는 Nullable 개체

반환

GetCustomObjects

구문: public inline Nullable< DetectedObjects > GetCustomObjects ( );

제공된 사용자 지정 학습 모델을 사용하여 분석된 이미지에서 검색된 개체 목록을 가져옵니다.

ImageAnalysisOptions::SetModelName이 호출되고 제공된 사용자 지정 모델이 개체를 검색하도록 학습된 경우 이 결과가 채워질 수 있습니다.

반환

DetectedObjects 결과 또는 빈 값을 포함하는 Nullable 개체

반환

GetText

구문: public inline Nullable< DetectedText > GetText ( );

분석된 이미지에서 추출된 텍스트 줄과 단어의 컬렉션을 가져옵니다.

이 결과는 ImageAnalysisOptions::SetFeatures를 호출하는 동안 ImageAnalysisFeature::Text가 포함된 경우에만 채워집니다.

반환

DetectedText 결과 또는 빈 값을 포함하는 Nullable 개체입니다.

GetTags

구문: public inline Nullable< ContentTags > GetTags ( );

분석된 이미지에서 콘텐츠 태그 검색 목록을 가져옵니다.

이 결과는 ImageAnalysisOptions::SetFeatures를 호출하는 동안 ImageAnalysisFeature::Tags가 포함된 경우에만 채워집니다.

반환

ContentTags 결과 또는 빈 값을 포함하는 Nullable 개체입니다.

GetCustomTags

구문: public inline Nullable< ContentTags > GetCustomTags ( );

제공된 사용자 지정 학습 모델을 사용하여 분석된 이미지에서 콘텐츠 태그 검색 목록을 가져옵니다.

ImageAnalysisOptions::SetModelName이 호출되고 제공된 사용자 지정 모델이 태그를 검색하도록 학습된 경우 이 결과가 채워질 수 있습니다.

반환

ContentTags 결과 또는 빈 값을 포함하는 Nullable 개체입니다.

GetPeople

구문: public inline Nullable< DetectedPeople > GetPeople ( );

분석된 이미지에서 검색된 사용자 목록을 가져옵니다.

이 결과는 ImageAnalysisOptions::SetFeatures를 호출하는 동안 ImageAnalysisFeature::사람 포함된 경우에만 채워집니다.

반환

DetectedPeople 결과 또는 빈 값을 포함하는 Nullable 개체입니다.

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()를 호출한 경우에만 채워집니다.

반환

SegmentationResult 또는 빈 값을 포함하는 Nullable 개체입니다.