이미지에서 전체적인 랜드마크 인식을 수행합니다.
이 API에는 선행 학습된 전체적 랜드마크 모델 애셋 번들이 필요합니다.
- 입력 이미지
MPImage
- 전체 랜드마크 감지가 실행되는 이미지입니다.
- 출력
HolisticLandmarkerResult
- 전체적인 랜드마크가 포함된 Holistic 정책erResult입니다.
중첩된 클래스
클래스 | HolisticLandmarker.HolisticLandmarkerOptions | HolisticLandmarker 설정 옵션 |
공개 메서드
상속된 메서드
공개 메서드
public static HolisticLandmarker createFromBuffer (Context context, ByteBuffer modelAssetBuffer)
모델 애셋 번들 버퍼와 기본 HolisticLandmarker.HolisticLandmarkerOptions
에서 HolisticLandmarker
인스턴스를 생성합니다.
매개변수
context | Android ERROR(/Context) |
---|---|
modelAssetBuffer | 감지 모델의 직접 ByteBuffer 또는 ERROR(/MappedByteBuffer) 입니다. |
생성 값
HolisticLandmarker 생성 중 오류가 발생하는 경우
|
public static HolisticLandmarker createFromFile (Context context, String modelAssetPath)
모델 애셋 번들 경로와 기본 HolisticLandmarker.HolisticLandmarkerOptions
에서 HolisticLandmarker
인스턴스를 생성합니다.
매개변수
context | Android ERROR(/Context) |
---|---|
modelAssetPath | 저작물에 메타데이터가 있는 전체적인 명소 모델로 이동하는 경로 |
생성 값
HolisticLandmarker 생성 중 오류가 발생하는 경우
|
public static HolisticLandmarker createFromFile (컨텍스트 컨텍스트, 파일 modelAssetFile)
모델 애셋 번들 파일과 기본 HolisticLandmarker.HolisticLandmarkerOptions
에서 HolisticLandmarker
인스턴스를 생성합니다.
매개변수
context | Android ERROR(/Context) |
---|---|
modelAssetFile | 전체적인 랜드마크 모델 File 인스턴스입니다. |
생성 값
IOException | tflite 모델 파일을 열 때 I/O 오류가 발생하는지 여부 |
---|---|
HolisticLandmarker 생성 중 오류가 발생하는 경우
|
PublicHolisticLandmarker createFromOptionsHolisticLandmarker.HolisticLandmarkerOptions
HolisticLandmarker.HolisticLandmarkerOptions
에서 HolisticLandmarker
인스턴스를 생성합니다.
매개변수
context | Android ERROR(/Context) |
---|---|
landmarkerOptions | HolisticLandmarker.HolisticLandmarkerOptions 인스턴스 |
생성 값
HolisticLandmarker 생성 중 오류가 발생하는 경우
|
공개 HolisticLandmarkerResult detect (MPImage 이미지)
기본 이미지 처리 옵션을 사용하여(예: 회전 적용 없음) 제공된 단일 이미지에서 전체 랜드마크 감지를 수행합니다. ERROR(/RunningMode.IMAGE)
를 사용하여 HolisticLandmarker
를 만들 때만 이 메서드를 사용합니다.
HolisticLandmarker
는 다음 색상 공간 유형을 지원합니다.
매개변수
이미지 | 처리할 MediaPipe MPImage 객체입니다. |
---|
생성 값
내부 오류가 있는 경우 |
공개 HolisticLandmarkerResult detect (MPImage 이미지, ImageProcessingOptions imageProcessingOptions)
제공된 단일 이미지에서 전체적인 랜드마크 감지를 수행합니다. HolisticLandmarker
가 ERROR(/RunningMode.IMAGE)
로 생성된 경우에만 이 메서드를 사용합니다.
HolisticLandmarker
는 다음 색상 공간 유형을 지원합니다.
매개변수
이미지 | 처리할 MediaPipe MPImage 객체입니다. |
---|---|
imageProcessingOptions | 추론을 실행하기 전에 입력 이미지를 처리하는 방법을 지정하는 ImageProcessingOptions 입니다. 관심 지역은 이 작업에서 지원되지 않습니다. ImageProcessingOptions.regionOfInterest() 를 지정하면 이 메서드에서 IllegalArgumentException이 발생합니다. |
생성 값
IllegalArgumentException | ImageProcessingOptions 가 관심 지역을 지정하는 경우입니다. |
---|---|
내부 오류가 있는 경우 |
public void detectAsync (MPImage 이미지, ImageProcessingOptions imageProcessingOptions, long timestampMs)
실시간 이미지 데이터를 전송하여 전체적인 랜드마크 인식을 수행합니다. 결과는 HolisticLandmarker.HolisticLandmarkerOptions
에 제공된 OutputHandler.ResultListener
를 통해 확인할 수 있습니다.
ERROR(/RunningMode.LIVE_STREAM)
를 사용하여 HolisticLandmarker
를 만들 때만 이 메서드를 사용합니다.
입력 이미지가 전체 랜드마크 아이콘에 전송되는 시점을 나타내는 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.
HolisticLandmarker
는 다음 색상 공간 유형을 지원합니다.
매개변수
이미지 | 처리할 MediaPipe MPImage 객체입니다. |
---|---|
imageProcessingOptions | 추론을 실행하기 전에 입력 이미지를 처리하는 방법을 지정하는 ImageProcessingOptions 입니다. 관심 지역은 이 작업에서 지원되지 않습니다. ImageProcessingOptions.regionOfInterest() 를 지정하면 이 메서드에서 IllegalArgumentException이 발생합니다. |
timestampMs | 입력 타임스탬프 (밀리초)입니다. |
생성 값
IllegalArgumentException | ImageProcessingOptions 가 관심 지역을 지정하는 경우입니다. |
---|---|
내부 오류가 있는 경우 |
public void detectAsync (MPImage 이미지, long timestampMs)
실시간 이미지 데이터를 전송하여 기본 이미지 처리 옵션으로 전체 랜드마크 감지를 수행합니다.즉, 회전 적용 없이 결과를 확인할 수 있습니다. 결과는 HolisticLandmarker.HolisticLandmarkerOptions
에서 제공하는 OutputHandler.ResultListener
를 통해 확인할 수 있습니다. HolisticLandmarker
가 ERROR(/RunningMode.LIVE_STREAM)
로 생성된 경우에만 이 메서드를 사용합니다.
입력 이미지가 전체 랜드마크 아이콘에 전송되는 시점을 나타내는 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.
HolisticLandmarker
는 다음 색상 공간 유형을 지원합니다.
매개변수
이미지 | 처리할 MediaPipe MPImage 객체입니다. |
---|---|
timestampMs | 입력 타임스탬프 (밀리초)입니다. |
생성 값
내부 오류가 있는 경우 |
공개 HolisticLandmarkerResult detectForVideo (MPImage 이미지, ImageProcessingOptions imageProcessingOptions, long timestampMs)
제공된 동영상 프레임에서 전체 랜드마크 감지를 수행합니다. HolisticLandmarker
가 ERROR(/RunningMode.VIDEO)
로 생성된 경우에만 이 메서드를 사용합니다.
동영상 프레임의 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.
HolisticLandmarker
는 다음 색상 공간 유형을 지원합니다.
매개변수
이미지 | 처리할 MediaPipe MPImage 객체입니다. |
---|---|
imageProcessingOptions | 추론을 실행하기 전에 입력 이미지를 처리하는 방법을 지정하는 ImageProcessingOptions 입니다. 관심 지역은 이 작업에서 지원되지 않습니다. ImageProcessingOptions.regionOfInterest() 를 지정하면 이 메서드에서 IllegalArgumentException이 발생합니다. |
timestampMs | 입력 타임스탬프 (밀리초)입니다. |
생성 값
IllegalArgumentException | ImageProcessingOptions 가 관심 지역을 지정하는 경우입니다. |
---|---|
내부 오류가 있는 경우 |
공개 HolisticLandmarkerResult detectForVideo (MPImage 이미지, 긴 timestampMs)
기본 이미지 처리 옵션을 사용하여(예: 회전 적용 없음) 제공된 동영상 프레임에서 전체 랜드마크 감지를 수행합니다. ERROR(/RunningMode.VIDEO)
를 사용하여 HolisticLandmarker
를 만들 때만 이 메서드를 사용합니다.
동영상 프레임의 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.
HolisticLandmarker
는 다음 색상 공간 유형을 지원합니다.
매개변수
이미지 | 처리할 MediaPipe MPImage 객체입니다. |
---|---|
timestampMs | 입력 타임스탬프 (밀리초)입니다. |
생성 값
내부 오류가 있는 경우 |