צילום מסך ב-Android

הפלט של מסך המכשיר הוא קובץ PNG.

שימוש

android screen capture [-ah] [--debug] [--device=PARAM] [--distance=PARAM] [--edge-thresh-strong=PARAM] [--edge-thresh-weak=PARAM] [--features=PARAM] [--min-area=PARAM] [--min-nested-area=PARAM] [--min-rect=PARAM] [--min-round=PARAM] [--output=PARAM] [--threshold=PARAM]

אפשרויות

  • ‫-a,--annotate – מזהה רכיבים בממשק המשתמש בצילום המסך ומוסיף להם תוויות עם תיבות תוחמות ממוספרות (#1,‏ #2 וכן הלאה). כך סוכני AI ותסריטים יכולים להפנות לרכיבים בממשק המשתמש במסך לפי מספר התווית, במקום לחשב ידנית את קואורדינטות הפיקסלים.
  • ‫--debug – פלט של שלבי זיהוי תכונות ביניים לכוונון פרמטרים.
  • ‫--device=PARAM – המספר הסידורי של המכשיר.
  • ‫--distance=PARAM – נעשה שימוש ב---annotate. מדד המרחק לשילוב צורות מזוהות בתכונות של ממשק המשתמש (MIN_EUCLIDEAN או MIN_ANISOTROPIC). המשקל של MIN_ANISOTROPIC להפרדה אנכית בציר ה-y גבוה יותר מהמשקל להפרדה אופקית בציר ה-x (ברירת מחדל: MIN_EUCLIDEAN).
  • ‫--edge-thresh-strong=PARAM – נעשה שימוש ב---annotate. סף גבוה (0 עד 1) לזיהוי קצוות. כדאי להקטין את הערך הזה אם המערכת מתעלמת מקצוות שקשה לזהות, או להגדיל אותו אם הזיהוי רועש מדי (ברירת מחדל: 0.1).
  • ‫--edge-thresh-weak=PARAM – נעשה שימוש ב---annotate. סף חלש (0 עד 1) לזיהוי קצוות. אם המערכת מתעלמת מקצוות שקשה לזהות, צריך להקטין את הערך הזה. אם הזיהוי רועש מדי, צריך להגדיל אותו (ברירת מחדל: 0.05).
  • ‫--features=PARAM – נעשה שימוש ב---annotate. אלגוריתם שמשמש לקיבוץ צורות מזוהות לתכונות בממשק המשתמש (GREEDY או FH). GREEDY משלב צורות שהמרחק ביניהן קטן מ---threshold לתכונה אחת. ‫FH משתמש ב---threshold כפרמטר של קנה מידה לפילוח, שבו ערכים גבוהים יותר יוצרים פחות תכונות גדולות יותר, וערכים נמוכים יותר יוצרים יותר תכונות קטנות יותר (ברירת מחדל: FH).
  • ‫-h,--help – הצגת הודעת העזרה של הפקודה שצוינה.
  • ‫--min-area=PARAM – נעשה שימוש ב---annotate. שטח הצורה המינימלי ב-dp² לפני זיהוי התכונה. המערכת מתעלמת מצורות קטנות יותר מהסף הזה (ברירת מחדל: 5.0).
  • ‫--min-nested-area=PARAM – נעשה שימוש ב---annotate. כדי לשמור על תכונות משנה מוטמעות, צריך להגדיר לפחות אזור תכונה ראשי אחד ב-dp². כדאי להגדיל את הערך הזה אם פרטים קטנים בתוך סמלים מסומנים כרכיבים נפרדים (ברירת מחדל: 3600.0).
  • ‫--min-rect=PARAM – נעשה שימוש ב---annotate. היחס המינימלי בין שטח הצורה לבין שטח תיבת התוחמת שלה שמוגדרת לפי הצירים. המערכת מתעלמת מהצורות שמתחת ל---min-rect ול---min-round (ברירת מחדל: 0.2).
  • ‫--min-round=PARAM – נעשה שימוש ב---annotate. העגלגלות המינימלית של הצורה (4 * PI * area / perimeter^2, כאשר 1.0 הוא עיגול מושלם). המערכת מתעלמת מהצורות שמתחת ל---min-rect ול---min-round (ברירת מחדל: 0.2).
  • ‫-o,--output=PARAM – כותב את צילום המסך לקובץ או לספרייה שצוינו.
  • ‫--threshold=PARAM – נעשה שימוש ב---annotate. ערך הסף לקיבוץ שמועבר לאלגוריתם שצוין ב---features (ברירת מחדל: 15).

אפשרויות android:

  • ‫--sdk=PARAM – הנתיב אל Android SDK.
  • ‫-v,--verbose – הפעלת פלט מפורט לפתרון בעיות.
  • ‫-V,--version – הדפסת פרטי הגרסה ויציאה.

תיאור

‫android screen capture מצלם צילום מסך בפורמט PNG של מכשיר Android או אמולטור שמחוברים.

אם לא מציינים את -o, --output, הבייטים של תמונת ה-PNG הגולמית נכתבים בפלט הסטנדרטי.

הוספת הערות לרכיבים בממשק המשתמש (-a, --annotate)

מעבירים את הערך -a, --annotate כדי לזהות רכיבים בממשק המשתמש במסך ולהוסיף תיבות תוחמות ממוספרות (#1, #2 וכן הלאה) סביב כל רכיב שזוהה. קובץ ה-PNG שנוצר כולל גם מטא-נתונים של תיבות תוחמות, כדי ש-android screen resolve יוכל לתרגם את התוויות של #N לקואורדינטות של (x, y) במסך.

אפשר לכוונן את רגישות הזיהוי באמצעות אפשרויות כמו --edge-thresh-weak,‏ --edge-thresh-strong,‏ --min-area,‏ --min-rect,‏ --min-round,‏ --min-nested-area,‏ --distance,‏ --features ו---threshold.

דוגמאות

שמירת צילום מסך של המכשיר המחובר ב-ui.png:

android screen capture --output=ui.png

צילום מסך עם הערות שבו מסומנות תיבות תוחמות של ממשק המשתמש לטירגוט חזותי:

android screen capture --annotate --output=ui_annotated.png