fdpowermon - מקוון בענן

תָכְנִית:

שֵׁם

fdpowermon - הוסף סמל של רמת סוללה למגש מערכת תואם freedesktop.org

תַקצִיר

fdpowermon

תיאור

תוכנית זו מאפשרת להציג סמל "רמת סוללה" בכל freedesktop.org תואם
אזור סטטוס. ניתן לעצב אותו באמצעות קובץ תצורה של טקסט רגיל
(/etc/fdpowermon/theme.cfg or $XDG_CONFIG_DIR/fdpowermon/theme.cfg), או דרך קצר
סקריפט perl (/etc/fdpowermon/theme.pl or $XDG_CONFIG_DIR/fdpowermon/theme.pl). אם
$XDG_CONFIG_DIR לא מוגדר, $HOME/.config משמש כברירת מחדל.

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

ערכות נושא, בין אם ערכות נושא של פרל או ערכות נושא של טקסט רגיל, נבנות באמצעות 'שלבים', שהם
מוגדר בשורה אחת. בקובץ תצורה של טקסט רגיל, שורה כזו נראית כך:

פריקה = 2:missing.png:low.png, 10:low.png, 100:full.png

זה מגדיר שלושה שלבים. הצעד הגבוה ביותר מציג "full.png" loading="עצלן" כאשר רמת הסוללה היא
בין 11% ל-100% (כולל); השלב השני מציג "low.png" loading="עצלן" כאשר רמת הסוללה
הוא בין 3% ל-10% (כולל); והשלב השלישי יעבור לסירוגין בין "missing.png"
ו-"low.png" loading="עצלן" במרווחים של שלוש שניות, כאשר הסוללה היא בין 0% ל-2%.

מכיוון שהקו מתחיל ב"פריקה", נעשה שימוש בשלבים אלו כאשר המערכת פועלת
על כוח הסוללה. ניתן להגדיר שורה דומה של שלבים עבור כאשר הסוללה נמצאת
טְעִינָה:

טעינה = 0:empty-charging.png, 10:low-charging.png, 100: full-charging.png

זה יראה "empty-charging.png" loading="עצלן" כאשר הסוללה ב-0% (בדיוק),
"low-charging.png" loading="עצלן" בין 1% ל-10% (כולל), ו-"full-charging.png" loading="עצלן" ב-11% ו
מֵעַל.

שימו לב שיש משמעות להזמנה: יש להגדיר שלבים מנמוך לגבוה.

כדי להשלים את תצורת ערכת הנושא, עלינו להוסיף עוד כמה פריטים:

[מיתמה]
שלבים = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
טעינה = 0:empty-charging.png, 10:low-charging.png, 100: full-charging.png
פריקה = 2:missing.png:low.png, 10:low.png, 100:full.png

זה מגדיר ערכת נושא שנקראת "mytheme" בעלת שלושה שלבים, והיא תחפש תמונות
הספרייה "/home/wouter/.fdpowermon/mytheme-icons". לא ניתן להגדיר את א
נושא בעל מספר שלבים שונה לשלב הטעינה מאשר עבור
שלב הפריקה; אם אתה רוצה את זה, פשוט הגדר (שלבים נוספים) עבור השלב שאתה
רוצה שיהיו פחות שלבים, עם אותו סמל כמו השלב שלמעלה או למטה.

שימו לב שגם כאן יש משמעות להזמנה; שורת ה"צעדים" צריכה להופיע לפני כל
קווי "טעינה" או "פריקה" (זה לא היה המקרה ב-fdpowermon 1.7 ומטה).

אם מוגדרת יותר מערכה אחת, fdpowermon, כברירת מחדל, ישתמש בערכת הנושא האחרונה
מוגדר בתצורה לכל משתמש, או (אם לא קיים קובץ תצורה לכל משתמש)
הנושא האחרון שהוגדר בתצורה כלל המערכת.

קובצי התצורה של ערכת הנושא של Perl יכולים להשתמש ב-fdpowermon::theme::make_default כדי לשנות את ברירת המחדל
נושא.

פרל API

@אזהרות
ניתן להשתמש במערך @fdpowermon::theme::אזהרות כדי לציין באילו רמות fdpowermon
צריך להוציא אזהרה רגילה. ברירת המחדל היא (10, 5, 1), כלומר להוציא אזהרה
ברמה של 10%, 5% ו-1%. שימו לב שאם הסוללה מתרוקנת בקצב מהיר במיוחד
קצב, ייתכן שהרמה ירדה אפילו יותר מזה לפני הוצאת האזהרה;
כמו כן, fdpowermon תוציא אזהרה מיידית כאשר החשמל יוסר מהמכונה
והכוח הוא מתחת לרמה הראשונה.

כדי לגרום ל-fdpowermon תמיד להנפיק אזהרה כאשר החשמל מופסק, הגדר את זה למשהו
כמו (100, 10, 5, 1). כדי להגדיר אזהרות של fdpowermon ב-20%, 10% ו-5%, הגדר את זה ל-
(20, 10, 5).

שימו לב שלא ניתן לשנות את טקסט האזהרה. אם אתה רוצה את זה, ראה את
fdpowermon::theme::warning sub, והשתמש באירוע.

$use_notify
ניתן להשתמש במשתנה $fdpowermon::theme::use_notify כדי להחליט אם להשתמש ב-a
הודעת libnotify (אם מוגדרת לערך שאינו אפס), או חלון דו-שיח (אם מוגדר לערך אשר
מוערך לאפס).

ברירת המחדל היא להשתמש ב-libnotify אם נתוני ההתבוננות הפנימית של libnotify Glib מותקנים, או
תיבת דו-שיח אם לא. כי תיבות דיאלוג יכולות לגנוב את הפוקוס ולכן לזרוע הרס
עם עבודת המשתמש, השימוש ב-libnotify מומלץ בחום על ידי המחבר.

שים לב שאם אתה מגדיר את המשתנה ללא-אפס במפורש, אז הבדיקה אם ה-
נתוני התבוננות פנימית של Glib מותקן יתעלמו. ודא שזה זמין בזה
מקרה!

חדש
צור ערכת נושא חדשה של fdpowermon. מחזיר התייחסות מבורכת; לְמָשָׁל,

my $theme = new fdpowermon::theme;

$theme->set_stepcount($count)
הגדר את מספר השלבים בערכת הנושא. שימו לב שלערכת נושא fdpowermon חייבת להיות שווה
מספר השלבים הן בכיוון ה"טעינה" והן בכיוון ה"פריקה".

יש לקרוא לפני קריאה ל-set_charging, set_discharging או parse_step.

$theme->set_dir($dir)
הגדר את ספריית הבסיס המשמשת לשמות קבצי אייקונים.

$theme->set_charging(\@elements)
הגדר את הסמלים שיוצגו כאשר הסוללה נטענת. הטיעון צריך להיות
נוצר באמצעות שיטת parse_step.

$theme->set_discharging(\@elements)
הגדר את הסמלים שיוצגו כאשר הסוללה מתרוקנת. הטיעון צריך להיות
נוצר באמצעות שיטת parse_step.

$theme->parse_step($defs)
מנתח את המחרוזת הנתונה למשהו שניתן להעביר ל-set_charging or
set_discharging. ההגדרות צריכות להיות בפורמט השלבים, המתואר לעיל, ללא
המובילים " charging = " או " discharging = ".

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

$theme->set_event($step, \&התקשר חזרה, 'ד')
עדכן את ערכת הנושא כך שתת 'התקשרות חוזרת' תתבצע כאשר אנו מפרקים ונגיע
$step בפעם הראשונה. כדי להגדיר אירוע בעת טעינה במקום זאת, העבר 'c' בתור השלישי
ויכוח.

שימו לב שהשלבים הם מערכים, ולכן הם מבוססי 0; הפריטים עם המספר הנמוך ביותר הם
השלבים ברמה הנמוכה ביותר.

כאשר האירוע מופעל, שגרת ההתקשרות חזרה תועבר לשני ארגומנטים: הראשון הוא
רמת הסוללה הנוכחית (באחוזים); השני הוא מספר המציין אם ה
הסוללה כרגע נטענת (1) או מתרוקנת (0). במקרה הניתוח של ה-ACPI
הפקודה נכשלת, עם זאת, הארגומנט השני עשוי להיות undef; כדאי להתכונן לזה
אפשרות. שימו לב ש-fdpowermon בעצמה מטפלת במקרה הזה בהנחה שהסוללה כן
טְעִינָה; אתה יכול או לא רוצה לעשות את אותו הדבר.

$theme->register($name)
רושם נושא תחת שם פרטי. אם ערכת נושא כבר קיימת בשם זה, היא כן
הוחלף.

make_default($name)
הופך ערכת נושא עם שם נתון לנושא ברירת המחדל.

get_theme($name)
מחפש נושא עם השם הפרטי; לְמָשָׁל,

my $theme = fdpowermon::theme::get_theme("default");

אזהרה ($הודעה)
הפק אזהרה, באמצעות libnotify, או באמצעות תיבת דו-שיח:

fdpowermon::theme::warning($message);

עיין בתיעוד על $fdpowermon::theme::use_notify למעלה לפרטים על אילו
היישום נבחר.

דוגמאות

לדוגמא מלאה של ערכת נושא .cfg, עיין למעלה.

כדי לבנות את אותו ערכת נושא במלואו מ-perl, תעשה משהו כזה:

my $theme = new fdpowermon::theme;
$theme->set_stepcount(3);
$theme->set_dir("/home/wouter/.fdpowermon/mytheme-icons");
$theme->set_charging($theme->parse_step("0:empty-charging.png, 10:low-charging.png, 100: full-charging.png"));
$theme->set_discharging($theme->parse_step("2:missing.png:low.png, 10:low.png, 100:full.png"));

(שים לב, כנושא פרל, זה יכנס ל-theme.pl, לא ל-theme.cfg; ראה לעיל לאפשרות
מיקומים עבור ערכות נושא של perl)

עם זאת, אלא אם כן אתה רוצה לבנות את ערכת הנושא באופן דינמי, לעשות זאת בדרך זו לא
מוּמלָץ. במקום זאת, תבנה את ערכת הנושא מקובץ ‎.cfg, ואולי תשנה אותו
מ-perl. נניח שאתה רוצה להוסיף אירוע כדי להשעות את המערכת כשמתחזק
נָמוּך; במקרה כזה, תעשה משהו כזה:

sub suspend {
system("sudo pm-suspend");
}

my $theme = fdpowermon::theme::get_theme("mytheme");
$theme->set_event(0, \&suspend, 'd');

זה יקרא את המשנה 'השעיה' כאשר הסוללה מתרוקנת ואנו מגיעים לנמוך ביותר
שלב (בדוגמה לעיל, זה יהיה כאשר הסוללה מגיעה ל-10%; אולי כדאי
לעשות את זה קצת מאוחר יותר). המשנה 'השעיה' זה פשוט קורא לתוכנית "pm-suspend", עם
sudo, כדי להשעות את המערכת.

השתמש ב-fdpowermon באינטרנט באמצעות שירותי onworks.net