ImageEmbedder

herkese açık final sınıfı ImageEmbedder

Resimlere yerleştirme ayıklama işlemi 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.
  • [1 x N] şekle sahip en az bir çıkış tensörü (kTfLiteUInt8/kTfLiteFloat32). Burada N, üretilen yerleştirmelerdeki boyut sayısıdır.

İç İçe Sınıflar

sınıf ImageEmbedder.ImageEmbedderOptions Kurulum ve ImageEmbedder seçenekleri. 

Herkese Açık Yöntemler

statik çift
cosineSimilarity(Yerleştirme u, Yerleştirme v)
İki Embedding nesnesi arasındaki kosinüs benzerliğini hesaplayan yardımcı işlev.
statik ImageEmbedder
createFromBuffer(Bağlam bağlamı, ByteBuffer modelBuffer)
Model arabelleğinden ve varsayılan ImageEmbedder.ImageEmbedderOptions değerinden bir ImageEmbedder örneği oluşturur.
statik ImageEmbedder
createFromFile(Bağlam bağlamı, Dize modelPath)
Model dosyasından ImageEmbedder örneği oluşturur ve ImageEmbedder.ImageEmbedderOptions varsayılan değerini oluşturur.
statik ImageEmbedder
createFromFile(Bağlam bağlamı, Dosya modelFile)
Model dosyasından ImageEmbedder örneği oluşturur ve ImageEmbedder.ImageEmbedderOptions varsayılan değerini oluşturur.
statik ImageEmbedder
createFromOptions(Bağlam bağlamı, ImageEmbedder.ImageEmbedderOptions seçenekleri)
ImageEmbedder.ImageEmbedderOptions örneğinden ImageEmbedder örneği oluşturur.
ImageEmbedderResult
embed(MPImage resmi, ImageProcessingOptions imageProcessingOptions)
Sağlanan tek resim üzerinde yerleştirme ayıklama gerçekleştirir.
ImageEmbedderResult
embed(MPImage resmi)
Sağlanan tek resim üzerinde varsayılan resim işleme seçenekleriyle (ör.
void
embedAsync(MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun timestampM'ler)
Canlı görüntü verilerini, yerleştirme ayıklaması gerçekleştirmek için gönderir. Sonuçlar, ImageEmbedder.ImageEmbedderOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla kullanıma sunulur.
void
embedAsync(MPImage resmi, uzun zamantimestampM'ler)
Varsayılan resim işleme seçenekleriyle (ör.
ImageEmbedderResult
embedForVideo(MPImage resmi, ImageProcessingOptions imageProcessingOptions, uzun zaman damgaları)
Sağlanan video çerçevesine yerleştirme ayıklama gerçekleştirir.
ImageEmbedderResult
embedForVideo(MPImage resmi, uzun zaman damgaları)
Sağlanan video çerçevesine varsayılan resim işleme seçenekleriyle (ör.

Devralınan Yöntemler

Herkese Açık Yöntemler

herkese açık static double cosineSimilarity (Yerleştirme u, Yerleştirme v)

İki Embedding nesnesi arasındaki kosinüs benzerliğini hesaplayan yardımcı işlev.

Parametreler
u
v
Dekoratif yastıklar
IllegalArgumentException yerleştirmelerin farklı türleri varsa (kayan ve ölçülmüş), farklı boyutlara sahip veya 0'lık bir L2 norm'u varsa.

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

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

Parametreler
context Android ERROR(/Context).
modelBuffer yerleştirme modelinin doğrudan ByteBuffer veya ERROR(/MappedByteBuffer) öğesi.
Dekoratif yastıklar
ImageEmbedder oluşturulurken bir hata meydana gelirse.

herkese açık static ImageEmbedder createFromFile (Bağlam içeriği, Dize modelPath)

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

Parametreler
context Android ERROR(/Context).
modelPath öğedeki yerleştirme modelinin yolunu içerir.
Dekoratif yastıklar
ImageEmbedder oluşturulurken bir hata meydana gelirse.

herkese açık static ImageEmbedder createFromFile (Bağlam içeriği, Dosya modelFile)

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

Parametreler
context Android ERROR(/Context).
modelFile yerleştirme modeli File örneğine bakalım.
Dekoratif yastıklar
IOException tflite model dosyası açılırken bir G/Ç hatası oluşursa.
ImageEmbedder oluşturulurken bir hata meydana gelirse.

herkese açık static ImageEmbedder createFromOptions (Bağlam bağlamı, ImageEmbedder.ImageEmbedderOptions seçenekleri)

ImageEmbedder.ImageEmbedderOptions örneğinden ImageEmbedder örneği oluşturur.

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

herkese açık ImageEmbedderResult yerleştir (MPImage resmi, ImageProcessingOptions imageProcessingOptions)

Sağlanan tek resim üzerinde yerleştirme ayıklama gerçekleştirir. Bu yöntemi yalnızca ImageEmbedder, ERROR(/RunningMode.IMAGE) ile oluşturulduğunda kullanın.

ImageEmbedder, 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 ImageEmbedderResult yerleştirme (MPImage görüntüsü)

Varsayılan resim işleme seçenekleriyle, sağlanan tek resim üzerinde yerleştirme ayıklaması gerçekleştirir (yani resmin tamamını döndürme işlemi uygulanmadan tüm resmi ilgilenilen bölge olarak kullanır). Bu yöntemi yalnızca ImageEmbedder, ERROR(/RunningMode.IMAGE) ile oluşturulduğunda kullanın.

ImageEmbedder, 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 void embedAsync (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun timestampM'ler)

Canlı görüntü verilerini, yerleştirme ayıklaması gerçekleştirmek için gönderir. Sonuçlar, ImageEmbedder.ImageEmbedderOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla kullanıma sunulur. Bu yöntemi yalnızca ImageEmbedder, 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.

ImageEmbedder, 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 embedAsync (MPImage resmi, uzun timestampMs)

Varsayılan resim işleme seçenekleriyle (ör. resmin tamamını döndürme uygulanmadan) varsayılan resim işleme seçenekleriyle kullanmak için canlı resim verilerini gönderir ve sonuçlar, ImageEmbedder.ImageEmbedderOptions içinde sağlanan OutputHandler.ResultListener aracılığıyla sunulur. Bu yöntemi yalnızca ImageEmbedder öğ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.

ImageEmbedder, 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 ImageEmbedderResult embedForVideo (MPImage görüntüsü, ImageProcessingOptions imageProcessingOptions, uzun timestampM'ler)

Sağlanan video çerçevesine yerleştirme ayıklama gerçekleştirir. Bu yöntemi yalnızca ImageEmbedder, 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.

ImageEmbedder, 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 ImageEmbedderResult embedForVideo (MPImage resmi, uzun zaman damgaları)

Varsayılan resim işleme seçenekleriyle, sağlanan video karesine yerleştirme ayıklaması yapar (yani resmin tamamını döndürme işlemi uygulanmadan tüm resmi ilgilenilen bölge olarak kullanır). Bu yöntemi yalnızca ImageEmbedder, 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.

ImageEmbedder, 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.