ImageClassifier

genel final sınıfı ImageClassifier

Görüntüler üzerinde sınıflandırma yapar.

API, isteğe bağlı ancak kesinlikle önerilen TFLite Modeli Meta Verileri içeren bir TFLite modeli gerektirir.

API, bir görüntü giriş tensörü ve bir veya daha fazla çıkış tensörü olan modelleri destekler. Daha net olmak gerekirse gereksinimler şunlardır.

  • Giriş resmi tensörü (kTfLiteUInt8/kTfLiteFloat32)
    • [batch x height x width x channels] boyutunda resim girişi.
    • toplu çıkarım desteklenmiyor (batch değerinin 1 olması gerekir).
    • yalnızca RGB girişleri desteklenir (channels değerinin 3 olması gerekir).
    • tür kTfLiteFloat32 olursa giriş normalleştirmesi için meta verilere NormalizationOptions eklenmelidir.
  • Şu özelliklere sahip en az bir çıkış tensörü (kTfLiteUInt8/kTfLiteFloat32):
    • N sınıfları ve 2 veya 4 boyut (ör. [1 x N] veya [1 x 1 x 1 x N])
    • isteğe bağlı (ancak önerilen) etiket eşlemelerini, her satırda bir etiket içeren TENSOR_AXIS_LABELS türünde AssociatedFiles olarak kullanabilirsiniz. Bu tür ilk AssociatedFile (varsa), sonuçların class_name alanını doldurmak için kullanılır. display_name alanı, yerel ayarı, oluşturma sırasında kullanılan ImageClassifierOptions öğesinin display_names_locale alanıyla ("en", yani İngilizce) eşleşen AssociatedFile'dan (varsa) doldurulur. Bunların hiçbiri mevcut değilse yalnızca sonuçların index alanı doldurulur.
    • İsteğe bağlı puan kalibrasyonu, ScoreCalibrationOptions ve TENSOR_AXIS_SCORE_CALIBRATION türünde bir AssociatedFile kullanılarak eklenebilir. Daha fazla ayrıntı için Metadata_schema.fbs adresine bakın.

Bu modelin bir örneğini TensorFlow Hub'da bulabilirsiniz.

İç İçe Sınıflar

sınıf ImageClassifier.ImageClassifierOptions Kurulum ve ImageClassifier seçenekleri. 

Herkese Açık Yöntemler

ImageClassifierResult
classify(MPImage resmi)
Varsayılan görüntü işleme seçenekleriyle, sağlanan tek görüntü üzerinde sınıflandırma yapar (ör.
ImageClassifierResult
classify(MPImage resmi, ImageProcessingOptions imageProcessingOptions)
Sağlanan tek resim üzerinde sınıflandırma yapar.
void
classifyAsync(MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun timestampMs)
Sınıflandırma gerçekleştirmek için canlı görüntü verilerini gönderir ve sonuçlar, ImageClassifier.ImageClassifierOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla sunulur.
void
classifyAsync(MPImage resmi, uzun zamantimestampMs)
Varsayılan görüntü işleme seçenekleriyle (ör.
ImageClassifierResult
classifyForVideo(MPImage resmi, uzun zaman damgaları)
Varsayılan görüntü işleme seçenekleriyle, sağlanan video karesinde sınıflandırma yapar.
ImageClassifierResult
classifyForVideo(MPImage resmi, ImageProcessingOptions imageProcessingOptions, uzun timestampM'ler)
Sağlanan video karesinde sınıflandırma gerçekleştirir.
statik ImageClassifier
createFromBuffer(Bağlam bağlamı, ByteBuffer modelBuffer)
Model arabelleğinden ve varsayılan ImageClassifier.ImageClassifierOptions değerinden bir ImageClassifier örneği oluşturur.
statik ImageClassifier
createFromFile(Bağlam bağlamı, Dize modelPath)
Model dosyasından ImageClassifier örneği oluşturur ve ImageClassifier.ImageClassifierOptions varsayılan değerini oluşturur.
statik ImageClassifier
createFromFile(Bağlam bağlamı, Dosya modelFile)
Model dosyasından ImageClassifier örneği oluşturur ve ImageClassifier.ImageClassifierOptions varsayılan değerini oluşturur.
statik ImageClassifier
createFromOptions(Bağlam bağlamı, ImageClassifier.ImageClassifierOptions seçenekleri)

Devralınan Yöntemler

Herkese Açık Yöntemler

herkese açık ImageClassifierResult classify (MPImage görüntüsü)

Sağlanan tek resim üzerinde, varsayılan resim işleme seçenekleriyle sınıflandırma yapar (ör. resmin tamamını döndürme işlemi uygulanmadan tüm resmi ilgilenilen bölge olarak kullanır). Bu yöntemi yalnızca ImageClassifier, ERROR(/RunningMode.IMAGE) ile oluşturulduğunda kullanın.

ImageClassifier, aşağıdaki renk alanı türlerini destekler:

Parametreler
resim İşlenmek üzere bir MediaPipe MPImage nesnesi.
Dekoratif yastıklar
dahili hata olup olmadığını kontrol edin.

herkese açık ImageClassifierResult classify (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions)

Sağlanan tek resim üzerinde sınıflandırma yapar. Bu yöntemi yalnızca ImageClassifier, ERROR(/RunningMode.IMAGE) ile oluşturulduğunda kullanın.

ImageClassifier, aşağıdaki renk alanı türlerini destekler:

Parametreler
resim İşlenmek üzere bir MediaPipe MPImage nesnesi.
imageProcessingOptions ImageProcessingOptions bağımsız değişkeni, çıkarımı çalıştırmadan önce giriş görüntüsünün nasıl işleneceğini belirtir.
Dekoratif yastıklar
dahili hata olup olmadığını kontrol edin.

herkese açık void classifyAsync (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun timestampM'ler)

Sınıflandırma gerçekleştirmek için canlı görüntü verilerini gönderir ve sonuçlar, ImageClassifier.ImageClassifierOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla sunulur. Bu yöntemi yalnızca ImageClassifier, ERROR(/RunningMode.LIVE_STREAM) ile oluşturulduğunda kullanın.

Giriş görüntüsünün nesne algılayıcıya ne zaman gönderildiğini belirtmek için bir zaman damgası (milisaniye cinsinden) sağlamanız gerekir. Giriş zaman damgaları tekdüze şekilde artmalıdır.

ImageClassifier, aşağıdaki renk alanı türlerini destekler:

Parametreler
resim İşlenmek üzere bir MediaPipe MPImage nesnesi.
imageProcessingOptions ImageProcessingOptions bağımsız değişkeni, çıkarımı çalıştırmadan önce giriş görüntüsünün nasıl işleneceğini belirtir.
timestampMs giriş zaman damgası (milisaniye cinsinden).
Dekoratif yastıklar
dahili hata olup olmadığını kontrol edin.

herkese açık void classifyAsync (MPImage resmi, uzun zaman damgaları)

Canlı resim verilerini, varsayılan resim işleme seçenekleriyle sınıflandırma yapmak için gönderir (yani resmin tamamını ilgili bölge olarak ve herhangi bir rotasyon uygulanmadan kullanır). Sonuçlar, ImageClassifier.ImageClassifierOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla sunulur. Bu yöntemi yalnızca ImageClassifier öğesi ERROR(/RunningMode.LIVE_STREAM) ile oluşturulduğunda kullanın.

Giriş görüntüsünün nesne algılayıcıya ne zaman gönderildiğini belirtmek için bir zaman damgası (milisaniye cinsinden) sağlamanız gerekir. Giriş zaman damgaları tekdüze şekilde artmalıdır.

ImageClassifier, aşağıdaki renk alanı türlerini destekler:

Parametreler
resim İşlenmek üzere bir MediaPipe MPImage nesnesi.
timestampMs giriş zaman damgası (milisaniye cinsinden).
Dekoratif yastıklar
dahili hata olup olmadığını kontrol edin.

herkese açık ImageClassifierResult classifyForVideo (MPImage resmi, uzun zaman damgaları)

Varsayılan resim işleme seçenekleriyle, sağlanan video karesinde sınıflandırma gerçekleştirir. Diğer bir deyişle, resmin tamamını döndürme işlemi uygulanmadan tüm resmi ilgilenilen bölge olarak kullanır. Bu yöntemi yalnızca ImageClassifier, ERROR(/RunningMode.VIDEO) ile oluşturulduğunda kullanın.

Video karesinin zaman damgasını (milisaniye cinsinden) sağlamanız gerekir. Giriş zaman damgaları tekdüze şekilde artmalıdır.

ImageClassifier, aşağıdaki renk alanı türlerini destekler:

Parametreler
resim İşlenmek üzere bir MediaPipe MPImage nesnesi.
timestampMs giriş zaman damgası (milisaniye cinsinden).
Dekoratif yastıklar
dahili hata olup olmadığını kontrol edin.

herkese açık ImageClassifierResult classifyForVideo (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun zaman damgaları)

Sağlanan video karesinde sınıflandırma gerçekleştirir. Bu yöntemi yalnızca ImageClassifier, ERROR(/RunningMode.VIDEO) ile oluşturulduğunda kullanın.

Video karesinin zaman damgasını (milisaniye cinsinden) sağlamanız gerekir. Giriş zaman damgaları tekdüze şekilde artmalıdır.

ImageClassifier, aşağıdaki renk alanı türlerini destekler:

Parametreler
resim İşlenmek üzere bir MediaPipe MPImage nesnesi.
imageProcessingOptions ImageProcessingOptions bağımsız değişkeni, çıkarımı çalıştırmadan önce giriş görüntüsünün nasıl işleneceğini belirtir.
timestampMs giriş zaman damgası (milisaniye cinsinden).
Dekoratif yastıklar
dahili hata olup olmadığını kontrol edin.

herkese açık statik ImageClassifier createFromBuffer (Bağlam bağlamı, ByteBuffer modelBuffer)

Model arabelleğinden ve varsayılan ImageClassifier.ImageClassifierOptions değerinden bir ImageClassifier örneği oluşturur.

Parametreler
context Android ERROR(/Context).
modelBuffer sınıflandırma modelinin doğrudan ByteBuffer veya ERROR(/MappedByteBuffer) değeri.
Dekoratif yastıklar
ImageClassifier oluşturulurken bir hata meydana gelirse.

herkese açık static ImageClassifier createFromFile (Bağlam bağlamı, Dize modelPath)

Model dosyasından ImageClassifier örneği oluşturur ve ImageClassifier.ImageClassifierOptions varsayılan değerini oluşturur.

Parametreler
context Android ERROR(/Context).
modelPath sınıflandırma modelini kullandığınızdan emin olun.
Dekoratif yastıklar
ImageClassifier oluşturulurken bir hata meydana gelirse.

herkese açık statik ImageClassifier createFromFile (Bağlam bağlamı, Dosya modelFile)

Model dosyasından ImageClassifier örneği oluşturur ve ImageClassifier.ImageClassifierOptions varsayılan değerini oluşturur.

Parametreler
context Android ERROR(/Context).
modelFile sınıflandırma modeli File örneğidir.
Dekoratif yastıklar
IOException tflite model dosyası açılırken bir G/Ç hatası oluşursa.
ImageClassifier oluşturulurken bir hata meydana gelirse.

herkese açık statik ImageClassifier createFromOptions (Bağlam bağlamı, ImageClassifier.ImageClassifierOptions seçenekleri)

Parametreler
context Android ERROR(/Context).
seçenekler ImageClassifier.ImageClassifierOptions örneği.
Dekoratif yastıklar
ImageClassifier oluşturulurken bir hata meydana gelirse.