fdpowermon - Online sa Cloud

PROGRAMA:

NAME

fdpowermon - magdagdag ng icon ng antas ng baterya sa isang system tray na sumusunod sa freedesktop.org

SINOPSIS

fdpowermon

DESCRIPTION

Ang program na ito ay nagpapahintulot sa isa na magpakita ng icon na "antas ng baterya" sa anumang freedesktop.org-compliant
lugar ng katayuan. Maaari itong maging tema sa pamamagitan ng alinman sa isang plain-text na configuration file
(/etc/fdpowermon/theme.cfg or $XDG_CONFIG_DIR/fdpowermon/theme.cfg), o sa pamamagitan ng maikling
perl script (/etc/fdpowermon/theme.pl or $XDG_CONFIG_DIR/fdpowermon/theme.pl). Kung
Hindi nakatakda ang $XDG_CONFIG_DIR, ginagamit ang $HOME/.config bilang default.

Ang una ay mas madali, dahil hindi ito nangangailangan ng anumang script; at talagang ang default
ang pagsasaayos ay isang halimbawa ng gayong simpleng tema ng teksto. Gayunpaman, pinapayagan ng huli
higit na kakayahang umangkop, dahil maaaring tukuyin ng isa ang mga callback na dapat patakbuhin kapag ang antas ng baterya
umabot sa isang tiyak na threshold.

Ang mga tema, maging perl na tema o plain-text na tema, ay binuo sa pamamagitan ng 'mga hakbang', na
tinukoy sa isang linya. Sa isang plain-text na config file, ganito ang hitsura ng isang linya:

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

Tinutukoy nito ang tatlong hakbang. Ang pinakamataas na hakbang ay nagpapakita ng "full.png" loading="lazy" kapag ang antas ng baterya ay
sa pagitan ng 11% at 100% (kasama); ang pangalawang hakbang ay nagpapakita ng "low.png" loading="lazy" kapag ang antas ng baterya
ay nasa pagitan ng 3% at 10% (kasama); at ang ikatlong hakbang ay magpapalit sa pagitan ng "missing.png"
at "low.png" loading="lazy" sa tatlong segundong pagitan, kapag ang baterya ay nasa pagitan ng 0% at 2%.

Dahil nagsisimula ang linya sa "discharging", ginagamit ang mga hakbang na ito kapag tumatakbo ang system
sa lakas ng baterya. Ang isang katulad na linya ng mga hakbang ay maaaring tukuyin kung kailan ang baterya ay
singilin:

singilin = 0:empty-charging.png, 10:low-charging.png, 100: full-charging.png

ipapakita nito ang "empty-charging.png" loading="lazy" kapag ang baterya ay nasa 0% (eksaktong),
"low-charging.png" loading="lazy" sa pagitan ng 1% at 10% (inclusive), at "full-charging.png" loading="lazy" sa 11% at
sa itaas.

Tandaan na mahalaga ang pag-order: dapat tukuyin ang mga hakbang mula mababa hanggang mataas.

Upang makumpleto ang pagsasaayos ng tema, dapat kaming magdagdag ng ilan pang mga item:

[mytheme]
hakbang = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
singilin = 0:empty-charging.png, 10:low-charging.png, 100: full-charging.png
discharge = 2:missing.png:low.png, 10:low.png, 100:full.png

Tinutukoy nito ang isang tema na tinatawag na "mytheme" na may tatlong hakbang, at maghahanap ng mga larawan
ang direktoryo na "/home/wouter/.fdpowermon/mytheme-icons". Hindi posibleng tukuyin ang a
tema na may ibang bilang ng mga hakbang para sa yugto ng pag-charge kaysa sa para sa
yugto ng paglabas; kung gusto mo iyon, tukuyin lamang ang (isang) karagdagang (mga) hakbang para sa yugto na ikaw
Gustong magkaroon ng mas kaunting mga hakbang, na may parehong icon ng hakbang sa itaas o ibaba.

Tandaan na ang pag-order ay makabuluhan din dito; ang linya ng "mga hakbang" ay dapat lumitaw bago ang anuman
"nagcha-charge" o "nagpapalabas" na mga linya (hindi ito ang kaso sa fdpowermon 1.7 o mas mababa).

Kung higit sa isang tema ang na-configure, ang fdpowermon, bilang default, ay gagamitin ang huling tema
tinukoy sa configuration ng bawat user, o (kung walang file ng configuration ng bawat user) ang
huling tema na tinukoy sa configuration ng buong system.

Ang Perl theme config file ay maaaring gumamit ng fdpowermon::theme::make_default upang baguhin ang default
tema.

perlas API

@mga babala
Maaaring gamitin ang array ng @fdpowermon::theme::warnings para tukuyin kung aling mga antas ang fdpowermon
dapat maglabas ng karaniwang babala. Ang default ay (10, 5, 1), na nangangahulugang magbigay ng babala
sa antas na 10%, 5%, at 1%. Tandaan na kung ang baterya ay tumatakbo nang flat sa isang partikular na mabilis
bilis, ang antas ay maaaring nabawasan nang higit pa kaysa doon bago ang babala;
gayundin, maglalabas kaagad ng babala ang fdpowermon kapag tinanggal ang kuryente sa makina
at ang kapangyarihan ay nasa ibaba ng unang antas.

Para laging mag-isyu ng babala ang fdpowermon kapag tinanggal ang power, itakda ito sa isang bagay
tulad ng (100, 10, 5, 1). Upang gawing 20%, 10%, at 5% ang mga babala sa isyu ng fdpowermon, itakda ito sa
(20, 10, 5).

Tandaan na hindi posibleng baguhin ang teksto ng babala. Kung gusto mo iyon, tingnan ang
fdpowermon::theme::warning sub, at gumamit ng event.

$use_notify
Ang variable na $fdpowermon::theme::use_notify ay maaaring gamitin upang magpasya kung gagamit ng a
libnotify na mensahe (kung nakatakda sa isang hindi zero na halaga), o isang dialog window (kung nakatakda sa isang halaga na
sinusuri sa zero).

Ang default ay ang paggamit ng libnotify kung ang libnotify Glib introspection data ay naka-install, o
isang dialog box kung hindi. Dahil ang mga dialog box ay maaaring nakawin ang focus at samakatuwid ay magdulot ng kalituhan
sa gawa ng user, ang paggamit ng libnotify ay mahigpit na inirerekomenda ng may-akda.

Tandaan na kung tahasan mong itinakda ang variable sa nonzero, pagkatapos ay ang pagsubok kung ang
Hindi papansinin ang naka-install na data ng introspection ng Glib. Tiyaking available ito doon
kaso!

bago
Gumawa ng bagong tema ng fdpowermon. Nagbabalik ng pinagpalang sanggunian; hal,

my $theme = bagong fdpowermon::theme;

$theme->set_stepcount($count)
Itakda ang bilang ng mga hakbang sa tema. Tandaan na ang isang tema ng fdpowermon ay dapat na may katumbas
bilang ng mga hakbang sa parehong direksyon ng "pagsingil" at "pagdiskarga."

Dapat tawagan bago tumawag sa set_charging, set_discharging, o parse_step.

$theme->set_dir($dir)
Itakda ang base na direktoryo na ginagamit para sa mga pangalan ng icon ng file.

$theme->set_charging(\@elements)
Itakda ang mga icon na dapat ipakita kapag nagcha-charge ang baterya. Ang argument ay dapat
nilikha sa pamamagitan ng paraan ng parse_step na paraan.

$theme->set_discharging(\@elements)
Itakda ang mga icon na dapat ipakita kapag nagdi-discharge ang baterya. Ang argument ay dapat
nilikha sa pamamagitan ng paraan ng parse_step na paraan.

$theme->parse_step($defs)
Pina-parse ang ibinigay na string sa isang bagay na maaaring ipasa sa set_charging o
set_discharging. Ang mga kahulugan ay dapat nasa format ng mga hakbang, na inilarawan sa itaas, nang wala
ang nangungunang " charging =" o " discharging = ".

Habang ang pamamaraang ito ay nagbabalik ng arrayref na maaaring suriin at (marahil) mabago,
ang mga tema na gustong maging forward-compatible ay dapat itong ituring bilang isang opaque na istraktura ng data.

$theme->set_event($step, \&callback, 'd')
I-update ang tema upang maisagawa ang sub na 'callback' kapag nagdi-discharge kami at naabot namin
$hakbang sa unang pagkakataon. Para magtakda ng event kapag nagcha-charge sa halip, ipasa ang 'c' bilang pangatlo
argumento.

Tandaan na ang mga hakbang ay mga array, at samakatuwid ay 0-based; ang mga bagay na may pinakamababang bilang ay
ang pinakamababang antas na mga hakbang.

Kapag nag-trigger ang kaganapan, ang callback routine ay ipapasa sa dalawang argumento: ang una ay
ang kasalukuyang antas ng baterya (sa porsyento); ang pangalawa ay isang numero na nagsasaad kung ang
ang baterya ay kasalukuyang nagcha-charge (1) o nagdi-discharge (0). Kung sakaling ang pag-parse ng ACPI
nabigo ang command, gayunpaman, ang pangalawang argumento ay maaaring undef; dapat paghandaan mo ito
posibilidad. Tandaan na ang fdpowermon mismo ang humahawak sa kasong iyon sa pamamagitan ng pag-aakalang ang baterya ay
singilin; maaari mo o hindi nais na gawin ang parehong.

$theme->register($name)
Nagrerehistro ng isang tema sa ilalim ng isang ibinigay na pangalan. Kung mayroon nang tema sa ilalim ng pangalang iyon, ito ay
pinalitan

make_default($name)
Ginagawang default na tema ang isang tema na may ibinigay na pangalan.

get_theme($name)
Hinahanap ang isang tema na may ibinigay na pangalan; hal,

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

babala($mensahe)
Gumawa ng babala, alinman gamit ang libnotify, o gamit ang isang dialog box:

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

Tingnan ang dokumentasyon sa $fdpowermon::theme::use_notify sa itaas para sa mga detalye kung saan
ang pagpapatupad ay pinili.

HALIMBAWA

Para sa isang buong halimbawa ng tema ng .cfg, tumingin sa itaas.

Upang ganap na makabuo ng parehong tema mula sa perl, gagawa ka ng ganito:

my $theme = bagong fdpowermon::theme;
$tema->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"));

(tandaan, bilang isang perl na tema, ito ay mapupunta sa theme.pl, hindi theme.cfg; tingnan sa itaas para sa posibleng
mga lokasyon para sa mga tema ng perl)

Gayunpaman, maliban kung gusto mong buuin ang tema nang pabago-bago, ang paggawa nito sa paraang ito ay hindi
inirerekomenda. Sa halip, bubuo ka ng tema mula sa isang .cfg file, at posibleng baguhin ito
mula sa perl. Sabihin nating gusto mong magdagdag ng kaganapan para suspindihin ang system kapag nagkaroon ng kuryente
mababa; sa kasong iyon, gagawa ka ng ganito:

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

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

Tatawagin nito ang 'suspinde' na sub kapag nagdi-discharge ang baterya at naabot namin ang pinakamababa
hakbang (sa halimbawa sa itaas, iyon ay kapag ang baterya ay umabot sa 10%; maaaring gusto mo
gawin iyon sa ibang pagkakataon). Ang 'suspend' sub na ito ay tinatawag na "pm-suspend" program, na may
sudo, para suspindihin ang system.

Gamitin ang fdpowermon online gamit ang mga serbisyo ng onworks.net