Titan Panel

Este artigo refere-se ao Código Google que será encerrado a 25 de Janeiro de 2016.

Titan Panel é uma interface AddOns que cria uma barra horizontal onde módulos plugin adicionais podem ser implantados exibindo todos os tipos de dados úteis, at-a-glance, do jogo. Está crescendo em popularidade devido a sua boa aparência, simplicidade e facilidade de criar plugins para serem exibidos dentro do painel.

Version 5 suporta uma variedade de diferentes localizações de barras. Eles são:

• 1 barra no topo
• 1 barra no fundo
• 1 barra no topo e 1 barra no fundo
• 1 barra no topo e 2 barras no fundo
• 2 barras no o topo
• 2 barras no fundo
• 2 barras no topo e 1 barra no fundo
• 2 barras no topo e 2 barras no fundo

Notícias

• Maio 1, 2009: HonorGoG publicou uma notícia no Portal do Painel Titan explicando uma mudança no licenciamento do Painel Titan da seguinte forma: “A Equipe de Desenvolvimento Titan mudou o licenciamento para o Painel Titan do implícito “Todos os Direitos Reservados” para uma licença limitada do BSD. Isto permitirá que a Equipe de Desenvolvimento Titan controle a distrubuição sob uma licença de código aberto. Todas as versões anteriores que afirmavam ser GPLv3 eram, de fato, “Todos os Direitos Reservados”, pois o texto necessário para o licenciamento GPLv3 não estava incluído na distribuição. Por favor, tenha isto em mente se você encontrar uma versão que afirma ser uma cópia licenciada da GPLv3 do Painel Titan, pois não é suportada pela Equipe de Desenvolvimento Titan e é uma violação dos nossos direitos autorais. Para detalhes adicionais de licenciamento, consulte o arquivo license.txt incluído na distribuição” ref
• 29 de novembro de 2008: HonorGoG postou a última versão do Painel Titan sobre a Maldição declarando “Temos trabalhado com a equipe da Maldição para ajudar a desenvolver um processo mais simplificado para autores addon que não mantêm uma presença no CurseForge SVN. Houve várias melhorias dramáticas que nos permitiram devolver o Titan Panel à Maldição sem que isso se tornasse um fardo como no passado” ref
• 17 de outubro de 2008: HonorGoG citou a razão para a remoção do Titan da Maldição como “A Maldição é actualmente demasiado instável para que possamos manter uma cópia neste site”. mais explicações dentro da área de comentários da Maldição do Titan por HonorGoG explicam “…eles iniciam um enorme esforço de migração para fundir a WoWAce e a Maldição com a MaldiçãoForge como o seu back-end mesmo antes do lançamento 3.0. Desculpe, mas não precisamos desse nível de dor”. Maldição
• Outubro 15, 2008: A equipa de desenvolvimento do Titan já não actualiza os addons no site curse.com ou nos afiliados. Nenhuma razão especificada. ref
• Dezembro de 2007: O Painel Titan foi adoptado pela Equipa de Desenvolvimento Titan com o esforço de desenvolvimento alojado no Google Code.

Histórico de lançamento

Author history

• Os novos autores do renovado Titan Panel são a Equipe de Desenvolvimento Titan, composta por: HonorGoG, Urnati, Joejanko, Lothaer, oXidFoX, pato.daia, Stingersoft & YeaChan. Você pode encontrar seu trabalho no Google Code
• Autores que deixaram a Equipe de Desenvolvimento Titan: jaketodd422, & trisTitan
• O autor do addon Titan 2 foi Adsertor @ UI.WWN.
• O autor de algumas atualizações e correções de bugs foi Dark Imakuni @ Curse (@ UI.WWN).
• O autor do addon Titan foi TitanMod @ Curse (@ UI.WWN).

Versões anteriores do autor

• Versão anterior do Adsertor: 3.1.1
• Pasta versão por Dark Imakuni: 1.3
• Pasta versão por TitanMod: pesquisa necessária

URLs

• v5.x.x URL: Código Google, Interface WoW e Maldição
• v4.x.x URL: Código do Google, Interface WoW e Maldição
• v3.1.1 URL: Maldição
• v3.1.1 URL: http://www.filebase.info (espelho como o site principal está quase em baixo quando o dia do patch é)
• 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

Telas

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

Incluído plugins Titan

Versão 5

Pendente…

Versão 4

Pendente…

Versão 3

A iteração final da versão 3 do Titan continha os seguintes plugins dentro da distribuição do núcleo:

Lista de plugins Titan

Nome	Descrição
TitanAmmo	Contagens de munições de exibição
TitanBag	Salão deixado em sacos
TitanClock	relógio com compensação para o seu verdadeiro fuso horário
TitanCoords	Localização das peças, mais as coordenadas. Não vai funcionar dentro de instâncias
TitanGoldTracker	displays money count
TitanXP	displays XP and tooltip with more information
TitanVolume	Volume deslizante para o volume principal
TitanLootType	Displays party loot settings
TitanPerformance	Shows the Performance data of WoW. Uso de memória por IU, tempo de coleta de lixo, fps, latência
TitanUIScale	Dispositivo para escalar o Painel Titã e os elementos gerais da IU
ItemBonuses	Mostra o bónus total dado por itens para cada stat
Regen	Mostrar a quantidade de HP e Mana regenerados por tick
Repair	Shows the current/max durability of each item you are currently wearing and the money needed to repair them

Version 2

As of Version 2, Adsertor adicionou muitos plugins de terceiros na Distribuição Principal do Painel Titan. Cada vez que uma nova versão destes plugins for lançada, uma nova versão de Titan será lançada também (em teoria).

>

>

>

>

>

>

>

Lista de Plugins Titan

Nome	Versão	Última Atualização	Autor	Descrição
TitanAmmo	2.04	–	TitanMod	como mostra contagens de munições
TitanBag	2.04	–	TitanMod	show room left in bags
TitanClock	2.04	–	TitanMod	relógio com offsets para o seu verdadeiro fuso horário
TitanCoords	2.04	–	TitanMod	>Localização das exibições, mais coordenadas. Não funciona dentro de instâncias
TitanMoney	2.04	–	TitanMod	displays money count
TitanXP	2.04	–	TitanMod	displays XP e tooltip com mais informações
TitanVolume	2.04	–	TitanMod	Volume deslizante para o volume principal
TitanLootType	2.04	–	TitanMod	Displays party loot settings
TitanPerformance	2.04	–	TitanMod	Shows the Performance data of WoW. Uso de memória por IU, tempo de coleta de lixo, fps, latência
TitanUIScale	2.04	–	TitanUIScale	Dispositivo para escalar o Painel Titã e os elementos gerais da IU
HonorPlus	r10.1700	9/22/05	Swiftstab	Shows Honor Information on the Titan Panel
ItemBonuses	0.9	10/12/05	CrowleyAJ	Mostra o bónus total dado por itens para cada stat
Regen	1700	9/21/05	skeetskeet	Mostrar a quantidade de HP e Mana regenerados por tick
Repair	0.2	7/18/05	LumpN	Mostra a durabilidade atual/máxima de cada item que você está usando atualmente e o dinheiro necessário para repará-los

Versão 1.X

Para começar com o Painel Titan, o autor incluiu vários plugins com o lançamento da estrutura:

• TitanAmmo – mostra a contagem de munições
• TitanBag – mostra o espaço deixado em sacos
• TitanClock – relógio com offsets para o seu verdadeiro fuso horário
• TitanCoords – mostra a localização, mais coordenadas
• TitanFPS – mostra FPS codificado por cores na barra
• TitanLatency – mostra latência codificada por cores na barra
• TitanHonor – exibe as estatísticas do seu PvP
• TitanMoney – exibe a contagem de dinheiro
• TitanXP – exibe XP e ponta de ferramenta com mais informações
• TitanVolume – deslizador de volume
• TitanLootType – exibe configurações de saque de festas
• TitanMemory – exibe uso de memória
• TitanUIScale – controle deslizante para escalar o Painel Titan e os elementos gerais da IU

Outros plugins Titan

Sites

Titan Panel Portal é o local para informações atuais sobre o desenvolvimento do Painel Titan. Uma lista dos plugins Titan disponíveis está pendente.

DrainingSouls.net tem uma lista completa e atualizada dos mods Titan Panel disponíveis. Foi actualizada pela última vez em Maio de 2008, para o Patch 2.4.

Query UI.worldofwar.net para plugins. Mais rápido que Maldição, apenas não tão “popular”.

Titan Plugin Listing mantido por Sepioth. Esta lista é ótima mas não foi atualizada desde julho de 2005.

Links para AddOns

Uma lista de plugins compatíveis com Titan Panel 4.0 estará disponível em breve no Titan Panel Portal.

Suggestions

A Equipe de Desenvolvimento Titan solicitou que todas as sugestões fossem inseridas como um problema no site do Google Code.

Recolha de lixo

Pode forçar uma recolha de lixo dentro do Painel Titan clicando com o botão esquerdo do rato no botão TitanPerformance.

Mudanças recentes para programadores

Pendente…

Guia do desenvolvedor

Se você quiser criar seu próprio plug-in para painel Titan, você deve obter o kit do desenvolvedor Titan Panel para alguns exemplos simples.

A anatomia geral de um botão do painel Titan é bastante simples. Há o próprio botão, que é o que aparece no painel Titã. Estes podem ser texto, ícones, texto e ícones combinados, ou outras molduras de IU arbitrariamente complexas. Cada botão tem um menu de contexto, uma dica de ferramenta e muitas vezes uma janela de controle.

Você define o botão no seu XML como você pode esperar:

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

O botão deve ter um gancho OnLoad para configurar os detalhes do plug-in, e deve chamar a função original TitanPanelButton_OnLoad() para se inserir na lista de plug-ins conhecidos do Painel. O modelo a herdar depende do tipo de plug-in que você deseja criar:

TitanPanelButtonTemplate O modelo básico; tem um menu de clique direito, e manipuladores padrão para OnLoad, OnShow, OnClick, OnUpdate, OnEnter, e OnLeave, mas não tem como exibir nada. Se você usar este modelo, você deve adicionar frames filhos para fazer algo. TitanPanelTextTemplate Um botão básico do painel Titan com uma string de texto. Use isto se você não tiver nenhum ícone e nada mais complexo do que uma string de texto para exibir. TitanPanelIconTemplate Um botão básico do painel Titan com um ícone. Use-o se você só tiver um ícone. Os botões do painel Titan com apenas um ícone serão exibidos no lado direito do painel Titan. O ícone de entrada de registo determina a textura utilizada, e o iconWidth determina a largura do ícone. TitanPanelComboTemplate Um botão do painel Titan com um ícone e uma cadeia de texto. Use-o quando quiser exibir uma cadeia de texto com um ícone opcionalmente visível ao lado dele. A variável Titan ShowIcon irá determinar se o ícone aparece, e o ícone de entrada de registoButtonWidth irá determinar o espaço reservado para o ícone.

Dois outros dois modelos também estão disponíveis como uma ajuda, mas não deve ser usado como um botão de nível superior Titan Panel:

TitanPanelChildButtonTemplate Um botão filho dentro de um modelo de botão dos pais. Use isto para adicionar mais de um botão a uma instância TitanPanelButtonTemplate; você deve conectar o evento OnClick se quiser que os botões dos seus filhos exibam um comportamento diferente ao dos pais. TitanOptionsSliderTemplate Um modelo para que os botões deslizantes verticais possam ser usados nas janelas de controle.

No seu método OnLoad, antes que o botão TitanPanelButton_OnLoad() seja chamado, você deve configurar o registro do botão. Esta é uma tabela que define como o botão aparece e funciona dentro do Painel, e tem os seguintes campos:

id Um ID de string para o plug-in. buildIn Configure para 1 para aparecer no menu built-ins. menuText Label para menu de alternância de plug-in. buttonTextFunction O nome de uma função para chamar para obter o texto do botão; deve retornar até quatro pares de etiqueta, valor. Se apenas uma única string é retornada, ela é sempre exibida. Se uma etiqueta e um valor, ou mais de uma etiqueta e um valor, forem retornados, as etiquetas só serão exibidas se a variável ShowLabelText for verdadeira. As etiquetas e os valores não são separados por Titan, por isso deve certificar-se que o texto da etiqueta inclui alguma separação (por exemplo, retornar “Label: “, “value”). tooltipTitle A linha de título da tooltip do plug-in. tooltipTextFunction O nome de uma função que deve retornar o texto a ser exibido na tooltip do plug-in, abaixo da linha de título. tooltipCustomFunction O nome de uma função que deve ser chamada quando o GameTooltip deve ser actualizado para este plug-in. icon Um nome de textura para o ícone deste plug-in. iconWidth A largura, em pixels, da textura do ícone. A largura padrão é de 16 pixels. iconButtonWidth A largura, em pixels, de um ícone ou botão de combinação. Se a variável ShowIcon for verdadeira, esta largura será adicionada a um botão de combinação e o ícone será exibido. Os botões de ícone sempre mostrarão seu ícone; se esta largura não for definida, a largura do ícone será usada. savedVariables Uma tabela de variáveis (chave, padrão) de listagem de dados para salvar por usuário para este plug-in. As variáveis podem ser acessadas através de TitanGetVar(id, key) e TitanSetVar(id, key, value). As variáveis ShowIcon e ShowLabelText são entendidas por Titan Panel. Os valores padrão de nil devem usar TITAN_NIL, já que os valores da tabela lua não podem ser nil. freqüência O intervalo, em segundos (ponto flutuante), entre atualizações. Quando esse intervalo (ou mais) tiver decorrido, uma função de atualização de botão ou ponta de ferramenta, ou ambas, serão chamadas, de acordo com updateType. updateType One of TITAN_PANEL_UPDATE_TOOLTIP, TITAN_PANEL_UPDATE_BUTTON ou TITAN_PANEL_UPDATE_ALL (padrão). Determina quais funções de atualização serão chamadas a cada segundo de freqüência.

Movendo para o nosso método OnLoad do plugin de exemplo. Você deve pelo menos fornecer as entradas id e menuText, embora normalmente você queira fornecer mais:

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: Se você pretende usar o modelo TitanPanelIconTemplate, você também deve ter certeza de inserir uma nova entrada na tabela TITAN_PANEL_NONMOVABLE_PLUGINS, no seu método OnLoad, contendo o id do seu plugin, por exemplo tinsert(TITAN_PANEL_NONMOVABLE_PLUGINS, “MyAddonid”).

Com apenas este código, você deve ter um plug-in Titan Panel que simplesmente mostra “Example”.

Se você quiser que ele responda aos cliques esquerdos, você precisa ou enganchar o evento OnClick para fazer o que você quer, ou criar um frame chamado TitanPanel(ID)ControlFrame, onde (ID) é o id do seu plug-in (por exemplo, TitanPanelExampleControlFrame). Este frame será mostrado e escondido anexado ao seu botão quando ele for clicado com o botão esquerdo.

Se você quiser que seu botão responda aos cliques do botão direito com um menu contextual, assegure-se de que você não prende OnClick ou que você chama TitanPanelButton_OnClick(arg1) depois de fazer seu próprio trabalho, para que o código do Titan possa capturar o evento do clique direito. Você também precisará definir uma função chamada TitanPanelRightClickMenu_Prepare(ID)Menu, chamando uma combinação das funções de construção do menu com o botão direito do mouse:

TitanPanelRightClickMenu_AddTitle(text, level?) Adiciona o texto dado como título do menu com o botão direito do mouse. level, se definido, determinará o nível de aninhamento do menu. TitanPanelRightClickMenu_AddSpacer(level?) Adiciona um espaço de preenchimento ao menu com o botão direito do rato. level, se estiver definido, determinará o nível de aninhamento do menu. TitanPanelRightClickMenu_AddToggleIcon(id) Adiciona uma opção de alternância de ícones ao menu de clique do lado direito. TitanPanelRightClickMenu_AddToggleLabelText(id) Adiciona uma opção de alternância de texto de etiqueta para o menu de clique direito. TitanPanelRightClickMenu_AddToggleColoredText(id) Adiciona uma opção de alternância de texto colorido ao menu de clique com o botão direito. TitanPanelRightClickMenu_AddCommand(text, value, funcname, level?) Adiciona uma função de retorno de chamada ao menu com o botão direito do rato, com a etiqueta do texto dado, argumento e nome da função a chamar. As funções predefinidas são TITAN_PANEL_MENU_FUNC_HIDE, que deve ter um texto de TITAN_PANEL_MENU_HIDE e um valor do ID do plug-in para remover do painel. TitanPanelRightClickMenu_AddToggleVar(text, id, var, toggleTable?) Adiciona uma opção toggle com texto de etiqueta, para a variável var do plug-in id. Se toggleTable estiver presente, é uma lista de opções, pelo menos uma das quais deve estar sempre definida.

Você pode construir um menu de contexto típico facilmente:

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

Note que o registro do plug-in de exemplo não incluiu nenhuma variável, então estas alternâncias não funcionarão, e podem até gerar erros. Além disso, ele não tem um ícone nem retorna uma etiqueta de seu método GetButtonText, então as alternâncias não teriam efeito mesmo que as variáveis existissem. Apenas como exemplo, corte e cole por sua conta e risco!

Referência histórica