ImageSegmenter

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

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

שים לב, שבנוסף ל-API הסטנדרטי לפילוח, ERROR(/segment) ו-ERROR(/segmentForVideo), שלוקחים תמונת קלט ומחזירים את הפלטים, אבל כוללים העתקה עמוקה של ההחזרות, ב-ImageSegmenter יש גם תמיכה ב-API לקריאה חוזרת, ERROR(/segmentWithResultListener) ו-ERROR(/segmentForVideoWithResultListener), שמאפשרים גישה לפלט דרך אפס עותק.

ה-API לקריאה חוזרת (callback) זמין לכל RunningMode ב-ImageSegmenter. צריך להגדיר את OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions בצורה תקינה כדי להשתמש ב-API לקריאה חוזרת.

ה-API מצפה למודל TFLite עם המטא-נתונים של המודל TFLite.

  • הזנת תמונה MPImage
    • התמונה שעליה מוצג מפלח התמונות.
  • פלט ImageSegmenter Results ImageSegmenterResult
    • ImageSegmenter result שמכיל מסכות מפולחות.

מחלקות מקננות

מחלקה ImageSegmenter.ImageSegmenterOptions אפשרויות להגדרת ImageSegmenter
מחלקה ImageSegmenter.SegmentationOptions אפשרויות להגדרת התנהגות של זמן ריצה של ImageSegmenter

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

סטטי ImageSegmenter
createFromOptions(הקשר הקשר, ImageSegmenter.ImageSegmenterOptions segmenterOptions)
List<String>
getLabels()
קבלת רשימת תוויות הקטגוריה ש-ImageSegmenter יכול לזהות.
ImageSegmenterResult
פלח(MPImage תמונה, ImageSegmenter.SegmentationOptions segmentationOptions)
מבצע פילוח של תמונות בתמונה הבודדת שסופקה.
ImageSegmenterResult
פלח(MPImage תמונה, ImageProcessingOptions image ProcessingOptions)
מבצע פילוח של תמונות בתמונה הבודדת שסופקה.
ImageSegmenterResult
segment(תמונת MPImage)
הפעולה הזו מבצעת פילוח תמונה בתמונה הבודדת שסופקה, עם אפשרויות ברירת מחדל לעיבוד תמונה, כלומר
void
segmentAsync(MPImage image, ImageProcessingOptions image ProcessingOptions, long timestampMs)
נשלחים נתוני תמונה בזמן אמת לביצוע פילוח תמונות, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener שסופק בImageSegmenter.ImageSegmenterOptions.
void
segmentAsync(MPImage image, ImageSegmenter.SegmentationOptions segmentationOptions, long timestampMs)
נשלחים נתוני תמונה בזמן אמת לביצוע פילוח תמונות, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener שסופק בImageSegmenter.ImageSegmenterOptions.
void
segmentAsync(תמונת MPImage, long timestampMs)
שליחת נתוני תמונה בזמן אמת לביצוע פילוח תמונות עם אפשרויות עיבוד תמונה שמוגדרות כברירת מחדל, כלומר
ImageSegmenterResult
segmentForVideo(תמונת MPImage, ImageProcessingOptions image ProcessingOptions, long timestampMs)
מבצע פילוח של התמונות במסגרת הווידאו שסופקה.
ImageSegmenterResult
segmentForVideo(תמונת MPImage, long timestampMs)
הפעולה הזו מבצעת פילוח תמונה במסגרת הווידאו שסופקה, עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר
ImageSegmenterResult
segmentForVideo(תמונה MPImage, ImageSegmenter.SegmentationOptions segmentationOptions, long timestampMs)
מבצע פילוח של התמונות במסגרת הווידאו שסופקה.
void
segmentForVideoWithResultListener(תמונה מסוג MPImage, ImageProcessingOptions image ProcessingOptions, long timestampMs)
מתבצע פילוח של תמונות במסגרת הווידאו שסופקה, ומספק תוצאות ללא עותק דרך OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions.
void
segmentForVideoWithResultListener(תמונה MPImage, ImageSegmenter.SegmentationOptions segmentationOptions, long timestampMs)
מתבצע פילוח של תמונות במסגרת הווידאו שסופקה, ומספק תוצאות ללא עותק דרך OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions.
void
segmentForVideoWithResultListener(תמונה MPImage, long timestampMs)
הפעולה הזו מבצעת פילוח תמונה במסגרת הווידאו שסופקה, עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר
void
segmentWithResultListener(תמונת MPImage, ImageProcessingOptions image ProcessingOptions)
מתבצע פילוח של תמונות בתמונה הבודדת שסופקה, ותוצאות ללא עותק דרך OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions.
void
segmentWithResultListener(תמונת MPImage)
הפעולה הזו מבצעת פילוח תמונה בתמונה הבודדת שסופקה, עם אפשרויות ברירת מחדל לעיבוד תמונה, כלומר
void
segmentWithResultListener(תמונת MPImage, ImageSegmenter.SegmentationOptions segmentationOptions)
מתבצע פילוח של תמונות בתמונה הבודדת שסופקה, ותוצאות ללא עותק דרך OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions.

שיטות שעברו בירושה

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

ציבורי סטטי ImageSegmenter createFromOptions (Contextcontext, ImageSegmenter.ImageSegmenterOptions segmenterOptions)

פרמטרים
context ERROR(/Context) של Android.
segmenterOptions מופע של ImageSegmenter.ImageSegmenterOptions.
קליעות
אם יש שגיאה במהלך היצירה של ImageSegmenter.

Public רשימה<String> getLabels ()

קבלת רשימת תוויות הקטגוריה ש-ImageSegmenter יכול לזהות. עבור סוג CATEGORY_MASK, האינדקס במסכת הקטגוריה תואם לקטגוריה ברשימת התוויות. בסוג CONFIDENCE_MASK, רשימת מסכות הפלט באינדקס תואמת לקטגוריה ברשימת התוויות.

אם לא סופקה מפת תוויות בקובץ המודל, תוחזר רשימה ריקה של תוויות.

Public ImageSegmenterResult פלח (MPImage תמונה, ImageSegmenter.SegmentationOptions segmentationOptions)

מבצע פילוח של תמונות בתמונה הבודדת שסופקה. יש להשתמש בשיטה הזו רק אם ה-ImageSegmenter נוצר באמצעות ERROR(/RunningMode.IMAGE). TODO עדכן מסמך Java לפי פורמט קלט תמונה.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
segmentationOptions ImageSegmenter.SegmentationOptions משמש להגדרת ההתנהגות של זמן ריצה של ImageSegmenter.
קליעות
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter נוצר באמצעות OutputHandler.ResultListener.

Public ImageSegmenterResult פלח (MPImage image, ImageProcessingOptions image ProcessingOptions)

מבצע פילוח של תמונות בתמונה הבודדת שסופקה. הגודל של מסכת הפלט זהה של תמונת הקלט. יש להשתמש בשיטה הזו רק אם ה-ImageSegmenter נוצר באמצעות ERROR(/RunningMode.IMAGE). TODO עדכן מסמך Java לפורמט קלט תמונה.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
imageProcessingOptions ImageProcessingOptions שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך ImageProcessingOptions.regionOfInterest() יגרום ל-method הזה לגרום לחריגת invalidArgument.
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter נוצר באמצעות OutputHandler.ResultListener.

Public ImageSegmenterResult פלח (תמונה MPImage)

מבצע פילוח תמונה בתמונה הבודדת שסופקה, עם אפשרויות ברירת מחדל לעיבוד תמונה, כלומר ללא סיבוב. הגודל של מסכת הפלט זהה לזה של תמונת הקלט. יש להשתמש בשיטה הזו רק אם השדה ImageSegmenter נוצר באמצעות ERROR(/RunningMode.IMAGE). TODO עדכן מסמך Java לפורמט קלט תמונה.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
קליעות
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter נוצר באמצעות OutputHandler.ResultListener.

public void segmentAsync (MPImage image, ImageProcessingOptions imageprocessingOptions, long timestampMs)

נשלחים נתוני תמונה בזמן אמת לביצוע פילוח תמונות, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener שסופק בImageSegmenter.ImageSegmenterOptions. הגודל של מסכת הפלט זהה כמו של תמונת הקלט. יש להשתמש בשיטה הזו רק אם השדה ImageSegmenter נוצר באמצעות ERROR(/RunningMode.LIVE_STREAM).

צריך לספק חותמת זמן (באלפיות שנייה) כדי לציין מתי תמונת הקלט נשלחת למפלח התמונות. חותמות הזמן של הקלט צריכות להיות במגמת עלייה מונוטונית.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
imageProcessingOptions ImageProcessingOptions שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך ImageProcessingOptions.regionOfInterest() יגרום ל-method הזה לגרום לחריגת invalidArgument.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית.

public void segmentAsync (MPImage image, ImageSegmenter.SegmentationOptions segmentationOptions, long timestampMs)

נשלחים נתוני תמונה בזמן אמת לביצוע פילוח תמונות, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener שסופק בImageSegmenter.ImageSegmenterOptions. יש להשתמש בשיטה הזו רק כשה-ImageSegmenter נוצר עם ERROR(/RunningMode.LIVE_STREAM).

צריך לספק חותמת זמן (באלפיות שנייה) כדי לציין מתי תמונת הקלט נשלחת למפלח התמונות. חותמות הזמן של הקלט צריכות להיות במגמת עלייה מונוטונית.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
segmentationOptions ImageSegmenter.SegmentationOptions משמש להגדרת ההתנהגות של זמן ריצה של ImageSegmenter.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
אם אירעה שגיאה פנימית.

Public void segmentAsync (MPImage image, long timestampMs)

שליחת נתוני תמונה בזמן אמת לביצוע פילוח תמונות עם אפשרויות עיבוד תמונה שמוגדרות כברירת מחדל. כלומר, ללא סיבוב, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener שצוינו ב-ImageSegmenter.ImageSegmenterOptions. הגודל של מסכת הפלט זהה לזה של תמונת הקלט. יש להשתמש בשיטה הזו רק אם ה-ImageSegmenter נוצר באמצעות ERROR(/RunningMode.LIVE_STREAM).

צריך לספק חותמת זמן (באלפיות שנייה) כדי לציין מתי תמונת הקלט נשלחת למפלח התמונות. חותמות הזמן של הקלט צריכות להיות במגמת עלייה מונוטונית.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
אם אירעה שגיאה פנימית.

public ImageSegmenterResult segmentForVideo (MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)

מבצע פילוח של התמונות במסגרת הווידאו שסופקה. הגודל של מסכת הפלט זהה של תמונת הקלט. יש להשתמש בשיטה הזו רק אם ה-ImageSegmenter נוצר באמצעות ERROR(/RunningMode.VIDEO).

ההרשאה נדרשת לספק את חותמת הזמן של הפריים בסרטון (באלפיות השנייה). חותמות הזמן של הקלט צריכות לעלות באופן מונוטוני.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
imageProcessingOptions ImageProcessingOptions שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך ImageProcessingOptions.regionOfInterest() יגרום ל-method הזה לגרום לחריגת invalidArgument.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter נוצר באמצעות OutputHandler.ResultListener.

Public ImageSegmenterResult segmentForVideo (MPImage image, long timestampMs)

מתבצע פילוח של התמונה במסגרת הווידאו שסופקה, עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר ללא סיבוב של התמונה. הגודל של מסכת הפלט זהה לזה של תמונת הקלט. יש להשתמש בשיטה הזו רק אם השדה ImageSegmenter נוצר באמצעות ERROR(/RunningMode.VIDEO).

ההרשאה נדרשת לספק את חותמת הזמן של הפריים בסרטון (באלפיות השנייה). חותמות הזמן של הקלט צריכות לעלות באופן מונוטוני.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter נוצר באמצעות OutputHandler.ResultListener.

public ImageSegmenterResult segmentForVideo (MPImage image, ImageSegmenter.SegmentationOptions segmentationOptions, long timestampMs)

מבצע פילוח של התמונות במסגרת הווידאו שסופקה. יש להשתמש בשיטה הזו רק אם ה-ImageSegmenter נוצר באמצעות ERROR(/RunningMode.VIDEO).

ההרשאה נדרשת לספק את חותמת הזמן של הפריים בסרטון (באלפיות השנייה). חותמות הזמן של הקלט צריכות לעלות באופן מונוטוני.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
segmentationOptions ImageSegmenter.SegmentationOptions משמש להגדרת ההתנהגות של זמן ריצה של ImageSegmenter.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter נוצר באמצעות OutputHandler.ResultListener.

public void segmentForVideoWithResultListener (MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)

מתבצע פילוח של תמונות במסגרת הווידאו שסופקה, ומספק תוצאות ללא עותק דרך OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions. הגודל של מסכת הפלט זהה של תמונת הקלט. יש להשתמש בשיטה הזו רק אם ה-ImageSegmenter נוצר באמצעות ERROR(/RunningMode.VIDEO).

ההרשאה נדרשת לספק את חותמת הזמן של הפריים בסרטון (באלפיות השנייה). חותמות הזמן של הקלט צריכות לעלות באופן מונוטוני.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
imageProcessingOptions
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter לא נוצר עם OutputHandler.ResultListener שמוגדר ב-ImageSegmenter.ImageSegmenterOptions.

public void segmentForVideoWithResultListener (MPImage image, ImageSegmenter.SegmentationOptions segmentationOptions, long timestampMs)

מתבצע פילוח של תמונות במסגרת הווידאו שסופקה, ומספק תוצאות ללא עותק דרך OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions. יש להשתמש בשיטה הזו רק אם ה-ImageSegmenter נוצר באמצעות ERROR(/RunningMode.VIDEO).

ההרשאה נדרשת לספק את חותמת הזמן של הפריים בסרטון (באלפיות השנייה). חותמות הזמן של הקלט צריכות לעלות באופן מונוטוני.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
segmentationOptions ImageSegmenter.SegmentationOptions משמש להגדרת ההתנהגות של זמן ריצה של ImageSegmenter.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter לא נוצר עם OutputHandler.ResultListener שמוגדר ב-ImageSegmenter.ImageSegmenterOptions.

public void segmentForVideoWithResultListener (MPImage image, long timestampMs)

מתבצע פילוח תמונות במסגרת הווידאו שסופקה, עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר ללא סיבוב, ומספק תוצאות מועתקות דרך OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions. הגודל של מסכת הפלט זהה לזה של תמונת הקלט. יש להשתמש בשיטה הזו רק אם השדה ImageSegmenter נוצר באמצעות ERROR(/RunningMode.VIDEO).

ההרשאה נדרשת לספק את חותמת הזמן של הפריים בסרטון (באלפיות השנייה). חותמות הזמן של הקלט צריכות לעלות באופן מונוטוני.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter לא נוצר עם OutputHandler.ResultListener שמוגדר ב-ImageSegmenter.ImageSegmenterOptions.

Public void segmentWithResultListener (MPImage image, ImageProcessingOptions image ProcessingOptions)

מתבצע פילוח של תמונות בתמונה הבודדת שסופקה, ותוצאות ללא עותק דרך OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions. הגודל של מסכת הפלט זהה של תמונת הקלט. יש להשתמש בשיטה הזו רק אם ה-ImageSegmenter נוצר באמצעות ERROR(/RunningMode.IMAGE).

TODO עדכן מסמך Java לפורמט קלט תמונה.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
imageProcessingOptions ImageProcessingOptions שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך ImageProcessingOptions.regionOfInterest() יגרום ל-method הזה לגרום לחריגת invalidArgument.
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter לא נוצר עם OutputHandler.ResultListener שמוגדר ב-ImageSegmenter.ImageSegmenterOptions.

Public void segmentWithResultListener (תמונה MPImage)

מבצע פילוח תמונה בתמונה הבודדת שסופקה עם אפשרויות עיבוד תמונה שמוגדרות כברירת מחדל, כלומר ללא סיבוב, ומספק תוצאות ללא עותק דרך OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions. הגודל של מסכת הפלט זהה לזה של תמונת הקלט. יש להשתמש בשיטה הזו רק אם השדה ImageSegmenter נוצר באמצעות ERROR(/RunningMode.IMAGE).

TODO עדכן מסמך Java לפורמט קלט תמונה.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
קליעות
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter לא נוצר עם OutputHandler.ResultListener שמוגדר ב-ImageSegmenter.ImageSegmenterOptions.

public void segmentWithResultListener (MPImage image, ImageSegmenter.SegmentationOptions segmentationOptions)

מתבצע פילוח של תמונות בתמונה הבודדת שסופקה, ותוצאות ללא עותק דרך OutputHandler.ResultListener ב-ImageSegmenter.ImageSegmenterOptions. יש להשתמש בשיטה הזו רק אם ה-ImageSegmenter נוצר באמצעות ERROR(/RunningMode.IMAGE).

TODO עדכן מסמך Java לפורמט קלט תמונה.

ב-ImageSegmenter יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
segmentationOptions ImageSegmenter.SegmentationOptions משמש להגדרת ההתנהגות של זמן ריצה של ImageSegmenter.
קליעות
אם אירעה שגיאה פנימית. לחלופין, אם ImageSegmenter לא נוצר עם OutputHandler.ResultListener שמוגדר ב-ImageSegmenter.ImageSegmenterOptions.