fdpowermon - Интернет в облаке

ПРОГРАММА:

ИМЯ

fdpowermon - добавить значок уровня заряда батареи в системный лоток, совместимый с freedesktop.org

СИНТАКСИС

fdpowermon

ОПИСАНИЕ

Эта программа позволяет отображать значок «уровень заряда батареи» в любом совместимом с freedesktop.org
область состояния. Его можно тематически оформить с помощью простого текстового файла конфигурации.
(/etc/fdpowermon/theme.cfg or $ XDG_CONFIG_DIR / fdpowermon / theme.cfg), или через короткое
Perl-скрипт (/etc/fdpowermon/theme.pl or $ XDG_CONFIG_DIR / fdpowermon / theme.pl). если
$ XDG_CONFIG_DIR не установлен, по умолчанию используется $ HOME / .config.

Первый вариант проще, так как не требует написания скриптов; и действительно по умолчанию
Конфигурация является примером такой простой текстовой темы. Однако последнее позволяет
больше гибкости, так как можно определить обратные вызовы, которые должны выполняться, когда уровень заряда батареи
достигает определенного порога.

Темы, будь то темы Perl или темы с обычным текстом, создаются с помощью «шагов», которые
определяется одной строкой. В текстовом файле конфигурации такая строка выглядит так:

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

Это определяет три шага. На самом высоком уровне отображается "full.png" loading = "lazy", когда уровень заряда батареи
от 11% до 100% (включительно); второй шаг показывает "low.png" loading = "lazy", когда уровень заряда батареи
составляет от 3% до 10% (включительно); и третий шаг будет чередоваться между "missing.png"
и "low.png" loading = "lazy" с трехсекундными интервалами, когда заряд батареи составляет от 0% до 2%.

Поскольку линия начинается с «разгрузки», эти шаги используются, когда система работает.
от батареи. Подобная последовательность действий может быть определена для случая, когда батарея разряжена.
зарядка:

Charging = 0: empty-charge.png, 10: low-charge.png, 100: full-charge.png

это покажет "empty-charge.png" loading = "lazy", когда батарея разряжена 0% (точно),
"low-charge.png" loading = "lazy" от 1% до 10% (включительно) и "full-charge.png" loading = "lazy" при 11% и
выше.

Обратите внимание, что порядок важен: шаги должны быть определены от меньшего к большему.

Чтобы завершить настройку темы, мы должны добавить еще несколько элементов:

[митема]
шаги = 3
каталог = /home/wouter/.fdpowermon/mytheme-icons
Charging = 0: empty-charge.png, 10: low-charge.png, 100: full-charge.png
discharging = 2: missing.png: low.png, 10: low.png, 100: full.png

Это определяет тему под названием "mytheme", которая состоит из трех шагов и будет искать изображения в
каталог "/home/wouter/.fdpowermon/mytheme-icons". Невозможно определить
тема, которая имеет другое количество шагов для фазы зарядки, чем для
фаза разгрузки; если вы этого хотите, просто определите дополнительный шаг для той фазы, которую вы
хотел бы иметь меньше шагов, у которых такой же значок, как у шага выше или ниже.

Обратите внимание, что здесь тоже важен порядок; строка "шаги" должна появиться перед любым
линии "зарядки" или "разрядки" (этого не было в fdpowermon 1.7 или ниже).

Если настроено более одной темы, fdpowermon по умолчанию будет использовать последнюю тему.
определены в конфигурации для каждого пользователя, или (если файл конфигурации для каждого пользователя не существует)
последняя тема, определенная в общесистемной конфигурации.

Файлы конфигурации темы Perl могут использовать fdpowermon :: theme :: make_default для изменения значения по умолчанию.
темы.

PERL API

@ предупреждения
Массив @fdpowermon :: theme :: warnings можно использовать, чтобы указать, на каких уровнях fdpowermon
должен выдать стандартное предупреждение. По умолчанию (10, 5, 1), что означает выдачу предупреждения.
на уровне 10%, 5% и 1%. Обратите внимание: если батарея разряжается особенно быстро
темп, уровень может снизиться даже больше, чем до того, как было выпущено предупреждение;
Кроме того, fdpowermon немедленно выдаст предупреждение при отключении питания от машины.
и мощность ниже первого уровня.

Чтобы fdpowermon всегда выдавал предупреждение при отключении питания, установите здесь что-нибудь
как (100, 10, 5, 1). Чтобы fdpowermon выдавал предупреждения на 20%, 10% и 5%, установите для этого параметра значение
(20. 10. 5).

Обратите внимание, что изменить текст предупреждения невозможно. Если вы этого хотите, посмотрите
fdpowermon :: theme :: warning sub и используйте событие.

$ use_notify
Переменная $ fdpowermon :: theme :: use_notify может использоваться, чтобы решить, использовать ли
сообщение libnotify (если установлено ненулевое значение) или диалоговое окно (если установлено значение, которое
равен нулю).

По умолчанию используется libnotify, если установлены данные интроспекции libnotify Glib, или
диалоговое окно, если нет. Потому что диалоговые окна могут украсть фокус и, следовательно, нанести ущерб
в работе пользователя автор настоятельно рекомендует использовать libnotify.

Обратите внимание, что если вы явно установите для переменной ненулевое значение, тогда проверяется, действительно ли
Установленные данные интроспекции Glib игнорируются. Убедитесь, что он доступен в этом
дело!

new
Создайте новую тему fdpowermon. Возвращает благословенную ссылку; например,

моя тема $ = новый fdpowermon :: theme;

$ theme-> set_stepcount ($ count)
Установите количество шагов в теме. Обратите внимание, что тема fdpowermon должна иметь одинаковые
количество шагов как в направлении «зарядки», так и в направлении «разряда».

Должен вызываться перед вызовом set_charging, set_discharging или parse_step.

$ тема-> set_dir ($ dir)
Установите базовый каталог, используемый для имен файлов значков.

$ theme-> set_charging (\ @ элементы)
Установите значки, которые должны отображаться при зарядке аккумулятора. Аргумент должен быть
создается методом parse_step.

$ theme-> set_discharging (\ @ элементы)
Установите значки, которые должны отображаться, когда батарея разряжается. Аргумент должен быть
создается методом parse_step.

$ тема-> parse_step ($ defs)
Преобразует данную строку во что-то, что может быть передано в set_charging или
set_discharging. Определения должны быть в формате шагов, описанном выше, без
ведущая «зарядка =» или «разрядка =».

Хотя этот метод возвращает ссылку на массив, которую можно проверить и (возможно) изменить,
темы, которые хотят иметь прямую совместимость, должны рассматривать их как непрозрачную структуру данных.

$ theme-> set_event ($ step, \&Перезвоните, 'd')
Обновите тему, чтобы выполнялся вспомогательный обратный вызов, когда мы разряжаемся, и мы достигаем
$ step впервые. Чтобы вместо этого установить событие при зарядке, передайте 'c' в качестве третьего
аргумент.

Обратите внимание, что шаги представляют собой массивы и поэтому начинаются с 0; элементы с наименьшими номерами
ступени самого нижнего уровня.

Когда событие срабатывает, подпрограмме обратного вызова будет передано два аргумента: первый -
текущий уровень заряда батареи (в процентах); второй - число, обозначающее,
аккумулятор в данный момент заряжается (1) или разряжается (0). В случае, если парсинг ACPI
команда не работает, однако второй аргумент может быть undef; вы должны подготовиться к этому
возможность. Обратите внимание, что сам fdpowermon обрабатывает этот случай, предполагая, что батарея разряжена.
зарядка; вы можете, а можете и не захотеть делать то же самое.

$ тема-> регистрация ($ имя)
Регистрирует тему под заданным именем. Если тема под этим именем уже существует, она
заменены.

make_default ($ имя)
Делает тему с заданным именем темой по умолчанию.

get_theme ($ имя)
Ищет тему с заданным именем; например,

моя тема $ = fdpowermon :: theme :: get_theme ("по умолчанию");

предупреждение ($ message)
Выведите предупреждение, используя libnotify или диалоговое окно:

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

См. Документацию по $ fdpowermon :: theme :: use_notify выше, чтобы узнать, какие
реализация выбрана.

ПРИМЕРЫ

Полный пример темы .cfg см. Выше.

Чтобы полностью сконструировать ту же тему из Perl, вы должны сделать что-то вроде этого:

моя тема $ = новый fdpowermon :: theme;
$ тема->set_stepcount(3);
$ theme-> set_dir ("/ home / wouter / .fdpowermon / mytheme-icons");
$ theme-> set_charging ($ theme-> parse_step ("0: empty-charge.png, 10: low-charge.png, 100: full-charge.png"));
$ theme-> set_discharging ($ theme-> parse_step ("2: missing.png: low.png, 10: low.png, 100: full.png"));

(обратите внимание, что как тема perl, это будет входить в theme.pl, а не theme.cfg; см. выше о возможных
места для тем perl)

Однако, если вы не хотите динамически строить тему, делать это таким образом нельзя.
рекомендуемые. Вместо этого вы должны создать тему из файла .cfg и, возможно, изменить его.
из perl. Предположим, вы хотите добавить событие для приостановки системы при подаче питания.
низкий; в этом случае вы бы сделали что-то вроде этого:

суб приостановить {
система ("sudo pm-suspend");
}

моя тема $ = fdpowermon :: theme :: get_theme ("mytheme");
$ theme-> set_event (0, \ & приостановить, 'd');

Это вызовет «приостановку», когда батарея разряжается и мы достигаем минимального значения.
шаг (в приведенном выше примере это будет, когда батарея достигнет 10%; вы можете захотеть
сделаем это несколько позже). Эта подпрограмма приостановки просто вызывает программу pm-suspend с
sudo, чтобы приостановить систему.

Используйте fdpowermon онлайн с помощью сервисов onworks.net