fdpowermon - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

fdpowermon - freedesktop.org-compliant सिस्टम ट्रे में बैटरी लेवल आइकन जोड़ें

SYNOPSIS

एफडीपॉवरमोन

वर्णन

यह प्रोग्राम किसी भी freedesktop.org-compliant में "बैटरी लेवल" आइकन प्रदर्शित करने की अनुमति देता है
स्थिति क्षेत्र. इसे सादे-पाठ कॉन्फ़िगरेशन फ़ाइल के माध्यम से थीम पर आधारित किया जा सकता है
(/etc/fdpowermon/theme.cfg or $XDG_CONFIG_DIR/fdpowermon/theme.cfg), या संक्षेप में
पर्ल स्क्रिप्ट (/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" लोडिंग = "lazy" दिखाता है
11% और 100% के बीच (समावेशी); दूसरा चरण बैटरी स्तर होने पर "low.png" लोडिंग = "lazy" दिखाता है
3% और 10% (समावेशी) के बीच है; और तीसरा चरण "missing.png" के बीच वैकल्पिक होगा
और तीन सेकंड के अंतराल पर "low.png" लोडिंग = "आलसी", जब बैटरी 0% और 2% के बीच हो।

चूँकि लाइन "डिस्चार्जिंग" से शुरू होती है, इन चरणों का उपयोग तब किया जाता है जब सिस्टम चल रहा हो
बैटरी पावर पर. बैटरी कब चालू है, इसके लिए चरणों की एक समान पंक्ति परिभाषित की जा सकती है
चार्ज:

चार्जिंग = 0:खाली-चार्जिंग.पीएनजी, 10:कम-चार्जिंग.पीएनजी, 100: फुल-चार्जिंग.पीएनजी

जब बैटरी 0% (बिल्कुल) पर होगी, तो यह "empty-charging.png"loading='lazy' दिखाएगा।
"लो-चार्जिंग.पीएनजी" लोडिंग = "आलसी" 1% और 10% (समावेशी) के बीच, और "फुल-चार्जिंग.पीएनजी" लोडिंग = "आलसी" 11% और
ऊपर।

ध्यान दें कि ऑर्डर देना महत्वपूर्ण है: चरणों को निम्न से उच्च तक परिभाषित किया जाना चाहिए।

थीम कॉन्फ़िगरेशन को पूरा करने के लिए, हमें कुछ और आइटम जोड़ने होंगे:

[मेरा थीम]
चरण = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
चार्जिंग = 0:खाली-चार्जिंग.पीएनजी, 10:कम-चार्जिंग.पीएनजी, 100: फुल-चार्जिंग.पीएनजी
डिस्चार्जिंग = 2:missing.png:low.png, 10:low.png, 100:full.png

यह "माइथीम" नामक एक थीम को परिभाषित करता है जिसमें तीन चरण होते हैं, और इसमें छवियों की तलाश की जाएगी
निर्देशिका "/home/wouter/.fdpowermon/mytheme-icons"। A को परिभाषित करना संभव नहीं है
थीम जिसमें चार्जिंग चरण के लिए चरणों की संख्या उससे भिन्न होती है
निर्वहन चरण; यदि आप ऐसा चाहते हैं, तो बस उस चरण के लिए अतिरिक्त चरण परिभाषित करें
कम चरण रखना चाहेंगे, जिसमें ऊपर या नीचे चरण के समान आइकन हो।

ध्यान दें कि ऑर्डर देना यहां भी महत्वपूर्ण है; "चरण" पंक्ति किसी भी से पहले दिखाई देनी चाहिए
"चार्जिंग" या "डिस्चार्जिंग" लाइनें (यह fdpowermon 1.7 या उससे नीचे का मामला नहीं था)।

यदि एक से अधिक थीम कॉन्फ़िगर की गई हैं, तो fdpowermon, डिफ़ॉल्ट रूप से, अंतिम थीम का उपयोग करेगा
प्रति-उपयोगकर्ता कॉन्फ़िगरेशन में परिभाषित, या (यदि कोई प्रति-उपयोगकर्ता कॉन्फ़िगरेशन फ़ाइल मौजूद नहीं है)।
सिस्टम-वाइड कॉन्फ़िगरेशन में परिभाषित अंतिम विषय।

पर्ल थीम कॉन्फ़िगरेशन फ़ाइलें डिफ़ॉल्ट को बदलने के लिए fdpowermon::theme::make_default का उपयोग कर सकती हैं
विषय.

PERL API

@चेतावनी
@fdpowermon::theme::चेतावनी सरणी का उपयोग यह निर्दिष्ट करने के लिए किया जा सकता है कि fdpowermon किस स्तर पर है
एक मानक चेतावनी जारी करनी चाहिए. डिफ़ॉल्ट (10, 5, 1) है, जिसका अर्थ है चेतावनी जारी करना
10%, 5% और 1% के स्तर पर। ध्यान दें कि यदि बैटरी विशेष रूप से तेज़ गति से चलती है
गति, चेतावनी जारी होने से पहले का स्तर और भी कम हो सकता है;
साथ ही, मशीन से बिजली हटाते ही fdpowermon तुरंत चेतावनी जारी करेगा
और शक्ति प्रथम स्तर से नीचे है।

बिजली चले जाने पर fdpowermon हमेशा चेतावनी जारी करे, इसके लिए इसे किसी चीज़ पर सेट करें
जैसे (100, 10, 5, 1). 20%, 10% और 5% पर fdpowermon जारी करने की चेतावनियाँ बनाने के लिए, इसे इस पर सेट करें
(20, १ 10, ९)।

ध्यान दें कि चेतावनी का पाठ बदलना संभव नहीं है। यदि आप ऐसा चाहते हैं, तो देखें
fdpowermon::theme::warning उप, और एक ईवेंट का उपयोग करें।

$use_notify
वेरिएबल $fdpowermon::theme::use_notify का उपयोग यह तय करने के लिए किया जा सकता है कि a का उपयोग करना है या नहीं
libnotify संदेश (यदि गैर-शून्य मान पर सेट है), या एक संवाद विंडो (यदि किसी मान पर सेट है)।
शून्य पर मूल्यांकन करता है)।

यदि libnotify Glib आत्मनिरीक्षण डेटा स्थापित है, या तो libnotify का उपयोग करना डिफ़ॉल्ट है
यदि नहीं तो एक संवाद बॉक्स। क्योंकि डायलॉग बॉक्स फोकस चुरा सकते हैं और इसलिए तबाही मचा सकते हैं
उपयोगकर्ता के काम के साथ, लेखक द्वारा libnotify का उपयोग करने की पुरजोर अनुशंसा की जाती है।

ध्यान दें कि यदि आप वेरिएबल को स्पष्ट रूप से गैर-शून्य पर सेट करते हैं, तो परीक्षण करें कि क्या
स्थापित ग्लिब आत्मनिरीक्षण डेटा को नजरअंदाज कर दिया जाएगा। सुनिश्चित करें कि यह उसमें उपलब्ध है
मामला!

नई
एक नई fdpowermon थीम बनाएं। एक धन्य संदर्भ लौटाता है; उदाहरणार्थ,

मेरी $थीम = नई fdpowermon::थीम;

$थीम->सेट_स्टेपकाउंट($काउंट)
थीम में चरणों की संख्या निर्धारित करें. ध्यान दें कि fdpowermon थीम में एक समान होना चाहिए
"चार्जिंग" और "डिस्चार्जिंग" दोनों दिशाओं में चरणों की संख्या।

set_charging, set_discharging, या parse_step को कॉल करने से पहले कॉल किया जाना चाहिए।

$थीम->सेट_डीआईआर($डीआईआर)
आइकन फ़ाइल नामों के लिए उपयोग की जाने वाली आधार निर्देशिका सेट करें।

$थीम->सेट_चार्जिंग(\@तत्व)
वे आइकन सेट करें जो बैटरी चार्ज होने पर दिखाए जाने चाहिए। तर्क होना चाहिए
parse_step विधि के माध्यम से बनाया गया।

$थीम->सेट_डिस्चार्जिंग(\@तत्व)
वे आइकन सेट करें जो बैटरी डिस्चार्ज होने पर दिखाए जाने चाहिए। तर्क होना चाहिए
parse_step विधि के माध्यम से बनाया गया।

$थीम->parse_step($defs)
दी गई स्ट्रिंग को किसी ऐसी चीज़ में पार्स करता है जिसे set_charging या पर पास किया जा सकता है
सेट_डिस्चार्जिंग। परिभाषाएँ ऊपर वर्णित चरण प्रारूप में होनी चाहिए, बिना
अग्रणी " चार्जिंग = " या " डिस्चार्जिंग = "।

हालाँकि यह विधि एक ऐरेरेफ़ लौटाती है जिसका निरीक्षण किया जा सकता है और (संभवतः) संशोधित किया जा सकता है,
जो थीम आगे-संगत होना चाहते हैं, उन्हें इसे एक अपारदर्शी डेटा संरचना के रूप में मानना ​​चाहिए।

$थीम->सेट_इवेंट($कदम, \&वापस कॉल करें, 'डी')
थीम को अपडेट करें ताकि जब हम डिस्चार्ज हो रहे हों और हम पहुंचें तो उप 'कॉलबैक' निष्पादित हो जाए
पहली बार $step. इसके बजाय चार्ज करते समय एक ईवेंट सेट करने के लिए, तीसरे के रूप में 'सी' पास करें
तर्क।

ध्यान दें कि चरण सरणियाँ हैं, और इसलिए 0-आधारित हैं; सबसे कम संख्या वाले आइटम हैं
निम्नतम स्तर के चरण.

जब ईवेंट ट्रिगर होता है, तो कॉलबैक रूटीन में दो तर्क पारित किए जाएंगे: पहला है
वर्तमान बैटरी स्तर (प्रतिशत में); दूसरा एक संख्या है जो दर्शाती है कि क्या
बैटरी वर्तमान में चार्ज हो रही है (1) या डिस्चार्ज हो रही है (0)। मामले में ACPI का विश्लेषण
आदेश विफल रहता है, हालाँकि, दूसरा तर्क अपरिभाषित हो सकता है; आपको इसके लिए तैयारी करनी चाहिए
संभावना। ध्यान दें कि fdpowermon स्वयं बैटरी मानकर उस मामले को संभालता है
चार्जिंग; हो सकता है कि आप भी ऐसा करना चाहें या न चाहें।

$थीम->रजिस्टर($नाम)
किसी थीम को किसी दिए गए नाम के अंतर्गत पंजीकृत करता है. यदि उस नाम के तहत कोई थीम पहले से मौजूद है, तो वह है
जगह ले ली।

make_default($नाम)
किसी दिए गए नाम वाली थीम को डिफ़ॉल्ट थीम बनाता है।

get_theme($नाम)
दिए गए नाम के साथ एक थीम ढूंढता है; उदाहरणार्थ,

मेरी $थीम = fdpowermon::थीम::get_theme("डिफ़ॉल्ट");

चेतावनी($संदेश)
एक चेतावनी उत्पन्न करें, या तो libnotify का उपयोग करके, या एक संवाद बॉक्स का उपयोग करके:

fdpowermon :: विषय :: चेतावनी ($ संदेश);

इसके विवरण के लिए ऊपर $fdpowermon::theme::use_notify पर दस्तावेज़ देखें
कार्यान्वयन चुना गया है.

उदाहरण

संपूर्ण .cfg थीम उदाहरण के लिए, ऊपर देखें।

पर्ल से पूरी तरह से एक ही थीम बनाने के लिए, आप कुछ इस तरह करेंगे:

मेरी $थीम = नई fdpowermon::थीम;
$थीम->set_stepcount; (3)
$theme->set_dir("/home/wouter/.fdpowermon/mytheme-icons");
$थीम->सेट_चार्जिंग($थीम->पार्स_स्टेप('0:खाली-चार्जिंग.पीएनजी, 10:लो-चार्जिंग.पीएनजी, 100: फुल-चार्जिंग.पीएनजी');
$थीम->सेट_डिस्चार्जिंग($थीम->पार्स_स्टेप("2:missing.png:low.png, 10:low.png, 100:full.png"));

(ध्यान दें, पर्ल थीम के रूप में, यह थीम.पीएल में जाएगा, थीम.सीएफजी में नहीं; संभव के लिए ऊपर देखें
पर्ल थीम के लिए स्थान)

हालाँकि, जब तक आप थीम को गतिशील रूप से नहीं बनाना चाहते, इसे इस तरह से करना संभव नहीं है
अनुशंसित। इसके बजाय, आप थीम को .cfg फ़ाइल से बनाएंगे, और संभवतः इसे संशोधित करेंगे
पर्ल से. मान लीजिए कि आप बिजली आने पर सिस्टम को निलंबित करने के लिए एक ईवेंट जोड़ना चाहते हैं
कम; उस स्थिति में, आप कुछ ऐसा करेंगे:

उप निलंबित {
सिस्टम ("सुडो पीएम-सस्पेंड");
}

मेरी $थीम = fdpowermon::थीम::get_theme("mytheme");
$theme->set_event(0, \&suspend, 'd');

जब बैटरी डिस्चार्ज हो रही हो और हम निम्नतम पर पहुंच जाएं तो इसे 'सस्पेंड' सब कहा जाएगा
चरण (उपरोक्त उदाहरण में, वह तब होगा जब बैटरी 10% तक पहुंच जाएगी; हो सकता है कि आप ऐसा करना चाहें
ऐसा कुछ बाद में करें)। यह 'सस्पेंड' उप बस "पीएम-सस्पेंड" प्रोग्राम को कॉल करता है
सुडो, सिस्टम को निलंबित करने के लिए।

onworks.net सेवाओं का उपयोग करके ऑनलाइन fdpowermon का उपयोग करें