Content-type: text/html Manpage of WMCLOCKMON

WMCLOCKMON

Section: User Commands (1)
Updated: September 07, 2002
Index Return to Main Contents

NOM

wmclockmon - Une application ancrable pour afficher l'heure, la date et les alarmes.

SYNOPSIS

wmclockmon [options]

DESCRIPTION

Cette page de manuel explique brièvement la commande wmclockmon.

WMClockMon est une application qui affiche une horloge numérique. C'est une application ancrable qui est supportée par des gestionnaires de fenêtres X tels que Window Maker, AfterStep, BlackBox, et Enlightenment.

Elle affiche l'heure et la date, au besoin un indicateur AM/PM et un indicateur d'alarme. Elle a une interface utilisateur avec un affichage d'aspect ACL (Affichage à Cristaux Liquides).

En cliquant sur le bouton gauche de la souris sur la fenêtre de l'application, on allume ou on éteint le rétro-éclairage. Un clic-gauche sur AM ou PM bascule entre les modes 12h et 24h, et un clic-gauche sur ALRM bascule entre les modes alarme et normal (pour cela vous devez avoir enregistré une alarme).

Un clic-milieu change successivement les différents thèmes d'affichage.

Un CTRL-clic-gauche de la souris sur l'arrière-plan affiche successivement les différents styles d'affichage : heure Internet en battements (beats en anglais), heure binaire, puis heure locale. On peut démarrer l'application directement avec l'heure Internet (voir l'option -it). Un CTRL-clic-milieu de la souris sur l'arrière-plan lance l'outil de configuration. Un CTRL-clic-droit de la souris sur l'arrière-plan lance le calendrier. De plus l'agenda du jour peut être affiché au démarrage ou à l'heure 00:00 (minuit), en utilisant l'option MessageCmd.

On peut ajouter automatiquement des alarmes avec le calendrier de wmclockmon (voir plus bas et voir aussi wmclockmon-cal (1) pour plus d'informations). Dès qu'une alarme survient, le mode alarme vous alerte en faisant clignoter le rétro-éclairage pendant 1 minute et en lançant la commande qui aura été préconfigurée. Ce mode peut être arrêté et relancé en cliquant sur le bouton droit de la souris dans la fenêtre de l'application. Si une heure d'alarme a été réglée sur off (arrêt, voir la section Fichier de Configuration), elle ne sera pas mise en marche. Seule la mise à jour du fichier de configuration pourra le permettre.

OPTIONS

Les options définies en ligne de commande ont priorité sur les options du fichier de configuration par défaut. Mais si un fichier est défini en ligne de commande (voir l'option -f), ses propres options auront priorité sur celles du fichier de configuration par défaut.

Cette application respecte la syntaxe habituelle de la ligne de commande GNU, avec des options longues commençant avec 2 tirets (--). Un récapitulatif des options se trouve ci-dessous.

-d, --display <string>

Ouvre une fenêtre avec l'affichage X défini. En l'absence de cette option, l'affichage X est celui défini par la variable d'environnement DISPLAY.

-h, --help

Affiche le texte d'aide et quitte.

-v, --version

Affiche la version du programme et quitte.

-bl, --backlight

Allume le rétro-éclairage.

-lc, --light-color <color>

Définit la couleur du rétro-éclairage ou des DEL (diodes électro-luminescentes). La valeur par défaut est rgb:6E/C6/3B pour un aspect ACL, rgb:00/B0/EA pour un aspect DEL. L'aspect est déterminé par le thème d'affichage choisi.

-it, --internet-time

Démarre avec l'heure Internet en battements (beats en anglais).

-i, --interval <number>

Définit le nombre de secondes entre deux mises à jour (1 par défaut).

-w, --windowed

Lance l'application en mode fenêtré.

-bw, --broken-wm

Active la réparation du gestionnaire de fenêtres.

-a, --alarm <HH:MM>

Règle l'heure de l'alarme à HH:MM (en mode 24h).

-c, --alarm-cmd <string>

Exécute la commande <string> (chaîne de caractères, en français) lorsqu'une alarme survient.

-mc, --message-cmd <string>

Affiche le message <string> lorsqu'une alarme survient.

-12, --h12

Définit l'affichage en mode 12 heures (24h par défaut).

-s, --style <name>

Définit le style de l'affichage. Si l'option -sd est fournie, il n'y a pas besoin de donner une extension au nom de fichier, car elle est donnée automatiquement (.mwcs). Si l'on utilise cette option en précisant l'extension .mwcs pour le fichier, cela détermine automatiquement le répertoire de styles, s'il n'est pas déjà défini. Une utilisation postérieure de -sd l'annulera et le remplacera. Utiliser une autre extension que .mwcs peut donner des résultats erronés.

-sd, --style-dir <directory>

Définit le répertoire où sont mémorisés les styles.

-nb, --no-blink

Supprime le clignotement lorsqu'une alarme survient.

-f, --cfgfile

Charge le fichier de configuration.

-nl, --no-locale

N'utilise pas la locale courante (utilise la locale C à la place).

-l, --label

Affiche une étiquette à la place de la date courante (utile si vous avez de multiples instances de wmclockmon affichant des fuseaux horaires différents).

-sc, --show-cal

Affiche l'agenda ou liste des tâches pour le jour d'aujourd'hui, au démarrage ou à l'heure 00:00 (minuit).

-ca, --cal-alrms

Charge les alarmes du calendrier pour le jour d'aujourd'hui.

FICHIER DE CONFIGURATION

wmclockmon utilise le fichier par défaut ~/.wmclockmonrc. Les lignes vides ou les lignes commençant par un caractère dièse (#) sont ignorées. Les entrées sont décrites ci-dessous (avec les valeurs par défaut indiquées entre parenthèses). Les valeurs booléennes doivent être données en anglais, et peuvent être 1 ou 0, true (vrai en français) ou false (faux), yes (oui) ou no (non), on (activé) ou off (désactivé), et ne sont pas sensibles à la casse. Le paquetage de wmclockmon contient un exemple de fichier.

Backlight =

Booléen (off).

Color =

Chaîne de caractères (#6EC63B pour l'aspect ACL, #00B0EA pour l'aspect DEL).

Alarm =

Chaîne de caractères (vide). Il peut y avoir plusieurs entrées Alarm. Une entrée est de la forme [bool@]HH:MM[-D][.M], avec bool représentant l'état de l'alarme (on ou off), HH:MM l'heure et la minute de l'alarme, D le nombre de jours pendant lesquels elle doit survenir et M le message qui doit être affiché quand cette alarme survient. Les valeurs de bool, D et M sont facultatives (par défaut, bool est à "on" et aucune valeur pour D signifie "tous les jours"). Les caractères «@», «-» et «.» sont des séparateurs entre l'heure et chacune de ces valeurs. L'heure de l'alarme DOIT être exprimée en mode 24h, avec 2 chiffres pour les heures et 2 chiffres pour les minutes (sans espaces). Le nombre de jours, s'il existe, doit être compris entre 1 et 7. Les valeurs d'heure, de minute et de jour doivent être exprimés en format strftime (%H:%M and %u). Voir les fichiers d'exemples dans le paquetage.

Command =

Chaîne de caractères (vide). La commande est exécutée lorsqu'une alarme survient (par exemple : ogg123 -d esd -q /home/thomas/documents/sons/alarme.ogg).

MessageCmd =

Chaîne de caractères (vide). Le message est affiché lorsque l'alarme survient.

Blink =

Booléen (yes).

H12 =

Booléen (false). Positionne le mode d'affichage en mode 12h (true) ou 24h (false).

Locale =

Booléen (yes). Utilise la locale courante, sinon utilise la locale C.

Style =

Chaîne (vide).

StyleDir =

Chaîne (vide). Répertoire où sont mémorisés les styles.

TimeMode =

Entier (0 : horloge normale, 1 : heure internet, 2 : horloge binaire).

ShowCal =

Booléen (No). Affiche le calendrier du jour d'aujourd'hui au démarrage ou à l'heure 00:00 (minuit).

CalAlrms =

Booléen (Off). Charge les alarmes du calendrier pour le jour d'aujourd'hui.

Un fichier de calendrier peut être unique (pour un jour particulier), mensuel ou annuel. Pour un jour, tous les fichiers de calendrier sont utilisés (s'ils existent).

STYLES

Il est très facile de créer un nouveau style. Un style se compose de 5 fichiers de description et de plusieurs fichiers d'images (pixmap en anglais) : un fichier de style principal, un fichier de style des éléments, un fichier de style de lettres, un fichier de style d'heure internet et un fichier de style d'horloge binaire. Chacun d'eux contient plusieurs variables et leurs valeurs associées. Le fichier de style principal doit avoir l'extension .mwcs ; les autres peuvent avoir un nom quelconque, mais pour une meilleure compréhension, il est préférable d'utiliser ceux qui sont déjà donnés.

FICHIER DE STYLE PRINCIPAL (.mwcs)

PartsStyle =

Définit le nom du fichier qui décrit le style des éléments.

LettersStyle =

Définit le nom du fichier qui décrit le style des lettres.

ITimeStyle =

Définit le nom du fichier qui décrit le style d'heure internet.

BTimeStyle =

Définit le nom du fichier qui décrit le style d'heure binaire.

BacklightOn =

Image d'arrière-plan (58x58 pixels) lorsque le rétro-éclairage est allumé.

BacklightOff =

Image d'arrière-plan (58x58 pixels) lorsque rétro-éclairage est éteint.

NbColors =

Nombre de couleurs estompées. Hours_PosX =
Hours_PosY =

: Positions horizontale et verticale de l'heure dans l'image d'arrière-plan, en pixels .

Hours_Big =

Affichage de l'heure en grand format (booléen). Minutes_PosX =
Minutes_PosY =
Minutes_Big =

: Idem pour les minutes.

Seconds_PosX =
Seconds_PosY =
Seconds_Big =

: Idem pour les secondes.

Seconds_Colon =

Définit si les secondes sont clignotantes. AM_PosX =
AM_PosY =

: Positions horizontale et verticale de l'heure du matin (AM) en mode 12h.

PM_PosX =
PM_PosY =

: Positions horizontale et verticale de l'heure du soir (PM) en mode 12h.

ALRM_PosX =
ALRM_PosY =

: Positions horizontale et verticale de l'alarme.

Weekday_PosX =
Weekday_PosY =

: Idem pour le jour de la semaine.

Day_PosX =
Day_PosY =

: Idem pour le numéro du jour.

Month_PosX =
Month_PosY =

: Idem pour le mois.

FICHIER DE STYLE DES ÉLÉMENTS (.pwcs)

Parts =

Images (pixmaps) pour les éléments graphiques (petits ou grand digits, graphiques, AM/PM/ALARM).

BDigitHeight =

Hauteur des grands digits en pixels.

BDigitWidth =

Largeur des grands digits en pixels. SDigitHeight =
SDigitWidth =

: Hauteur et largeur des petits digits en pixels.

FICHIER DE STYLE DES LETTRES (.lwcs)

Letters =

Image pour les lettres. LetterHeight =
LetterWidth =

: Hauteur et largeur des lettres.

FICHIER DE STYLE D'HEURE INTERNET (.iwcs)

IBacklightOn =

Image d'arrière-plan pour le rétro-éclairage allumé pour l'heure internet.

IBacklightOff =

Idem pour le rétro-éclairage éteint. Beats_PosX =
Beats_PosY =
Beats_Big =

: Positions horizontale et verticale, grand format, pour les battements.

10thOB_PosX =
10thOB_PosY =
10thOB_Big =

: Idem pour les dixièmes de battements.

10thOB_Display =

Affichage des dixièmes de battements (booléen). Graph_PosX =
Graph_PosY =
Graph_Display =

: Positions horizontale et verticale, pour les graphiques.

FICHIER DE STYLE D'HEURE BINAIRE (.bwcs)

BBacklightOn =

Image d'arrière-plan pour le rétro-éclairage allumé pour l'heure binaire.

BBacklightOff =

Image d'arrière-plan pour le rétro-éclairage éteint pour l'heure binaire. Bin_HX =
Bin_HY =

: Positions horizontale et verticale de départ des bits des heures (en commençant par les bits de poids le plus élevé).

Bin_MX =
Bin_MY =

: Idem pour les bits des minutes.

Bin_SX =
Bin_SY =

: Idem pour les bits des secondes.

Bin_ZX =
Bin_ZY =

: Taille horizontale et verticale des carrés des bits de temps.

Bin_WX =
Bin_WY =

: Positions horizontale et verticale de départ des bits du jour de la semaine (en commençant par les bits de poids le plus élevé).

Bin_DX =
Bin_DY =

: Idem pour les bits du jour du mois.

Bin_OX =
Bin_OY =

: Idem pour les bits du mois.

Bin_IX =
Bin_IY =

: Tailles horizontale et verticale des carrés des bits de date. Si Bin_IX = -1 , l'affichage de la date est supprimé ; les autres définitions pour la date sont alors inutiles.

Bin_D1X =
Bin_D1Y =

: Espace horizontal et vertical entre 2 bits du même nombre pour le temps.

Bin_D2X =
Bin_D2Y =

: Espace horizontal et vertical entre 2 nombres binaires pour la même partie de temps.

Bin_D3X =
Bin_D3Y =

: Espace horizontal et vertical entre 2 bits du même nombre pour la date.

Bin_D4X =
Bin_D4Y =

: Espace horizontal et vertical entre 2 bits du même nombre pour la même partie de date.

VOIR AUSSI

wmclockmon-config(1), wmclockmon-cal(1), strftime(3)

AUTEUR

WMClockMon a été écrit en assembleur par Thomas Nemeth <tnemeth@free.fr>. Il est largement basé sur WMMemMon et WMCPULoad de Seiichi SATO <ssato@sh.rim.or.jp> et WMMemLoad de Mark Staggs <me@markstaggs.net>.

TRADUCTION

Ce document est une traduction, réalisée par Jean-Luc Duflot <jl POING duflot CHEZ laposte POING net> le 28 octobre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : LANGUAGE=en man wmclockmon. N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Index

FICHIER DE CONFIGURATION

STYLES

FICHIER DE STYLE PRINCIPAL (.mwcs)
FICHIER DE STYLE DES ÉLÉMENTS (.pwcs)
FICHIER DE STYLE DES LETTRES (.lwcs)
FICHIER DE STYLE D'HEURE INTERNET (.iwcs)
FICHIER DE STYLE D'HEURE BINAIRE (.bwcs)

VOIR AUSSI

AUTEUR

TRADUCTION

This document was created by man2html, using the manual pages.
Time: 13:14:13 GMT, January 02, 2008