XPhotos plugin pour XLOBBY par TocaToc - Version

Transcription

1 XPhotos plugin pour XLOBBY par TocaToc - Version Dernière mise à jour : 01/05/2007 Ce plugin a pour but de : Créer la database de vos photos pour XLOBBY, Créer, dans le répertoire "Cache" de Xlobby, un aperçu en résolution 200 x 200. Cette aperçu est fait pour chaque photos et pour les aux maximum quatres premières photos de chaque branche. Cette recopie de l'arborescence du répertoire de vos photos permet une navigation plus fluïde dans vos différents thèmes. Recherche des appareils photos connectés pour importer les photos en les renommant dans le répertoire de vos photos. Les actions peuvent être réalisées depuis une fenêtre XLOBBY ou la fenêtre WINDOWS de configuration du plugin. Exemples d aperçu de thème : Le plugin est constitué de 3 fichiers : XPhotos.dll : bibliothèque du plugin, XPhotos.xml : paramètres de configuration du plugin. Si le plugin ne trouve pas ce fichier a son initialisation, il utilise des valeurs par défaut, XDebug.txt : fichier d'enregistrement de variables et commandes en mode DEBUG. Seul le premier est impératif. Les deux autres sont créés par le plugin si nécessaire. Descriptif du fichier XPhotos.xml : Le fichier "XPhotos.xml" contient les paramètres de configuration du plugin : Debug : ce champ lorsqu'il vaut "true" permet l'activation du mode DEBUG, c'est à dire l'enregistrement dans le fichier XDebug.txt de : La valeur de la variable de la fonction "GetVariable" a chaque appel de celle-çi, 1 / 9

2 "ShowDialog" a chaque appel de la méthode "ShowDialog", La valeur de la variable de la fonction " Execute" a chaque appel de celle-çi, "Fin Thread Création Database" ou "Fin Thread Importation Database" à la fin des Threads de création de la DataBase ou de transfert de photos, "Arret Thread Création Database" ou "Arret Thread Importation Database" à chaque arrêt des Threads de création de la DataBase ou de transfert de photos avant la fin de ceux-çi. La valeur par défaut de ce paramètre est : "false". TypeFichier : ce champ définit le type de photos de votre base de données et le type de photos à importer. Sa valeur par défaut est : "*.jpg" DirPictures : ce champ définit le répertoire de travail dans l'arborescence de vos photos (création de la DataBase ou importation de photos). Sa valeur par défaut est : "D:\\Multi-media\\Photos". DirMesPhotos : ce champ définit le répertoire de plus haut niveau de l'arborescence de vos photos. Sa valeur par défaut est : "D:\\Multi-media\\Photos". DirCache : ce champ définit le répertoire du cache de Xlobby. Sa valeur par défaut de ce paramètre est : "C:\\Program Files\\Xlobby\\cache". DirXmlPictures : ce champ définit le répertoire d enregistrement du fichier "Photos.xml database de Xlobby des photos, il est généré par ce plugin. Sa valeur par défaut est : "C:\\Program Files\\Xlobby\\databases". DirPhotoNumerique : ces champs (au maximum 20) contiennent l'arborescences de vos appareils sans la lettre du disque, celle-çi étant détecté automatiquement par le plugin (exemple : "DCIM\100MSDCF"). Sa valeur par défaut est : " ". Theme : ce champ définit le répertoire dans lequel les photos importées seront enregistrées. S il n existe pas le plugin le crée. Sa valeur par défaut est : "Année". SousTheme : ce champ définit le répertoire dans lequel les photos importées seront enregistrées. S il n existe pas le plugin le crée. Sa valeur par défaut est : "Noel, Vacances". CouleurA, R, G, B : ces champs définissent la couleur de la barre de progression pour Xlobby. Leur valeur doit être comprise entre 0 et 255. La valeur par défaut de ce paramètre est : "255", ce qui correspond à une barre de progression de couleur "Blanche". Le fichier est sauvegardé ou créé : A la création de la database depuis la fenêtre Windows de configuration du plugin, A l'importation de photos depuis la fenêtre Windows de configuration du plugin, A chaque appui sur la touche SAVE de la fenêtre windows de configuration du plugin, A chaque modification de la Source, Theme ou SousTheme depuis une fenêtre de Xlobby. Mes données multi-média sont rangées sur mon disque "D" comme suit (d'ou la valeur par défaut des variables "DirPictures" et "DirMesPhotos") : 2 / 9

3 Si l'un des répertoires est invalide (valeur par défaut ou valeur du fichier "XPHOTOS.xml"), il prend la valeur "Chemin inconnu". De plus si l'un des répertoires : "DirPictures", "DirCache" ou "DirXmlPictures" est invalide, et qu'une création de la DataBase est demandée ou "DirPhotoNumerique", "DirPictures", "DirCache" ou "DirXmlPictures" est invalide, et qu'une importation de photos est demandée. le compte-rendu de la fenêtre de XLobby prend la valeur "Vérifier les répertoires" ou la fenêtre suivante apparait à coté de la fenêtre Windows de configuration du plugin. Commandes : Ce plugin a 8 commandes : Initialiser Cette fonction permet la lecture du fichier de configuration du plugin. A la fin de son execution, la fenêtre de compte-rendu prend la valeur : "fichier C:\...\XPhotos.xml récupéré" si le fichier existe dans le répertoire "...\Xlobby\plugins\Xphotos". "Valeurs par défaut" si le fichier n'existe pas dans le répertoire "...\Xlobby\plugins\Xphotos". Creer Compte le nombre de photos ("TypeFichier") présentes dans la branche "DirPictures" (y compris dans les sous répertoires), Sauvegarde, si elle existe, le fichier XML "pictures.xml" de la database de vos photos de XLOBBY sous le nom "pictures.xml_old" Crée la database pour XLOBBY "pictures.xml", Gére le compteur et la barre de progression pendant la génération de la database. Au cours de son execution : Le compte-rendu de la fenêtre Windows de configuration du plugin prend la valeur "Création en cours des aperçus et du XML des YY / XXX photos" (avec XXX le nombre total de vos photos, YY le nombre de photos déjà pris en compte par DataBase). A la fin de son execution, la fenêtre de compte-rendu prend la valeur "Création terminé des aperçus et du XML des XXX photos", Le compte-rendu de la fenêtre Xlobby prend la valeur "Création en cours des aperçus et du XML des XXX photos" (avec XXX le nombre total de vos photos). A la fin de son execution, la fenêtre de compte-rendu prend la valeur "Création terminé des aperçus et du XML des XXX photos". Si l'execution de la fonction est demandée alors qu'une importation de photos est en cours alors la fenêtre de compte-rendu de la fenêtre de XLobby prend la valeur "Attendre la fin de l'importation" ou la fenêtre suivante apparait à coté de la fenêtre Windows de configuration du plugin. 3 / 9

4 Importer Compte le nombre de photos ("TypeFichier") présentes dans le répertoire "DirPhotoNumerique", Move (et non copy : les photos sont supprimées de la source) les photos présentes dans le répertoire source vers le répertoire " \Theme\SousTheme\". Il crée les répertoires "Theme" et "SousTheme" s'ils n'existent pas. Lors du transfert les photos sont renommées "Theme - SousTheme - 0xx". "xx" é tant un compteur incrémenté à chaque photo transférée. Si le répertoire de destination est contient déjà des photos, la valeur initiale de xx est égale au nombre de photos dans le répertoire de destination + 1. Gére le compteur et la barre de progression pendant le transfert. A la fin de son execution, la fenêtre de compte-rendu prend la valeur : "Chemin des photos à transferer invalide" si le répertoire source est invalide, "Il n'y a pas de fichiers à transférer" si le répertoire source ne contient pas de photo de type "TypeFichier", "transfert partiel des images effectuées" s'il existe déjà dans le répertoire de destination une photo ayant un nom "Theme - SousTheme - 0xx" (avec xx supèrieur au nombre de photos présentes dans le répertoire). Ces photos n'ont pas été tranférées, cela évite la perte de photos. "transfert de toutes les images effectuées" si le transfert des photos c'est déroulé complétement. Nota : Si l'execution de la fonction est demandée alors qu'une importation de photos est en cours alors la fenêtre de compte-rendu prend la valeur "Attendre la fin de la création de la DataBase". Sauver Cette fonction sauvegarde le fichier de configuration du plugin, le crée s'il n'existe pas. A la fin de son execution, la fenêtre de compte-rendu prend la valeur "Donnees Sauvegardees". Cancel Cette fonction si : La fonction "Créer" est en cours d'execution, tue le ThrEAD correspond, renomme le fichier, si il existe, "pictures.xml_old" en "pictures.xml", La fonction "Importer" est en cours d'execution, tue le ThrEAD correspond. Nota : Si le mode DEBUG est sélectionné, il y a enregistrement dans le fichier "XDebug.txt" de "Arret Thread Création Database" ou "Arret Thread Importation photos". MajSource récupère via la fenêtre "PhotosRenameSourceOverlay" de Xlobby, un nom de répertoire, par exemple "2007", Remplace les caractères interdits du nom par des espaces, le recherche dans les sous répertoires de "DirMesPhotos", si il est trouvé le champ source de la fenêtre du plugin de Xlobby prendra la nouvelle valeur. Sinon le champ source de la fenêtre du plugin de Xlobby prendra la valeur du paramètre " DirMesPhotos". MajTheme 4 / 9

5 récupère, via la fenêtre "PhotosRenameThemeOverlay" de Xlobby, le nouveau Thème, Remplace les caractères interdits du nom par des espaces, sauvegarde le fichier de configuration du plugin, le crée s'il n'existe pas, met a jour du nouveau thème la fenêtre du plugin de Xlobby. MajSsTheme récupère via la fenêtre "PhotosRenameSsThemeOverlay" de Xlobby, le nouveau SousThème, Remplace les caractères interdits du nom par des espaces, sauvegarde le fichier de configuration du plugin, le crée s'il n'existe pas, met a jour du nouveau Sous-Thème la fenêtre du plugin de Xlobby. Variables : Ce plugin a 9 variables. Elles sont renseignées par celui-ci sur réception de la fonction " GetVariable (string name)". Ces variables sont : BarreProgres : Elle permet l'affichage de la barre de progression de la fenêtre de Xlobby, Source : Elle correspond au répertoire de vos photos, Cache : Elle correspond au répertoire du cache de Xlobby ou seront enregisté les apercus, XmlPicture : Elle corespond au répertoire de la database Xlobby de vos photos, PhotoNum : Elle correspond à la source des photos à importer, NomTheme : Elle correspond au répetoire d'enregistrement des photos à importer, NomSousTheme : Elle correspond au sous répertoire d'enregistrement des photos à importer, Avancement : C'est un compteur de progression de l'importation des photos ou de génération de la database de Xlobby. Sa valeur max correspond au nombre de photos traités par la tâche en cours. TexteMessage : Elle fournit les compte-rendus d'execution du plugin. Installation : Le dossier compressé "Xphotos.zip " contient les fichiers nécessairent à l'installation du plugin XPhotos dans Xlobby avec une skin de "1280 x 768". Après l'avoir télécharger et décompresser, suivre les étapes suivantes : Copier dans votre répertoire skins de Xlobby, " \Xlobby\skins\<<My Skin>>", les 5 fenêtres Xlobby du plugin se trouvant dans le répertoire " \Xlobby\skins\My skin X768" du fichier décompressé : Photos.xml, PhotosOverlay.xml, PhotosRenameSourceOverlay.xml, PhotosRenameThemeOverlay.xml, PhotosRenameSsThemeOverlay.xml. Copier dans votre répertoire plugins de Xlobby, " \Xlobby\plugins", le répertoire avec son contenu "XPhotos" qui se trouve dans le répertoire " \Xlobby\plugins\XPhotos" du fichier décompressé. Ce répertoire comprend la bibliothèque du plugin "XPhotos.dll", 5 / 9

6 Copier dans votre répertoire Xlobby " \Xlobby\skins\<<My Skin>>\eventgroups" le fichier "Photos.xml" des évènements Xphotos se trouvant dans le répertoire "\Xlobby\skins\My skin X768\eventgroups" du fichier décompressé. Copier dans votre répertoire Xlobby " \Xlobby\skins\<<My Skin>>\backgrounds" le fichier "Photos.jpg" fond de page de Xphotos se trouvant dans le répertoire "\Xlobby\skins\My skin X768\backgrounds" du fichier décompressé. Modifier votre fichier "goto.xml" se trouvant dans votre répertoire " \Xlobby\skins\<<My Skin>>\eventgroups" pour ajouter l'événement "goto Photos" (Cf. "\Xlobby\skins\My skin X768\eventgroups\goto.xml"). Ajouter dans votre fenêtre "menu" de Xlobby un bouton d'appel de la fenêtre "Photos.xml". Lancer XLobby, Appeler la fenêtre Windows de configuration des plugins, Sélectionner le plugin Xphoto et appuyer sur la touche "Configuration", Puisque l'installation ne comprend pas de fichier XPhotos.xml, l'initialisation du plugin est faite avec les valeurs par défauts. Dans cette exemple, seul le répertoire des images est inconnu (1) et le chemin des photos à importer est vide (2). Modifier le chemin inconnu (1), Rentrer l'arborescence de votre appareil photos numérique (2), la lettre du disque n'a pas d'importance, elle est recherchée à chaque utilisation, Sauver les paramètres par appui sur la touche SAVE. Les données ont été sauvegardées et le fichier XPhotos.xml a été créé (1), L'arborescence de votre appareil photo numérique ou téléphone est mémorisée (3), Rentrer une à une les autres arborescences de vos appareils photos numérique ou téléphone (2), Sauver les paramètres par appui sur la touche SAVE. Utilisation du plugin : Depuis la fenêtre de configuration Windows : 1. Barre de progression, 2. Fenêtre de compte-rendu, 6 / 9

7 3. Bouton de création de la database Xlobby des photos, 4. Bouton d importation des photos depuis le répertoire 8 dans le répertoire A\B\C, 5. Bouton sauvegarde du fichier de configuration du plugin, 6. Bouton d arrêt du plugin, 7. liste des sources de photos à importer. La sélection d une source, si celle-ci est connectée au PC, la fenêtre 8 est mise à jour, sinon la fenêtre 8 prend la valeur «Pas d'appareil trouvé» Depuis la fenêtre de XLobby : 1.. Bouton d activation du plugin, 2.. Bouton d appel de la fenêtre Menu de Xlobby. Depuis la fenêtre PhotosOverlay de Xlobby : 1.. Barre de progression, 2.. Fenêtre de compte-rendu, 3.. Bouton de création de la database Xlobby des photos, 4.. Bouton d importation des photos depuis le répertoire 8 dans le répertoire A\B\C, 5.. Bouton d arrêt du plugin 6.. Bouton d appel de la fenêtre PhotosRenameSourceOverlay de modification du Thème, 7.. Bouton d appel de la fenêtre PhotosRenameThemeOverlay de modification du Thème, 8.. Bouton d appel de la fenêtre PhotosRenameSsThemeOverlay de modification du SousThème. Depuis la fenêtre PhotosRenameSourceOverlay, PhotosRenameThemeOverlay ou PhotosRenameSsThemeOverlay de Xlobby : 1.. Bouton de validation du nouveau Thème ou SousThème, 2.. Bouton inactif actuellement, 7 / 9

8 8 / Bouton d annulation de la modification du nouveau Thème ou SousThème, 4.. Champ de saisi du nouveau Thème ou SousThème

9 Outils utilisés pour le développement : Ce plugin a été développé avec : Il nécessite l'installation de : # Visual C# Express 2005.Net Framework : v Evolutions a venir : Après une importation, pouvoir mettre à jour la DataBase photos de XLobby de manière partielle (ne pas être obligé de la générer complètement), Pouvoir importer plusieurs types de photos simultannément. Actuellement on importe qu'un type à la fois, Gerer la touche ABC des fenêtres PhotosRenameSourceOverlay, PhotosRenameThemeOverlay ou PhotosRenameSsThemeOverlay de Xlobby. Suggestions : Vous pouvez me laisser un pour me signaler les Bugs, faire des suggestions ou des remarques. 9 / 9