Titan Panel

Tento článek odkazuje na Google Code, který bude ukončen 25. ledna 2016.

Titan Panel je rozhraní AddOns, které vytváří horizontální lištu, na níž lze nasadit další moduly zásuvných modulů zobrazující nejrůznější užitečné, přehledné herní údaje. Jeho popularita roste díky pěknému vzhledu, jednoduchosti a snadnému vytváření zásuvných modulů, které se mají v panelu zobrazovat.

Verze 5 podporuje řadu různých umístění panelu. Jsou to např:

• 1 pruh nahoře
• 1 pruh dole
• 1 pruh nahoře a 1 pruh dole
• 1 pruh nahoře a 2 pruhy dole
• 2 pruhy na nahoře
• 2 takty dole
• 2 takty nahoře a 1 takt dole
• 2 takty nahoře a 2 takty dole

Novinky

• Květen 1, 2009: HonorGoG zveřejnil na portálu Titan Panel následující novinku vysvětlující změnu v licencování Titan Panelu: „Vývojový tým Titanu změnil licenci pro Titan Panel z implicitního „Všechna práva vyhrazena“ na omezenou licenci BSD. To umožní vývojovému týmu Titanu kontrolovat distribuci pod open source licencí. Všechny předchozí verze, které se hlásily k licenci GPLv3, byly ve skutečnosti „All Rights Reserved“, protože požadovaný text pro licenci GPLv3 nebyl součástí distribuce. Pokud narazíte na verzi, která tvrdí, že je kopií panelu Titan s licencí GPLv3, mějte to prosím na paměti, protože ji vývojový tým Titan nepodporuje a porušuje naše autorská práva. Další podrobnosti o licenci naleznete v souboru license.txt, který je součástí distribuce.“ ref
• Dne 29. listopadu 2008: HonorGoG zveřejnil nejnovější verzi Panelu Titan na Curse s prohlášením: „Spolupracovali jsme s týmem Curse, abychom pomohli vyvinout zjednodušený proces pro autory doplňků, kteří neudržují přítomnost na CurseForge SVN. Došlo k několika dramatickým vylepšením, která nám umožnila vrátit Titan Panel do Curse, aniž by se stal přítěží jako v minulosti.“ ref
• 17. října 2008: HonorGoG uvedl jako důvod odstranění Titanu z Curse: „Curse je v současné době příliš nestabilní na to, abychom mohli udržovat jeho kopii na těchto stránkách.“ ref Další vysvětlení v rámci oblasti komentářů Curse k Titanu od HonorGoG vysvětluje: „…těsně před vydáním verze 3.0 zahajují masivní migrační úsilí o sloučení WoWAce a Curse s CurseForge jako jejich back-endem. Je nám líto, ale takovou míru bolesti prostě nepotřebujeme.“ Curse
• 15. října 2008: Vývojový tým Titanu již neaktualizuje doplňky na webu curse.com ani na pobočkách. Žádný důvod není uveden. ref
• Prosinec 2007 : Titan Panel byl přijat vývojovým týmem Titanu s tím, že vývojové úsilí je umístěno na Google Code.

Historie vydání

Historie autorů

• Novými autory přepracovaného Panelu Titan je vývojový tým Titan ve složení: HonorGoG, Urnati, Joejanko, Lothaer, oXidFoX, pato.daia, Stingersoft & YeaChan. Jejich práci najdete na Google Code
• Autoři, kteří opustili Titan Development Team: jaketodd422, & trisTitan
• Autorem addonu Titan 2 byl Adsertor @ UI.WWN.
• Autorem některých aktualizací a oprav chyb byl Dark Imakuni @ Curse (@ UI.WWN).
• Autorem addonu Titan byl TitanMod @ Curse (@ UI.WWN).

Poslední verze autorů

• Poslední verze od Adsertor: 3.1.1
• Poslední verze od Dark Imakuni: 1.3
• Poslední verze od TitanMod: research needed

URLs

• v5.x.x URL:
• v4.x.x URL: Kód Googlu, rozhraní WoW a prokletí
• v4.x.x URL: URL: Kód Google, rozhraní WoW a prokletí
• v3.1.1: Prokletí
• v3.1.1 URL: http://www.filebase.info (zrcadlo, protože hlavní stránka je téměř nefunkční, když je den záplaty)
• v2.20 URL: URL: WoW UI nebo http://www.curse-gaming.com/mod.php?addid=860

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

Snímky obrazovky

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

Obsažené pluginy Titanu

Verze 5

Čeká se…

Verze 4

Čeká se…

Verze 3

Konečná iterace Titan verze 3 obsahovala v rámci jádra distribuce následující zásuvné moduly:

.

.

Seznam zásuvných modulů Titanu

Název	Popis
TitanAmmo	zobrazení počtu munice
TitanBag	zobrazí zbývající místo v brašnách
TitanClock	hodiny s posunem pro vaši skutečnou časovou zónu
TitanCoords	zobrazí polohu, plus souřadnice. Nefunguje uvnitř instancí
TitanGoldTracker	zobrazuje počet peněz
TitanXP	zobrazuje XP a tooltip s dalšími informacemi
TitanVolume	Posuvník hlasitosti pro hlavní hlasitost
TitanLootType	zobrazuje nastavení party lootu
TitanPerformance	Zobrazuje údaje o výkonu WoW. Využití paměti podle uživatelského rozhraní, doba sběru odpadků, fps, latence
TitanUIScale	posuvník pro škálování panelu Titána a celkových prvků uživatelského rozhraní
ItemBonuses	Zobrazuje celkový bonus poskytovaný předměty pro jednotlivé statistiky
Regen	Show množství HP a many regenerované za jedno zaškrtnutí
Oprava	Zobrazuje aktuální/maximální trvanlivost každého předmětu, který máte právě na sobě, a peníze potřebné na jejich opravu

Verze 2

Od verze 2, Adsertor přidal mnoho zásuvných modulů třetích stran na základní distribuci Titan Panel. Pokaždé, když bude vydána nová verze těchto zásuvných modulů, bude vydána i nová verze panelu Titan (teoreticky).

.

Seznam zásuvných modulů Titanu

Název	Verze	Poslední aktualizace	Autor	Popis
TitanAmmo	2.04	–	TitanMod	zobrazit počty munice
TitanBag	2.04	–	TitanMod	zobrazí zbývající místo v brašnách
TitanClock	2.04	–	TitanMod	hodiny s posunem pro vaše skutečné časové pásmo
TitanCoords	2.04	–	TitanMod	zobrazí polohu plus souřadnice. Nebude fungovat uvnitř instancí
TitanMoney	2.04	–	TitanMod	zobrazuje počet peněz
TitanXP	2.04	–	TitanMod	zobrazí XP a tooltip s dalšími informacemi
TitanVolume	2.04	–	TitanMod	Posuvník hlasitosti pro hlavní hlasitost
TitanLootType	2.04	–	TitanMod	zobrazuje nastavení party lootu
TitanPerformance	2.04	–	TitanMod	Zobrazuje údaje o výkonu WoW. Využití paměti podle uživatelského rozhraní, doba vybírání odpadu, fps, latence
TitanUIScale	2.04	–	TitanMod	posuvník pro škálování panelu Titan a celkových prvků uživatelského rozhraní
HonorPlus	r10.1700	9/22/05	Swiftstab	Zobrazuje informace o cti na panelu Titan
ItemBonusy	0.9	10/12/05	CrowleyAJ	Zobrazuje celkový bonus poskytovaný předměty pro každou statistiku
Regen	1700	9/21/05	skeetskeet	Zobrazuje množství HP a many regenerované za jedno zaškrtnutí
Repair	0.2	7/18/05	LumpN	Zobrazuje aktuální/maximální trvanlivost každého předmětu, který máte právě na sobě, a peníze potřebné k jeho opravě

Verze 1.X

Abyste mohli s panelem Titan začít pracovat, autor k vydání frameworku přiložil několik zásuvných modulů:

• TitanAmmo – zobrazuje počty munice
• TitanBag – zobrazuje zbývající místo v brašnách
• TitanClock – hodiny s posunem pro vaše skutečné časové pásmo
• TitanCoords – zobrazuje polohu, plus souřadnice
• TitanFPS – zobrazuje barevně kódované FPS v liště
• TitanLatency – zobrazuje barevně kódované zpoždění v liště
• TitanHonor – zobrazí vaše PvP statistiky
• TitanMoney – zobrazí počet peněz
• TitanXP – zobrazí XP a nápovědu s dalšími informacemi
• TitanVolume – posuvník hlasitosti
• TitanLootType – zobrazí hlasitost, kterou jste získali. zobrazuje nastavení party lootu
• TitanMemory – zobrazuje využití paměti
• TitanUIScale – posuvník pro škálování panelu Titan a celkových prvků uživatelského rozhraní

Další zásuvné moduly Titan

Stránky

Portál panelu Titan je místo pro aktuální informace týkající se vývoje panelu Titan. Seznam dostupných zásuvných modulů Titan je v očekávání.

DrainingSouls.net má vyčerpávající a aktuální seznam dostupných modifikací Titan Panelu. Naposledy byl aktualizován v květnu 2008 pro patch 2.4.

Pátrejte po zásuvných modulech na stránkách UI.worldofwar.net. Rychlejší než Curse, jen ne tak „populární“.

Seznam zásuvných modulů pro Titan spravuje Sepioth. Tento seznam je skvělý, ale nebyl aktualizován od července 2005.

Odkazy na doplňky

Seznam zásuvných modulů kompatibilních s panelem Titan 4.0 bude brzy k dispozici na portálu panelu Titan.

Návrhy

Vývojový tým Titanu požádal, aby všechny návrhy byly zadány jako problém na webu Google Code.

Sběr odpadu

Sběr odpadu můžete v rámci panelu Titan vynutit kliknutím levým tlačítkem myši na tlačítko TitanPerformance.

Aktuální změny pro vývojáře

Vyžaduje se…

Příručka pro vývojáře

Pokud chcete vytvořit vlastní zásuvný modul panelu Titan, měli byste si pořídit vývojářskou sadu Titan Panel, kde najdete několik jednoduchých příkladů.

Obecná anatomie tlačítka panelu Titan je poměrně jednoduchá. Existuje samotné tlačítko, které se zobrazuje na panelu Titan. Může to být text, ikony, kombinace textu a ikon nebo jiné libovolně složité rámce uživatelského rozhraní. Každé tlačítko má kontextovou nabídku, nápovědu a často i ovládací okno.

Tlačítko definujete ve svém XML tak, jak byste asi očekávali:

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

Tlačítko by mělo mít háček OnLoad, který nastaví podrobnosti o zásuvném modulu, a mělo by volat původní funkci TitanPanelButton_OnLoad(), aby se vložilo do seznamu známých zásuvných modulů panelu. Šablona, ze které se má dědit, závisí na tom, jaký druh zásuvného modulu chcete vytvořit:

TitanPanelButtonTemplate Základní šablona; má nabídku pravého tlačítka myši a výchozí obsluhy pro OnLoad, OnShow, OnClick, OnUpdate, OnEnter a OnLeave, ale nemá možnost nic zobrazit. Pokud použijete tuto šablonu, musíte přidat podřízené rámy, které budou něco dělat. TitanPanelTextTemplate Základní tlačítko panelu Titan s textovým řetězcem. Použijte ji, pokud nemáte žádnou ikonu a nic složitějšího než textový řetězec k zobrazení. TitanPanelIconTemplate Základní tlačítko panelu Titan s ikonou. Použijte ji, pokud máte pouze ikonu. Tlačítka panelu Titan s pouhou ikonou se zobrazí na pravé straně panelu Titan. Ikona položky registru určuje použitou texturu a iconWidth určuje šířku ikony. TitanPanelComboTemplate Tlačítko panelu Titan s ikonou i textovým řetězcem. Použijte jej, pokud chcete zobrazit textový řetězec s volitelně viditelnou ikonou vedle něj. Proměnná Titan ShowIcon určí, zda se ikona zobrazí, a položka registru iconButtonWidth určí prostor vyhrazený pro ikonu.

Dvě další šablony jsou k dispozici také jako pomůcka, ale neměly by se používat jako tlačítko nejvyšší úrovně panelu Titan:

Šablona TitanPanelChildButtonTemplate Podřízené tlačítko v rámci šablony rodičovského tlačítka. Použijte ji k přidání více než jednoho tlačítka do instance šablony TitanPanelButtonTemplate; měli byste připojit událost OnClick, pokud chcete, aby vaše podřízená tlačítka vykazovala jiné chování než rodičovská. TitanOptionsSliderTemplate Šablona pro svislé posuvníky, které se používají v ovládacích oknech.

V metodě OnLoad musíte před voláním funkce TitanPanelButton_OnLoad() nastavit registr tlačítka. Jedná se o tabulku definující způsob zobrazení a fungování tlačítka v rámci Panelu, která obsahuje následující pole:

id Řetězcové ID zásuvného modulu. builtIn Nastavte na 1, aby se zobrazovalo v nabídce vestavěných modulů. menuText Popisek pro přepínací menu zásuvného modulu. buttonTextFunction Název funkce, která se zavolá pro získání textu tlačítka; měla by vrátit až čtyři dvojice label, value. Pokud je vrácen pouze jeden řetězec, zobrazí se vždy. Pokud je vrácen popisek a hodnota nebo více než jeden popisek a hodnota, zobrazí se popisky pouze v případě, že je proměnná ShowLabelText true. Štítky a hodnoty nejsou odděleny Titanem, proto byste se měli ujistit, že text štítku obsahuje nějaké oddělení (např. vrátit „Štítek: „, „hodnota“). tooltipTitle Titulní řádek pro nápovědu zásuvného modulu. tooltipTextFunction Název funkce, která má vrátit text, který se zobrazí v nápovědě zásuvného modulu pod titulním řádkem. tooltipCustomFunction Název funkce, která se má zavolat, když se má aktualizovat GameTooltip pro tento zásuvný modul. icon Název textury pro ikonu tohoto zásuvného modulu. iconWidth Šířka textury ikony v pixelech. Výchozí šířka je 16 pixelů. iconButtonWidth Šířka ikony nebo kombinovaného tlačítka v pixelech. Pokud je proměnná ShowIcon true, bude tato šířka přidána ke kombinovanému tlačítku a ikona zobrazena. Tlačítka s ikonou budou vždy zobrazovat svou ikonu; pokud tato šířka není nastavena, bude použita šířka ikony. savedVariables Tabulka (klíčových, výchozích) údajů se seznamem proměnných, které se mají uložit pro jednotlivé uživatele tohoto zásuvného modulu. K proměnným lze přistupovat pomocí TitanGetVar(id, key) a TitanSetVar(id, key, value). Proměnným ShowIcon a ShowLabelText rozumí Titan Panel. Výchozí hodnoty nil musí místo nich používat TITAN_NIL, protože hodnoty tabulky lua nemohou být nil. frequency Interval mezi aktualizacemi v sekundách (s plovoucí desetinnou čárkou). Jakmile tento interval (nebo více) uplyne, zavolá se buď funkce aktualizace tlačítka, nebo tooltipu, nebo obě, podle updateType. updateType Jedna z možností TITAN_PANEL_UPDATE_TOOLTIP, TITAN_PANEL_UPDATE_BUTTON nebo TITAN_PANEL_UPDATE_ALL (výchozí). Určuje, které aktualizační funkce budou volány každou frekvenci sekund.

Přejdeme k metodě OnLoad našeho ukázkového zásuvného modulu. Musíte zadat alespoň položky id a menuText, i když obvykle budete chtít zadat více:

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

Poznámka: Pokud hodláte použít šablonu TitanPanelIconTemplate, musíte se také ujistit, že v metodě OnLoad vložíte do tabulky TITAN_PANEL_NONMOVABLE_PLUGINS novou položku obsahující id vašeho zásuvného modulu, např. tinsert(TITAN_PANEL_NONMOVABLE_PLUGINS, „MyAddonid“).

Pouze s tímto kódem byste měli mít zásuvný modul TitanPanel, který jednoduše zobrazuje „Příklad“.

Pokud chcete, aby reagoval na kliknutí levým tlačítkem myši, musíte buď připojit událost OnClick, aby dělala to, co chcete, nebo vytvořit rámec s názvem TitanPanel(ID)ControlFrame, kde (ID) je id vašeho zásuvného modulu (např. TitanPanelExampleControlFrame). Tento rámec se zobrazí a skryje připojený k vašemu tlačítku, když na něj kliknete levým tlačítkem myši.

Pokud chcete, aby vaše tlačítko reagovalo na kliknutí pravým tlačítkem myši kontextovou nabídkou, zajistěte, abyste buď nezapojili OnClick, nebo abyste po provedení vlastní práce zavolali TitanPanelButton_OnClick(arg1), aby kód Titanu mohl zachytit událost kliknutí pravým tlačítkem myši. Budete také muset definovat funkci s názvem TitanPanelRightClickMenu_Prepare(ID)Menu, která bude volat kombinaci funkcí pro sestavení menu pravým tlačítkem myši:

TitanPanelRightClickMenu_AddTitle(text, level?) Přidá zadaný text jako nadpis menu pravým tlačítkem myši. level, pokud je nastaven, určí úroveň vnoření menu. TitanPanelRightClickMenu_AddSpacer(level?) Přidá do nabídky pravého tlačítka myši vyplňovací mezeru. level, je-li nastaven, určí úroveň vnoření nabídky. TitanPanelRightClickMenu_AddToggleIcon(id) Přidá do nabídky pravého tlačítka myši možnost přepínání ikon. TitanPanelRightClickMenu_AddToggleLabelText(id) Přidá do nabídky pravého tlačítka myši možnost přepnutí textu popisku. TitanPanelRightClickMenu_AddToggleColoredText(id) Přidá do nabídky pravého tlačítka myši možnost přepínání barevného textu. TitanPanelRightClickMenu_AddCommand(text, value, funcname, level?) Přidá do nabídky pravého tlačítka myši funkci zpětného volání s daným textovým popiskem, argumentem a názvem funkce pro volání. Předdefinované funkce jsou TITAN_PANEL_MENU_FUNC_HIDE, která by měla mít text TITAN_PANEL_MENU_HIDE a hodnotu ID zásuvného modulu, který má být z panelu odstraněn. TitanPanelRightClickMenu_AddToggleVar(text, id, var, toggleTable?) Přidá možnost přepínání s textem popisku, pro proměnnou var plug-in id. Pokud je toggleTable, je to seznam možností, z nichž alespoň jedna musí být vždy nastavena.

Typickou kontextovou nabídku můžete sestavit snadno:

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

Všimněte si, že registr příkladu plug-inu neobsahoval žádné proměnné, takže tyto přepínače nebudou fungovat a mohou dokonce generovat chyby. Navíc nemá ani ikonu, ani nevrací popisek ze své metody GetButtonText, takže přepínače by neměly žádný účinek, i kdyby proměnné existovaly. Pouze příklad, vystřihněte a vložte na vlastní nebezpečí!

Historický odkaz