ImageSegmenter

الفئة النهائية العامة ImageSegmenter

ينفذ تجزئة على الصور.

تتوقع واجهة برمجة التطبيقات (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 .

الأساليب العامة

مقطع الصور الثابت
createFromBuffer (نموذج ByteBuffer )
ينشئ مثيل ImageSegmenter بمخزن مؤقت للنموذج و ImageSegmenter.ImageSegmenterOptions الافتراضي.
مقطع الصور الثابت
createFromBufferAndOptions (خيارات ByteBuffer modelBuffer، و ImageSegmenter.ImageSegmenterOptions )
ينشئ مثيل ImageSegmenter مع مخزن مؤقت للنموذج و ImageSegmenter.ImageSegmenterOptions .
مقطع الصور الثابت
createFromFile (سياق السياق، String modelPath)
ينشئ مثيل ImageSegmenter من ImageSegmenter.ImageSegmenterOptions الافتراضي.
مقطع الصور الثابت
createFromFile ( ملف نموذج الملف)
ينشئ مثيل ImageSegmenter من ImageSegmenter.ImageSegmenterOptions الافتراضي.
مقطع الصور الثابت
createFromFileAndOptions (خيارات File modelFile و ImageSegmenter.ImageSegmenterOptions )
ينشئ مثيل ImageSegmenter من ImageSegmenter.ImageSegmenterOptions .
مقطع الصور الثابت
createFromFileAndOptions (سياق السياق، وخيارات String modelPath، و ImageSegmenter.ImageSegmenterOptions )
ينشئ مثيل ImageSegmenter من ImageSegmenter.ImageSegmenterOptions .
قائمة < التجزئة >
المقطع (frameBufferHandle الطويل، خيارات ImageProcessingOptions )
قائمة < التجزئة >
المقطع (صورة TensorImage )
ينفذ التجزئة الفعلية على الصورة المقدمة.
قائمة < التجزئة >
المقطع (صورة MlImage )
ينفذ التجزئة الفعلية على MlImage المقدمة.
قائمة < التجزئة >
المقطع (صورة TensorImage ، خيارات ImageProcessingOptions )
ينفذ التجزئة الفعلية على الصورة المقدمة باستخدام ImageProcessingOptions .
قائمة < التجزئة >
المقطع (صورة MlImage ، خيارات ImageProcessingOptions )
ينفذ التجزئة الفعلية على MlImage المقدمة مع ImageProcessingOptions .

الطرق الموروثة

الأساليب العامة

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 الخيارات التالية:

حدود
صورة كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV
خيارات تقوم الخيارات بتكوين كيفية المعالجة المسبقة للصورة
عائدات
  • نتائج تنفيذ تجزئة الصورة. لاحظ أنه في ذلك الوقت، من المتوقع إرجاع عنصر Segmentation واحد. يتم تخزين النتيجة في List لتمديدها لاحقًا، على سبيل المثال، نماذج تجزئة المثيلات، والتي قد تُرجع تجزئة واحدة لكل كائن.
رميات
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد
غير الشرعيين استثناء حجة إذا كان نوع مساحة اللون للصورة غير مدعوم

القائمة العامة < التجزئة > المقطع (صورة MlImage ، خيارات ImageProcessingOptions )

ينفذ التجزئة الفعلية على MlImage المقدمة مع ImageProcessingOptions .

يدعم ImageSegmenter الخيارات التالية:

حدود
صورة MlImage لتقسيم.
خيارات تقوم الخيارات بتكوين كيفية المعالجة المسبقة للصورة.
عائدات
  • نتائج تنفيذ تجزئة الصورة. لاحظ أنه في ذلك الوقت، من المتوقع إرجاع عنصر Segmentation واحد. يتم تخزين النتيجة في List لتمديدها لاحقًا، على سبيل المثال، نماذج تجزئة المثيلات، والتي قد تُرجع تجزئة واحدة لكل كائن.
رميات
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد
غير الشرعيين استثناء حجة إذا كان نوع مساحة اللون للصورة غير مدعوم