FaceStylizer

공개 최종 클래스 FaceStylizer

이미지에 얼굴 스타일을 적용합니다.

입력 이미지를 가져와서 출력을 반환하지만 반환의 깊은 복사를 포함하는 표준 스타일 지정 API인 stylize(MPImage) 및 ERROR(/#stylizeForVideo) 외에도 FaceStylizer는 결과 리스너가 지속되는 동안 제로 카피를 통해 출력에 액세스할 수 있도록 하는 콜백 API, stylizeWithResultListener(MPImage) 및 ERROR(/#stylizeForVideoWithResultListener)도 지원합니다.

Callback API는 FaceStylizer의 모든 RunningMode에서 사용할 수 있습니다. 콜백 API를 사용하도록 FaceStylizer.FaceStylizerOptions에 OutputHandler.ResultListener를 올바르게 설정합니다.

이 API는 TFLite 모델 메타데이터를 포함하는 TFLite 모델을 예상합니다.

  • 입력 이미지 MPImage
    • 얼굴 스타일라이저가 실행되는 이미지입니다.
  • 출력 MPImage MPImage
    • 스타일이 지정된 얼굴이 포함된 MPImage입니다.

중첩된 클래스

클래스 FaceStylizer.FaceStylizerOptions FaceStylizer 설정 옵션 

공개 메서드

정적 FaceStylizer
createFromOptions(컨텍스트 컨텍스트, FaceStylizer.FaceStylizerOptions stylizerOptions)
FaceStylizer.FaceStylizerOptions에서 FaceStylizer 인스턴스를 만듭니다.
FaceStylizerResult
stylize(MPImage image, ImageProcessingOptions imageProcessingOptions)
제공된 단일 이미지에 얼굴 스타일을 적용합니다.
FaceStylizerResult
stylize(MPImage 이미지)
기본 이미지 처리 옵션(예:
void
stylizeWithResultListener(MPImage 이미지)
기본 이미지 처리 옵션(예:
void
stylizeWithResultListener(MPImage 이미지, ImageProcessingOptions imageProcessingOptions)
제공된 단일 이미지에 얼굴 스타일을 지정하고 FaceStylizer.FaceStylizerOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다.

상속된 메서드

공개 메서드

public static FaceStylizer createFromOptions (Context context, FaceStylizer.FaceStylizerOptions stylizerOptions)

FaceStylizer.FaceStylizerOptions에서 FaceStylizer 인스턴스를 만듭니다.

매개변수
context Android ERROR(/Context)
stylizerOptions FaceStylizer.FaceStylizerOptions 인스턴스
생성 값
FaceStylizer 생성 중 오류가 발생하는 경우

공개 FaceStylizerResult 스타일화 (MPImage 이미지, ImageProcessingOptions imageProcessingOptions)

제공된 단일 이미지에 얼굴 스타일을 적용합니다. RunningMode.IMAGE를 사용하여 FaceStylizer를 만들 때만 이 메서드를 사용합니다.

FaceStylizer는 다음 색상 공간 유형을 지원합니다.

입력 이미지의 크기에는 제한이 없습니다. 출력 이미지는 얼굴이 가장 잘 보이는 스타일화된 이미지입니다. 양식화된 출력 이미지 크기는 모델 출력 크기와 동일합니다. 입력 이미지에서 얼굴이 감지되지 않으면 Optional.empty()를 반환합니다.

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
imageProcessingOptions 추론을 실행하기 전에 입력 이미지를 처리하는 방법을 지정하는 ImageProcessingOptions입니다. 관심 지역은 이 작업에서 지원되지 않습니다. ImageProcessingOptions.regionOfInterest()를 지정하면 이 메서드에서 IllegalArgumentException이 발생합니다.
생성 값
IllegalArgumentException ImageProcessingOptions가 관심 지역을 지정하는 경우입니다.
내부 오류가 있는 경우 또는 FaceStylizer가 OutputHandler.ResultListener로 생성된 경우입니다.

공개 FaceStylizerResult 스타일화 (MPImage 이미지)

기본 이미지 처리 옵션을 사용하여(예: 회전은 적용되지 않음) 제공된 단일 이미지에 얼굴 스타일을 지정합니다. FaceStylizer가 RunningMode.IMAGE로 생성된 경우에만 이 메서드를 사용합니다.

FaceStylizer는 다음 색상 공간 유형을 지원합니다.

입력 이미지의 크기에는 제한이 없습니다. 출력 이미지는 얼굴이 가장 잘 보이는 스타일화된 이미지입니다. 양식화된 출력 이미지 크기는 모델 출력 크기와 동일합니다. 입력 이미지에서 얼굴이 감지되지 않으면 Optional.empty()를 반환합니다.

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
생성 값
내부 오류가 있는 경우 또는 FaceStylizer가 OutputHandler.ResultListener로 생성된 경우입니다.

public void stylizeWithResultListener (MPImage 이미지)

기본 이미지 처리 옵션(예: 회전 적용) 없이 제공된 단일 이미지에 얼굴 스타일화를 실행하고 FaceStylizer.FaceStylizerOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다. FaceStylizer가 RunningMode.IMAGE로 생성된 경우에만 이 메서드를 사용합니다.

FaceStylizer는 다음 색상 공간 유형을 지원합니다.

입력 이미지의 크기에는 제한이 없습니다. 출력 이미지는 얼굴이 가장 잘 보이는 스타일화된 이미지입니다. 양식화된 출력 이미지 크기는 모델 출력 크기와 동일합니다. 입력 이미지에서 얼굴이 감지되지 않으면 Optional.empty()를 반환합니다.

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
생성 값
IllegalArgumentException ImageProcessingOptions가 관심 지역을 지정하는 경우입니다.
내부 오류가 있는 경우 또는 FaceStylizer.FaceStylizerOptions에 설정된 OutputHandler.ResultListener로 FaceStylizer가 생성되지 않은 경우입니다.

public void stylizeWithResultListener (MPImage image, ImageProcessingOptions imageProcessingOptions)

제공된 단일 이미지에 얼굴 스타일을 지정하고 FaceStylizer.FaceStylizerOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다. RunningMode.IMAGE를 사용하여 FaceStylizer를 만들 때만 이 메서드를 사용합니다.

FaceStylizer는 다음 색상 공간 유형을 지원합니다.

입력 이미지의 크기에는 제한이 없습니다. 출력 이미지는 얼굴이 가장 잘 보이는 스타일화된 이미지입니다. 양식화된 출력 이미지 크기는 모델 출력 크기와 동일합니다. 입력 이미지에서 얼굴이 감지되지 않으면 Optional.empty()를 반환합니다.

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
imageProcessingOptions 추론을 실행하기 전에 입력 이미지를 처리하는 방법을 지정하는 ImageProcessingOptions입니다. 관심 지역은 이 작업에서 지원되지 않습니다. ImageProcessingOptions.regionOfInterest()를 지정하면 이 메서드에서 IllegalArgumentException이 발생합니다.
생성 값
IllegalArgumentException ImageProcessingOptions가 관심 지역을 지정하는 경우입니다.
내부 오류가 있는 경우 또는 FaceStylizer.FaceStylizerOptions에 설정된 OutputHandler.ResultListener로 FaceStylizer가 생성되지 않은 경우입니다.