ObjectDetector

klasës përfundimtare publike ObjectDetector

Kryen zbulimin e objekteve në imazhe.

API pret një model TFLite me Metadata të Modelit TFLite. .

API mbështet modelet me një tensor hyrjeje imazhi dhe katër tensorë daljeje. Për të qenë më specifik, këtu janë kërkesat.

  • Tenzori hyrës i imazhit ( kTfLiteUInt8 / kTfLiteFloat32 )
    • futja e imazhit të madhësisë [batch x height x width x channels] .
    • konkluzioni i grupit nuk mbështetet (kërkohet që batch të jetë 1).
    • mbështeten vetëm hyrjet RGB ( channels duhet të jenë 3).
    • nëse lloji është kTfLiteFloat32 , NormalizationOptions kërkohet t'i bashkëngjiten meta të dhënave për normalizimin e hyrjes.
  • Tenzorët e daljes duhet të jenë 4 daljet e një funksioni DetectionPostProcess , dmth:
    • Tenzori i vendndodhjes ( kTfLiteFloat32 ):
      • tensori i madhësisë [1 x num_results x 4] , grupi i brendshëm që përfaqëson kutitë kufizuese në formën [lart, majtas, djathtas, poshtë].
      • BoundingBoxProperties kërkohet t'i bashkëngjiten meta të dhënave dhe duhet të specifikojë type=BOUNDARIES dhe coordinate_type=RATIO .
    • Tenzori i klasave ( kTfLiteFloat32 ):
      • tensor i madhësisë [1 x num_results] , secila vlerë përfaqëson indeksin e numrit të plotë të një klase.
      • nëse hartat e etiketave i bashkëngjiten meta të dhënave si skedarë të lidhur me TENSOR_VALUE_LABELS , ato përdoren për të kthyer vlerat e tensorit në etiketa.
    • tensori i rezultateve ( kTfLiteFloat32 ):
      • tensor i madhësisë [1 x num_results] , secila vlerë përfaqëson rezultatin e objektit të zbuluar.
    • Numri i tensorit të zbulimit ( kTfLiteFloat32 ):
      • numër i plotë num_rezultatet si tensor me madhësi [1] .

Një shembull i një modeli të tillë mund të gjendet në TensorFlow Hub. .

Klasat e mbivendosura

klasës ObjectDetector.ObjectDetectorOptions Opsionet për konfigurimin e një ObjectDetector .

Metodat publike

ObjectDetector statik
createFromBuffer (konteksti i kontekstit, ByteBuffer modelBuffer)
Krijon një shembull ObjectDetector nga një tampon modeli dhe ObjectDetector.ObjectDetectorOptions .
ObjectDetector statik
createFromFile (konteksti i kontekstit, modeli i vargut shteg)
Krijon një shembull ObjectDetector nga një skedar modeli dhe ObjectDetector.ObjectDetectorOptions .
ObjectDetector statik
createFromFile (konteksti i kontekstit, modeli i skedaritFile )
Krijon një shembull ObjectDetector nga një skedar modeli dhe ObjectDetector.ObjectDetectorOptions .
ObjectDetector statik
createFromOptions (konteksti i kontekstit, ObjectDetector.ObjectDetectorOptions detektorOptions)
Krijon një shembull ObjectDetector nga një ObjectDetector.ObjectDetectorOptions .
Rezultati i Detektorit të Objekteve
zbuloj (imazh MPI )
Kryen zbulimin e objektit në imazhin e vetëm të dhënë me opsionet e paracaktuara të përpunimit të imazhit, dmth
Rezultati i Detektorit të Objekteve
zbuloj (imazh MPIimage , ImageProcessingOptions imageProcessingOptions)
Kryen zbulimin e objektit në imazhin e vetëm të dhënë.
i pavlefshëm
detectAsync (imazh MPImage , ImageProcessingOptions imageProcessingOptions, vula të gjata kohore)
Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer zbulimin e objekteve dhe rezultatet do të jenë të disponueshme nëpërmjet OutputHandler.ResultListener të ofruar në ObjectDetector.ObjectDetectorOptions .
i pavlefshëm
detectAsync (imazhi i imazhit MPI , stampat e gjata kohore)
Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer zbulimin e objekteve me opsionet e paracaktuara të përpunimit të imazhit, dmth
Rezultati i Detektorit të Objekteve
detectForVideo (imazh MPIimage , ImageProcessingOptions imageProcessingOptions, vula të gjata kohoreM)
Kryen zbulimin e objekteve në kornizën e dhënë të videos.
Rezultati i Detektorit të Objekteve
detectForVideo (imazh MPI- imazhi, vula kohore të gjata)
Kryen zbulimin e objekteve në kornizën e dhënë të videos me opsionet e paracaktuara të përpunimit të imazhit, dmth

Metodat e trashëguara

Metodat publike

publik statik ObjectDetector createFromBuffer (konteksti i kontekstit, modeli ByteBuffer )

Krijon një shembull ObjectDetector nga një tampon modeli dhe ObjectDetector.ObjectDetectorOptions .

Parametrat
kontekst një ERROR(/Context) në Android.
modelBuffer një ByteBuffer direkt ose një ERROR(/MappedByteBuffer) i modelit të zbulimit.
Hedhjet
nëse ka një gabim gjatë krijimit të ObjectDetector .

publik statik ObjectDetector createFromFile (konteksti i kontekstit, modeli i vargut Path)

Krijon një shembull ObjectDetector nga një skedar modeli dhe ObjectDetector.ObjectDetectorOptions .

Parametrat
kontekst një ERROR(/Context) në Android.
modelRruga rruga drejt modelit të zbulimit me meta të dhëna në aktive.
Hedhjet
nëse ka një gabim gjatë krijimit të ObjectDetector .

publik statik ObjectDetector createFromFile (konteksti i kontekstit, modeli i skedaritFile )

Krijon një shembull ObjectDetector nga një skedar modeli dhe ObjectDetector.ObjectDetectorOptions .

Parametrat
kontekst një ERROR(/Context) në Android.
modelFile modeli i zbulimit File skedarit.
Hedhjet
Përjashtim IO nëse ndodh një gabim I/O kur hapet skedari i modelit tflite.
nëse ka një gabim gjatë krijimit të ObjectDetector .

publike statike ObjectDetector createFromOptions (konteksti i kontekstit, ObjectDetector.ObjectDetectorOptions detectorOptions)

Krijon një shembull ObjectDetector nga një ObjectDetector.ObjectDetectorOptions .

Parametrat
kontekst një ERROR(/Context) në Android.
Opsionet e detektorit një shembull ObjectDetector.ObjectDetectorOptions .
Hedhjet
nëse ka një gabim gjatë krijimit të ObjectDetector .

Zbulimi publik i ObjectDetectorResult (imazhi i imazhit MPI )

Kryen zbulimin e objektit në imazhin e vetëm të dhënë me opsionet e paracaktuara të përpunimit të imazhit, dmth pa aplikuar asnjë rrotullim. Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.IMAGE) .

ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
Hedhjet
nëse ka një gabim të brendshëm.

Zbulimi publik i ObjectDetectorResult (imazhi MPImage , ImageProcessingOptions imageProcessingOptions)

Kryen zbulimin e objektit në imazhin e vetëm të dhënë. Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.IMAGE) .

ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
imageProcessingOptions ImageProcessingOptions duke specifikuar se si të përpunohet imazhi i hyrjes përpara se të ekzekutohet përfundimi. Vini re se rajoni i interesit nuk mbështetet nga kjo detyrë: specifikimi i ImageProcessingOptions.regionOfInterest() do të rezultojë që kjo metodë të hedhë një IllegalArgumentException.
Hedhjet
IllegalArgumentPërjashtim nëse ImageProcessingOptions specifikojnë një rajon me interes.
nëse ka një gabim të brendshëm.

publik void detectAsync (imazh MPImage , ImageProcessingOptions imageProcessingOptions, vula të gjata kohore)

Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer zbulimin e objekteve dhe rezultatet do të jenë të disponueshme nëpërmjet OutputHandler.ResultListener të ofruar në ObjectDetector.ObjectDetectorOptions . Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.LIVE_STREAM) .

Kërkohet të jepet një vulë kohore (në milisekonda) për të treguar se kur imazhi i hyrjes dërgohet në detektorin e objektit. Vula kohore e hyrjes duhet të rritet në mënyrë monotone.

ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
imageProcessingOptions ImageProcessingOptions duke specifikuar se si të përpunohet imazhi i hyrjes përpara se të ekzekutohet përfundimi. Vini re se rajoni i interesit nuk mbështetet nga kjo detyrë: specifikimi i ImageProcessingOptions.regionOfInterest() do të rezultojë që kjo metodë të hedhë një IllegalArgumentException.
vula kohoreMs vulën kohore të hyrjes (në milisekonda).
Hedhjet
IllegalArgumentPërjashtim nëse ImageProcessingOptions specifikojnë një rajon me interes.
nëse ka një gabim të brendshëm.

publik void detectAsync (imazhi i imazhit MPI , stampat e gjata kohore)

Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer zbulimin e objekteve me opsionet e përpunimit të imazhit të paracaktuar, dmth pa asnjë rrotullim të aplikuar, dhe rezultatet do të jenë të disponueshme nëpërmjet OutputHandler.ResultListener të ofruar në ObjectDetector.ObjectDetectorOptions . Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.LIVE_STREAM) .

Kërkohet të jepet një vulë kohore (në milisekonda) për të treguar se kur imazhi i hyrjes dërgohet në detektorin e objektit. Vula kohore e hyrjes duhet të rritet në mënyrë monotone.

ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
vula kohoreMs vulën kohore të hyrjes (në milisekonda).
Hedhjet
nëse ka një gabim të brendshëm.

publik ObjectDetectorResult detectForVideo (imazh MPI- imazhi, ImageProcessingOptions imageProcessingOptions, vula të gjata kohore)

Kryen zbulimin e objekteve në kornizën e dhënë të videos. Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.VIDEO) .

Kërkohet të jepet vula kohore e kornizës së videos (në milisekonda). Vula kohore e hyrjes duhet të rritet në mënyrë monotone.

ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
imageProcessingOptions ImageProcessingOptions duke specifikuar se si të përpunohet imazhi i hyrjes përpara se të ekzekutohet përfundimi. Vini re se rajoni i interesit nuk mbështetet nga kjo detyrë: specifikimi i ImageProcessingOptions.regionOfInterest() do të rezultojë që kjo metodë të hedhë një IllegalArgumentException.
vula kohoreMs vulën kohore të hyrjes (në milisekonda).
Hedhjet
IllegalArgumentPërjashtim nëse ImageProcessingOptions specifikojnë një rajon me interes.
nëse ka një gabim të brendshëm.

publik ObjectDetectorResult detectForVideo (imazh MPI , vula kohore të gjata)

Kryen zbulimin e objekteve në kornizën e dhënë të videos me opsionet e parazgjedhura të përpunimit të imazhit, dmth pa aplikuar asnjë rrotullim. Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.VIDEO) .

Kërkohet të jepet vula kohore e kornizës së videos (në milisekonda). Vula kohore e hyrjes duhet të rritet në mënyrë monotone.

ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
vula kohoreMs vulën kohore të hyrjes (në milisekonda).
Hedhjet
nëse ka një gabim të brendshëm.