[TUTO] créer son horloge

Introduction

Vu le peu d'info qu'on trouve sur le sujet, j'ai décidé de faire un tutoriel afin de vous permettre de créer assez facilement votre propre horloge/préserveur d'écran pour Moonshell mais aussi l'OS de la Supercard DS one ou celui de l'EZ-Flash V.


Téléchargements

Pour créer une horloge, vous avez tout d'abord besoin du logiciel CustomKit.exe. Celui-ci est
fourni avec Moonshell. On pouvait le télécharger sur le site officiel au lien suivant.
http://mdxonline.dyndns.org/archives/2007/08/moonshell_ver171p1_top_page.shtml

Cependant, le site semble avoir été fermé depuis la sortie du M3 Sakura. Donc voici un lien alternatif.
http://forum.supercard.cn/attachment.php?aid=443

Pour les développeurs mais aussi pour les bidouilleurs, il peut être appréciable de se procurer les codes sources du jeu complet de plug-ins pour Moonshell. Les horloges se trouvent dans les dossiers mspv31_clk_***.
http://www.zshare.net/download/1570904892d30836/


Créer son horloge numérique

Pour les développeurs, il leur est facile de fouiller dans les codes sources pour créer des horloges en tous genres mais pour les autres une application a été faite pour créer des horloges assez varier facilement. Voici la procédure.

1) D'abord, décompressez l'archive ClockKit.zip puis créez un nouveau dossier à l'intérieur de celui résultant. (ou bien dans le dossier misc

2) Dans ce dossier, créer les images suivantes.

• Date.png : Cette image contient les 14 caractères qui composent l'affichage de la date (,-./0123456789). Sa largeur = la largeur des caractères et sa hauteur = la hauteur des caractères x 14.
  
• AMPM.png : Cette image contient les caractères qui composent l'affichage du AM/PM (matin/après midi)
  
• HourMinuts.png : Cette image contient les 11 caractères qui composent l'affichage des heures et minutes (0123456789:). Sa largeur = la largeur des caractères et sa hauteur = la hauteur des caractères x 11.
  
• Second.png : Cette image contient les 11 caractères qui composent l'affichage des secondes (0123456789:). Sa largeur = la largeur des caractères et sa hauteur = la hauteur des caractères x 11.
  
• BG.png : Cette image est celle de l'arrière-plan. Sa taille fait celle de l'écran. C'est à dire : largeur = 256 et hauteur = 192. Elle peut être plus petite afin de faire un arrière-plan recouvert de plusieurs fois cette image comme un toit avec des tuiles.
  
• Temperature.png : Cette image contient les 13 caractères qui composent l'affichage de la température (./0123456789º). Sa largeur = la largeur des caractères et sa hauteur = la hauteur des caractères x 13.

Vous pouvez utiliser le logiciel The Gimp ou un équivalent pour créer ces images.

Notes :
- Les espacements se feront automatiquement.
- Chaque image peuvent être omisée. Par exemple, si vous ne voulez pas afficher la température ou la date, ce n'est pas la peine de la créer.

3) Une fois les images créées, lancez CustomKit.exe.

Note : Avant de débuter, sachez que le programme n'est pas compatible avec Vista ni Virtual PC.
Le programme ressemble à ça :



Celui-ci va vous permettre de créer le plug-in sans avoir recours à la programmation. Ce programme s'occupe automatiquement de l'emplacement des caractères en fonction de leur tailles. Vous n'avez juste qu'à indiquer la position (du coin supérieur gauche) de la date (XX / XX / XXXX), de l'horaire (XX:XX), des secondes (:XX), de l'AM/PM (en mode 12h seulement) et de la température (XX.XXº).

Cliquez sur "Édit (E)" pour incorporez les images au plug-in. Commencez, par exemple, par l'arrière-plan en sélectionnant "BG Load from file (B)".


Note : "BG fill select color (B)" permet de choisir une couleur à la place d'une image.

Sélectionnez l'image de l'arrière-plan et cliquez sur "Ouvrir".

Si votre image fait 256x192, laissez les paramètre tel quels et cliquez sur l'icone avec la marque verte suivit des points d'interrogations (Normalement ça devrait être du japonais).


Ensuite, incorporez la date en cliquant sur "Édit (E)" et sélectionnant "Date (D)"

Une fois l'image sélectionnée, une fenêtre va s'ouvrir avec une autre en son centre vous demandant
"Transparent? Y/N".



Y (oui) permet de changer la couleur de fond en vert. Ce vert sera invisible dans l'horloge.

Modifiez les paramètres X, Y et "test string" mais laissez "Format string" tel quel.
Ensuite cliquez sur "OK (O)" pour incorporer l'image au plug-in. Puis répétez l'opération pour chaque image.

Une fois les images incorporées, cliquez sur "File (F)" puis "Save MSP as (O)" et le plug-in sera prêt.

Note : Le nom du plug-in doit nécessairement commencer par "clk_".

Vous pouvez créer un aperçu en cliquant sur "File (F)" puis "Save Preview (P)".



4) Votre plug-in est fini, il ne vous reste plus qu'à le copier sur votre carte mémoire.

Le plug-in se compose des 3 fichiers suivants.

clk_name.bin
clk_name.ini
clk_name.msp

Pour l'installer, copier ces 3 fichiers dans le dossier moonshl/plugin/ ou scshell/plugin/ pour la SCDSone. Il faut aussi nécessairement effacer l'horloge précédente de ce dossier pour que votre horloge soit prise en compte à coup sûr.

Notes :
- Le fichier clk_name.bin contient les images en BVR15bin les une à la suite des autres. Le header de 12 octet indique leur position (2 octets par image).
- Le fichier clk_name.msp est le programme du plug-in.
- Le fichier clk_name.ini est un fichier de text. Vous pourrez par la suite éditer le fichier clk_name.ini pour modifier les paramètres.

5) AM/PM et autres paramètres
L'indication AM/PM n'apparaît qu'en mode 12h. Editez le global.ini pour paramétrer le mode 12/24h.

Code:

[ClockPlugin]

; 11.1 Enabled = [0|1] (Default = 1)

; Displaying the clock plug-in.
; 0 = Hide
; 1 = Display

; 時計プラグインを有効にします。
; 0=無効, 1=有効

Enabled=1

; 11.2 RTC24Hour = [0|1] (Default = 1)

; Defining hour time format.
; 0 = 12-hour time format (with: AM/PM -letters)
; 1 = 24-hour time format

; 24時間系設定をします。
; 0=12時間系, 1=24時間系

RTC24Hour=1

; 11.3 FormatDate = [value] (Default = YYYY/MM/DD)

; The display format of the date. Max length is 32 characters.
; In this example, the year(Y) is 2001, month(M) is 2 and the day(D) is 3.
; When using code (it displays):
; YYYY (2001), YY (01), MM (02), M (2), DD (03), D (3)
; So using code: YYYY/MM/DD  date is displayed as: 2001/02/03
; Different separator characters can be used: , - . /

; 日本語はYYYY/MM/DDでok.

FormatDate=YYYY/MM/DD

Si RTC24Hour=1 l'affichage de l'heure se fera en mode 24h.

Enabled=1 permet d'activer l'horloge.

Pour régler le temps nécessaire pour que l'horloge apparaisse allez à cet endroit :

Code:

[BacklightTimeout]

; Specified number. (unit of sec)
; Anything turns off the backlight when there is no key input.
; WhenStandby=FileClosed WhenPicture=BMP/Jpeg etc. WhenText=Text WhenSound=NSF/MP3 etc.
; 指定秒数キー入力がないときにバックライトを消灯します。時計プラグインがあるときは時計を表示します。

WhenStandby=10
WhenPicture=15
WhenText=30
WhenSound=10

Les valeurs correspondent à des secondes.


Créer son horloge analogue

Grâce à Cotsz de Dev-fr, on peut désormais créer une horloge à aiguilles. Pour cela, suivez la même procédure que pour l'horloge numérique mais à la fin, remplacez les fichiers clk_name.msp et clk_name.ini par les clk_osx_analog.msp et clk_osx_analog.ini de cette archive (sans oublier de le renommer). Ensuite éditez le fichier .ini afin de paramétrer la position et la longueur des aiguilles ainsi que le reste.


Convertion des couleurs

Les valeurs des couleurs du fichier clk_name.ini sont au format BVR555. La plupart des logiciels de dessin actuels indiquent les valeurs des couleurs au format RVB888. Donc il va falloir vous servir d'une calculatrice Hexadécimale/binaire/décimale pour effectuer les conversions.

Prenons l'exemple avec la couleur de l'aiguille des secondes SecondWireColor.
Mon logiciel de dessin (The gimp) me donne FF0000. C'est à dire R=FF, V=00 et B=00.

D'abord, changez l'ordre des valeurs du niveaux de couleurs RVB => BVR

FF 00 00 => 00 00 FF

Ensuite, convertissez les valeurs hexadécimales en binaire.

00 00 FF => 00000000 00000000 11111111 (Ajoutez des 0 à gauche de chaque valeur afin d'obtenir 3 x 8bit si nécessaire)

Puis retirer les 3 octets de droite pour chaque valeur pour ne laisser que 3 x 5 bit.

00000000 00000000 11111111 => 00000 00000 11111

Réunissez l'ensemble.

00000 00000 11111 => 000000000011111

Convertissez cette valeur binaire en décimale et voilà vous aurez la valeur au format BVR555.

000000000011111 => 31

Ce qui donne SecondWireColor=31

Répétez l'opération pour chaque couleur.


Exemple d'horloges analogues



Téléchargement : clk_diddles_analog.zip, clk_Hello_Kitty_Angel.zip et clk_OSX_theme_analog_v100.zip.


tuto by supercarte, Source