ImageSearcher

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

ينفذ بحث التشابه على الصور.

تتوقع واجهة برمجة التطبيقات (API) نموذج TFLite مع بيانات تعريف نموذج TFLite الاختيارية، ولكن يوصى بها بشدة. .

  • موتر صورة الإدخال ( kTfLiteUInt8 / kTfLiteFloat32 )
    • حجم إدخال الصورة [batch x height x width x channels] .
    • استنتاج الدُفعة غير مدعوم (يُشترط أن تكون batch 1).
    • يتم دعم مدخلات RGB فقط (يجب أن تكون channels 3).
    • إذا كان النوع هو kTfLiteFloat32 ، فيجب إرفاق خيارات التسوية بالبيانات الوصفية لتطبيع الإدخال.
  • موتر الإخراج ( kTfLiteUInt8 / kTfLiteFloat32 )
    • مكونات N المقابلة للأبعاد N لمتجه المعالم الذي تم إرجاعه لطبقة الإخراج هذه.
    • إما 2 أو 4 أبعاد، أي [1 x N] أو [1 x 1 x 1 x N] .

TODO(b/180502532): إضافة مؤشر إلى النموذج النموذجي.

TODO(b/222671076): إضافة أساليب إنشاء المصنع بدون خيارات، مثل `createFromFile`، بمجرد دعم تنسيق الملف الفردي (ملف الفهرس المعبأ في النموذج).

فئات متداخلة

فصل ImageSearcher.ImageSearcherOptions خيارات لإعداد ImageSearcher.

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

باحث الصور الثابت
createFromBufferAndOptions (خيارات ByteBuffer modelBuffer، و ImageSearcher.ImageSearcherOptions )
ينشئ مثيل ImageSearcher مع مخزن مؤقت للنموذج و ImageSearcher.ImageSearcherOptions .
باحث الصور الثابت
باحث الصور الثابت
createFromFileAndOptions (سياق السياق، خيارات String modelPath، ImageSearcher.ImageSearcherOptions )
باحث الصور الثابت
createFromFileAndOptions (خيارات File modelFile و ImageSearcher.ImageSearcherOptions )
إنشاء مثيل ImageSearcher .
قائمة < أقرب جار >
البحث (صورة TensorImage ، خيارات ImageProcessingOptions )
ينفذ استخراج التضمين على TensorImage المزود باستخدام ImageProcessingOptions ، متبوعًا بالبحث عن أقرب جار في الفهرس.
قائمة < أقرب جار >
بحث (صورة MlImage )
ينفذ استخراج التضمين في MlImage المقدم، متبوعًا بالبحث عن أقرب جار في الفهرس.
قائمة < أقرب جار >
البحث (صورة MlImage ، خيارات ImageProcessingOptions )
ينفذ استخراج التضمين على MlImage المقدم باستخدام ImageProcessingOptions ، متبوعًا بالبحث عن أقرب جار في الفهرس.
قائمة < أقرب جار >
بحث (صورة TensorImage )
ينفذ استخراج التضمين في TensorImage المقدم، متبوعًا بالبحث عن أقرب جار في الفهرس.

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

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

ImageSearcher ثابت عام createFromBufferAndOptions (خيارات ByteBuffer modelBuffer، ImageSearcher.ImageSearcherOptions )

ينشئ مثيل ImageSearcher مع مخزن مؤقت للنموذج و ImageSearcher.ImageSearcherOptions .

حدود
modelBuffer ByteBuffer مباشر أو MappedByteBuffer لنموذج البحث
خيارات
رميات
غير الشرعيين استثناء حجة إذا كان المخزن المؤقت للنموذج ليس ByteBuffer مباشرًا أو MappedByteBuffer
IOEException في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل ملف الفهرس
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد

ImageSearcher ثابت عام createFromBufferAndOptionsImpl (خيارات ByteBuffer modelBuffer، ImageSearcher.ImageSearcherOptions ، int IndexFd)

حدود
modelBuffer
خيارات
مؤشرFd

ImageSearcher ثابت عام createFromFileAndOptions (سياق السياق، String modelPath، خيارات ImageSearcher.ImageSearcherOptions )

حدود
سياق
modelPath مسار نموذج البحث مع البيانات الوصفية في الأصول
خيارات
رميات
IOEException في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite أو ملف الفهرس
غير الشرعيين استثناء حجة إذا كانت الوسيطة غير صالحة
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد

ImageSearcher ثابت عام createFromFileAndOptions ( ملف modelFile، خيارات ImageSearcher.ImageSearcherOptions )

إنشاء مثيل ImageSearcher .

حدود
modelFile مثيل File نموذج البحث
خيارات
رميات
IOEException في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite أو ملف الفهرس
غير الشرعيين استثناء حجة إذا كانت الوسيطة غير صالحة
استثناء الدولة غير القانوني إذا كان هناك خطأ داخلي
استثناء وقت التشغيل إذا كان هناك خطأ غير محدد

البحث في القائمة العامة < أقرب الجيران > (صورة TensorImage ، خيارات ImageProcessingOptions )

ينفذ استخراج التضمين على TensorImage المزود باستخدام ImageProcessingOptions ، متبوعًا بالبحث عن أقرب جار في الفهرس.

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

يدعم ImageSearcher أنواع مساحات الألوان TensorImage التالية:

حدود
صورة كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV
خيارات
رميات
غير الشرعيين استثناء حجة إذا كان نوع مساحة اللون للصورة غير مدعوم

بحث في القائمة العامة < أقرب جار > (صورة MlImage )

ينفذ استخراج التضمين في MlImage المقدم، متبوعًا بالبحث عن أقرب جار في الفهرس.

حدود
صورة كائن MlImage الذي يمثل صورة
رميات
غير الشرعيين استثناء حجة إذا كان نوع تخزين الصورة أو تنسيقها غير مدعوم

بحث في القائمة العامة < أقرب الجيران > (صورة MlImage ، خيارات ImageProcessingOptions )

ينفذ استخراج التضمين على MlImage المقدم باستخدام ImageProcessingOptions ، متبوعًا بالبحث عن أقرب جار في الفهرس.

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

حدود
صورة كائن MlImage الذي يمثل صورة
خيارات يقوم بتكوين الخيارات بما في ذلك عائد الاستثمار والتناوب
رميات
غير الشرعيين استثناء حجة إذا كان نوع تخزين الصورة أو تنسيقها غير مدعوم

بحث في القائمة العامة < أقرب جار > (صورة TensorImage )

ينفذ استخراج التضمين في TensorImage المقدم، متبوعًا بالبحث عن أقرب جار في الفهرس.

يدعم ImageSearcher أنواع مساحات الألوان TensorImage التالية:

حدود
صورة كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV
رميات
غير الشرعيين استثناء حجة إذا كان نوع مساحة اللون للصورة غير مدعوم