מבצע פילוח על תמונות.
ה-API מצפה למודל TFLite עם Metadata של מודל TFLite. .
ה-API תומך בדגמים עם טנזור קלט תמונה אחד וטנסור פלט אחד. ליתר דיוק, הנה הדרישות.
- טנזור תמונה קלט (
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 . |
שיטות ציבוריות
שיטות בירושה
שיטות ציבוריות
Public static ImageSegmenter createFromBuffer ( ByteBuffer modelBuffer)
יוצר מופע ImageSegmenter
עם מאגר מודל ועם ברירת המחדל ImageSegmenter.ImageSegmenterOptions
.
פרמטרים
דגםBuffer | ByteBuffer ישיר או MappedByteBuffer של מודל הפילוח |
---|
זורק
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
---|---|
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
חריג טיעון לא חוקי | אם מאגר המודל אינו ByteBuffer ישיר או MappedByteBuffer |
Public static ImageSegmenter createFromBufferAndOptions (אפשרויות ByteBuffer modelBuffer, ImageSegmenter.ImageSegmenterOptions )
יוצר מופע ImageSegmenter
עם מאגר מודל ו- ImageSegmenter.ImageSegmenterOptions
.
פרמטרים
דגםBuffer | ByteBuffer ישיר או MappedByteBuffer של מודל הפילוח |
---|---|
אפשרויות |
זורק
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
---|---|
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
חריג טיעון לא חוקי | אם מאגר המודל אינו ByteBuffer ישיר או MappedByteBuffer |
Public static ImageSegmenter createFromFile (הקשר הקשר, דגם מחרוזת נתיב)
יוצר מופע ImageSegmenter
מברירת המחדל של ImageSegmenter.ImageSegmenterOptions
.
פרמטרים
הֶקשֵׁר | |
---|---|
modelPath | נתיב של מודל הפילוח עם מטא נתונים בנכסים |
זורק
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
---|---|
חריג טיעון לא חוקי | אם טיעון אינו חוקי |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public static ImageSegmenter createFromFile ( קובץ modelFile)
יוצר מופע ImageSegmenter
מברירת המחדל של ImageSegmenter.ImageSegmenterOptions
.
פרמטרים
modelFile | מודל הפילוח מופע File |
---|
זורק
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
---|---|
חריג טיעון לא חוקי | אם טיעון אינו חוקי |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public static ImageSegmenter createFromFileAndOptions (אפשרויות דגם FileFile , ImageSegmenter.ImageSegmenterOptions )
יוצר מופע ImageSegmenter
מתוך ImageSegmenter.ImageSegmenterOptions
.
פרמטרים
modelFile | מודל הפילוח מופע File |
---|---|
אפשרויות |
זורק
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
---|---|
חריג טיעון לא חוקי | אם טיעון אינו חוקי |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public static ImageSegmenter createFromFileAndOptions (הקשר הקשר, דגם מחרוזת נתיב, ImageSegmenter.ImageSegmenterOptions אפשרויות)
יוצר מופע ImageSegmenter
מתוך ImageSegmenter.ImageSegmenterOptions
.
פרמטרים
הֶקשֵׁר | |
---|---|
modelPath | נתיב של מודל הפילוח עם מטא נתונים בנכסים |
אפשרויות |
זורק
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
---|---|
חריג טיעון לא חוקי | אם טיעון אינו חוקי |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
רשימה ציבורית < פילוח > פלח (מסגרת ארוכה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
להרחבה מאוחרת יותר למודלים של פילוח מופעים, אשר עשויים להחזיר פילוח אחד לכל אובייקט.
זורק
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
---|---|
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
חריג טיעון לא חוקי | אם סוג מרחב הצבע של התמונה אינו נתמך |