ImageSegmenter

공개 최종 클래스 ImageSegmenter

이미지에서 이미지 분할을 수행합니다.

입력 이미지를 가져와서 출력을 반환하지만 반환의 전체 사본을 포함하는 표준 세분화 API인 ERROR(/segment) 및 ERROR(/segmentForVideo) 외에도 ImageSegmenter는 콜백 API, ERROR(/segmentWithResultListener) 및 ERROR(/segmentForVideoWithResultListener)도 지원하므로 제로 카피를 통해 출력에 액세스할 수 있습니다.

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

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

  • 입력 이미지 MPImage
    • 이미지 분할기가 실행되는 이미지입니다.
  • 출력 ImageSegmenterResult ImageSegmenterResult
    • 분할 마스크가 포함된 ImageSegmenterResult입니다.

중첩된 클래스

클래스 ImageSegmenter.ImageSegmenterOptions ImageSegmenter 설정 옵션 
클래스 ImageSegmenter.SegmentationOptions ImageSegmenter의 런타임 동작을 구성하기 위한 옵션입니다. 

공개 메서드

정적 ImageSegmenter
createFromOptions(컨텍스트 context, ImageSegmenter.ImageSegmenterOptionssegmenterOptions)
ImageSegmenter.ImageSegmenterOptions에서 ImageSegmenter 인스턴스를 만듭니다.
List<String>
getLabels()
ImageSegmenter가 인식할 수 있는 카테고리 라벨 목록을 가져옵니다.
ImageSegmenterResult
segmenter(MPImage image, ImageSegmenter.SegmentationOptions segmentsOptions)
제공된 단일 이미지에서 이미지 분할을 수행합니다.
ImageSegmenterResult
segment(MPImage image, ImageProcessingOptions imageProcessingOptions)
제공된 단일 이미지에서 이미지 분할을 수행합니다.
ImageSegmenterResult
segment(MPImage 이미지)
기본 이미지 처리 옵션(예:
void
segmentAsync(MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)
실시간 이미지 데이터를 전송하여 이미지를 분할합니다. 결과는 ImageSegmenter.ImageSegmenterOptions에 제공된 OutputHandler.ResultListener를 통해 확인할 수 있습니다.
void
segmentAsync(MPImage image, ImageSegmenter.SegmentationOptionssegmentOptions, long timestampMs)를 사용하세요.
실시간 이미지 데이터를 전송하여 이미지를 분할합니다. 결과는 ImageSegmenter.ImageSegmenterOptions에 제공된 OutputHandler.ResultListener를 통해 확인할 수 있습니다.
void
segmentAsync(MPImage 이미지, 긴 timestampMs)
실시간 이미지 데이터를 전송하여 기본 이미지 처리 옵션으로 이미지 분할을 수행합니다(예:
ImageSegmenterResult
segmentForVideo(MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)
제공된 동영상 프레임에서 이미지 분할을 실행합니다.
ImageSegmenterResult
segmentForVideo(MPImage 이미지, 긴 timestampMs)
기본 이미지 처리 옵션으로 제공된 동영상 프레임에서 이미지 분할을 실행합니다.예를 들면 다음과 같습니다.
ImageSegmenterResult
segmentForVideo(MPImage image, ImageSegmenter.SegmentationOptionssegmentationOptions, long timestampMs)는
제공된 동영상 프레임에서 이미지 분할을 실행합니다.
void
segmentForVideoWithResultListener(MPImage 이미지, ImageProcessingOptions imageProcessingOptions, long timestampMs)
제공된 동영상 프레임에서 이미지 분할을 실행하고 ImageSegmenter.ImageSegmenterOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다.
void
segmentForVideoWithResultListener(MPImage image, ImageSegmenter.SegmentationOptionssegmentationOptions, long timestampMs)를 사용하세요.
제공된 동영상 프레임에서 이미지 분할을 실행하고 ImageSegmenter.ImageSegmenterOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다.
void
segmentForVideoWithResultListener(MPImage 이미지, 긴 timestampMs)
기본 이미지 처리 옵션으로 제공된 동영상 프레임에서 이미지 분할을 실행합니다.예를 들면 다음과 같습니다.
void
segmentWithResultListener(MPImage 이미지, ImageProcessingOptions imageProcessingOptions)
제공된 단일 이미지에서 이미지 분할을 실행하고 ImageSegmenter.ImageSegmenterOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다.
void
segmentWithResultListener(MPImage 이미지)
기본 이미지 처리 옵션(예:
void
segmentWithResultListener(MPImage 이미지, ImageSegmenter.SegmentationOptionssegmentationOptions)
제공된 단일 이미지에서 이미지 분할을 실행하고 ImageSegmenter.ImageSegmenterOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다.

상속된 메서드

공개 메서드

public static ImageSegmenter createFromOptions (Context context, ImageSegmenter.ImageSegmenterOptions segmenterOptions)

ImageSegmenter.ImageSegmenterOptions에서 ImageSegmenter 인스턴스를 만듭니다.

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

public List<String> getLabels ()

ImageSegmenter가 인식할 수 있는 카테고리 라벨 목록을 가져옵니다. CATEGORY_MASK 유형의 경우 카테고리 마스크의 색인은 라벨 목록의 카테고리에 상응합니다. CONFIDENCE_MASK 유형의 경우 색인의 출력 마스크 목록은 라벨 목록의 카테고리에 해당합니다.

모델 파일에 제공된 labelmap이 없는 경우 빈 라벨 목록이 반환됩니다.

공개 ImageSegmenterResult 세그먼트 (MPImage 이미지, ImageSegmenter.SegmentationOptionssegmentationOptions)

제공된 단일 이미지에서 이미지 분할을 수행합니다. ERROR(/RunningMode.IMAGE)를 사용하여 ImageSegmenter를 만들 때만 이 메서드를 사용합니다. 입력 이미지 형식의 TODO 업데이트 자바 문서

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

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
segmentationOptions ImageSegmenter의 런타임 동작을 구성하는 데 사용되는 ImageSegmenter.SegmentationOptions.
생성 값
내부 오류가 있는 경우 또는 ImageSegmenter가 OutputHandler.ResultListener로 만들어진 경우입니다.

공개 ImageSegmenterResult 세그먼트 (MPImage 이미지, ImageProcessingOptions imageProcessingOptions)

제공된 단일 이미지에서 이미지 분할을 수행합니다. 출력 마스크의 크기는 입력 이미지와 동일합니다. ERROR(/RunningMode.IMAGE)를 사용하여 ImageSegmenter를 만들 때만 이 메서드를 사용합니다. 입력 이미지 형식의 TODO 업데이트 자바 문서

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

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

공개 ImageSegmenterResult 세그먼트 (MPImage 이미지)

기본 이미지 처리 옵션을 사용하여, 즉 회전 적용 없이 제공된 단일 이미지에 대해 이미지 분할을 실행합니다. 출력 마스크의 크기는 입력 이미지와 동일합니다. ImageSegmenter가 ERROR(/RunningMode.IMAGE)로 생성된 경우에만 이 메서드를 사용합니다. 입력 이미지 형식의 TODO 업데이트 자바 문서

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

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

public void segmentAsync (MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)

실시간 이미지 데이터를 전송하여 이미지를 분할합니다. 결과는 ImageSegmenter.ImageSegmenterOptions에 제공된 OutputHandler.ResultListener를 통해 확인할 수 있습니다. 출력 마스크의 크기는 입력 이미지와 동일합니다. ImageSegmenter가 ERROR(/RunningMode.LIVE_STREAM)로 생성된 경우에만 이 메서드를 사용합니다.

입력 이미지가 이미지 분할기로 전송되는 시점을 나타내는 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

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

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

public void segmentAsync (MPImage image, ImageSegmenter.SegmentationOptions segmentationOptions, long timestampMs)

실시간 이미지 데이터를 전송하여 이미지를 분할합니다. 결과는 ImageSegmenter.ImageSegmenterOptions에 제공된 OutputHandler.ResultListener를 통해 확인할 수 있습니다. ImageSegmenter가 ERROR(/RunningMode.LIVE_STREAM)로 생성된 경우에만 이 메서드를 사용합니다.

입력 이미지가 이미지 분할기로 전송되는 시점을 나타내는 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

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

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
segmentationOptions ImageSegmenter의 런타임 동작을 구성하는 데 사용되는 ImageSegmenter.SegmentationOptions.
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
내부 오류가 있는 경우

public void segmentAsync (MPImage 이미지, long timestampMs)

실시간 이미지 데이터를 전송하여 기본 이미지 처리 옵션으로 이미지 분할을 실행합니다.즉, 회전이 적용되지 않은 상태로 이미지가 분할됩니다. 결과는 ImageSegmenter.ImageSegmenterOptions에 제공된 OutputHandler.ResultListener를 통해 확인할 수 있습니다. 출력 마스크의 크기는 입력 이미지와 동일합니다. ERROR(/RunningMode.LIVE_STREAM)를 사용하여 ImageSegmenter를 만들 때만 이 메서드를 사용합니다.

입력 이미지가 이미지 분할기로 전송되는 시점을 나타내는 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

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

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
내부 오류가 있는 경우

공개 ImageSegmenterResult segmentForVideo (MPImage 이미지, ImageProcessingOptions imageProcessingOptions, long timestampMs)

제공된 동영상 프레임에서 이미지 분할을 실행합니다. 출력 마스크의 크기는 입력 이미지와 동일합니다. ERROR(/RunningMode.VIDEO)를 사용하여 ImageSegmenter를 만들 때만 이 메서드를 사용합니다.

동영상 프레임의 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

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

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

공개 ImageSegmenterResult segmentForVideo (MPImage 이미지, 긴 timestampMs)

기본 이미지 처리 옵션을 사용하여(예: 회전 적용 없이) 제공된 동영상 프레임에서 이미지 분할을 실행합니다. 출력 마스크의 크기는 입력 이미지와 동일합니다. ImageSegmenter가 ERROR(/RunningMode.VIDEO)로 생성된 경우에만 이 메서드를 사용합니다.

동영상 프레임의 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

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

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
내부 오류가 있는 경우 또는 ImageSegmenter가 OutputHandler.ResultListener로 만들어진 경우입니다.

공개 ImageSegmenterResult segmentForVideo (MPImage image, ImageSegmenter.SegmentationOptionsscaleOptions, long timestampMs)

제공된 동영상 프레임에서 이미지 분할을 실행합니다. ERROR(/RunningMode.VIDEO)를 사용하여 ImageSegmenter를 만들 때만 이 메서드를 사용합니다.

동영상 프레임의 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

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

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
segmentationOptions ImageSegmenter의 런타임 동작을 구성하는 데 사용되는 ImageSegmenter.SegmentationOptions.
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
내부 오류가 있는 경우 또는 ImageSegmenter가 OutputHandler.ResultListener로 만들어진 경우입니다.

public void segmentForVideoWithResultListener (MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)

제공된 동영상 프레임에서 이미지 분할을 실행하고 ImageSegmenter.ImageSegmenterOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다. 출력 마스크의 크기는 입력 이미지와 동일합니다. ERROR(/RunningMode.VIDEO)를 사용하여 ImageSegmenter를 만들 때만 이 메서드를 사용합니다.

동영상 프레임의 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

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

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
imageProcessingOptions
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
IllegalArgumentException ImageProcessingOptions가 관심 지역을 지정하는 경우입니다.
내부 오류가 있는 경우 또는 ImageSegmenter.ImageSegmenterOptions에 설정된 OutputHandler.ResultListener로 ImageSegmenter가 생성되지 않은 경우입니다.

public void segmentForVideoWithResultListener (MPImage image, ImageSegmenter.SegmentationOptions segmentationOptions, long timestampMs)

제공된 동영상 프레임에서 이미지 분할을 실행하고 ImageSegmenter.ImageSegmenterOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다. ERROR(/RunningMode.VIDEO)를 사용하여 ImageSegmenter를 만들 때만 이 메서드를 사용합니다.

동영상 프레임의 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

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

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
segmentationOptions ImageSegmenter의 런타임 동작을 구성하는 데 사용되는 ImageSegmenter.SegmentationOptions.
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
내부 오류가 있는 경우 또는 ImageSegmenter.ImageSegmenterOptions에 설정된 OutputHandler.ResultListener로 ImageSegmenter가 생성되지 않은 경우입니다.

public void segmentForVideoWithResultListener (MPImage 이미지, 긴 timestampMs)

기본 이미지 처리 옵션을 사용하여(예: 회전을 적용하지 않고) 제공된 동영상 프레임에서 이미지 분할을 실행하고 ImageSegmenter.ImageSegmenterOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다. 출력 마스크의 크기는 입력 이미지와 동일합니다. ImageSegmenter가 ERROR(/RunningMode.VIDEO)로 생성된 경우에만 이 메서드를 사용합니다.

동영상 프레임의 타임스탬프 (밀리초)를 제공해야 합니다. 입력 타임스탬프는 단조 증가해야 합니다.

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

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
timestampMs 입력 타임스탬프 (밀리초)입니다.
생성 값
내부 오류가 있는 경우 또는 ImageSegmenter.ImageSegmenterOptions에 설정된 OutputHandler.ResultListener로 ImageSegmenter가 생성되지 않은 경우입니다.

public void segmentWithResultListener (MPImage image, ImageProcessingOptions imageProcessingOptions)

제공된 단일 이미지에서 이미지 분할을 실행하고 ImageSegmenter.ImageSegmenterOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다. 출력 마스크의 크기는 입력 이미지와 동일합니다. ERROR(/RunningMode.IMAGE)를 사용하여 ImageSegmenter를 만들 때만 이 메서드를 사용합니다.

입력 이미지 형식의 TODO 업데이트 자바 문서

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

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

public void segmentWithResultListener (MPImage 이미지)

기본 이미지 처리 옵션, 즉 회전 적용 없이 제공된 단일 이미지에 대해 이미지 분할을 실행하고 ImageSegmenter.ImageSegmenterOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다. 출력 마스크의 크기는 입력 이미지와 동일합니다. ImageSegmenter가 ERROR(/RunningMode.IMAGE)로 생성된 경우에만 이 메서드를 사용합니다.

입력 이미지 형식의 TODO 업데이트 자바 문서

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

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
생성 값
내부 오류가 있는 경우 또는 ImageSegmenter.ImageSegmenterOptions에 설정된 OutputHandler.ResultListener로 ImageSegmenter가 생성되지 않은 경우입니다.

public void segmentWithResultListener (MPImage image, ImageSegmenter.SegmentationOptions segmentationOptions)

제공된 단일 이미지에서 이미지 분할을 실행하고 ImageSegmenter.ImageSegmenterOptions의 OutputHandler.ResultListener를 통해 복사되지 않은 결과를 제공합니다. ERROR(/RunningMode.IMAGE)를 사용하여 ImageSegmenter를 만들 때만 이 메서드를 사용합니다.

입력 이미지 형식의 TODO 업데이트 자바 문서

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

매개변수
이미지 처리할 MediaPipe MPImage 객체입니다.
segmentationOptions ImageSegmenter의 런타임 동작을 구성하는 데 사용되는 ImageSegmenter.SegmentationOptions.
생성 값
내부 오류가 있는 경우 또는 ImageSegmenter.ImageSegmenterOptions에 설정된 OutputHandler.ResultListener로 ImageSegmenter가 생성되지 않은 경우입니다.