fdpowermon - Dalam Talian di Awan

JADUAL:

NAMA

fdpowermon - tambah ikon aras bateri pada dulang sistem yang mematuhi freedesktop.org

SINOPSIS

fdpowermon

DESCRIPTION

Program ini membenarkan seseorang untuk memaparkan ikon "paras bateri" dalam mana-mana yang mematuhi freedesktop.org
kawasan status. Ia boleh bertemakan sama ada melalui fail konfigurasi teks biasa
(/etc/fdpowermon/theme.cfg or $XDG_CONFIG_DIR/fdpowermon/theme.cfg), atau melalui pendek
skrip perl (/etc/fdpowermon/theme.pl or $XDG_CONFIG_DIR/fdpowermon/theme.pl). Jika
$XDG_CONFIG_DIR tidak ditetapkan, $HOME/.config digunakan sebagai lalai.

Yang pertama lebih mudah, kerana ia tidak memerlukan sebarang skrip; dan sememangnya lalai
konfigurasi ialah contoh tema teks biasa sedemikian. Walau bagaimanapun, yang terakhir membenarkan
lebih fleksibiliti, kerana seseorang boleh menentukan panggilan balik yang harus dijalankan apabila tahap bateri
mencapai ambang tertentu.

Tema, sama ada tema perl atau tema teks biasa, dibina melalui 'langkah', iaitu
ditakrifkan dalam satu baris. Dalam fail konfigurasi teks biasa, baris sedemikian kelihatan seperti ini:

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

Ini mentakrifkan tiga langkah. Langkah tertinggi menunjukkan "full.png" loading="lazy" apabila tahap bateri adalah
antara 11% dan 100% (termasuk); langkah kedua menunjukkan "low.png" loading="lazy" apabila tahap bateri
adalah antara 3% dan 10% (termasuk); dan langkah ketiga akan berselang-seli antara "missing.png"
dan "low.png" loading="lazy" pada selang tiga saat, apabila bateri berada di antara 0% dan 2%.

Memandangkan talian bermula dengan "menyahcas", langkah ini digunakan apabila sistem sedang berjalan
pada kuasa bateri. Barisan langkah yang serupa boleh ditakrifkan untuk masa bateri
mengecas:

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

ini akan menunjukkan "empty-charging.png" loading="lazy" apabila bateri berada pada 0% (tepat),
"low-charging.png" loading="lazy" antara 1% dan 10% (inklusif) dan "full-charging.png" loading="lazy" pada 11% dan
atas.

Ambil perhatian bahawa pesanan adalah penting: langkah harus ditakrifkan dari rendah ke tinggi.

Untuk melengkapkan konfigurasi tema, kami mesti menambah beberapa item lagi:

[mitos]
langkah = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
mengecas = 0:empty-charging.png, 10:low-charging.png, 100: full-charging.png
menyahcas = 2:missing.png:low.png, 10:low.png, 100:full.png

Ini mentakrifkan tema yang dipanggil "mytheme" yang mempunyai tiga langkah, dan akan mencari imej di dalamnya
direktori "/home/wouter/.fdpowermon/mytheme-icons". Tidak mungkin untuk mentakrifkan a
tema yang mempunyai bilangan langkah yang berbeza untuk fasa pengecasan berbanding untuk fasa pengecasan
fasa pelepasan; jika anda mahu itu, hanya tentukan (satu) langkah tambahan untuk fasa yang anda
ingin mempunyai kurang langkah, yang mempunyai ikon yang sama seperti langkah di atas atau di bawah.

Ambil perhatian bahawa pesanan adalah penting di sini juga; baris "langkah" harus muncul sebelum mana-mana
talian "mengecas" atau "menyahcas" (ini tidak berlaku dalam fdpowermon 1.7 ke bawah).

Jika lebih daripada satu tema dikonfigurasikan, fdpowermon akan, secara lalai, menggunakan tema terakhir
ditakrifkan dalam konfigurasi setiap pengguna, atau (jika tiada fail konfigurasi setiap pengguna wujud) fail
tema terakhir yang ditakrifkan dalam konfigurasi seluruh sistem.

Fail konfigurasi tema Perl boleh menggunakan fdpowermon::theme::make_default untuk menukar lalai
tema.

mutiara API

@amaran
Tatasusunan @fdpowermon::theme::warnings boleh digunakan untuk menentukan tahap mana fdpowermon
harus mengeluarkan amaran standard. Lalai ialah (10, 5, 1), yang bermaksud mengeluarkan amaran
pada tahap 10%, 5%, dan 1%. Ambil perhatian bahawa jika bateri berjalan rata dengan sangat pantas
kadar, tahap mungkin telah berkurangan lebih jauh daripada itu sebelum amaran dikeluarkan;
juga, fdpowermon akan mengeluarkan amaran serta-merta apabila kuasa dikeluarkan dari mesin
dan kuasa berada di bawah tahap pertama.

Untuk menjadikan fdpowermon sentiasa mengeluarkan amaran apabila kuasa dialih keluar, tetapkan ini kepada sesuatu
seperti (100, 10, 5, 1). Untuk membuat amaran isu fdpowermon pada 20%, 10% dan 5%, tetapkan ini kepada
(20, 10, 5).

Ambil perhatian bahawa tidak mungkin untuk menukar teks amaran. Jika anda mahu itu, lihat
fdpowermon::theme::warning sub, dan gunakan acara.

$use_notify
Pembolehubah $fdpowermon::theme::use_notify boleh digunakan untuk memutuskan sama ada untuk menggunakan a
mesej libnotify (jika ditetapkan kepada nilai bukan sifar), atau tetingkap dialog (jika ditetapkan kepada nilai yang
menilai kepada sifar).

Lalai ialah menggunakan libnotify jika data introspeksi libnotify Glib dipasang, atau
kotak dialog jika tidak. Kerana kotak dialog boleh mencuri tumpuan dan oleh itu mendatangkan malapetaka
dengan kerja pengguna, menggunakan libnotify sangat disyorkan oleh pengarang.

Ambil perhatian bahawa jika anda menetapkan pembolehubah kepada bukan sifar secara eksplisit, maka ujian sama ada atau tidak
Data introspeksi Glib yang dipasang akan diabaikan. Pastikan ia tersedia di dalamnya
kes!

baru
Cipta tema fdpowermon baharu. Mengembalikan rujukan yang diberkati; cth.,

$theme saya = fdpowermon baru::tema;

$theme->set_stepcount($count)
Tetapkan bilangan langkah dalam tema. Ambil perhatian bahawa tema fdpowermon mesti mempunyai persamaan
bilangan langkah dalam kedua-dua arah "mengecas" dan "menyahcas".

Hendaklah dipanggil sebelum memanggil set_charging, set_discharging, atau parse_step.

$theme->set_dir($dir)
Tetapkan direktori asas yang digunakan untuk nama fail ikon.

$theme->set_charging(\@elements)
Tetapkan ikon yang sepatutnya ditunjukkan semasa bateri sedang dicas. Hujah sepatutnya
dicipta melalui kaedah parse_step.

$theme->set_discharging(\@elements)
Tetapkan ikon yang sepatutnya ditunjukkan semasa bateri sedang dinyahcas. Hujah sepatutnya
dicipta melalui kaedah parse_step.

$theme->parse_step($defs)
Menghuraikan rentetan yang diberikan kepada sesuatu yang boleh dihantar ke set_charging atau
set_discharging. Takrifan hendaklah dalam format langkah, yang diterangkan di atas, tanpa
yang terkemuka " mengecas = " atau " menunaikan = ".

Walaupun kaedah ini mengembalikan arrayref yang boleh diperiksa dan (mungkin) diubah suai,
tema yang ingin serasi ke hadapan harus menganggapnya sebagai struktur data legap.

$theme->set_event($step, \&panggil balik, 'd')
Kemas kini tema supaya sub 'panggilan balik' dilaksanakan apabila kami menunaikan dan kami sampai
$langkah buat kali pertama. Untuk menetapkan acara semasa mengecas sebaliknya, berikan 'c' sebagai yang ketiga
hujah.

Ambil perhatian bahawa langkah-langkah adalah tatasusunan, dan oleh itu berasaskan 0; item bernombor terendah ialah
langkah peringkat terendah.

Apabila peristiwa dicetuskan, rutin panggil balik akan diluluskan dua hujah: yang pertama ialah
paras bateri semasa (dalam peratus); yang kedua ialah nombor yang menunjukkan sama ada
bateri sedang mengecas (1) atau menyahcas (0). Sekiranya penghuraian ACPI
arahan gagal, bagaimanapun, hujah kedua mungkin undef; anda harus bersedia untuk ini
kemungkinan. Ambil perhatian bahawa fdpowermon sendiri mengendalikan kes itu dengan menganggap bateri adalah
mengecas; anda mungkin mahu atau tidak mahu melakukan perkara yang sama.

$theme->register($name)
Mendaftarkan tema di bawah nama yang diberikan. Jika tema sudah wujud di bawah nama itu, ia adalah
diganti.

make_default($name)
Menjadikan tema dengan nama yang diberikan sebagai tema lalai.

get_theme($name)
Mencari tema dengan nama yang diberikan; cth.,

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

amaran($message)
Hasilkan amaran, sama ada menggunakan libnotify atau menggunakan kotak dialog:

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

Lihat dokumentasi tentang $fdpowermon::theme::use_notify di atas untuk mendapatkan butiran mengenainya
pelaksanaan dipilih.

CONTOH

Untuk contoh tema .cfg penuh, lihat di atas.

Untuk membina tema yang sama sepenuhnya daripada perl, anda akan melakukan sesuatu seperti ini:

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

(perhatikan, sebagai tema perl, ini akan masuk dalam theme.pl, bukan theme.cfg; lihat di atas untuk kemungkinan
lokasi untuk tema perl)

Walau bagaimanapun, melainkan anda mahu membina tema secara dinamik, melakukannya dengan cara ini tidak
disyorkan. Sebaliknya, anda akan membina tema daripada fail .cfg dan mungkin mengubah suainya
daripada perl. Katakan anda ingin menambah acara untuk menggantung sistem apabila kuasa mendapat
rendah; dalam kes itu, anda akan melakukan sesuatu seperti ini:

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

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

Ini akan memanggil sub 'gantung' apabila bateri sedang dinyahcas dan kami mencapai yang paling rendah
langkah (dalam contoh di atas, itu adalah apabila bateri mencapai 10%; anda mungkin mahu
lakukan itu kemudian). Sub 'gantung' ini hanya memanggil program "pm-suspend", dengan
sudo, untuk menggantung sistem.

Gunakan fdpowermon dalam talian menggunakan perkhidmatan onworks.net