ImageSegmenter

מחלקה סופית ציבורית ImageSegmenter

מבצע פילוח על תמונות.

ה-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 .

שיטות ציבוריות

סטטי ImageSegmenter
createFromBuffer ( ByteBuffer modelBuffer)
יוצר מופע ImageSegmenter עם מאגר מודל ועם ברירת המחדל ImageSegmenter.ImageSegmenterOptions .
סטטי ImageSegmenter
createFromBufferAndOptions (אפשרויות ByteBuffer modelBuffer, ImageSegmenter.ImageSegmenterOptions )
יוצר מופע ImageSegmenter עם מאגר מודל ו- ImageSegmenter.ImageSegmenterOptions .
סטטי ImageSegmenter
createFromFile (הקשר הקשר, דגם מחרוזת נתיב)
יוצר מופע ImageSegmenter מברירת המחדל של ImageSegmenter.ImageSegmenterOptions .
סטטי ImageSegmenter
createFromFile ( קובץ modelFile)
יוצר מופע ImageSegmenter מברירת המחדל של ImageSegmenter.ImageSegmenterOptions .
סטטי ImageSegmenter
createFromFileAndOptions (אפשרויות קובץ modelFile, ImageSegmenter.ImageSegmenterOptions )
יוצר מופע ImageSegmenter מתוך ImageSegmenter.ImageSegmenterOptions .
סטטי ImageSegmenter
createFromFileAndOptions (הקשר הקשר, דגם מחרוזת נתיב, אפשרויות ImageSegmenter.ImageSegmenterOptions )
יוצר מופע ImageSegmenter מתוך ImageSegmenter.ImageSegmenterOptions .
רשימה < פילוח >
מקטע (מסגרת ארוכהBufferHandle, אפשרויות ImageProcessingOptions )
רשימה < פילוח >
קטע (תמונה של TensorImage )
מבצע פילוח בפועל בתמונה שסופקה.
רשימה < פילוח >
קטע (תמונת MlImage )
מבצע פילוח בפועל ב- MlImage שסופק.
רשימה < פילוח >
מקטע (תמונת TensorImage , אפשרויות ImageProcessingOptions )
מבצע פילוח בפועל בתמונה שסופקה עם ImageProcessingOptions .
רשימה < פילוח >
קטע (תמונה MlImage , אפשרויות ImageProcessingOptions )
מבצע פילוח בפועל ב- MlImage שסופק עם ImageProcessingOptions .

שיטות בירושה

שיטות ציבוריות

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 תומך באפשרויות הבאות:

פרמטרים
תמונה אובייקט UINT8 TensorImage המייצג תמונת RGB או YUV
אפשרויות האפשרויות קובעות כיצד לעבד את התמונה מראש
החזרות
  • תוצאות של ביצוע פילוח תמונה. שים לב שבאותו זמן, רכיב Segmentation בודד צפוי להיות מוחזר. התוצאה מאוחסנת ב- List להרחבה מאוחרת יותר למודלים של פילוח מופעים, אשר עשויים להחזיר פילוח אחד לכל אובייקט.
זורק
חריגה של מדינה בלתי חוקית אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה
חריג טיעון לא חוקי אם סוג מרחב הצבע של התמונה אינו נתמך

רשימה ציבורית < פילוח > פלח (תמונה MlImage , אפשרויות ImageProcessingOptions )

מבצע פילוח בפועל ב- MlImage שסופק עם ImageProcessingOptions .

ImageSegmenter תומך באפשרויות הבאות:

פרמטרים
תמונה MlImage לפלח.
אפשרויות האפשרויות קובעות כיצד לעבד את התמונה מראש.
החזרות
  • תוצאות של ביצוע פילוח תמונה. שים לב שבאותו זמן, רכיב Segmentation בודד צפוי להיות מוחזר. התוצאה מאוחסנת ב- List להרחבה מאוחרת יותר למודלים של פילוח מופעים, אשר עשויים להחזיר פילוח אחד לכל אובייקט.
זורק
חריגה של מדינה בלתי חוקית אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה
חריג טיעון לא חוקי אם סוג מרחב הצבע של התמונה אינו נתמך