Görüntüler üzerinde segmentasyon gerçekleştirir.
API , TFLite Model Meta Verilerine sahip bir TFLite modeli beklemektedir. .
API, bir görüntü giriş tensörü ve bir çıkış tensörü olan modelleri destekler. Daha spesifik olmak gerekirse, gereksinimler şunlardır.
- Giriş görüntüsü tensörü (
kTfLiteUInt8
/kTfLiteFloat32
)- boyut görüntü girişi
[batch x height x width x channels]
. - toplu çıkarım desteklenmiyor (
batch
1 olması gerekiyor). - yalnızca RGB girişleri desteklenir (
channels
3 olması gerekir). - tür
kTfLiteFloat32
ise, giriş normalleştirmesi için normalizationOptions'ın meta verilere eklenmesi gerekir.
- boyut görüntü girişi
kTfLiteUInt8
/ kTfLiteFloat32
)- boyut tensörü
[batch x mask_height x mask_width x num_classes]
, buradabatch
1 olması gerekir,mask_width
vemask_height
model tarafından üretilen segmentasyon maskelerinin boyutlarıdır venum_classes
model tarafından desteklenen sınıfların sayısıdır. - isteğe bağlı (ancak önerilen) etiket eşlemeleri, her satırda bir etiket içeren TENSOR_AXIS_LABELS türünde AssociatedFile-s olarak eklenebilir. Bu türden ilk AssociatedFile (varsa) sınıf adını, yani sonuçların
ColoredLabel.getlabel()
ını doldurmak için kullanılır. Görünen ad, yaniColoredLabel.getDisplayName()
, yerel ayarı, oluşturma zamanında kullanılan `ImageSegmenterOptions`ın `display_names_locale` alanıyla eşleşen AssociatedFile'dan (varsa) doldurulur (varsayılan olarak "en", yani İngilizce). Bunlardan hiçbiri mevcut değilse sonuçların yalnızca 'index' alanı doldurulacaktır.
Böyle bir modelin bir örneğini TensorFlow Hub'da bulabilirsiniz. .
İç İçe Sınıflar
sınıf | ImageSegmenter.ImageSegmenterOptions | ImageSegmenter ayarlama seçenekleri. |
Genel Yöntemler
Kalıtsal Yöntemler
Genel Yöntemler
genel statik ImageSegmenter createFromBuffer ( ByteBuffer modelBuffer)
Model arabelleği ve varsayılan ImageSegmenter.ImageSegmenterOptions
ile bir ImageSegmenter
örneği oluşturur.
Parametreler
modelTampon | segmentasyon modelinin doğrudan ByteBuffer veya MappedByteBuffer |
---|
Atar
Yasadışı Durum İstisnası | dahili bir hata varsa |
---|---|
Çalışma zamanı istisnası | aksi takdirde belirtilmeyen bir hata varsa |
YasadışıTartışmaİstisna | model arabelleği doğrudan bir ByteBuffer veya MappedByteBuffer değilse |
genel statik ImageSegmenter createFromBufferAndOptions ( ByteBuffer modelBuffer, ImageSegmenter.ImageSegmenterOptions seçenekleri)
Model arabelleği ve ImageSegmenter.ImageSegmenterOptions
ile bir ImageSegmenter
örneği oluşturur.
Parametreler
modelTampon | segmentasyon modelinin doğrudan ByteBuffer veya MappedByteBuffer |
---|---|
seçenekler |
Atar
Yasadışı Durum İstisnası | dahili bir hata varsa |
---|---|
Çalışma zamanı istisnası | aksi takdirde belirtilmeyen bir hata varsa |
YasadışıTartışmaİstisna | model arabelleği doğrudan bir ByteBuffer veya MappedByteBuffer değilse |
public static ImageSegmenter createFromFile (Bağlam bağlamı, String modelPath)
Varsayılan ImageSegmenter.ImageSegmenterOptions
öğesinden bir ImageSegmenter
örneği oluşturur.
Parametreler
bağlam | |
---|---|
modelYol | varlıklardaki meta verilerle segmentasyon modelinin yolu |
Atar
IO İstisnası | tflite modeli yüklenirken bir G/Ç hatası oluşursa |
---|---|
YasadışıTartışmaİstisna | eğer bir argüman geçersizse |
Yasadışı Durum İstisnası | dahili bir hata varsa |
Çalışma zamanı istisnası | aksi takdirde belirtilmeyen bir hata varsa |
genel statik ImageSegmenter createFromFile ( Dosya modeliFile)
Varsayılan ImageSegmenter.ImageSegmenterOptions
öğesinden bir ImageSegmenter
örneği oluşturur.
Parametreler
modelDosya | segmentasyon modeli File örneği |
---|
Atar
IO İstisnası | tflite modeli yüklenirken bir G/Ç hatası oluşursa |
---|---|
YasadışıTartışmaİstisna | eğer bir argüman geçersizse |
Yasadışı Durum İstisnası | dahili bir hata varsa |
Çalışma zamanı istisnası | aksi takdirde belirtilmeyen bir hata varsa |
public static ImageSegmenter createFromFileAndOptions ( Dosya modelFile, ImageSegmenter.ImageSegmenterOptions seçenekleri)
ImageSegmenter.ImageSegmenterOptions
öğesinden bir ImageSegmenter
örneği oluşturur.
Parametreler
modelDosya | segmentasyon modeli File örneği |
---|---|
seçenekler |
Atar
IO İstisnası | tflite modeli yüklenirken bir G/Ç hatası oluşursa |
---|---|
YasadışıTartışmaİstisna | eğer bir argüman geçersizse |
Yasadışı Durum İstisnası | dahili bir hata varsa |
Çalışma zamanı istisnası | aksi takdirde belirtilmeyen bir hata varsa |
public static ImageSegmenter createFromFileAndOptions (Bağlam bağlamı, String modelPath, ImageSegmenter.ImageSegmenterOptions seçenekleri)
ImageSegmenter.ImageSegmenterOptions
öğesinden bir ImageSegmenter
örneği oluşturur.
Parametreler
bağlam | |
---|---|
modelYol | varlıklardaki meta verilerle segmentasyon modelinin yolu |
seçenekler |
Atar
IO İstisnası | tflite modeli yüklenirken bir G/Ç hatası oluşursa |
---|---|
YasadışıTartışmaİstisna | eğer bir argüman geçersizse |
Yasadışı Durum İstisnası | dahili bir hata varsa |
Çalışma zamanı istisnası | aksi takdirde belirtilmeyen bir hata varsa |
genel Liste < Segmentasyon > segment (uzun çerçeveBufferHandle, ImageProcessingOptions seçenekleri)
Parametreler
çerçeveBufferHandle | |
---|---|
seçenekler |
genel Liste < Segmentasyon > segment ( TensorImage görüntüsü)
Sağlanan görüntü üzerinde gerçek segmentasyonu gerçekleştirir.
ImageSegmenter
aşağıdaki TensorImage
renk alanı türlerini destekler:
Parametreler
görüntü | bir RGB veya YUV görüntüsünü temsil eden bir UINT8 TensorImage nesnesi |
---|
İadeler
- görüntü segmentasyonu gerçekleştirmenin sonuçları. Şu anda tek bir
Segmentation
öğesinin döndürülmesinin beklendiğini unutmayın. Sonuç, örneğin nesne başına bir segmentasyon döndürebilen örnek segmentasyon modellerine daha sonra genişletilmek üzere birList
saklanır.
Atar
Yasadışı Durum İstisnası | dahili bir hata varsa |
---|---|
Çalışma zamanı istisnası | aksi takdirde belirtilmeyen bir hata varsa |
YasadışıTartışmaİstisna | görüntünün renk alanı türü desteklenmiyorsa |
genel Liste < Segmentasyon > segment ( MlImage resmi)
Sağlanan MlImage
üzerinde gerçek segmentasyonu gerçekleştirir.
Parametreler
görüntü | segmentlere ayrılacak bir MlImage . |
---|
İadeler
- görüntü segmentasyonu gerçekleştirmenin sonuçları. Şu anda tek bir
Segmentation
öğesinin döndürülmesinin beklendiğini unutmayın. Sonuç, örneğin nesne başına bir segmentasyon döndürebilen örnek segmentasyon modellerine daha sonra genişletilmek üzere birList
saklanır.
Atar
Yasadışı Durum İstisnası | dahili bir hata varsa |
---|---|
Çalışma zamanı istisnası | aksi takdirde belirtilmeyen bir hata varsa |
YasadışıTartışmaİstisna | görüntünün depolama türü veya formatı desteklenmiyorsa |
genel Liste < Segmentasyon > segment ( TensorImage görüntüsü, ImageProcessingOptions seçenekleri)
ImageProcessingOptions
ile sağlanan görüntü üzerinde gerçek segmentasyonu gerçekleştirir.
ImageSegmenter
aşağıdaki TensorImage
renk alanı türlerini destekler:
ImageSegmenter
aşağıdaki seçenekleri destekler:
- görüntü döndürme (
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
aracılığıyla). Varsayılan olarakImageProcessingOptions.Orientation.TOP_LEFT
.
Parametreler
görüntü | bir RGB veya YUV görüntüsünü temsil eden bir UINT8 TensorImage nesnesi |
---|---|
seçenekler | seçenekler görüntünün nasıl ön işleneceğini yapılandırır |
İadeler
- görüntü segmentasyonu gerçekleştirmenin sonuçları. Şu anda tek bir
Segmentation
öğesinin döndürülmesinin beklendiğini unutmayın. Sonuç, örneğin nesne başına bir segmentasyon döndürebilen örnek segmentasyon modellerine daha sonra genişletilmek üzere birList
saklanır.
Atar
Yasadışı Durum İstisnası | dahili bir hata varsa |
---|---|
Çalışma zamanı istisnası | aksi takdirde belirtilmeyen bir hata varsa |
YasadışıTartışmaİstisna | görüntünün renk alanı türü desteklenmiyorsa |
genel Liste < Segmentasyon > segment ( MlImage görüntüsü, ImageProcessingOptions seçenekleri)
ImageProcessingOptions
ile sağlanan MlImage
üzerinde gerçek segmentasyonu gerçekleştirir.
ImageSegmenter
aşağıdaki seçenekleri destekler:
- görüntü döndürme (
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
aracılığıyla). Varsayılan olarakImageProcessingOptions.Orientation.TOP_LEFT
şeklindedir.MlImage.getRotation()
etkili değil.
Parametreler
görüntü | segmentlere ayrılacak bir MlImage . |
---|---|
seçenekler | seçenekler görüntünün nasıl ön işleneceğini yapılandırır. |
İadeler
- görüntü segmentasyonu gerçekleştirmenin sonuçları. Şu anda tek bir
Segmentation
öğesinin döndürülmesinin beklendiğini unutmayın. Sonuç, örneğin nesne başına bir segmentasyon döndürebilen örnek segmentasyon modellerine daha sonra genişletilmek üzere birList
saklanır.
Atar
Yasadışı Durum İstisnası | dahili bir hata varsa |
---|---|
Çalışma zamanı istisnası | aksi takdirde belirtilmeyen bir hata varsa |
YasadışıTartışmaİstisna | görüntünün renk alanı türü desteklenmiyorsa |