Titan Panel

Denne artikel henviser til Google Code, som vil blive lukket ned den 25. januar 2016.

Titan Panel er en grænseflade AddOns, som skaber en vandret bjælke, hvor yderligere plugin-moduler kan indsættes, der viser alle mulige nyttige, overskuelige spildata. Det vokser i popularitet på grund af dets gode udseende, enkelhed og lethed til at skabe plugins, der skal vises i panelet.

Version 5 understøtter en række forskellige barplaceringer. De er:

• 1 bjælke øverst
• 1 bjælke nederst
• 1 bjælke øverst og 1 bjælke nederst
• 1 bjælke øverst og 2 bjælker nederst
• 2 bjælker øverst og 2 bjælker nederst
• 2 bjælker øverst toppen
• 2 bjælker i bunden
• 2 bjælker i toppen og 1 bjælke i bunden
• 2 bjælker i toppen og 2 bjælker i bunden

Nyheder

• 1. maj, 2009: HonorGoG har offentliggjort en nyhed på Titan Panel Portal, der forklarer en ændring i licensgivningen for Titan Panel som følger: “Titan Development Team har ændret licensen for Titan Panel fra den underforståede “All Rights Reserved” til en begrænset BSD-licens. Dette vil gøre det muligt for Titan Development Team at kontrollere distributionen under en open source-licens. Alle tidligere versioner, der påstod at være GPLv3, var i virkeligheden “All Rights Reserved”, da den nødvendige tekst for GPLv3-licensering ikke var inkluderet i distributionen. Husk venligst på dette, hvis du finder en version, der hævder at være en GPLv3-licenseret kopi af Titan Panel, da det ikke understøttes af Titan Development Team og er en overtrædelse af vores ophavsret. For yderligere licensoplysninger henvises til filen license.txt, der er inkluderet i distributionen.” ref
• 29. november 2008: HonorGoG lagde den seneste version af Titan Panel ud på Curse og udtalte: “Vi har arbejdet sammen med Curse-holdet for at hjælpe med at udvikle en mere strømlinet proces for addon-forfattere, som ikke opretholder en tilstedeværelse på CurseForge SVN. Der er sket flere dramatiske forbedringer, som har gjort det muligt for os at returnere Titan Panel til Curse uden at det er blevet en byrde, som det tidligere har været.” ref
• 17. oktober 2008: Yderligere forklaringer inden for Curse kommentarfeltet for Titan af HonorGoG forklarer “…de starter en massiv migreringsindsats for at fusionere WoWAce og Curse med CurseForge som deres back-end lige før 3.0 udgivelsen. Beklager, vi har bare ikke brug for det niveau af smerte.” Curse
• 15. oktober 2008: Titan-udviklingsholdet opdaterer ikke længere addons på curse.com eller affiliates. Ingen årsag er angivet. ref
• December 2007 : Titan Panel blev vedtaget af Titan Development Team med udviklingsarbejdet hostet hos Google Code.

Udgivelseshistorik

Author history

• De nye forfattere til det fornyede Titan Panel er Titan Development Team, bestående af: HonorGoG, Urnati, Joejanko, Lothaer, oXidFoX, pato.daia, Stingersoft & YeaChan. Du kan finde deres arbejde på Google Code
• Autorer, der har forladt Titan Development Team: jaketodd422, & trisTitan
• Autoren af Titan 2 addon var Adsertor @ UI.WWN.
• Author til nogle opdateringer og fejlrettelser var Dark Imakuni @ Curse (@ UI.WWN).
• Author til Titan addon var TitanMod @ Curse (@ UI.WWN).

Førre forfatterversioner

• Sidste version af Adsertor: Sidste version af Adsertor: 3.1.1
• Sidste version af Dark Imakuni: 1.3
• Sidste version af TitanMod: Research needed

URLs

• v5.x.x URL: Google Code, WoW Interface and Curse
• v4.x.x.x URL: Google-kode, WoW-grænseflade og forbandelse
• v3.1.1 URL: Curse
• v3.1.1.1 URL: http://www.filebase.info (mirror, da hovedwebstedet næsten er nede, når der er patch-dag)
• v2.20 URL: WoW UI eller http://www.curse-gaming.com/mod.php?addid=860

• v1.3 eller v1.27 URL: http://www.curse-gaming.com/mod.php?addid=860

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

Screenshots

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

Inkluderede Titan plugins

Version 5

Pending…

Version 4

Pending…

Version 3

Den endelige iteration af Titan version 3 indeholdt følgende plugins i kernedistributionen:

Liste over Titan-plugins

Navn	Beskrivelse
TitanAmmo	vis ammunitionstællinger
TitanBag	viser plads tilbage i tasker
TitanClock	ur med forskydninger for din sande tidszone
TitanCoords	viser placering, plus koordinater. Virker ikke inde i instanser
TitanGoldTracker	viser antal penge
TitanXP	viser XP og tooltip med flere oplysninger
TitanVolume	Lydstyrkeregulator for hovedlydstyrken
TitanLootType	viser indstillinger for party loot
TitanPerformance	Viser Ydelsesdata for WoW. Hukommelsesforbrug ved UI, garbage collection time, fps, latency
TitanUIScale	slider til skalering af Titan-panelet og de overordnede UI-elementer
ItemBonuses	Viser den samlede bonus, der gives af genstande for hver stat
Regen	Show mængden af HP og Mana, der regenereres pr. tick
Reparation	Viser den aktuelle/maksimale holdbarhed for hver genstand, du bærer i øjeblikket, og de penge, der er nødvendige for at reparere dem

Version 2

Som i version 2, Adsertor har tilføjet mange tredjeparts plugins på kernefordelingen af Titan Panel. Hver gang en ny version af disse plugins bliver frigivet, vil en ny version af Titan også blive frigivet (i teorien).

Liste over Titan-plugins

Navn	Version	Sidste opdatering	Author	Beskrivelse
TitanAmmo	2.04	–	TitanMod	vis ammunitionstællinger
TitanBag	2.04	–	TitanMod	viser plads tilbage i tasker
TitanClock	2.04	–	TitanMod	ur med forskydninger for din sande tidszone
TitanCoords	2.04	–	TitanMod	viser placering, plus koordinater. Virker ikke inden for instanser
TitanMoney	2.04	–	TitanMod	viser pengetal
TitanXP	2.04	–	TitanMod	viser XP og tooltip med flere oplysninger
TitanVolume		2.04	–	TitanMod	Volume slider for hovedvolumen
	TitanLootType	2.04	–	TitanMod	viser indstillinger for party loot
TitanPerformance	2.04	–	TitanMod	Viser Ydelsesdata for WoW. Hukommelsesforbrug ved UI, garbage collection time, fps, latency
TitanUIScale	2.04	–	TitanMod	slider til skalering af Titan-panelet og de overordnede elementer i brugergrænsefladen
	HonorPlus	r10.1700	9/22/05	Swiftstab	Viser oplysninger om ære på Titan-panelet
ItemBonus	0.9	10/12/05	CrowleyAJ	Viser den samlede bonus givet af genstande for hver stat
	Regen	1700	9/21/05	skeetskeet	Viser mængden af HP og Mana regenereret pr. tick
Repair	0.2	7/18/05	LumpN	Viser den aktuelle/maksimale holdbarhed for hver genstand, du bærer i øjeblikket, og de penge, der er nødvendige for at reparere dem

Version 1.X

For at få dig i gang med Titan Panel, har forfatteren inkluderet flere plugins med rammeudgivelsen:

• TitanAmmo – viser ammunitionstællinger
• TitanBag – viser plads tilbage i tasker
• TitanClock – ur med forskydninger til din sande tidszone
• TitanCoords – viser placering, plus koordinater
• TitanFPS – viser farvekodet FPS i bjælken
• TitanLatency – viser farvekodet latency i bjælken
• TitanHonor – viser viser dine PvP-statistikker
• TitanMoney – viser antallet af penge
• TitanXP – viser XP og tooltip med flere oplysninger
• TitanVolume – lydstyrkeregulator
• TitanLootType – viser dine PvP-statistikker
• TitanLootType – viser dine PvP-statistikker
• TitanLootType – viser dine PvP-statistikker viser party loot-indstillinger
• TitanMemory – viser hukommelsesforbrug
• TitanUIScale – skyder til skalering af Titan Panel og de overordnede UI-elementer

Andre Titan-plugins

Sider

Titan Panel Portal er stedet for aktuelle oplysninger om udviklingen af Titan Panel. En liste over tilgængelige Titan plugins er under udarbejdelse.

DrainingSouls.net har en omfattende og opdateret liste over tilgængelige Titan Panel mods. Den blev sidst opdateret i maj 2008, for Patch 2.4.

Søg på UI.worldofwar.net efter plugins. Hurtigere end Curse, bare ikke så “populær”.

Titan Plugin Listing vedligeholdt af Sepioth. Denne liste er fantastisk, men er ikke blevet opdateret siden juli 2005.

Link til AddOns

En liste over Titan Panel 4.0-kompatible plugins vil snart være tilgængelig på Titan Panel Portal.

Suggestions

The Titan Development Team har bedt om at alle forslag skal indtastes som et issue på Google Code-webstedet.

Garbage collection

Du kan fremtvinge en garbage collection i Titan Panel ved at venstreklikke på knappen TitanPerformance.

Reneste ændringer for udviklere

Afhænger…

Vejledning til udviklere

Hvis du ønsker at oprette dit eget Titan Panel-plugin, bør du hente Titan Panel-udviklerpakken for at få nogle enkle eksempler.

Den generelle anatomi af en Titan Panel-knap er ret enkel. Der er selve knappen, som er det, der vises på Titan-panelet. Disse kan være tekst, ikoner, kombinationer af tekst og ikoner eller andre vilkårligt komplekse UI-rammer. Hver knap har en kontekstmenu, et tooltip og ofte et kontrolvindue.

Du definerer knappen i din XML, som du måske forventer:

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

Knappen bør have en OnLoad hook til at opsætte plug-in’ets detaljer og bør kalde den originale TitanPanelButton_OnLoad() funktion for at indsætte sig selv i panelets liste over kendte plug-ins. Den skabelon, der skal arves fra, afhænger af, hvilken slags plug-in du ønsker at oprette:

TitanPanelButtonTemplate Den grundlæggende skabelon; har en højreklikmenu og standard handlers for OnLoad, OnShow, OnClick, OnUpdate, OnEnter og OnLeave, men ingen mulighed for at vise noget. Hvis du bruger denne skabelon, skal du tilføje underordnede rammer for at gøre noget. TitanPanelTextTemplate En grundlæggende Titan-panelknap med en tekststreng. Brug denne, hvis du ikke har noget ikon og ikke har noget mere komplekst end en tekststreng at vise. TitanPanelIconTemplate En grundlæggende Titan-panelknap med et ikon. Brug denne, hvis du kun har et ikon. Titanpanel-knapper med kun et ikon vil blive vist i højre side af Titanpanelet. Registreringsindtastningens ikon bestemmer den anvendte tekstur, og iconWidth bestemmer ikonets bredde. TitanPanelComboTemplate En Titan-panelknap med både et ikon og en tekststreng. Brug denne, når du ønsker at vise en tekststreng med et valgfrit synligt ikon ved siden af den. Titan-variablen ShowIcon bestemmer, om ikonet vises, og registreringsposten iconButtonWidth bestemmer den plads, der er reserveret til ikonet.

To andre skabeloner er også tilgængelige som en hjælp, men bør ikke bruges som en Titan Panel-knap på øverste niveau:

TitanPanelChildButtonTemplate En børneknap inden for en overordnet knapskabelon. Brug denne til at tilføje mere end én knap til en TitanPanelButtonTemplate-instans; du bør tilslutte OnClick-hændelsen, hvis du ønsker, at dine barnknapper skal udvise en anden adfærd end den overordnede. TitanOptionsSliderTemplate En skabelon for lodrette skydere til brug i kontrolvinduer.

I din OnLoad-metode, før TitanPanelButton_OnLoad() kaldes, skal du opsætte knappens register. Dette er en tabel, der definerer, hvordan knappen vises og fungerer i panelet, og har følgende felter:

id Et streng-ID for plug-in’et. builtIn Sæt til 1 for at blive vist i menuen for indbyggede elementer. menuText Etiket til plug-in-omskiftermenuen. buttonTextFunction Navnet på en funktion, der skal kaldes for at få knapteksten; bør returnere op til fire par af label, value. Hvis der kun returneres en enkelt streng, vises den altid. Hvis der returneres en etiket og en værdi eller mere end en etiket og en værdi, vises etiketterne kun, hvis variablen ShowLabelText er sand. Etiketterne og værdierne er ikke adskilt af Titan, så du bør sørge for, at din etikettekst indeholder en vis adskillelse (f.eks. returnerer “Label: “, “value”). tooltipTitle Titellinjen for plug-in’ens tooltip. tooltipTextFunction Navnet på en funktion, der skal returnere tekst, som skal vises i plug-in’ens tooltip under titellinjen. tooltipCustomFunction Navnet på en funktion, der skal kaldes, når GameTooltip skal opdateres for dette plug-in. icon Et teksturnavn for dette plug-in’s ikon. iconWidth Bredden i pixels for ikontekstur. Standardbredden er 16 pixel. iconButtonWidth Bredden i pixel for et ikon eller en kombiknap. Hvis variablen ShowIcon er sand, vil denne bredde blive tilføjet til en kombinations-knap, og ikonet vil blive vist. Ikonknapper vil altid vise deres ikon; hvis denne bredde ikke er indstillet, vil ikonets bredde blive anvendt. savedVariables En tabel med (nøgle, standard) data med variabler, der skal gemmes pr. bruger for dette plug-in. Variablerne kan tilgås via TitanGetVar(id, key) og TitanSetVar(id, key, value). Variablerne ShowIcon og ShowLabelText forstås af Titan Panel. Standardværdier på nil skal bruge TITAN_NIL i stedet, da lua tabelværdier ikke kan være nil. frequency Intervallet, i (flydende point) sekunder, mellem opdateringer. Når dette interval (eller mere) er udløbet, vil enten en knap- eller tooltip-opdateringsfunktion, eller begge, blive kaldt i henhold til updateType. updateType En af TITAN_PANEL_UPDATE_TOOLTIP, TITAN_PANEL_UPDATE_BUTTON eller TITAN_PANEL_UPDATE_ALL (standard). Bestemmer, hvilke opdateringsfunktioner der vil blive kaldt hvert frekvenssekund.

Vi går videre til vores eksempelplugin’s OnLoad-metode. Du skal som minimum levere id- og menuText-posterne, selvom du normalt vil ønske at levere mere:

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

Bemærk: Hvis du har til hensigt at bruge TitanPanelIconTemplate-skabelonen, skal du også sørge for at indsætte en ny post i tabellen TITAN_PANEL_NONMOVABLE_PLUGINS, på din OnLoad-metode, der indeholder id’et for dit plugin, f.eks. tinsert(TITAN_PANEL_NONMOVABLE_PLUGINS, “MyAddonid”).

Med blot denne kode skulle du have et Titan Panel-plugin, der blot viser “Example”.

Hvis du vil have det til at reagere på venstreklik, skal du enten tilslutte OnClick-hændelsen for at gøre det, du ønsker, eller oprette en ramme kaldet TitanPanel(ID)ControlFrame, hvor (ID) er dit plugins id (f.eks. TitanPanelExampleControlFrame). Denne ramme vil blive vist og skjult knyttet til din knap, når der klikkes med venstre hånd.

Hvis du ønsker, at din knap skal reagere på højreklik med en kontekstmenu, skal du sikre dig, at du enten ikke hooker OnClick, eller at du kalder TitanPanelButton_OnClick(arg1) efter at have udført dit eget arbejde, så Titan-koden kan fange højreklikbegivenheden. Du skal også definere en funktion ved navn TitanPanelRightClickMenu_Prepare(ID)Menu, der kalder en kombination af funktionerne til konstruktion af højreklikmenuer:

TitanPanelRightClickMenu_AddTitle(text, level?) Tilføjer den givne tekst som en højreklikmenutitel. level, hvis det er indstillet, bestemmer menuens nesting-niveau. TitanPanelRightClickMenu_AddSpacer(level?) Tilføjer et fyldningsrum til højreklikmenuen. level, hvis det er indstillet, bestemmer menuens nesting-niveau. TitanPanelRightClickMenu_AddToggleIcon(id) Tilføjer et ikon til at skifte indstilling til højreklikmenuen. TitanPanelRightClickMenu_AddToggleLabelText(id) Tilføjer en mulighed for at skifte mellem etikette og tekst til højreklikmenuen. TitanPanelRightClickMenu_AddToggleColoredText(id) Tilføjer en mulighed for at skifte mellem farvet tekst og højreklikmenuen. TitanPanelRightClickMenu_AddCommand(text, value, funcname, level?) Tilføjer en callback-funktion til højreklikmenuen med den givne tekstekst, det givne argument og det givne funktionsnavn, der skal kaldes. Foruddefinerede funktioner er TITAN_PANEL_MENU_FUNC_HIDE, som skal have en tekst på TITAN_PANEL_MENU_HIDE og en værdi på det plug-in-id, der skal fjernes fra panelet. TitanPanelRightClickMenu_AddToggleVar(text, id, var, toggleTable?) Tilføjer en toggle-indstilling med labeltekst for plug-in id’s variabel var. Hvis toggleTable er til stede, er det en liste over indstillinger, hvoraf mindst én altid skal være indstillet.

Du kan nemt opbygge en typisk kontekstmenu:

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

Bemærk, at eksemplets plug-in-register ikke indeholdt nogen variabler, så disse toggles vil ikke fungere, og kan endda generere fejl. Desuden har den hverken et ikon eller returnerer en etiket fra sin GetButtonText-metode, så vippene ville ikke have nogen effekt, selv hvis variablerne fandtes. Kun eksempel, klip og indsæt på egen risiko!

Historisk reference