fdpowermon - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

fdpowermon - thêm biểu tượng mức pin vào khay hệ thống tương thích với Freedesktop.org

SYNOPSIS

fdpowermon

MÔ TẢ

Chương trình này cho phép người dùng hiển thị biểu tượng "mức pin" trong bất kỳ chương trình nào tuân thủ Libeesktop.org
khu vực trạng thái. Nó có thể được theo chủ đề thông qua một tệp cấu hình văn bản thuần túy
(/etc/fdpowermon/theme.cfg or $ XDG_CONFIG_DIR / fdpowermon / theme.cfg), hoặc qua một đoạn ngắn
tập lệnh perl (/etc/fdpowermon/theme.pl or $ XDG_CONFIG_DIR / fdpowermon / theme.pl). Nếu
$ XDG_CONFIG_DIR chưa được đặt, $ HOME / .config được sử dụng làm mặc định.

Cách trước dễ dàng hơn, vì nó không yêu cầu bất kỳ tập lệnh nào; và thực sự là mặc định
cấu hình là một ví dụ về chủ đề văn bản thuần túy như vậy. Tuy nhiên, sau này cho phép
linh hoạt hơn, vì người ta có thể xác định các lệnh gọi lại sẽ được chạy khi mức pin
đạt đến một ngưỡng nhất định.

Chủ đề, cho dù chủ đề perl hay chủ đề văn bản thuần túy, được xây dựng thông qua 'các bước', đó là
được xác định trong một dòng duy nhất. Trong tệp cấu hình văn bản thuần túy, một dòng như sau:

xả = 2: thiếu.png: thấp.png, 10: thấp.png, 100: đầy.png

Điều này xác định ba bước. Bước cao nhất hiển thị "full.png" loading = "lazy" khi mức pin là
từ 11% đến 100% (bao gồm); bước thứ hai hiển thị "low.png" loading = "lazy" khi mức pin
là từ 3% đến 10% (bao gồm); và bước thứ ba sẽ xen kẽ giữa "thiếu.png"
và "low.png" loading = "lazy" trong khoảng thời gian ba giây, khi pin từ 0% đến 2%.

Vì dòng bắt đầu bằng "xả", các bước này được sử dụng khi hệ thống đang chạy
trên nguồn pin. Một dòng các bước tương tự có thể được xác định khi pin
sạc:

đang sạc = 0: sạc cạn.png, 10: sạc thấp.png, 100: sạc đầy.png

điều này sẽ hiển thị "blank-charge.png" loading = "lazy" khi pin ở mức 0% (chính xác),
"low-Charge.png" loading = "lazy" từ 1% đến 10% (bao gồm cả) và "full-charge.png" loading = "lazy" ở 11% và
ở trên.

Lưu ý rằng thứ tự là rất quan trọng: các bước nên được xác định từ thấp đến cao.

Để hoàn thành cấu hình chủ đề, chúng ta phải thêm một số mục nữa:

[giao diện của tôi]
bước = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
đang sạc = 0: sạc cạn.png, 10: sạc thấp.png, 100: sạc đầy.png
xả = 2: thiếu.png: thấp.png, 10: thấp.png, 100: đầy.png

Điều này xác định một chủ đề được gọi là "mytheme" có ba bước và sẽ tìm kiếm các hình ảnh trong
thư mục "/home/wouter/.fdpowermon/mytheme-icons". Không thể xác định một
chủ đề có một số bước cho giai đoạn tính phí khác với
giai đoạn phóng điện; nếu bạn muốn điều đó, chỉ cần xác định (một) (các) bước bổ sung cho giai đoạn mà bạn
muốn có ít bước hơn, có biểu tượng giống như bước trên hoặc dưới.

Lưu ý rằng việc đặt hàng ở đây cũng rất quan trọng; dòng "bước" sẽ xuất hiện trước bất kỳ
dòng "sạc" hoặc "xả" (trường hợp này không xảy ra trong fdpowermon 1.7 trở xuống).

Nếu nhiều chủ đề được định cấu hình, theo mặc định, fdpowermon sẽ sử dụng chủ đề cuối cùng
được xác định trong cấu hình cho mỗi người dùng hoặc (nếu không có tệp cấu hình cho mỗi người dùng tồn tại)
chủ đề cuối cùng được xác định trong cấu hình toàn hệ thống.

Các tệp cấu hình chủ đề Perl có thể sử dụng fdpowermon :: theme :: make_default để thay đổi mặc định
chủ đề.

Ngọc trai API

@cảnh báo
Mảng @fdpowermon :: theme :: warning có thể được sử dụng để chỉ định fdpowermon ở cấp độ nào
nên đưa ra một cảnh báo tiêu chuẩn. Giá trị mặc định là (10, 5, 1), có nghĩa là đưa ra cảnh báo
ở mức 10%, 5% và 1%. Lưu ý rằng nếu pin cạn kiệt với tốc độ đặc biệt nhanh
tốc độ, mức độ có thể đã giảm hơn nữa so với trước khi cảnh báo được đưa ra;
Ngoài ra, fdpowermon sẽ đưa ra cảnh báo ngay lập tức khi rút nguồn khỏi máy
và sức mạnh dưới mức đầu tiên.

Để làm cho fdpowermon luôn đưa ra cảnh báo khi nguồn điện bị ngắt, hãy đặt điều này thành một cái gì đó
như (100, 10, 5, 1). Để đặt cảnh báo fdpowermon đưa ra ở mức 20%, 10% và 5%, hãy đặt giá trị này thành
(20, 10, 5).

Lưu ý rằng không thể thay đổi văn bản của cảnh báo. Nếu bạn muốn điều đó, hãy xem
fdpowermon :: theme :: cảnh báo phụ và sử dụng một sự kiện.

$ use_notify
Biến $ fdpowermon :: theme :: use_notify có thể được sử dụng để quyết định xem có sử dụng
thông báo libnotify (nếu được đặt thành giá trị khác) hoặc cửa sổ hộp thoại (nếu được đặt thành giá trị
đánh giá bằng XNUMX).

Mặc định là sử dụng libnotify nếu dữ liệu nội quan libnotify Glib được cài đặt, hoặc
một hộp thoại nếu không. Bởi vì hộp thoại có thể đánh cắp tiêu điểm và do đó tàn phá
với công việc của người dùng, việc sử dụng libnotify được tác giả đặc biệt khuyến khích.

Lưu ý rằng nếu bạn đặt biến thành khác không một cách rõ ràng, thì việc kiểm tra xem có hay không
Dữ liệu nội quan Glib được cài đặt sẽ bị bỏ qua. Hãy chắc chắn rằng nó có sẵn trong đó
trường hợp!

mới
Tạo một chủ đề fdpowermon mới. Trả về một tham chiếu may mắn; ví dụ,

$ theme = new fdpowermon :: theme của tôi;

$ theme-> set_stepcount ($ count)
Đặt số bước trong chủ đề. Lưu ý rằng chủ đề fdpowermon phải có
số bước theo cả chiều "sạc" và "xả".

Nên được gọi trước khi gọi set_charging, set_discharging hoặc parse_step.

$ theme-> set_dir ($ dir)
Đặt thư mục cơ sở được sử dụng cho tên tệp biểu tượng.

$ theme-> set_charging (\ @ phần tử)
Đặt các biểu tượng sẽ hiển thị khi pin đang sạc. Đối số phải là
được tạo bằng phương thức parse_step.

$ theme-> set_discharging (\ @ phần tử)
Đặt các biểu tượng sẽ hiển thị khi pin đang hết. Đối số phải là
được tạo bằng phương thức parse_step.

$ theme-> parse_step ($ defs)
Phân tích cú pháp chuỗi đã cho thành một thứ gì đó có thể được chuyển cho set_charging hoặc
set_discharging. Các định nghĩa phải ở định dạng các bước, được mô tả ở trên, không có
hàng đầu "sạc =" hoặc "xả =".

Trong khi phương thức này trả về một arrayref có thể được kiểm tra và (có thể) được sửa đổi,
các chủ đề muốn tương thích với nhau nên coi nó như một cấu trúc dữ liệu không rõ ràng.

$ theme-> set_event ($ bước, \&gọi lại, 'NS')
Cập nhật chủ đề để 'lệnh gọi lại' phụ được thực thi khi chúng tôi đang xả và chúng tôi đạt được
$ bước lần đầu tiên. Thay vào đó, để đặt sự kiện khi tính phí, hãy chuyển chữ 'c' làm chữ cái thứ ba
tranh luận.

Lưu ý rằng các bước là mảng và do đó dựa trên 0; các mục được đánh số thấp nhất là
các bước cấp thấp nhất.

Khi sự kiện kích hoạt, quy trình gọi lại sẽ được chuyển hai đối số: đối số đầu tiên là
mức pin hiện tại (tính bằng phần trăm); thứ hai là một số biểu thị liệu
pin hiện đang sạc (1) hoặc đang xả (0). Trong trường hợp phân tích cú pháp của ACPI
lệnh không thành công, tuy nhiên, đối số thứ hai có thể là undef; bạn nên chuẩn bị cho điều này
khả năng. Lưu ý rằng bản thân fdpowermon xử lý trường hợp đó bằng cách giả sử pin là
tính phí; bạn có thể muốn hoặc không muốn làm như vậy.

$ theme-> đăng ký ($ name)
Đăng ký một chủ đề dưới một tên nhất định. Nếu một chủ đề đã tồn tại dưới tên đó, nó sẽ
đã thay thế.

make_default ($ name)
Đặt một chủ đề có tên đã cho làm chủ đề mặc định.

get_theme ($ name)
Tìm kiếm một chủ đề với tên đã cho; ví dụ,

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

cảnh báo ($ message)
Đưa ra cảnh báo, sử dụng libnotify hoặc sử dụng hộp thoại:

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

Xem tài liệu về $ fdpowermon :: theme :: use_notify ở trên để biết chi tiết về
thực hiện được chọn.

VÍ DỤ

Để có ví dụ đầy đủ về chủ đề .cfg, hãy xem ở trên.

Để xây dựng cùng một chủ đề hoàn toàn từ perl, bạn sẽ làm như sau:

$ theme = new fdpowermon :: theme của tôi;
$ theme->set_stepcount(3);
$ theme-> set_dir ("/ home / wouter / .fdpowermon / mytheme-icon");
$ theme-> set_charging ($ theme-> parse_step ("0: blank-charge.png, 10: low-charge.png, 100: full-charge.png"));
$ theme-> set_discharging ($ theme-> parse_step ("2: thiếu.png: low.png, 10: low.png, 100: full.png"));

(lưu ý, là một chủ đề perl, điều này sẽ đi trong theme.pl, không phải theme.cfg; có thể xem ở trên
vị trí cho các chủ đề perl)

Tuy nhiên, trừ khi bạn muốn xây dựng chủ đề động, nếu không, làm theo cách này không
khuyến khích. Thay vào đó, bạn sẽ xây dựng chủ đề từ tệp .cfg và có thể sửa đổi nó
từ perl. Giả sử bạn muốn thêm một sự kiện để tạm ngừng hệ thống khi có điện
Thấp; trong trường hợp đó, bạn sẽ làm điều gì đó như sau:

đình chỉ phụ {
system ("sudo pm-pause");
}

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

Điều này sẽ gọi là phụ 'tạm ngưng' khi pin đang xả và chúng tôi đạt mức thấp nhất
(trong ví dụ trên, đó là khi pin đạt 10%; bạn có thể muốn
làm điều đó sau đó). Phụ 'tạm ngưng' này chỉ đơn giản gọi là chương trình "chiều-tạm ngưng", với
sudo, để tạm ngưng hệ thống.

Sử dụng fdpowermon trực tuyến bằng các dịch vụ onworks.net