fdpowermon — online w chmurze

PROGRAM:

IMIĘ

fdpowermon - dodaje ikonę poziomu baterii do zasobnika systemowego zgodnego z freedesktop.org

STRESZCZENIE

fdpowermon

OPIS

Ten program pozwala wyświetlać ikonę „poziomu baterii” w każdym zgodnym z freedesktop.org
obszar stanu. Można go motywować za pomocą zwykłego pliku konfiguracyjnego
(/etc/fdpowermon/theme.cfg or $XDG_CONFIG_DIR/fdpowermon/theme.cfg) lub przez skrót
skrypt Perla (/etc/fdpowermon/theme.pl or $XDG_CONFIG_DIR/fdpowermon/theme.pl). Jeśli
$XDG_CONFIG_DIR nie jest ustawiony, $HOME/.config jest używany jako domyślny.

Ta pierwsza jest prostsza, ponieważ nie wymaga żadnego skryptu; i rzeczywiście domyślny
konfiguracja jest przykładem takiego motywu zwykłego tekstu. Jednak to drugie pozwala
większą elastyczność, ponieważ można zdefiniować wywołania zwrotne, które powinny być uruchamiane, gdy poziom naładowania baterii
osiąga pewien próg.

Motywy, czy to motywy Perla, czy motywy zwykłego tekstu, są budowane poprzez „kroki”, którymi są
zdefiniowany w jednej linii. W zwykłym pliku konfiguracyjnym taka linia wygląda następująco:

rozładowanie = 2:brak.png:niski.png, 10:niski.png, 100:pełny.png

To definiuje trzy kroki. Najwyższy stopień pokazuje „full.png” loading = „leniwy”, gdy poziom naładowania baterii wynosi
od 11% do 100% (włącznie); drugi krok pokazuje „low.png” loading = „leniwy”, gdy poziom naładowania baterii
wynosi od 3% do 10% (włącznie); a trzeci krok będzie na przemian „missing.png”
i "low.png" loading="leniwy" w odstępach trzysekundowych, gdy poziom naładowania baterii wynosi od 0% do 2%.

Ponieważ linia zaczyna się od „rozładowania”, kroki te są wykonywane, gdy system jest uruchomiony
na zasilaniu bateryjnym. Podobną linię kroków można zdefiniować dla sytuacji, gdy bateria jest
ładowanie:

ładowanie = 0:puste ładowanie.png, 10:niskie ładowanie.png, 100: ładowanie pełne.png

to pokaże „empty-charging.png” loading = „leniwy”, gdy bateria jest na poziomie 0% (dokładnie),
"low-charging.png" loading="leniwy" od 1% do 10% (włącznie) oraz "full-charging.png" loading="leniwy" przy 11% i
powyżej.

Należy pamiętać, że kolejność jest istotna: kroki należy zdefiniować od najniższego do najwyższego.

Aby zakończyć konfigurację motywu, musimy dodać jeszcze kilka elementów:

[mój motyw]
kroki = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
ładowanie = 0:puste ładowanie.png, 10:niskie ładowanie.png, 100: ładowanie pełne.png
rozładowanie = 2:brak.png:niski.png, 10:niski.png, 100:pełny.png

To definiuje motyw o nazwie „mytheme”, który ma trzy kroki i będzie szukał obrazów
katalog „/home/wouter/.fdpowermon/mytheme-icons”. Nie można zdefiniować A
motyw, który ma inną liczbę kroków dla fazy ładowania niż dla
faza rozładowania; jeśli chcesz, po prostu zdefiniuj (dodatkowy) krok(i) dla fazy, którą chcesz
chciałby mieć mniej kroków, które mają taką samą ikonę jak krok powyżej lub poniżej.

Pamiętaj, że tutaj również kolejność ma znaczenie; linia „steps” powinna pojawić się przed dowolnymi
linie „ładowania” lub „rozładowywania” (nie dotyczyło to fdpowermon 1.7 lub starszych).

Jeśli skonfigurowano więcej niż jeden motyw, fdpowermon domyślnie użyje ostatniego motywu
zdefiniowany w konfiguracji dla użytkownika lub (jeśli nie istnieje żaden plik konfiguracyjny dla użytkownika) plik
ostatni motyw zdefiniowany w konfiguracji ogólnosystemowej.

Pliki konfiguracyjne motywu Perla mogą używać fdpowermon::theme::make_default do zmiany domyślnego
motyw.

Perła API

@ostrzeżenia
Tablicy @fdpowermon::theme::warnings można użyć do określenia poziomów fdpowermon
powinien wydać standardowe ostrzeżenie. Wartością domyślną jest (10, 5, 1), co oznacza wysłanie ostrzeżenia
na poziomie 10%, 5% i 1%. Należy pamiętać, że jeśli bateria rozładuje się w szczególnie szybkim tempie
tempa, poziom mógł spaść jeszcze bardziej niż przed wydaniem ostrzeżenia;
fdpowermon natychmiast wyświetli ostrzeżenie, gdy zasilanie zostanie odłączone od maszyny
a moc jest poniżej pierwszego poziomu.

Aby fdpowermon zawsze wyświetlał ostrzeżenie po odłączeniu zasilania, ustaw to na coś
jak (100, 10, 5, 1). Aby fdpowermon wyświetlał ostrzeżenia o 20%, 10% i 5%, ustaw to na
(20, 10, 5, XNUMX).

Pamiętaj, że nie ma możliwości zmiany tekstu ostrzeżenia. Jeśli chcesz to zobacz
fdpowermon::theme::warning sub i użyj zdarzenia.

$use_notify
Zmienna $fdpowermon::theme::use_notify może być użyta do podjęcia decyzji, czy użyć a
libnotify (jeśli jest ustawiona na wartość różną od zera) lub okno dialogowe (jeśli jest ustawiona na wartość, która
ocenia na zero).

Domyślnie jest używane libnotify, jeśli dane introspekcji libnotify Glib są zainstalowane, lub
okno dialogowe, jeśli nie. Ponieważ okna dialogowe mogą ukraść fokus, a tym samym siać spustoszenie
z pracą użytkownika użycie libnotify jest zdecydowanie zalecane przez autora.

Zauważ, że jeśli jawnie ustawisz zmienną na wartość różną od zera, to test, czy the
Zainstalowane dane introspekcji Glib będą ignorowane. Upewnij się, że jest w tym dostępny
Obudowa!

nowa
Utwórz nowy motyw fdpowermon. Zwraca błogosławioną referencję; np,

mój motyw $ = nowy fdpowermon:: motyw;

$theme->set_stepcount($count)
Ustaw liczbę kroków w motywie. Zauważ, że motyw fdpowermon musi mieć równy
liczbę kroków zarówno w kierunku „ładowania”, jak i „rozładowania”.

Powinien zostać wywołany przed wywołaniem set_charging, set_discharging lub parse_step.

$theme->set_dir($dir)
Ustaw katalog podstawowy używany do nazw plików ikon.

$theme->set_charging(\@elementy)
Ustaw ikony, które mają być wyświetlane podczas ładowania baterii. Argument powinien być
utworzone za pomocą metody parse_step.

$theme->set_discharging(\@elementy)
Ustaw ikony, które mają być wyświetlane, gdy bateria się rozładowuje. Argument powinien być
utworzone za pomocą metody parse_step.

$theme->parse_step($defs)
Analizuje podany ciąg w coś, co można przekazać do set_charging lub
ustawione_rozładowanie. Definicje powinny być w formacie kroków opisanym powyżej, bez
wiodący „ładowanie =” lub „rozładowanie =”.

Chociaż ta metoda zwraca odwołanie do tablicy, które można sprawdzić i (prawdopodobnie) zmodyfikować,
motywy, które chcą być kompatybilne w przód, powinny traktować je jako nieprzejrzystą strukturę danych.

$motyw->set_event($krok, \&oddzwonić, 'D')
Zaktualizuj motyw, aby podrzędne wywołanie zwrotne było wykonywane, gdy się rozładowujemy i docieramy
$krok po raz pierwszy. Aby zamiast tego ustawić zdarzenie podczas ładowania, podaj „c” jako trzecie
argumenty.

Zauważ, że kroki są tablicami i dlatego są oparte na 0; pozycje o najniższych numerach są
stopnie najniższego poziomu.

Gdy zdarzenie zostanie wyzwolone, procedurze wywołania zwrotnego zostaną przekazane dwa argumenty: pierwszy to
aktualny poziom naładowania baterii (w procentach); druga to liczba oznaczająca, czy
akumulator aktualnie się ładuje (1) lub rozładowuje (0). W przypadku parsowania pliku ACPI
polecenie nie powiedzie się, jednak drugim argumentem może być undef; powinieneś się na to przygotować
możliwość. Zauważ, że sam fdpowermon obsługuje ten przypadek, zakładając, że bateria jest
ładowanie; możesz lub nie chcesz zrobić tego samego.

$theme->register($nazwa)
Rejestruje motyw pod daną nazwą. Jeśli motyw już istnieje pod tą nazwą, to tak
wymieniony.

make_default($nazwa)
Ustawia motyw o podanej nazwie jako motyw domyślny.

get_theme($nazwa)
Wyszukuje motyw o podanej nazwie; np,

mój $theme = fdpowermon::theme::get_theme("default");

ostrzeżenie($wiadomość)
Utwórz ostrzeżenie, używając libnotify lub okna dialogowego:

fdpowermon::motyw::ostrzeżenie($wiadomość);

Zobacz dokumentację $fdpowermon::theme::use_notify powyżej, aby uzyskać szczegółowe informacje o tym
wybrana jest realizacja.

PRZYKŁADY

Pełny przykład motywu .cfg znajduje się powyżej.

Aby w pełni zbudować ten sam motyw z Perla, zrobiłbyś coś takiego:

mój motyw $ = nowy fdpowermon:: motyw;
$motyw->set_stepcount(3);
$theme->set_dir("/home/wouter/.fdpowermon/mytheme-icons");
$theme->set_charging($theme->parse_step("0:puste-ładowanie.png, 10:niskie-ładowanie.png, 100: pełne-ładowanie.png"));
$theme->set_discharging($theme->parse_step("2:missing.png:low.png, 10:low.png, 100:full.png"));

(uwaga, jako motyw perla, to powinno znaleźć się w theme.pl, a nie w theme.cfg; patrz wyżej, aby zobaczyć możliwe
lokalizacje motywów Perla)

Jeśli jednak nie chcesz dynamicznie budować motywu, robienie tego w ten sposób nie jest
Zalecana. Zamiast tego zbudujesz motyw z pliku .cfg i ewentualnie go zmodyfikujesz
z perla. Powiedzmy, że chcesz dodać zdarzenie zawieszające system po przywróceniu zasilania
Niski; w takim przypadku zrobiłbyś coś takiego:

zawieszenie subskrypcyjne {
system("sudo pm-suspend");
}

mój $motyw = fdpowermon::motyw::get_theme("mojmotyw");
$theme->set_event(0, \&suspend, 'd');

Spowodowałoby to wywołanie „zawieszenia” łodzi podwodnej, gdy bateria się rozładowuje i osiągamy najniższy poziom
krok (w powyższym przykładzie byłoby to, gdy bateria osiągnie 10%; możesz chcieć
zrobić to trochę później). Ten podrzędny tryb „zawieszenia” po prostu wywołuje program „pm-suspend”, za pomocą
sudo, aby zawiesić system.

Korzystaj z fdpowermon online, korzystając z usług onworks.net