다음을 통해 공유


class ImageAnalysis::ImageAnalysisOptions

ImageAnalyzer의 함수를 제어하는 구성 옵션을 나타냅니다.

표준 모델을 사용하여 이미지 분석을 수행하는 경우 SetFeatures()를 호출하고 분석할 하나 이상의 시각적 기능을 설정해야 합니다. 시각적 기능에 대한 기본 선택은 없습니다. 사용자 지정 모델을 사용하거나 이미지 구분을 수행하는 경우 시각적 기능을 지정할 필요가 없습니다.

멤버

고급

구문: public AdvancedOptions & Advanced;

고급 옵션 및 매개 변수.

SetFeatures

구문: public inline void SetFeatures ( const std::vector< ImageAnalysisFeature > & ImageAnalysisFeatures );

이미지에서 추출할 하나 이상의 시각적 기능 목록을 설정합니다.

기본 모델을 사용하는 경우 하나 이상의 시각적 기능을 지정해야 합니다. SetModelName을 호출하여 사용자 지정 학습 모델을 사용하는 경우 모델에서 암시된 시각적 기능을 지정할 필요가 없습니다. SetSegmentationMode를 호출하여 이미지 구분을 수행하는 경우 시각적 기능을 지정할 필요가 없습니다. SetFeatures 및/또는 SetModelName을 호출하여 시각적 기능을 추출하거나 세분화(SetSegmentationMode 호출)를 수행할 수 있지만 동시에 둘 다 수행할 수는 없습니다.

매개 변수

  • ImageAnalysisFeatures 시각적 기능 목록

GetFeatures

구문: public inline std::vector< ImageAnalysisFeature > GetFeatures ( );

이미지에서 추출할 하나 이상의 시각적 기능 목록을 가져옵니다.

반환

시각적 기능 목록

SetCroppingAspectRatios

구문: public inline void SetCroppingAspectRatios ( const std::vector< double > & aspectRatios );

자르기 제안이 맞도록 시도해야 하는 가로 세로 비율 목록을 설정합니다(스마트 작물이라고도 함).

가로 세로 비율은 대상 자르기 너비를 높이로 나누어 계산됩니다.

지원되는 값은 0.75에서 1.8(포함) 사이입니다.

이 메서드를 호출하는 것은 ImageAnalysisFeature::CropSuggestions가 분석할 이미지 기능 중 하나로 설정된 경우에만 관련이 있습니다(ImageAnalysisOptions::SetFeatures 메서드 참조).

SetCroppingAspectRatios()가 호출되지 않지만 ImageAnalysisFeature::CropSuggestions가 기능으로 지정된 경우 서비스는 가로 세로 비율로 0.5에서 2.0(포함) 사이에 맞는 하나의 자르기 제안을 반환합니다.

매개 변수

  • aspectRatios 양수(양수)의 양수 목록

GetCroppingAspectRatios

구문: public inline std::vector< double > GetCroppingAspectRatios ( );

자르기(스마트 작물이라고도 함)에 사용할 가로 세로 비율 목록을 가져옵니다.

반환

가로 세로 비율 목록입니다. 가로 세로 비율이 이전에 설정되지 않은 경우 이 목록은 비어 있습니다.

가로 세로 비율은 대상 자르기 너비를 높이로 나누어 계산됩니다.

지원되는 값은 0.75에서 1.8(포함) 사이입니다.

SetLanguage

구문: public inline void SetLanguage ( const std::string & language );

이미지 분석이 결과에 사용해야 하는 언어를 설정합니다.

이 언어는 ISO 639-1 코드(예: 영어의 경우 "en", 프랑스어의 경우 "fr")로 제공되어야 합니다. 이 값을 설정하지 않으면 영어의 기본값은 "en"입니다. 지원되는 언어 코드 목록과 각 언어에 대해 지원되는 시각적 기능을 참조하세요 https://aka.ms/cv-languages .

매개 변수

  • language 언어 코드

GetLanguage

구문: public inline std::string GetLanguage ( );

이미지 분석이 결과에 사용해야 하는 언어를 가져옵니다.

반환

서비스에서 이미지 분석 결과에 사용할 언어입니다.

언어는 ISO 639-1 형식입니다(예: 영어의 경우 "en", 프랑스어의 경우 "fr"). 이 값을 설정하지 않으면 영어의 기본값은 "en"입니다. 지원되는 언어 코드 목록과 각 언어에 대해 지원되는 시각적 기능을 참조하세요 https://aka.ms/cv-languages .

SetModelVersion

구문: public inline void SetModelVersion ( const std::string & modelVersion );

Image Analysis Service에서 사용해야 하는 모델 버전을 설정합니다. 이 옵션을 설정하지 않으면 기본값은 "최신"입니다.

"latest"는 현재 서비스에서 지원되는 유일한 값입니다. 향후 서비스 업데이트에서 지원되는 모델 버전은 "최신" 또는 "YYYY-MM-DD" 또는 "YYYY-MM-DD-preview" 형식으로 제공되며, 여기서 YYYY, MM, DD는 각각 연도, 월 및 일입니다.

매개 변수

  • modelVersion 모델 버전

GetModelVersion

구문: public inline std::string GetModelVersion ( );

Image Analysis Service에서 사용해야 하는 모델 버전을 가져옵니다. 이 옵션을 설정하지 않은 경우 기본값은 "최신"입니다.

반환

서비스에서 사용하는 AI 모델 버전입니다. 현재 지원되는 유일한 값은 "최신"입니다.

SetGenderNeutralCaption

구문: public inline void SetGenderNeutralCaption ( const bool genderNeutral );

이미지 분석 캡션 결과의 성 중립성을 설정합니다.

매개 변수

  • genderNeutral"true"이면 캡션 성별 용어가 없습니다. "true"이면 "남자/여자"라는 단어가 "사람"으로 대체되고 "Boy/Girl"은 "Child"로 바뀝니다. 설정하지 않으면 기본값은 "false"입니다.

ImageAnalysisFeature::Caption이 기능 목록에 포함된 경우에만 관련됩니다(ImageAnalysisOptions::SetFeatures 참조).

GetGenderNeutralCaption

구문: public inline bool GetGenderNeutralCaption ( );

이미지 분석 캡션 결과의 성 중립성을 가져옵니다.

반환

반환된 캡션 성별 용어가 없으면 "true"입니다. 그렇지 않으면 "false"(기본값)입니다.

SetModelName

구문: public inline void SetModelName ( const std::string & modelName );

Image Analysis Service에서 사용해야 하는 사용자 지정 학습 모델의 이름을 설정합니다. 이 옵션을 설정하지 않으면 기본(표준) 모델이 사용됩니다. SetFeatures 및/또는 SetModelName을 호출하여 시각적 기능을 추출하거나 세분화(SetSegmentationMode 호출)를 수행할 수 있지만 동시에 둘 다 수행할 수는 없습니다.

매개 변수

  • modelName 사용자 지정 모델 이름

GetModelName

구문: public inline std::string GetModelName ( );

Image Analysis Service에서 사용하는 사용자 지정 학습 모델의 이름을 가져옵니다.

반환

사용자 지정 모델 이름이거나 사용자 지정 모델이 설정되지 않은 경우 빈 문자열입니다(이 경우 표준 모델이 사용됨).

SetSegmentationMode

구문: public inline void SetSegmentationMode ( const ImageSegmentationMode segmentationMode );

Image Analysis Service에서 사용해야 하는 구분 모드를 설정합니다.

ImageSegmentationMode::BackgroundRemoval 또는 ImageSegmentationMode::ForegroundMatting 중 하나를 설정하면 Image Analysis 서비스는 구분 작업을 수행하고, succesfull이면 결과 구분의 단일 PNG 이미지를 반환합니다. 기본적으로 구분은 수행되지 않습니다. 시각적 기능을 추출하거나(SetFeatures 및/또는 SetModelName을 호출하여) 세분화를 수행할 수 있지만(SetSegmentationMode를 호출하여) 둘 다 동시에 수행할 수는 없습니다.

매개 변수

  • segmentationMode 원하는 구분 모드

GetSegmentationMode

구문: public inline ImageSegmentationMode GetSegmentationMode ( );

현재 구분 모드를 가져옵니다.

반환

현재 구분 모드입니다.

~ImageAnalysisOptions

구문: public ~ImageAnalysisOptions ( ) = default;

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

만들기

구문: public inline static std::shared_ptr< ImageAnalysisOptions > Create ( );

ImageAnalysisOptions 클래스의 새 instance 초기화합니다.

반환

std::shared_ptr 내부에 래핑된 새로 만든 ImageAnalysisOptions