fdpowermon - Online in de cloud

PROGRAMMA:

NAAM

fdpowermon - voeg een batterijniveaupictogram toe aan een freedesktop.org-compatibel systeemvak

KORTE INHOUD

fdpowermon

PRODUCTBESCHRIJVING

Met dit programma kan men een "batterijniveau"-pictogram weergeven in elke freedesktop.org-compatibele computer
status gebied. Het kan een thema krijgen via een configuratiebestand in platte tekst
(/etc/fdpowermon/thema.cfg or $XDG_CONFIG_DIR/fdpowermon/thema.cfg), of via een kortsluiting
perl-script (/etc/fdpowermon/theme.pl or $XDG_CONFIG_DIR/fdpowermon/theme.pl). Als
$XDG_CONFIG_DIR is niet ingesteld, $HOME/.config wordt standaard gebruikt.

Het eerste is eenvoudiger, omdat er geen scripting voor nodig is; en inderdaad de standaard
configuratie is een voorbeeld van een dergelijk thema in platte tekst. Dit laatste maakt het echter wel mogelijk
meer flexibiliteit, omdat men callbacks kan definiëren die moeten worden uitgevoerd als de batterij leeg is
een bepaalde drempel bereikt.

Thema's, of het nu perl-thema's of platte-tekstthema's zijn, worden opgebouwd via 'stappen'
op één lijn gedefinieerd. In een configuratiebestand met platte tekst ziet zo'n regel er als volgt uit:

ontladen = 2:missing.png:low.png, 10:low.png, 100:full.png

Dit definieert drie stappen. De hoogste stap toont "full.png"loading="lazy" wanneer het batterijniveau hoog is
tussen 11% en 100% (inclusief); de tweede stap toont "low.png"loading="lazy" wanneer het batterijniveau is bereikt
ligt tussen 3% en 10% (inclusief); en de derde stap zal afwisselend "missing.png" zijn
en "low.png" loading="lazy" met intervallen van drie seconden, wanneer de batterij tussen 0% en 2% is.

Omdat de lijn begint met "ontladen", worden deze stappen gebruikt wanneer het systeem draait
op batterijvermogen. Een soortgelijke reeks stappen zou kunnen worden gedefinieerd voor wanneer de batterij leeg is
opladen:

opladen = 0:leeg-opladen.png, 10:laag-opladen.png, 100: volledig-opladen.png

dit toont "empty- Charging.png" Loading = "Lazy" wanneer de batterij 0% is (precies),
"low-lading.png" load="lazy" tussen 1% en 10% (inclusief), en "full-lading.png" load="lazy" op 11% en
bovenstaand.

Houd er rekening mee dat de volgorde belangrijk is: de stappen moeten van laag naar hoog worden gedefinieerd.

Om de themaconfiguratie te voltooien, moeten we nog een paar items toevoegen:

[mijn thema]
stappen = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
opladen = 0:leeg-opladen.png, 10:laag-opladen.png, 100: volledig-opladen.png
ontladen = 2:missing.png:low.png, 10:low.png, 100:full.png

Dit definieert een thema met de naam "mytheme", dat uit drie stappen bestaat en waarin naar afbeeldingen wordt gezocht
de directory "/home/wouter/.fdpowermon/mytheme-icons". Het is niet mogelijk om a te definiëren
thema dat een ander aantal stappen heeft voor de oplaadfase dan voor de
ontlaadfase; als je dat wilt, definieer dan gewoon (een) extra stap(pen) voor de fase waarin je zit
wil graag minder stappen hebben, die hetzelfde pictogram heeft als de stap erboven of eronder.

Merk op dat bestellen ook hier belangrijk is; de regel "stappen" moet vóór elke regel verschijnen
"opladen" of "ontladen" lijnen (dit was niet het geval in fdpowermon 1.7 of lager).

Als er meer dan één thema is geconfigureerd, zal fdpowermon standaard het laatste thema gebruiken
gedefinieerd in de configuratie per gebruiker, of (als er geen configuratiebestand per gebruiker bestaat) de
laatste thema gedefinieerd in de systeembrede configuratie.

Perl-themaconfiguratiebestanden kunnen fdpowermon::theme::make_default gebruiken om de standaard te wijzigen
thema.

PERL API

@waarschuwingen
De @fdpowermon::theme::warnings array kan worden gebruikt om te specificeren op welke niveaus fdpowermon
zou een standaardwaarschuwing moeten geven. De standaardwaarde is (10, 5, 1), wat betekent dat er een waarschuwing moet worden gegeven
op een niveau van 10%, 5% en 1%. Houd er rekening mee dat als de batterij bijzonder snel leeg raakt
tempo kan het niveau zelfs nog verder zijn gedaald dan vóór de waarschuwing werd afgegeven;
ook zal fdpowermon onmiddellijk een waarschuwing geven wanneer de stroom van de machine wordt verwijderd
en het vermogen ligt onder het eerste niveau.

Om ervoor te zorgen dat fdpowermon altijd een waarschuwing geeft wanneer de stroom wordt uitgeschakeld, stelt u dit op iets in
zoals (100, 10, 5, 1). Om ervoor te zorgen dat fdpowermon waarschuwingen geeft bij 20%, 10% en 5%, stelt u dit in op
(20, 10, 5, XNUMX).

Houd er rekening mee dat het niet mogelijk is om de tekst van de waarschuwing te wijzigen. Als je dat wilt, kijk dan op de
fdpowermon::theme::warning sub, en gebruik een evenement.

$gebruik_melding
De variabele $fdpowermon::theme::use_notify kan worden gebruikt om te beslissen of er een
libnotify-bericht (indien ingesteld op een waarde die niet nul is), of een dialoogvenster (indien ingesteld op een waarde die
evalueert naar nul).

De standaard is om libnotify te gebruiken als de libnotify Glib introspectiegegevens zijn geïnstalleerd, of
een dialoogvenster als dat niet het geval is. Omdat dialoogvensters de focus kunnen stelen en daardoor grote schade kunnen aanrichten
met het werk van de gebruiker wordt het gebruik van libnotify sterk aanbevolen door de auteur.

Houd er rekening mee dat als u de variabele expliciet instelt op niet-nul, de test of de
Glib-introspectiegegevens die zijn geïnstalleerd, worden genegeerd. Zorg ervoor dat het daarin beschikbaar is
geval!

nieuwe
Maak een nieuw fdpowermon-thema. Retourneert een gezegende referentie; bijvoorbeeld

mijn $theme = nieuw fdpowermon::theme;

$theme->set_stepcount($count)
Stel het aantal stappen in het thema in. Merk op dat een fdpowermon-thema een gelijk moet hebben
aantal stappen in zowel de "opladen" als de "ontladen" richting.

Moet worden aangeroepen voordat set_charge, set_dissolving of parse_step wordt aangeroepen.

$theme->set_dir($dir)
Stel de basismap in die wordt gebruikt voor pictogrambestandsnamen.

$theme->set_charge(\@elements)
Stel de pictogrammen in die moeten worden weergegeven wanneer de batterij wordt opgeladen. Het argument zou moeten zijn
gemaakt via de parse_step methode.

$theme->set_dissolving(\@elements)
Stel de pictogrammen in die moeten worden weergegeven wanneer de batterij leeg raakt. Het argument zou moeten zijn
gemaakt via de parse_step methode.

$theme->parse_step($defs)
Parseert de gegeven string in iets dat kan worden doorgegeven aan set_lading of
set_ontladen. De definities moeten het stappenformaat hebben, zoals hierboven beschreven, zonder
de leidende " opladen = " of " ontladen = ".

Hoewel deze methode een arrayref retourneert die kan worden geïnspecteerd en (waarschijnlijk) gewijzigd,
thema's die voorwaarts compatibel willen zijn, moeten het behandelen als een ondoorzichtige datastructuur.

$theme->set_event($stap, \&Bel terug, 'D')
Update het thema zodat de sub 'callback' wordt uitgevoerd wanneer we aan het ontladen zijn en we bereiken
$stap voor de eerste keer. Om in plaats daarvan een gebeurtenis in te stellen tijdens het opladen, geeft u een 'c' door als derde
argument.

Merk op dat de stappen arrays zijn en daarom op 0 gebaseerd zijn; de laagst genummerde items zijn
de stappen op het laagste niveau.

Wanneer de gebeurtenis wordt geactiveerd, krijgt de callback-routine twee argumenten doorgegeven: de eerste is
het huidige batterijniveau (in procent); de tweede is een getal dat aangeeft of de
de batterij wordt momenteel opgeladen (1) of ontladen (0). In het geval dat het parseren van de ACPI
opdracht mislukt, maar het tweede argument kan undef zijn; je moet je hierop voorbereiden
mogelijkheid. Merk op dat fdpowermon dit geval zelf afhandelt door aan te nemen dat het om de batterij gaat
opladen; je kunt wel of niet hetzelfde willen doen.

$thema->registreren($naam)
Registreert een thema onder een bepaalde naam. Als er al een thema bestaat onder die naam, dan is dat zo
vervangen.

make_default($naam)
Zorgt ervoor dat een thema met een bepaalde naam het standaardthema wordt.

get_theme($naam)
Zoekt een thema op met de opgegeven naam; bijvoorbeeld

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

waarschuwing($bericht)
Produceer een waarschuwing, met behulp van libnotify, of met behulp van een dialoogvenster:

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

Zie de documentatie over $fdpowermon::theme::use_notify hierboven voor details hierover
uitvoering wordt gekozen.

Voorbeelden

Kijk hierboven voor een volledig .cfg-themavoorbeeld.

Om hetzelfde thema volledig uit perl te construeren, zou je zoiets als dit doen:

mijn $theme = nieuw fdpowermon::theme;
$thema->set_stepcount(3);
$theme->set_dir("/home/wouter/.fdpowermon/mytheme-icons");
$theme->set_charge($theme->parse_step("0:leeg-opladen.png, 10:laag-opladen.png, 100: volledig-opladen.png"));
$theme->set_dissolving($theme->parse_step("2:missing.png:low.png, 10:low.png, 100:full.png"));

(let op, als perl-thema zou dit in thema.pl terechtkomen, niet in thema.cfg; zie hierboven voor mogelijke
locaties voor perl-thema's)

Tenzij u het thema dynamisch wilt opbouwen, is dit echter niet mogelijk
aanbevolen. In plaats daarvan zou u het thema bouwen vanuit een .cfg-bestand en dit eventueel aanpassen
van perl. Stel dat u een gebeurtenis wilt toevoegen om het systeem uit te schakelen wanneer de stroom weer wordt ingeschakeld
laag; in dat geval zou je zoiets als dit doen:

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

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

Dit zou de 'suspend'-sub noemen wanneer de batterij leeg raakt en we het laagste bereiken
stap (in het bovenstaande voorbeeld zou dat zijn wanneer de batterij 10% bereikt; misschien wil je dat ook doen
doe dat later). Deze 'suspend'-sub roept eenvoudigweg het programma 'pm-suspend' aan, met
sudo, om het systeem op te schorten.

Gebruik fdpowermon online met behulp van onworks.net-services