fdpowermon - Online na nuvem

PROGRAMA:

NOME

fdpowermon - adiciona um ícone de nível de bateria a uma bandeja do sistema compatível com freedesktop.org

SINOPSE

fdpowermon

DESCRIÇÃO

Este programa permite a exibição de um ícone de "nível de bateria" em qualquer dispositivo compatível com freedesktop.org
área de status. Ele pode ter um tema por meio de um arquivo de configuração de texto simples
(/etc/fdpowermon/theme.cfg or $ XDG_CONFIG_DIR / fdpowermon / theme.cfg), ou por meio de um curto
script perl (/etc/fdpowermon/theme.pl or $ XDG_CONFIG_DIR / fdpowermon / theme.pl). Se
$ XDG_CONFIG_DIR não está definido, $ HOME / .config é usado como padrão.

O primeiro é mais fácil, pois não requer nenhum script; e de fato o padrão
a configuração é um exemplo desse tema de texto simples. No entanto, o último permite
mais flexibilidade, pois é possível definir retornos de chamada que devem ser executados quando o nível da bateria
atinge um certo limite.

Temas, sejam temas perl ou temas de texto simples, são construídos através de 'etapas', que são
definido em uma única linha. Em um arquivo de configuração de texto simples, essa linha tem a seguinte aparência:

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

Isso define três etapas. A etapa mais alta mostra "full.png" carregando = "preguiçoso" quando o nível da bateria é
entre 11% e 100% (inclusive); a segunda etapa mostra "low.png" carregando = "preguiçoso" quando o nível da bateria
está entre 3% e 10% (inclusive); e a terceira etapa alternará entre "missing.png"
e "low.png" carregando = "preguiçoso" em intervalos de três segundos, quando a bateria está entre 0% e 2%.

Uma vez que a linha começa com "descarregando", essas etapas são usadas quando o sistema está funcionando
com energia da bateria. Uma linha semelhante de etapas pode ser definida para quando a bateria está
carregamento:

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

isso mostrará "empty-loading.png" carregando = "preguiçoso" quando a bateria está em 0% (exatamente),
"low-charge.png" loading = "preguiçoso" entre 1% e 10% (inclusive) e "full-loading.png" carregando = "preguiçoso" em 11% e
acima.

Observe que a ordenação é significativa: as etapas devem ser definidas de baixo para cima.

Para completar a configuração do tema, devemos adicionar mais alguns itens:

[meu tema]
passos = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
carregando = 0: empty-charge.png, 10: low-charge.png, 100: full-loading.png
descarregando = 2: missing.png: low.png, 10: low.png, 100: full.png

Isso define um tema chamado "mytheme" que tem três etapas e procurará imagens em
o diretório "/home/wouter/.fdpowermon/mytheme-icons". Não é possível definir um
tema que tem um número diferente de etapas para a fase de carregamento do que para o
fase de descarga; se você quiser isso, basta definir (uma) etapa (s) extra (s) para a fase que você
gostaria de ter menos etapas, que têm o mesmo ícone da etapa acima ou abaixo.

Observe que a ordenação também é importante aqui; a linha "etapas" deve aparecer antes de qualquer
linhas de "carga" ou "descarga" (este não era o caso em fdpowermon 1.7 ou inferior).

Se mais de um tema estiver configurado, o fdpowermon irá, por padrão, usar o último tema
definido na configuração por usuário, ou (se nenhum arquivo de configuração por usuário existir) o
último tema definido na configuração de todo o sistema.

Os arquivos de configuração de tema Perl podem usar fdpowermon :: theme :: make_default para alterar o padrão
tema.

PERL API

@avisos
O array @fdpowermon :: theme :: warnings pode ser usado para especificar em quais níveis fdpowermon
deve emitir um aviso padrão. O padrão é (10, 5, 1), o que significa emitir um aviso
a um nível de 10%, 5% e 1%. Observe que se a bateria descarregar de uma maneira particularmente rápida
ritmo, o nível pode ter reduzido ainda mais do que antes do aviso ser emitido;
Além disso, o fdpowermon emitirá um aviso imediatamente quando a energia for removida da máquina
e o poder está abaixo do primeiro nível.

Para fazer com que o fdpowermon sempre emita um aviso quando a energia é removida, defina isso para algo
como (100, 10, 5, 1). Para tornar fdpowermon emitir avisos em 20%, 10% e 5%, defina isso como
(20, 10, 5)

Observe que não é possível alterar o texto do aviso. Se você quiser isso, veja o
fdpowermon :: theme :: warning sub, e usa um evento.

$ use_notify
A variável $ fdpowermon :: theme :: use_notify pode ser usada para decidir se deve usar um
mensagem libnotify (se definido com um valor diferente de zero), ou uma janela de diálogo (se definido com um valor que
avalia para zero).

O padrão é usar libnotify se os dados de introspecção do libnotify Glib estiverem instalados, ou
uma caixa de diálogo se não. Porque as caixas de diálogo podem roubar o foco e, portanto, causar estragos
com o trabalho do usuário, o uso de libnotify é fortemente recomendado pelo autor.

Observe que se você definir a variável como diferente de zero explicitamente, o teste se o
Os dados de introspecção Glib instalados serão ignorados. Certifique-se de que esteja disponível nesse
casas!

novo
Crie um novo tema fdpowermon. Retorna uma referência abençoada; por exemplo,

meu $ theme = new fdpowermon :: theme;

$ theme-> set_stepcount ($ count)
Defina o número de etapas no tema. Observe que um tema fdpowermon deve ter um igual
número de etapas na direção de "carregamento" e "descarga".

Deve ser chamado antes de chamar set_charging, set_discharging ou parse_step.

$ theme-> set_dir ($ dir)
Defina o diretório base usado para nomes de arquivos de ícone.

$ theme-> set_charging (\ @ elementos)
Defina os ícones que devem ser exibidos quando a bateria está carregando. O argumento deve ser
criado por meio do método parse_step.

$ theme-> set_discharging (\ @ elementos)
Defina os ícones que devem ser mostrados quando a bateria está descarregando. O argumento deve ser
criado por meio do método parse_step.

$ theme-> parse_step ($ defs)
Analisa a string dada em algo que pode ser passado para set_charging ou
set_discharging. As definições devem estar no formato de etapas, descrito acima, sem
o principal "carregando =" ou "descarregando =".

Embora este método retorne um arrayref que pode ser inspecionado e (provavelmente) modificado,
temas que desejam ser compatíveis com versões futuras devem tratá-los como uma estrutura de dados opaca.

$ theme-> set_event ($ step, \&ligar de volta, 'd')
Atualize o tema para que o sub 'callback' seja executado quando estivermos descarregando e alcançarmos
$ step pela primeira vez. Para definir um evento ao carregar, em vez disso, passe um 'c' como o terceiro
argumento.

Observe que as etapas são matrizes e, portanto, são baseadas em 0; os itens de menor número são
as etapas de nível mais baixo.

Quando o evento for disparado, a rotina de retorno de chamada receberá dois argumentos: o primeiro é
o nível atual da bateria (em porcentagem); o segundo é um número que indica se o
a bateria está carregando (1) ou descarregando (0). No caso da análise do ACPI
o comando falha, entretanto, o segundo argumento pode ser undef; você deve se preparar para isso
possibilidade. Observe que o próprio fdpowermon lida com esse caso, assumindo que a bateria está
cobrando; você pode ou não desejar fazer o mesmo.

$ theme-> register ($ name)
Registra um tema com um determinado nome. Se já existe um tema com esse nome, é
substituído.

make_default ($ name)
Torna um tema com um determinado nome o tema padrão.

get_theme ($ name)
Procura um tema com o nome fornecido; por exemplo,

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

aviso ($ mensagem)
Produza um aviso, usando libnotify ou usando uma caixa de diálogo:

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

Veja a documentação em $ fdpowermon :: theme :: use_notify acima para detalhes sobre quais
a implementação é escolhida.

EXEMPLOS

Para obter um exemplo completo do tema .cfg, consulte acima.

Para construir o mesmo tema totalmente a partir do perl, você faria algo assim:

meu $ theme = new fdpowermon :: theme;
$ 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"));

(note, como um tema perl, isso iria em theme.pl, não theme.cfg; veja acima para possíveis
locais para temas perl)

No entanto, a menos que você queira construir o tema dinamicamente, fazê-lo desta forma não é
recomendado. Em vez disso, você construiria o tema a partir de um arquivo .cfg e possivelmente o modificaria
de perl. Digamos que você deseja adicionar um evento para suspender o sistema quando a energia chegar
baixo; nesse caso, você faria algo assim:

sub suspender {
sistema ("sudo pm-suspend");
}

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

Isso chamaria o sub 'suspender' quando a bateria estiver descarregando e atingirmos o nível mais baixo
etapa (no exemplo acima, isso seria quando a bateria atingir 10%; você pode querer
faça isso um pouco mais tarde). Este sub 'suspender' simplesmente chama o programa "pm-suspend", com
sudo, para suspender o sistema.

Use fdpowermon online usando serviços onworks.net