ImageSegmenter

공개 최종 클래스 ImageSegmenter

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

API에는 TFLite 모델 메타데이터가 포함된 TFLite 모델이 필요합니다. .

API는 하나의 이미지 입력 ​​텐서와 하나의 출력 텐서가 있는 모델을 지원합니다. 보다 구체적으로 요구 사항은 다음과 같습니다.

  • 입력 이미지 텐서( kTfLiteUInt8 / kTfLiteFloat32 )
    • [batch x height x width x channels] 크기의 이미지 입력.
    • 일괄 추론은 지원되지 않습니다( batch 는 1이어야 함).
    • RGB 입력만 지원됩니다( channels 3개여야 함).
    • 유형이 kTfLiteFloat32 이면 입력 정규화를 위해 메타데이터에 NormalizationOptions를 연결해야 합니다.
  • 출력 이미지 텐서( kTfLiteUInt8 / kTfLiteFloat32 )
    • 크기가 [batch x mask_height x mask_width x num_classes] 인 텐서. 여기서 batch 1이어야 하며, mask_width 와 mask_height 모델이 생성한 분할 마스크의 차원이고, num_classes 는 모델이 지원하는 클래스 수입니다.
    • 선택적(권장) 라벨 맵은 한 줄에 하나의 라벨을 포함하는 TENSOR_AXIS_LABELS 유형의 AssociatedFile-s로 첨부될 수 있습니다. 첫 번째 AssociatedFile(있는 경우)은 클래스 이름, 즉 결과의 ColoredLabel.getlabel() 채우는 데 사용됩니다. 표시 이름, 즉 ColoredLabel.getDisplayName() 은 생성 시 사용된 `ImageSegmenterOptions`의 `display_names_locale` 필드와 로케일이 일치하는 AssociatedFile(있는 경우)에서 채워집니다(기본적으로 "en", 즉 영어). 이들 중 어느 것도 사용할 수 없는 경우 결과의 'index' 필드만 채워집니다.

이러한 모델의 예는 TensorFlow Hub에서 찾을 수 있습니다. .

중첩 클래스

수업 ImageSegmenter.ImageSegmenter옵션 ImageSegmenter 설정 옵션.

공개 방법

정적 ImageSegmenter
createFromBuffer ( ByteBuffer 모델버퍼)
모델 버퍼와 기본 ImageSegmenter.ImageSegmenterOptions 사용하여 ImageSegmenter 인스턴스를 생성합니다.
정적 ImageSegmenter
createFromBufferAndOptions ( ByteBuffer modelBuffer, ImageSegmenter.ImageSegmenterOptions 옵션)
모델 버퍼와 ImageSegmenter.ImageSegmenterOptions 사용하여 ImageSegmenter 인스턴스를 생성합니다.
정적 ImageSegmenter
createFromFile (컨텍스트 컨텍스트, 문자열 modelPath)
기본 ImageSegmenter.ImageSegmenterOptions 에서 ImageSegmenter 인스턴스를 만듭니다.
정적 ImageSegmenter
createFromFile ( 파일 모델파일)
기본 ImageSegmenter.ImageSegmenterOptions 에서 ImageSegmenter 인스턴스를 만듭니다.
정적 ImageSegmenter
createFromFileAndOptions ( 파일 모델파일, ImageSegmenter.ImageSegmenterOptions 옵션)
ImageSegmenter.ImageSegmenterOptions 에서 ImageSegmenter 인스턴스를 만듭니다.
정적 ImageSegmenter
createFromFileAndOptions (컨텍스트 컨텍스트, 문자열 modelPath, ImageSegmenter.ImageSegmenterOptions 옵션)
ImageSegmenter.ImageSegmenterOptions 에서 ImageSegmenter 인스턴스를 만듭니다.
목록 < 세분화 >
세그먼트 (긴 프레임버퍼핸들, ImageProcessingOptions 옵션)
목록 < 세분화 >
세그먼트 ( TensorImage 이미지)
제공된 이미지에 대해 실제 분할을 수행합니다.
목록 < 세분화 >
세그먼트 ( MlImage 이미지)
제공된 MlImage 에서 실제 분할을 수행합니다.
목록 < 세분화 >
세그먼트 ( TensorImage 이미지, ImageProcessingOptions 옵션)
ImageProcessingOptions 사용하여 제공된 이미지에서 실제 분할을 수행합니다.
목록 < 세분화 >
세그먼트 ( MlImage 이미지, ImageProcessingOptions 옵션)
ImageProcessingOptions 사용하여 제공된 MlImage 에서 실제 분할을 수행합니다.

상속된 메서드

공개 방법

공개 정적 ImageSegmenter createFromBuffer ( ByteBuffer modelBuffer)

모델 버퍼와 기본 ImageSegmenter.ImageSegmenterOptions 사용하여 ImageSegmenter 인스턴스를 생성합니다.

매개변수
모델버퍼 분할 모델의 직접 ByteBuffer 또는 MappedByteBuffer
던지기
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우
IllegalArgumentException 모델 버퍼가 직접 ByteBuffer 또는 MappedByteBuffer 가 아닌 경우

공개 정적 ImageSegmenter createFromBufferAndOptions ( ByteBuffer modelBuffer, ImageSegmenter.ImageSegmenterOptions 옵션)

모델 버퍼와 ImageSegmenter.ImageSegmenterOptions 사용하여 ImageSegmenter 인스턴스를 생성합니다.

매개변수
모델버퍼 분할 모델의 직접 ByteBuffer 또는 MappedByteBuffer
옵션
던지기
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우
IllegalArgumentException 모델 버퍼가 직접 ByteBuffer 또는 MappedByteBuffer 가 아닌 경우

공개 정적 ImageSegmenter createFromFile (컨텍스트 컨텍스트, 문자열 modelPath)

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

매개변수
문맥
모델경로 자산의 메타데이터가 있는 분할 모델의 경로
던지기
IO예외 tflite 모델을 로드할 때 I/O 오류가 발생하는 경우
IllegalArgumentException 인수가 유효하지 않은 경우
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우

공개 정적 ImageSegmenter createFromFile ( 파일 모델파일)

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

매개변수
모델파일 분할 모델 File 인스턴스
던지기
IO예외 tflite 모델을 로드할 때 I/O 오류가 발생하는 경우
IllegalArgumentException 인수가 유효하지 않은 경우
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우

공개 정적 ImageSegmenter createFromFileAndOptions ( 파일 모델파일, ImageSegmenter.ImageSegmenterOptions 옵션)

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

매개변수
모델파일 분할 모델 File 인스턴스
옵션
던지기
IO예외 tflite 모델을 로드할 때 I/O 오류가 발생하는 경우
IllegalArgumentException 인수가 유효하지 않은 경우
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우

공개 정적 ImageSegmenter createFromFileAndOptions (컨텍스트 컨텍스트, 문자열 modelPath, ImageSegmenter.ImageSegmenterOptions 옵션)

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

매개변수
문맥
모델경로 자산의 메타데이터가 있는 분할 모델의 경로
옵션
던지기
IO예외 tflite 모델을 로드할 때 I/O 오류가 발생하는 경우
IllegalArgumentException 인수가 유효하지 않은 경우
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우

공개 목록 < 분할 > 세그먼트 (긴 프레임버퍼핸들, ImageProcessingOptions 옵션)

매개변수
프레임버퍼핸들
옵션

공개 목록 < 분할 > 세그먼트 ( TensorImage 이미지)

제공된 이미지에 대해 실제 분할을 수행합니다.

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

매개변수
영상 RGB 또는 YUV 이미지를 나타내는 UINT8 TensorImage 객체
보고
  • 이미지 분할을 수행한 결과입니다. 이때 단일 Segmentation 요소가 반환될 것으로 예상됩니다. 결과는 나중에 객체당 하나의 분할을 반환할 수 있는 인스턴스 분할 모델 등으로 확장하기 위해 List 에 저장됩니다.
던지기
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우
IllegalArgumentException 이미지의 색상 공간 유형이 지원되지 않는 경우

공개 목록 < 분할 > 세그먼트 ( MlImage 이미지)

제공된 MlImage 에서 실제 분할을 수행합니다.

매개변수
영상 분할할 MlImage .
보고
  • 이미지 분할을 수행한 결과입니다. 이때 단일 Segmentation 요소가 반환될 것으로 예상됩니다. 결과는 나중에 객체당 하나의 분할을 반환할 수 있는 인스턴스 분할 모델 등으로 확장하기 위해 List 에 저장됩니다.
던지기
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우
IllegalArgumentException 이미지의 저장 유형이나 형식이 지원되지 않는 경우

공개 목록 < Segmentation > 세그먼트 ( TensorImage 이미지, ImageProcessingOptions 옵션)

ImageProcessingOptions 사용하여 제공된 이미지에서 실제 분할을 수행합니다.

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

ImageSegmenter 다음 옵션을 지원합니다.

매개변수
영상 RGB 또는 YUV 이미지를 나타내는 UINT8 TensorImage 객체
옵션 옵션은 이미지 전처리 방법을 구성합니다.
보고
  • 이미지 분할을 수행한 결과입니다. 이때 단일 Segmentation 요소가 반환될 것으로 예상됩니다. 결과는 나중에 객체당 하나의 분할을 반환할 수 있는 인스턴스 분할 모델 등으로 확장하기 위해 List 에 저장됩니다.
던지기
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우
IllegalArgumentException 이미지의 색상 공간 유형이 지원되지 않는 경우

공개 목록 < Segmentation > 세그먼트 ( MlImage 이미지, ImageProcessingOptions 옵션)

ImageProcessingOptions 사용하여 제공된 MlImage 에서 실제 분할을 수행합니다.

ImageSegmenter 다음 옵션을 지원합니다.

매개변수
영상 분할할 MlImage .
옵션 옵션은 이미지 전처리 방법을 구성합니다.
보고
  • 이미지 분할을 수행한 결과입니다. 이때 단일 Segmentation 요소가 반환될 것으로 예상됩니다. 결과는 나중에 객체당 하나의 분할을 반환할 수 있는 인스턴스 분할 모델 등으로 확장하기 위해 List 에 저장됩니다.
던지기
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우
IllegalArgumentException 이미지의 색상 공간 유형이 지원되지 않는 경우