ObjectDetector

공공 최종 클래스 ObjectDetector

이미지에서 물체 감지를 수행합니다.

API는있는 TFLite 모델 기대 TFLite 모델 메타 데이터. .

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

  • 입력 화상 텐서 ( kTfLiteUInt8 / kTfLiteFloat32 )
    • 크기의 화상 입력 [batch x height x width x channels] .
    • 배치 추론 (지원하지 않는 batch 1이 될 필요가있다).
    • RGB 입력 만이 지원된다 ( channels 3을 할 필요가있다).
    • 유형이면 kTfLiteFloat32 , NormalizationOptions는 입력 정상화에 대한 메타 데이터에 첨부 될 필요가있다.
  • 출력 텐서는의 사 개 출력해야합니다 DetectionPostProcess 영업 이익, 즉 :
    • 위치 텐서 ( kTfLiteFloat32 ) :
      • 크기 텐서 [1 x num_results x 4] , 형태 바운딩 박스를 나타내는 내부 배열 [좌측 상단, 우측, 하단].
      • BoundingBoxProperties 메타 데이터에 부착해야하며 지정해야 type=BOUNDARIEScoordinate_type=RATIO .
    • 클래스 텐서 ( kTfLiteFloat32 ) :
      • 크기 텐서 [1 x num_results] 는 클래스의 정수 인덱스를 각각 나타내는 값.
      • 라벨 맵이 같은 메타 데이터에 연결하는 경우 TENSOR_VALUE_LABELS 관련 파일들은 레이블에 텐서 값을 변환하는 데 사용됩니다.
    • 점수 텐서 ( kTfLiteFloat32 ) :
      • 크기 텐서 [1 x num_results] , 검출 대상의 점을 각각 나타내는 값.
    • 감지 텐서의 수 ( kTfLiteFloat32 ) :
      • 크기의 텐서 등 정수 NUM_RESULTS [1] .

같은 모델의 예에서 찾을 수 있습니다 TensorFlow 허브. .

중첩 클래스

수업 ObjectDetector.ObjectDetector옵션 ObjectDetector 설정을 위한 옵션입니다.

공개 메서드

정적 ObjectDetector
createFromBuffer ( ByteBuffer를 modelBuffer)
작성 ObjectDetector 모델 버퍼와 기본에 예를 ObjectDetector.ObjectDetectorOptions .
정적 ObjectDetector
정적 ObjectDetector
createFromFile (컨텍스트 컨텍스트, 문자열 modelPath)
정적 ObjectDetector
정적 ObjectDetector
정적 ObjectDetector
목록 < 검색 >
검출 ( MlImage의 이미지)
제공된에서 실제 검출 수행 MlImage .
목록 < 검색 >
검출 ( TensorImage의 이미지 ImageProcessingOptions의 옵션)
제공된 이미지에 대해 실제 감지를 수행합니다.
목록 < 검색 >
검출 ( MlImage의 이미지 ImageProcessingOptions의 옵션)
제공된에서 실제 검출 수행 MlImageImageProcessingOptions .
목록 < 검색 >
검출 ( TensorImage의 이미지)
제공된 이미지에 대해 실제 감지를 수행합니다.

상속된 메서드

공개 메서드

공공 정적 ObjectDetector createFromBuffer ( ByteBuffer를 modelBuffer)

작성 ObjectDetector 모델 버퍼와 기본에 예를 ObjectDetector.ObjectDetectorOptions .

매개변수
모델 버퍼 직접 ByteBuffer 또는 MappedByteBuffer 검출 모델
던지다
IllegalArgumentException 모델 버퍼 직접적인없는 경우 ByteBuffer 또는 MappedByteBuffer * @throws IllegalStateException가 내부 오류가 있는지
런타임 예외 달리 지정되지 않은 오류가 있는 경우

공공 정적 ObjectDetector createFromBufferAndOptions ( ByteBuffer를 modelBuffer, ObjectDetector.ObjectDetectorOptions의 옵션)

작성 ObjectDetector 모델 버퍼와 함께 인스턴스 ObjectDetector.ObjectDetectorOptions .

매개변수
모델 버퍼 직접 ByteBuffer 또는 MappedByteBuffer 검출 모델
옵션
던지다
IllegalArgumentException 모델 버퍼 직접적인 아닌 경우 ByteBuffer 또는 MappedByteBuffer
불법 상태 예외 내부 오류가 있는 경우
런타임 예외 달리 지정되지 않은 오류가 있는 경우

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

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

공공 정적 ObjectDetector createFromFile ( 파일 modelFile)

매개변수
모델파일 검출 모델 File
던지다
IO 예외 tflite 모델을 로드할 때 I/O 오류가 발생하는 경우
IllegalArgumentException 인수가 유효하지 않은 경우
불법 상태 예외 내부 오류가 있는 경우
런타임 예외 달리 지정되지 않은 오류가 있는 경우

공공 정적 ObjectDetector createFromFileAndOptions (컨텍스트 컨텍스트, 문자열 modelPath, ObjectDetector.ObjectDetectorOptions의 옵션)

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

공공 정적 ObjectDetector createFromFileAndOptions ( 파일 modelFile, ObjectDetector.ObjectDetectorOptions의 옵션)

매개변수
모델파일 검출 모델 File
옵션
던지다
IO 예외 tflite 모델을 로드할 때 I/O 오류가 발생하는 경우
IllegalArgumentException 인수가 유효하지 않은 경우
불법 상태 예외 내부 오류가 있는 경우
런타임 예외 달리 지정되지 않은 오류가 있는 경우

공개 목록 < 검색 > 감지 ( MlImage의 이미지)

제공된에서 실제 검출 수행 MlImage .

매개변수
영상 MlImage 화상을 나타내는 개체
던지다
불법 상태 예외 내부 오류가 있는 경우
런타임 예외 달리 지정되지 않은 오류가 있는 경우
IllegalArgumentException 이미지의 저장 유형 또는 형식이 지원되지 않는 경우

공개 목록 < 검색 > 감지 ( TensorImage의 이미지, ImageProcessingOptions의 옵션)

제공된 이미지에 대해 실제 감지를 수행합니다.

ObjectDetector 다음과 같은 지원 TensorImage 색 공간 유형 :

ObjectDetector 다음과 같은 옵션을 지원합니다 :

매개변수
영상 UINT8 TensorImage 의 RGB 또는 YUV 이미지를 나타내는 개체
옵션 이미지를 사전 처리하는 방법을 구성하는 옵션
던지다
불법 상태 예외 내부 오류가 있는 경우
런타임 예외 달리 지정되지 않은 오류가 있는 경우
IllegalArgumentException 이미지의 색 공간 유형이 지원되지 않는 경우

공개 목록 < 검색 > 감지 ( MlImage의 이미지, ImageProcessingOptions의 옵션)

제공된에서 실제 검출 수행 MlImageImageProcessingOptions .

ObjectDetector 다음과 같은 옵션을 지원합니다 :

매개변수
영상 MlImage 화상을 나타내는 개체
옵션 이미지를 사전 처리하는 방법을 구성하는 옵션
던지다
불법 상태 예외 내부 오류가 있는 경우
런타임 예외 달리 지정되지 않은 오류가 있는 경우
IllegalArgumentException 이미지의 저장 유형 또는 형식이 지원되지 않는 경우

공개 목록 < 검색 > 감지 ( TensorImage의 이미지)

제공된 이미지에 대해 실제 감지를 수행합니다.

ObjectDetector 다음과 같은 지원 TensorImage 색 공간 유형 :

매개변수
영상 UINT8 TensorImage 의 RGB 또는 YUV 이미지를 나타내는 개체
던지다
불법 상태 예외 내부 오류가 있는 경우
런타임 예외 달리 지정되지 않은 오류가 있는 경우
IllegalArgumentException 이미지의 색 공간 유형이 지원되지 않는 경우