Panneau Titan

Cet article fait référence à Google Code qui sera fermé le 25 janvier 2016.

Titan Panel est une interface AddOns qui crée une barre horizontale où des modules plugins supplémentaires peuvent être déployés affichant toutes sortes de données utiles, en un coup d’œil, sur le jeu. Sa popularité grandit en raison de son bon aspect, de sa simplicité et de la facilité de créer des plugins à afficher dans le panneau.

La version 5 prend en charge une variété de différents emplacements de barre. Ils sont :

• 1 barre en haut
• 1 barre en bas
• 1 barre en haut et 1 barre en bas
• 1 barre en haut et 2 barres en bas
• 2 barres en… le haut
• 2 barres en bas
• 2 barres en haut et 1 barre en bas
• 2 barres en haut et 2 barres en bas

Nouvelles

• Le 1er mai, 2009 : HonorGoG a publié une nouvelle sur le portail du Titan Panel expliquant un changement dans la licence du Titan Panel comme suit : « L’équipe de développement de Titan a modifié la licence de Titan Panel en passant de l’implicite « Tous droits réservés » à une licence BSD limitée. Cela permettra à l’équipe de développement de Titan de contrôler la distribution sous une licence open source. Toutes les versions précédentes qui prétendaient être sous GPLv3 étaient, en fait, « Tous droits réservés » car le texte requis pour la licence GPLv3 n’était pas inclus dans la distribution. Veuillez garder cela à l’esprit si vous trouvez une version prétendant être une copie de Titan Panel sous licence GPLv3, car elle n’est pas soutenue par l’équipe de développement de Titan et constitue une violation de notre copyright. Pour des détails supplémentaires sur la licence, veuillez vous référer au fichier license.txt inclus dans la distribution. » ref
• 29 novembre 2008 : HonorGoG a publié la dernière version de Titan Panel sur Curse en déclarant : « Nous avons travaillé avec l’équipe de Curse pour aider à développer un processus plus rationalisé pour les auteurs d’addons qui ne maintiennent pas une présence sur le SVN de CurseForge. Il y a eu plusieurs améliorations spectaculaires qui nous ont permis de rendre Titan Panel à Curse sans que cela ne devienne un fardeau comme par le passé » réf
• 17 octobre 2008 : HonorGoG cite la raison de la suppression de Titan de Curse comme suit : « Curse est actuellement trop instable pour que nous en maintenions une copie sur ce site. » réf D’autres explications dans la zone de commentaires de Curse pour Titan par HonorGoG expliquent « …ils commencent un effort de migration massif pour fusionner WoWAce et Curse avec CurseForge comme back-end juste avant la sortie de la version 3.0. Désolé, nous n’avons tout simplement pas besoin de ce niveau de douleur. » Curse
• 15 octobre 2008 : L’équipe de développement de Titan ne met plus à jour les addons sur curse.com ou ses affiliés. Aucune raison n’est précisée. ref
• Décembre 2007 : Titan Panel a été adopté par l’équipe de développement Titan, l’effort de développement étant hébergé chez Google Code.

Historique des versions

Historique des auteurs

• Les nouveaux auteurs du Titan Panel remanié sont l’équipe de développement du Titan, composée de : HonorGoG, Urnati, Joejanko, Lothaer, oXidFoX, pato.daia, Stingersoft & YeaChan. Vous pouvez trouver leurs travaux sur Google Code
• Auteurs ayant quitté l’équipe de développement de Titan : jaketodd422, & trisTitan
• L’auteur de l’addon Titan 2 était Adsertor @ UI.WWN.
• L’auteur de certaines mises à jour et corrections de bugs était Dark Imakuni @ Curse (@ UI.WWN).
• L’auteur de l’addon Titan était TitanMod @ Curse (@ UI.WWN).

Versions antérieures de l’auteur

• Dernière version par Adsertor : 3.1.1
• Dernière version par Dark Imakuni : 1.3
• Dernière version par TitanMod : recherche nécessaire

URLs

• v5.x.x URL : Code Google, interface WoW et malédiction
• v4.x.x URL : Google Code, WoW Interface et Curse
• v3.1.1 URL : Curse
• v3.1.1 URL : http://www.filebase.info (miroir car le site principal est presque en panne lors du patch day)
• v2.20 URL : WoW UI ou http://www.curse-gaming.com/mod.php?addid=860

• v1.3 ou v1.27 URL : http://www1.curse-gaming.com/mod.php?addid=2142

Captures d’écran

Titan 2:
http://ui.worldofwar.net/images/ui/1129167028WoWScrnShot_101205_172526.jpg

Included Titan plugins

Version 5

Pending…

Version 4

Pending…

Version 3

L’itération finale de la version 3 de Titan contenait les plugins suivants dans la distribution de base :

.

.

Liste des plugins Titan

Nom	Description
TitanAmmo	show ammo counts
TitanBag	montrer la place restante dans les sacs
TitanClock	horloge avec décalage pour votre vrai fuseau horaire
TitanCoords	affiche l’emplacement, plus les coordonnées. Ne fonctionnera pas à l’intérieur des instances
TitanGoldTracker	affiche le compte d’argent
TitanXP	affiche l’XP et une infobulle avec plus d’informations
TitanVolume	Curseur de volume pour le volume principal
TitanLootType	affiche les paramètres de loot du parti
TitanPerformance	Affiche les données de performance de WoW. Utilisation de la mémoire par l’interface utilisateur, temps de collecte des ordures, fps, latence
TitanUIScale	slider pour la mise à l’échelle du panneau Titan et des éléments de l’UI globale
ItemBonuses	Montre le bonus total donné par les items pour chaque stat
Regen	Montre la quantité de HP et de Mana régénérés par tick
Réparation	Affiche la durabilité actuelle/max de chaque objet que vous portez actuellement et l’argent nécessaire pour les réparer

Version 2

A compter de la version 2, Adsertor a ajouté de nombreux plugins tiers sur la distribution de base de Titan Panel. Chaque fois qu’une nouvelle version de ces plugins est publiée, une nouvelle version de Titan sera également publiée (en théorie).

.

Liste des plugins Titan

Nom	Version	Dernière mise à jour	Auteur	Description
TitanAmmo	2.04	–	TitanMod	montrer le nombre de munitions
TitanBag	2.04	–	TitanMod	montrer la place restante dans les sacs
TitanClock	2.04	–	TitanMod	horloge avec des décalages pour votre vrai fuseau horaire
TitanCoords	2.04	–	TitanMod	affiche l’emplacement, plus les coordonnées. Ne fonctionne pas dans les instances
TitanMoney	2.04	–	TitanMod	affiche le nombre d’argent
TitanXP	2.04	–	TitanMod	affiche l’XP et une infobulle avec plus d’informations
TitanVolume	2.04	–	TitanMod	Curseur de volume pour le volume principal
TitanLootType	2.04	–	TitanMod	Affiche les paramètres de loot des partis
TitanPerformance	2.04	–	TitanMod	Affiche les données de performance de WoW. Utilisation de la mémoire par l’interface utilisateur, temps de collecte des déchets, fps, latence
TitanUIScale	2.04	–	TitanMod	slider pour la mise à l’échelle du panneau Titan et des éléments généraux de l’interface utilisateur
HonorPlus	r10.1700	9/22/05	Swiftstab	Affiche les informations d’honneur sur le panneau Titan
ItemBonuses	0.9	10/12/05	CrowleyAJ	Affiche le bonus total donné par les objets pour chaque stat
Regen	1700	9/21/05	skeetskeet	Montre la quantité de HP et de Mana régénérés par tick
Réparation	0.2	7/18/05	LumpN	Affiche la durabilité actuelle/max de chaque objet que vous portez actuellement et l’argent nécessaire pour les réparer

Version 1.X

Pour vous permettre de démarrer avec le panneau Titan, l’auteur a inclus plusieurs plugins avec la version du framework :

• TitanAmmo – montre le nombre de munitions
• TitanBag – montre la place restante dans les sacs
• TitanClock – horloge avec des décalages pour votre vrai fuseau horaire
• TitanCoords – affiche la localisation, plus les coordonnées
• TitanFPS – affiche le FPS avec un code couleur dans la barre
• TitanLatency – affiche la latence avec un code couleur dans la barre
• TitanHonor – affiche vos statistiques PvP
• TitanMoney – affiche le compte d’argent
• TitanXP – affiche l’XP et une infobulle avec plus d’informations
• TitanVolume – curseur de volume
• TitanLootType – affiche les paramètres de loot du parti
• TitanMemory – affiche l’utilisation de la mémoire
• TitanUIScale – curseur de mise à l’échelle du Titan Panel et de l’ensemble des éléments de l’interface utilisateur

Autres plugins Titan

Sites

Titan Panel Portal est l’emplacement des informations actuelles concernant le développement de Titan Panel. Une liste des plugins Titan disponibles est en attente.

DrainingSouls.net possède une liste complète et à jour des mods Titan Panel disponibles. Elle a été mise à jour pour la dernière fois en mai 2008, pour le patch 2.4.

Recherche de plugins sur UI.worldofwar.net. Plus rapide que Curse, mais pas aussi « populaire ».

Liste de plugins Titan maintenue par Sepioth. Cette liste est géniale mais n’a pas été mise à jour depuis juillet 2005.

Liens vers les AddOns

Une liste des plugins compatibles avec Titan Panel 4.0 sera bientôt disponible sur le portail de Titan Panel.

Suggestions

L’équipe de développement de Titan a demandé que toutes les suggestions soient saisies comme un problème sur le site de Google Code.

Collecte de déchets

Vous pouvez forcer une collecte de déchets dans Titan Panel en cliquant avec le bouton gauche sur le bouton TitanPerformance.

Modifications récentes pour les développeurs

En attente…

Guide du développeur

Si vous voulez créer votre propre plug-in Titan panel, vous devriez obtenir le kit du développeur Titan Panel pour quelques exemples simples.

L’anatomie générale d’un bouton Titan panel est assez simple. Il y a le bouton lui-même, qui est ce qui apparaît sur le panneau Titan. Cela peut être du texte, des icônes, une combinaison de texte et d’icônes, ou d’autres cadres d’interface utilisateur arbitrairement complexes. Chaque bouton dispose d’un menu contextuel, d’une info-bulle et souvent d’une fenêtre de contrôle.

Vous définissez le bouton dans votre XML comme vous pouvez vous y attendre :

...<Frame parent="UIParent"> <Frames> <Button name="TitanPanelExampleButton" inherits="TitanPanelTextTemplate" frameStrata="FULLSCREEN" toplevel="true"> <Scripts> <OnLoad> TitanPanelExampleButton_OnLoad(); TitanPanelButton_OnLoad(); </OnLoad> </Scripts> </Button> </Frames></Frame>...

Le bouton doit avoir un hook OnLoad pour configurer les détails du plug-in, et doit appeler la fonction originale TitanPanelButton_OnLoad() pour s’insérer dans la liste des plug-ins connus du Panel. Le modèle dont il faut hériter dépend du type de plug-in que vous souhaitez créer :

TitanPanelButtonTemplate Le modèle de base ; possède un menu de clic droit, et des gestionnaires par défaut pour OnLoad, OnShow, OnClick, OnUpdate, OnEnter, et OnLeave, mais aucun moyen d’afficher quoi que ce soit. Si vous utilisez ce modèle, vous devez ajouter des cadres enfants pour faire quelque chose. TitanPanelTextTemplate Un bouton de base du panneau Titan avec une chaîne de texte. Utilisez ce modèle si vous n’avez pas d’icône et rien de plus complexe qu’une chaîne de texte à afficher. TitanPanelIconTemplate Bouton de base du panneau Titan comportant une icône. Utilisez-le si vous n’avez qu’une icône. Les boutons du panneau Titan avec une simple icône seront affichés sur le côté droit du panneau Titan. L’icône de l’entrée de registre détermine la texture utilisée, et iconWidth détermine la largeur de l’icône. TitanPanelComboTemplate Bouton du panneau Titan comportant à la fois une icône et une chaîne de texte. Utilisez-le lorsque vous souhaitez afficher une chaîne de texte avec une icône optionnellement visible à côté. La variable Titan ShowIcon déterminera si l’icône apparaît, et l’entrée de registre iconButtonWidth déterminera l’espace réservé à l’icône.

Deux autres modèles sont disponibles comme aide également, mais ne doivent pas être utilisés comme un bouton de niveau supérieur du Titan Panel :

TitanPanelChildButtonTemplate Un bouton enfant dans un modèle de bouton parent. Utilisez-le pour ajouter plus d’un bouton à une instance de TitanPanelButtonTemplate ; vous devez accrocher l’événement OnClick si vous voulez que vos boutons enfants aient un comportement différent de celui du parent. TitanOptionsSliderTemplate Un modèle pour les curseurs verticaux à utiliser dans les fenêtres de contrôle.

Dans votre méthode OnLoad, avant que le TitanPanelButton_OnLoad() ne soit appelé, vous devez configurer le registre du bouton. Il s’agit d’une table définissant la façon dont le bouton apparaît et fonctionne dans le Panel, et possède les champs suivants :

id Une chaîne ID pour le plug-in. builtIn Défini à 1 pour apparaître dans le menu built-ins. menuText Label pour le menu basculant du plug-in. buttonTextFunction Le nom d’une fonction à appeler pour obtenir le texte du bouton ; doit retourner jusqu’à quatre paires de label, valeur. Si une seule chaîne est renvoyée, elle est toujours affichée. Si une étiquette et une valeur, ou plus d’une étiquette et d’une valeur, sont retournées, les étiquettes ne seront affichées que si la variable ShowLabelText est vraie. Les étiquettes et les valeurs ne sont pas séparées par Titan, vous devez donc vous assurer que le texte de votre étiquette comporte une séparation (par exemple, renvoyer « Label : « , « value »). tooltipTitle La ligne de titre de l’infobulle du plug-in. tooltipTextFunction Le nom d’une fonction qui doit renvoyer le texte à afficher dans l’infobulle du plug-in, sous la ligne de titre. tooltipCustomFunction Nom de la fonction à appeler lorsque le GameTooltip de ce module externe doit être mis à jour. icon Nom de la texture de l’icône de ce module externe. iconWidth Largeur, en pixels, de la texture de l’icône. La largeur par défaut est de 16 pixels. iconButtonWidth Largeur, en pixels, d’une icône ou d’un bouton combo. Si la variable ShowIcon est vraie, cette largeur sera ajoutée à un bouton combiné et l’icône sera affichée. Les boutons d’icône afficheront toujours leur icône ; si cette largeur n’est pas définie, la largeur de l’icône sera utilisée. savedVariables Tableau de données (clé, par défaut) listant les variables à sauvegarder par utilisateur pour ce plug-in. Les variables sont accessibles via TitanGetVar(id, key) et TitanSetVar(id, key, value). Les variables ShowIcon et ShowLabelText sont comprises par Titan Panel. Les valeurs par défaut de nil doivent utiliser TITAN_NIL à la place, car les valeurs des tables lua ne peuvent pas être nil. frequency L’intervalle, en secondes (virgule flottante), entre les mises à jour. Lorsque cet intervalle (ou plus) s’est écoulé, une fonction de mise à jour du bouton ou de l’infobulle, ou les deux, seront appelées, en fonction de updateType. updateType L’un des éléments suivants : TITAN_PANEL_UPDATE_TOOLTIP, TITAN_PANEL_UPDATE_BUTTON ou TITAN_PANEL_UPDATE_ALL (par défaut). Détermine les fonctions de mise à jour qui seront appelées toutes les secondes de fréquence.

Passons à la méthode OnLoad de notre exemple de plugin. Vous devez au moins fournir les entrées id et menuText, bien qu’habituellement vous voudrez en fournir davantage :

function TitanPanelExamplePlugin_OnLoad() this.registry = { id = "Example", menuText = "Example Plug-in", tooltipTitle = "Example Plug-in", buttonTextFunction = "TitanPanelExamplePlugin_GetButtonText", };endfunction TitanPanelExamplePlugin_GetButtonText() return "Example";end

Note : Si vous avez l’intention d’utiliser le modèle TitanPanelIconTemplate, vous devez également vous assurer d’insérer une nouvelle entrée dans la table TITAN_PANEL_NONMOVABLE_PLUGINS, sur votre méthode OnLoad, contenant l’id de votre plugin, par exemple tinsert(TITAN_PANEL_NONMOVABLE_PLUGINS, « MyAddonid »).

Avec juste ce code, vous devriez avoir un plug-in Titan Panel qui affiche simplement « Exemple ».

Si vous voulez qu’il réponde aux clics gauches, vous devez soit accrocher l’événement OnClick pour faire ce que vous voulez, soit créer un cadre appelé TitanPanel(ID)ControlFrame, où (ID) est l’id de votre plug-in (par exemple, TitanPanelExampleControlFrame). Ce cadre sera affiché et caché attaché à votre bouton lorsqu’il est cliqué avec le bouton gauche.

Si vous voulez que votre bouton réponde aux clics droits avec un menu contextuel, assurez-vous que soit vous ne hookez pas OnClick, soit vous appelez TitanPanelButton_OnClick(arg1) après avoir fait votre propre travail, afin que le code Titan puisse attraper l’événement de clic droit. Vous devrez également définir une fonction nommée TitanPanelRightClickMenu_Prepare(ID)Menu, appelant une combinaison des fonctions de construction de menu de clic droit:

TitanPanelRightClickMenu_AddTitle(text, level ?) Ajoute le texte donné comme titre de menu de clic droit. level, si défini, déterminera le niveau d’imbrication du menu. TitanPanelRightClickMenu_AddSpacer(level ?) Ajoute un espace de remplissage au menu du clic droit. Le niveau, s’il est défini, déterminera le niveau d’imbrication du menu. TitanPanelRightClickMenu_AddToggleIcon(id) Ajoute une option de basculement d’icône au menu du clic droit. TitanPanelRightClickMenu_AddToggleLabelText(id) Ajoute une option de basculement du texte de l’étiquette au menu du clic droit. TitanPanelRightClickMenu_AddToggleColoredText(id) Ajoute une option de basculement de texte coloré au menu du clic droit. TitanPanelRightClickMenu_AddCommand(text, value, funcname, level ?) Ajoute une fonction de rappel au menu du clic droit, avec le libellé du texte, l’argument et le nom de la fonction à appeler. Les fonctions prédéfinies sont TITAN_PANEL_MENU_FUNC_HIDE, qui doit avoir un texte de TITAN_PANEL_MENU_HIDE et une valeur de l’ID du plug-in à retirer du panneau. TitanPanelRightClickMenu_AddToggleVar(text, id, var, toggleTable ?) Ajoute une option de basculement avec le label text, pour la variable var du plug-in id. Si toggleTable est présent, c’est une liste d’options, dont au moins une doit toujours être définie.

Vous pouvez construire un menu contextuel typique facilement:

function TitanPanelRightClickMenu_PrepareExampleMenu() TitanPanelRightClickMenu_AddTitle(TitanPlugins.menuText); TitanPanelRightClickMenu_AddToggleIcon("Example"); TitanPanelRightClickMenu_AddToggleLabelText("Example"); TitanPanelRightClickMenu_AddSpacer(); TitanPanelRightClickMenu_AddCommand(TITAN_PANEL_MENU_HIDE, "Example", TITAN_PANEL_MENU_FUNC_HIDE);end

Notez que le registre du plug-in de l’exemple n’a pas inclus de variables, donc ces toggle ne fonctionneront pas, et peuvent même générer des erreurs. En outre, le plug-in ne possède pas d’icône et ne renvoie pas d’étiquette à partir de sa méthode GetButtonText, de sorte que les boutons à bascule n’auraient aucun effet même si les variables existaient. Exemple seulement, coupez et collez à vos risques et périls !

Référence historique

.