fdpowermon - Online di Cloud

PROGRAM:

NAMA

fdpowermon - tambahkan ikon level baterai ke baki sistem yang sesuai dengan freedesktop.org

RINGKASAN

fdpowermon.dll

DESKRIPSI

Program ini memungkinkan seseorang untuk menampilkan ikon "tingkat baterai" di semua yang sesuai dengan freedesktop.org
daerah status. Itu dapat bertema melalui file konfigurasi teks biasa
(/etc/fdpowermon/theme.cfg or $XDG_CONFIG_DIR/fdpowermon/tema.cfg), atau melalui short
skrip perl (/etc/fdpowermon/theme.pl or $XDG_CONFIG_DIR/fdpowermon/tema.pl). Jika
$XDG_CONFIG_DIR tidak disetel, $HOME/.config digunakan sebagai default.

Yang pertama lebih mudah, karena tidak memerlukan skrip apa pun; dan memang default
konfigurasi adalah contoh dari tema teks biasa. Namun, yang terakhir memungkinkan untuk
lebih banyak fleksibilitas, karena seseorang dapat menentukan panggilan balik yang harus dijalankan ketika tingkat baterai
mencapai ambang batas tertentu.

Tema, apakah tema perl atau tema teks biasa, dibangun melalui 'langkah-langkah', yaitu
didefinisikan dalam satu baris. Dalam file konfigurasi teks biasa, baris seperti ini terlihat seperti ini:

pengosongan = 2:hilang.png:rendah.png, 10:rendah.png, 100:penuh.png

Ini mendefinisikan tiga langkah. Langkah tertinggi menunjukkan "full.png" loading="malas" ketika level baterai
antara 11% dan 100% (termasuk); langkah kedua menunjukkan pemuatan "rendah.png" = "malas" ketika level baterai
adalah antara 3% dan 10% (termasuk); dan langkah ketiga akan bergantian antara "missing.png"
dan "low.png" loading="lazy" pada interval tiga detik, saat baterai berada di antara 0% dan 2%.

Karena baris dimulai dengan "pengosongan", langkah-langkah ini digunakan saat sistem sedang berjalan
pada daya baterai. Garis langkah serupa dapat ditentukan ketika baterai
pengisian:

pengisian = 0:pengisian kosong.png, 10:pengisian rendah.png, 100: pengisian penuh.png

ini akan menampilkan "pengisian kosong.png" loading="malas" saat baterai berada pada 0% (tepatnya),
"low-charging.png" loading="malas" antara 1% dan 10% (inklusif), dan "full-charging.png" loading="malas" pada 11% dan
atas.

Perhatikan bahwa pemesanan itu penting: langkah-langkah harus ditentukan dari rendah ke tinggi.

Untuk menyelesaikan konfigurasi tema, kita harus menambahkan beberapa item lagi:

[tema]
langkah = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
pengisian = 0:pengisian kosong.png, 10:pengisian rendah.png, 100: pengisian penuh.png
pengosongan = 2:hilang.png:rendah.png, 10:rendah.png, 100:penuh.png

Ini mendefinisikan tema yang disebut "mytheme" yang memiliki tiga langkah, dan akan mencari gambar di
direktori "/home/wouter/.fdpowermon/mytheme-icons". Tidak mungkin untuk mendefinisikan
tema yang memiliki jumlah langkah berbeda untuk fase pengisian daripada untuk
fase pemakaian; jika Anda menginginkannya, cukup tentukan (satu) langkah tambahan untuk fase yang Anda inginkan
ingin memiliki lebih sedikit langkah, yang memiliki ikon yang sama dengan langkah di atas atau di bawah.

Perhatikan bahwa pemesanan juga penting di sini; garis "langkah" akan muncul sebelum apa pun
garis "pengisian" atau "pengosongan" (ini tidak terjadi di fdpowermon 1.7 atau lebih rendah).

Jika lebih dari satu tema dikonfigurasi, fdpowermon akan, secara default, menggunakan tema terakhir
didefinisikan dalam konfigurasi per pengguna, atau (jika tidak ada file konfigurasi per pengguna)
tema terakhir yang ditentukan dalam konfigurasi seluruh sistem.

File konfigurasi tema Perl dapat menggunakan fdpowermon::theme::make_default untuk mengubah default
Tema.

PERL API

@peringatan
Array @fdpowermon::theme::warnings dapat digunakan untuk menentukan di level mana fdpowermon
harus mengeluarkan peringatan standar. Standarnya adalah (10, 5, 1), yang berarti mengeluarkan peringatan
pada tingkat 10%, 5%, dan 1%. Perhatikan bahwa jika baterai habis dengan sangat cepat
kecepatan, level mungkin telah berkurang lebih jauh dari itu sebelum peringatan dikeluarkan;
juga, fdpowermon akan segera mengeluarkan peringatan ketika daya dimatikan dari mesin
dan kekuatannya di bawah level pertama.

Untuk membuat fdpowermon selalu mengeluarkan peringatan saat daya dimatikan, setel ini ke sesuatu
seperti (100, 10, 5, 1). Untuk membuat peringatan masalah fdpowermon pada 20%, 10%, dan 5%, setel ini ke
(20, 10, 5).

Perhatikan bahwa tidak mungkin mengubah teks peringatan. Jika Anda menginginkannya, lihat
fdpowermon::theme::warning sub, dan gunakan event.

$use_notify
Variabel $fdpowermon::theme::use_notify dapat digunakan untuk memutuskan apakah akan menggunakan a
libnotify pesan (jika disetel ke nilai bukan nol), atau jendela dialog (jika disetel ke nilai yang
mengevaluasi ke nol).

Defaultnya adalah menggunakan libnotify jika data introspeksi libnotify Glib diinstal, atau
kotak dialog jika tidak. Karena kotak dialog dapat mencuri fokus dan karena itu mendatangkan malapetaka
dengan karya pengguna, menggunakan libnotify sangat disarankan oleh penulis.

Perhatikan bahwa jika Anda menyetel variabel ke bukan nol secara eksplisit, maka uji apakah variabel
Data introspeksi Glib yang terpasang akan diabaikan. Pastikan itu tersedia di dalamnya
kasus!

yang baru
Buat tema fdpowermon baru. Mengembalikan referensi yang diberkati; misalnya,

$tema saya = fdpowermon baru::tema;

$theme->set_stepcount($count)
Atur jumlah langkah dalam tema. Perhatikan bahwa tema fdpowermon harus memiliki persamaan
jumlah langkah dalam arah "pengisian" dan "pengosongan".

Harus dipanggil sebelum memanggil set_charging, set_discharging, atau parse_step.

$tema->set_dir($dir)
Atur direktori dasar yang digunakan untuk nama file ikon.

$theme->set_charging(\@elements)
Atur ikon yang akan ditampilkan saat baterai sedang diisi. Argumennya harus
dibuat dengan metode parse_step.

$theme->set_discharging(\@elements)
Atur ikon yang harus ditampilkan saat baterai habis. Argumennya harus
dibuat dengan metode parse_step.

$theme->parse_step($defs)
Parsing string yang diberikan menjadi sesuatu yang dapat diteruskan ke set_charging atau
set_pengosongan. Definisi harus dalam format langkah, dijelaskan di atas, tanpa
terkemuka " pengisian = " atau " pemakaian = ".

Sementara metode ini mengembalikan arrayref yang dapat diperiksa dan (mungkin) dimodifikasi,
tema yang ingin kompatibel ke depan harus memperlakukannya sebagai struktur data buram.

$tema->set_event($langkah, \&panggil balik, 'D')
Perbarui tema sehingga sub 'panggilan balik' dijalankan saat kami mengeluarkan dan kami mencapai
$langkah untuk pertama kalinya. Untuk mengatur acara saat mengisi daya, berikan 'c' sebagai yang ketiga
argumen.

Perhatikan bahwa langkah-langkahnya adalah array, dan karena itu berbasis 0; item bernomor terendah adalah
langkah-langkah tingkat terendah.

Saat peristiwa dipicu, rutinitas panggilan balik akan melewati dua argumen: yang pertama adalah
tingkat baterai saat ini (dalam persen); yang kedua adalah angka yang menunjukkan apakah
baterai sedang diisi (1) atau habis (0). Dalam hal penguraian ACPI
perintah gagal, namun, argumen kedua mungkin undef; kamu harus bersiap untuk ini
kemungkinan. Perhatikan bahwa fdpowermon sendiri menangani kasus itu dengan mengasumsikan baterainya
pengisian; Anda mungkin atau mungkin tidak ingin melakukan hal yang sama.

$tema->daftar($nama)
Mendaftarkan tema dengan nama yang diberikan. Jika sebuah tema sudah ada dengan nama itu, itu adalah
diganti.

make_default($nama)
Membuat tema dengan nama yang diberikan menjadi tema default.

get_theme($nama)
Mencari tema dengan nama yang diberikan; misalnya,

$tema saya = fdpowermon::tema::get_tema("default");

peringatan($pesan)
Menghasilkan peringatan, baik menggunakan libnotify, atau menggunakan kotak dialog:

fdpowermon::tema::peringatan($pesan);

Lihat dokumentasi di $fdpowermon::theme::use_notify di atas untuk detailnya
implementasi dipilih.

CONTOH

Untuk contoh tema .cfg lengkap, lihat di atas.

Untuk membangun tema yang sama sepenuhnya dari Perl, Anda akan melakukan sesuatu seperti ini:

$tema saya = fdpowermon baru::tema;
$tema->set_jumlah langkah(3);
$theme->set_dir("/home/wouter/.fdpowermon/mytheme-icons");
$theme->set_charging($theme->parse_step("0:pengisian kosong.png, 10:pengisian rendah.png, 100: pengisian daya penuh.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 theme.pl, bukan theme.cfg; lihat di atas untuk kemungkinan
lokasi untuk tema perl)

Namun, kecuali jika Anda ingin membangun tema secara dinamis, melakukannya dengan cara ini tidak
direkomendasikan. Sebagai gantinya, Anda akan membuat tema dari file .cfg, dan mungkin memodifikasinya
dari perl. Katakanlah Anda ingin menambahkan acara untuk menangguhkan sistem saat listrik menyala
rendah; dalam hal ini, Anda akan melakukan sesuatu seperti ini:

sub menangguhkan {
system("Sudo pm-suspend");
}

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

Ini akan memanggil sub 'tangguhkan' saat baterai habis dan kami mencapai yang terendah
langkah (dalam contoh di atas, itu adalah ketika baterai mencapai 10%; Anda mungkin ingin
lakukan itu nanti). Sub 'suspend' ini hanya memanggil program "pm-suspend", dengan
sudo, untuk menangguhkan sistem.

Gunakan fdpowermon online menggunakan layanan onworks.net