ينفذ تجزئة على الصور.
تتوقع واجهة برمجة التطبيقات (API) نموذج TFLite مع بيانات تعريف نموذج TFLite. .
تدعم واجهة برمجة التطبيقات النماذج ذات موتر إدخال صورة واحد وموتر إخراج واحد. لنكون أكثر تحديدا، وهنا المتطلبات.
- موتر صورة الإدخال (
kTfLiteUInt8
/kTfLiteFloat32
)- حجم إدخال الصورة
[batch x height x width x channels]
. - استنتاج الدُفعة غير مدعوم (يُشترط أن تكون
batch
1). - يتم دعم مدخلات RGB فقط (يجب أن تكون
channels
3). - إذا كان النوع هو
kTfLiteFloat32
، فيجب إرفاق خيارات التسوية بالبيانات الوصفية لتطبيع الإدخال.
- حجم إدخال الصورة
kTfLiteUInt8
/ kTfLiteFloat32
)- موتر الحجم
[batch x mask_height x mask_width x num_classes]
، حيث يجب أن تكونbatch
1،mask_width
وmask_height
هي أبعاد أقنعة التجزئة التي ينتجها النموذج، وnum_classes
هو عدد الفئات التي يدعمها النموذج. - يمكن إرفاق خريطة (خرائط) التسمية الاختيارية (لكن الموصى بها) كـ AssociatedFile-s بالنوع TENSOR_AXIS_LABELS، والتي تحتوي على تسمية واحدة في كل سطر. يتم استخدام ملف AssociatedFile الأول (إن وجد) لملء اسم الفئة، أي
ColoredLabel.getlabel()
للنتائج. يتم ملء اسم العرض، أيColoredLabel.getDisplayName()
، من ملف AssociatedFile (إن وجد) الذي تتطابق إعداداته المحلية مع حقل `display_names_locale` الخاص بـ `ImageSegmenterOptions` المستخدم في وقت الإنشاء ("en" افتراضيًا، أي الإنجليزية). إذا لم يتوفر أي من هذه العناصر، فسيتم ملء حقل "الفهرس" فقط للنتائج.
يمكن العثور على مثال لهذا النموذج على TensorFlow Hub. .
فئات متداخلة
فصل | ImageSegmenter.ImageSegmenterOptions | خيارات لإعداد ImageSegmenter . |
الأساليب العامة
الطرق الموروثة
الأساليب العامة
ImageSegmenter العام الثابت createFromBuffer ( ByteBuffer modelBuffer)
ينشئ مثيل ImageSegmenter
بمخزن مؤقت للنموذج و ImageSegmenter.ImageSegmenterOptions
الافتراضي.
حدود
modelBuffer | ByteBuffer مباشر أو MappedByteBuffer لنموذج التجزئة |
---|
رميات
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
---|---|
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
غير الشرعيين استثناء حجة | إذا كان المخزن المؤقت للنموذج ليس ByteBuffer مباشرًا أو MappedByteBuffer |
ImageSegmenter العام الثابت createFromBufferAndOptions (خيارات ByteBuffer modelBuffer، ImageSegmenter.ImageSegmenterOptions )
ينشئ مثيل ImageSegmenter
مع مخزن مؤقت للنموذج و ImageSegmenter.ImageSegmenterOptions
.
حدود
modelBuffer | ByteBuffer مباشر أو MappedByteBuffer لنموذج التجزئة |
---|---|
خيارات |
رميات
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
---|---|
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
غير الشرعيين استثناء حجة | إذا كان المخزن المؤقت للنموذج ليس ByteBuffer مباشرًا أو MappedByteBuffer |
ImageSegmenter العام الثابت createFromFile (سياق السياق، String modelPath)
ينشئ مثيل ImageSegmenter
من ImageSegmenter.ImageSegmenterOptions
الافتراضي.
حدود
سياق | |
---|---|
modelPath | مسار نموذج التجزئة مع البيانات الوصفية في الأصول |
رميات
IOEException | في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite |
---|---|
غير الشرعيين استثناء حجة | إذا كانت الوسيطة غير صالحة |
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
ImageSegmenter العام الثابت createFromFile ( ملف modelFile)
ينشئ مثيل ImageSegmenter
من ImageSegmenter.ImageSegmenterOptions
الافتراضي.
حدود
modelFile | مثيل File نموذج التجزئة |
---|
رميات
IOEException | في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite |
---|---|
غير الشرعيين استثناء حجة | إذا كانت الوسيطة غير صالحة |
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
ImageSegmenter العام الثابت createFromFileAndOptions (خيارات File modelFile و ImageSegmenter.ImageSegmenterOptions )
ينشئ مثيل ImageSegmenter
من ImageSegmenter.ImageSegmenterOptions
.
حدود
modelFile | مثيل File نموذج التجزئة |
---|---|
خيارات |
رميات
IOEException | في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite |
---|---|
غير الشرعيين استثناء حجة | إذا كانت الوسيطة غير صالحة |
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
ImageSegmenter العام الثابت createFromFileAndOptions (سياق السياق، String modelPath، ImageSegmenter.ImageSegmenterOptions options)
ينشئ مثيل ImageSegmenter
من ImageSegmenter.ImageSegmenterOptions
.
حدود
سياق | |
---|---|
modelPath | مسار نموذج التجزئة مع البيانات الوصفية في الأصول |
خيارات |
رميات
IOEException | في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite |
---|---|
غير الشرعيين استثناء حجة | إذا كانت الوسيطة غير صالحة |
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
مقطع القائمة العامة <Segmentation> (خيارات الإطار الطويل BufferHandle و ImageProcessingOptions )
حدود
frameBufferHandle | |
---|---|
خيارات |
القائمة العامة < التجزئة > المقطع (صورة TensorImage )
ينفذ التجزئة الفعلية على الصورة المقدمة.
يدعم ImageSegmenter
أنواع مساحات الألوان TensorImage
التالية:
حدود
صورة | كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV |
---|
عائدات
- نتائج تنفيذ تجزئة الصورة. لاحظ أنه في ذلك الوقت، من المتوقع إرجاع عنصر
Segmentation
واحد. يتم تخزين النتيجة فيList
لتمديدها لاحقًا، على سبيل المثال، نماذج تجزئة المثيلات، والتي قد تُرجع تجزئة واحدة لكل كائن.
رميات
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
---|---|
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
غير الشرعيين استثناء حجة | إذا كان نوع مساحة اللون للصورة غير مدعوم |
القائمة العامة < التجزئة > المقطع (صورة MlImage )
ينفذ التجزئة الفعلية على MlImage
المقدمة.
حدود
صورة | MlImage لتقسيم. |
---|
عائدات
- نتائج تنفيذ تجزئة الصورة. لاحظ أنه في ذلك الوقت، من المتوقع إرجاع عنصر
Segmentation
واحد. يتم تخزين النتيجة فيList
لتمديدها لاحقًا، على سبيل المثال، نماذج تجزئة المثيلات، والتي قد تُرجع تجزئة واحدة لكل كائن.
رميات
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
---|---|
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
غير الشرعيين استثناء حجة | إذا كان نوع تخزين الصورة أو تنسيقها غير مدعوم |
القائمة العامة < التجزئة > المقطع (صورة TensorImage ، خيارات ImageProcessingOptions )
ينفذ التجزئة الفعلية على الصورة المقدمة باستخدام ImageProcessingOptions
.
يدعم ImageSegmenter
أنواع مساحات الألوان TensorImage
التالية:
يدعم ImageSegmenter
الخيارات التالية:
- تدوير الصورة (من خلال
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). يتم تعيينه افتراضيًا علىImageProcessingOptions.Orientation.TOP_LEFT
حدود
صورة | كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV |
---|---|
خيارات | تقوم الخيارات بتكوين كيفية المعالجة المسبقة للصورة |
عائدات
- نتائج تنفيذ تجزئة الصورة. لاحظ أنه في ذلك الوقت، من المتوقع إرجاع عنصر
Segmentation
واحد. يتم تخزين النتيجة فيList
لتمديدها لاحقًا، على سبيل المثال، نماذج تجزئة المثيلات، والتي قد تُرجع تجزئة واحدة لكل كائن.
رميات
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
---|---|
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
غير الشرعيين استثناء حجة | إذا كان نوع مساحة اللون للصورة غير مدعوم |
القائمة العامة < التجزئة > المقطع (صورة MlImage ، خيارات ImageProcessingOptions )
ينفذ التجزئة الفعلية على MlImage
المقدمة مع ImageProcessingOptions
.
يدعم ImageSegmenter
الخيارات التالية:
- تدوير الصورة (من خلال
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). الافتراضي هوImageProcessingOptions.Orientation.TOP_LEFT
.MlImage.getRotation()
غير فعال.
حدود
صورة | MlImage لتقسيم. |
---|---|
خيارات | تقوم الخيارات بتكوين كيفية المعالجة المسبقة للصورة. |
عائدات
- نتائج تنفيذ تجزئة الصورة. لاحظ أنه في ذلك الوقت، من المتوقع إرجاع عنصر
Segmentation
واحد. يتم تخزين النتيجة فيList
لتمديدها لاحقًا، على سبيل المثال، نماذج تجزئة المثيلات، والتي قد تُرجع تجزئة واحدة لكل كائن.
رميات
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
---|---|
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
غير الشرعيين استثناء حجة | إذا كان نوع مساحة اللون للصورة غير مدعوم |