מבצע חיפוש דמיון בתמונות.
ה-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. |
שיטות ציבוריות
שיטות בירושה
שיטות ציבוריות
ImageSearcher סטטי ציבורי createFromBufferAndOptions (אפשרויות ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions )
יוצר מופע ImageSearcher
עם מאגר מודל ו- ImageSearcher.ImageSearcherOptions
.
פרמטרים
דגםBuffer | ByteBuffer ישיר או MappedByteBuffer של מודל החיפוש |
---|---|
אפשרויות |
זורק
חריג טיעון לא חוקי | אם מאגר המודל אינו ByteBuffer ישיר או MappedByteBuffer |
---|---|
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת קובץ האינדקס |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public static ImageSearcher createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions options, int indexFd)
פרמטרים
דגםBuffer | |
---|---|
אפשרויות | |
indexFd |
ImageSearcher סטטי ציבורי createFromFileAndOptions (הקשר הקשר, דגם מחרוזת נתיב, אפשרויות ImageSearcher.ImageSearcherOptions )
יוצר מופע ImageSearcher
מ- ImageSearcher.ImageSearcherOptions
.
פרמטרים
הֶקשֵׁר | |
---|---|
modelPath | נתיב של מודל החיפוש עם מטא נתונים בנכסים |
אפשרויות |
זורק
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת מודל tflite או קובץ האינדקס |
---|---|
חריג טיעון לא חוקי | אם טיעון אינו חוקי |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
ImageSearcher סטטי ציבורי createFromFileAndOptions (אפשרויות דגם FileFile , ImageSearcher.ImageSearcherOptions )
יוצר מופע ImageSearcher
.
פרמטרים
modelFile | מודל החיפוש מופע File |
---|---|
אפשרויות |
זורק
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת מודל tflite או קובץ האינדקס |
---|---|
חריג טיעון לא חוקי | אם טיעון אינו חוקי |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
רשימה ציבורית < NearestNeighbor > חיפוש (תמונת TensorImage , אפשרויות ImageProcessingOptions )
מבצע חילוץ הטמעה ב- TensorImage
שסופק עם ImageProcessingOptions
, ואחריו חיפוש של השכן הקרוב באינדקס.
ImageSearcher
תומך באפשרויות הבאות:
- אזור עניין (ROI) (דרך
ImageProcessingOptions.Builder.setRoi(Rect)
). ברירת המחדל היא לתמונה כולה. - סיבוב תמונה (דרך
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). ברירת המחדל היאImageProcessingOptions.Orientation.TOP_LEFT
.
ImageSearcher
תומך בסוגי מרחב הצבעים הבאים TensorImage
:
פרמטרים
תמונה | אובייקט UINT8 TensorImage המייצג תמונת RGB או YUV |
---|---|
אפשרויות |
זורק
חריג טיעון לא חוקי | אם סוג מרחב הצבע של התמונה אינו נתמך |
---|
רשימה ציבורית < NearestNeighbor > חיפוש ( תמונה MlImage )
מבצע חילוץ הטבעה ב- MlImage
שסופק, ואחריו חיפוש של השכן הקרוב באינדקס.
פרמטרים
תמונה | אובייקט MlImage המייצג תמונה |
---|
זורק
חריג טיעון לא חוקי | אם סוג האחסון או הפורמט של התמונה אינם נתמכים |
---|
רשימה ציבורית < NearestNeighbor > חיפוש ( MlImage image, Image ProcessingOptions אפשרויות)
מבצע מיצוי הטמעה ב- MlImage
שסופק עם ImageProcessingOptions
, ואחריו חיפוש של השכן הקרוב באינדקס.
ImageSearcher
תומך באפשרויות הבאות:
- אזור עניין (ROI) (דרך
ImageProcessingOptions.Builder.setRoi(Rect)
). ברירת המחדל היא לתמונה כולה. - סיבוב תמונה (דרך
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). ברירת המחדל היאImageProcessingOptions.Orientation.TOP_LEFT
.MlImage.getRotation()
אינו יעיל.
פרמטרים
תמונה | אובייקט MlImage המייצג תמונה |
---|---|
אפשרויות | מגדיר אפשרויות כולל החזר ROI וסיבוב |
זורק
חריג טיעון לא חוקי | אם סוג האחסון או הפורמט של התמונה אינם נתמכים |
---|
רשימה ציבורית < NearestNeighbor > חיפוש ( תמונת TensorImage )
מבצע חילוץ הטבעה על TensorImage
שסופק, ולאחר מכן חיפוש של השכן הקרוב באינדקס.
ImageSearcher
תומך בסוגי מרחב הצבעים הבאים TensorImage
:
פרמטרים
תמונה | אובייקט UINT8 TensorImage המייצג תמונת RGB או YUV |
---|
זורק
חריג טיעון לא חוקי | אם סוג מרחב הצבע של התמונה אינו נתמך |
---|