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