WOW原始UI代码分析【ActionButton】
开场白：
1、这是我分析WOW原始UI代码后，对一些比较关键的部分，记录下来的
2、文章里面如果有什么纰漏，希望大家毫不客气的提出来，我一定查究！
3、关于基础问题可以参考
WOW UI
《UI制作入门》http://www.pcgames.com.cn/netgames/zhuanti/wow/expert/Ui.htm
《WOW UI定制入门》http://202.113.13.169/site/mybbs/read.php?tid=33
《WOW插件制作指南》http://www.cnblogs.com/bluefee/archive/2005/04/14/137217.html
《ADDONS编写普及》http://wowbbs.game.mop.com/viewthread.php?tid=216755&extra=page%3D1
《动手写个属于自己的UI》http://wowbbs.game.mop.com/viewthread.php?tid=149814&fpage=1&highlight=
XML
《XML初学进阶》http://www.chinausd.com/code/code.asp?id=173/5058
《XMLSpy 2005 Enterprise Edition》http://www.altova.com/download_spy_enterprise.html
Lua
《Lua5.0参考手册中文版》http://www.cnblogs.com/bluefee/archive/2005/04/15/138576.html
《Lua 程序设计初步》http://bbs.battlecn.net/read.php?tid=541871&fpage=1
《通过例子学习Lua》http://www.wowtc.com/bbs/read.php?tid=4999&fpage=2
《Programming in LUA中文版》http://www.wowtc.com/bbs/read.php?tid=4998&fpage=2
《LuaEdit v2.5》http://luaforge.net/projects/luaedit/
4、关于如何提取MPQ文件，如何查看BLP图像，可以参考
《WoW Working Link》http://www.fukt.bth.se/%7Ek/wow/stuff/howto-extract-interface-files.txt
《Win MPQ》http://wow.duowan.com/2005-05-16/007R/26857843.html
《Win BLP Viewer》http://gamedown.yesky.com/game/108/108805.html
5、关于查询资料可以参考
《WoW Wiki》http://www.wowwiki.com/Interface_Customization/
《WOW APIs》http://www.cnblogs.com/bluefee/archive/2005/04/12/136270.html
《UI&Macro Forum》http://forums.worldofwarcraft.com/board.aspx?fn=wow-interface-customization
6、如果该问题是可以类推，或是从上下文能马上理解，或是从字面就知道含义的我就不罗嗦了
7、对于相同的问题我一般只分析一次，或是简要的提示一下，具体内容可以参考我以前的分析
8、如果你对自己查找资料的能力感到抱歉，可以E-mail向我询问，我会努力帮助你
9、联系方式E-mail: [email protected] Blog: blog.csdn.net/tcxxs QQ: 35548917
10、做人要厚道，转载请注明出处！
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
正式开始：
1、版本：1.7.1 (4659)
2、这次我写的是ActionbuttonTemplate.xml，ActionBarFrame.xml和ActionButton.lua
他们是动作按钮的基础UI，也是大家比较关心的一部分，在Interface/FrameXML里面
3、这次分析用到的名词解释：
【模板】学过C++语言的人都知道虚函数，实际上是一个道理，只是作为子代继承的规范，不可创建实例
【栅格】一个用来放置图标的格子，默认为无图标时隐藏，当然你也可以显示它
【额外栅格】包括了战士姿态，德鲁依外形，盗贼潜行的栅格
【栅格ID】每个栅格都有对应的ID，是该栅格的唯一标示
【图标】每个技能和物品，包括交易技能，食物，宏等都有一个可以拖动的图标
【动作键】当把图标放置到栅格上时，这个整体就叫动作键
【额外动作键】当把图标放置到额外栅格上时，这个整体就叫额外动作键
【动作条】一般12个栅格组成一排或者一列，称这个为动作条
【额外动作条】由12个额外栅格组成一排或者一列，称这个为额外动作条
【动作条ID】在默认动作条中每个动作条都有页码，是这个动作条的唯一标示
这里解释一下各个动作条的位置，主动作条包括1，2页
然后右边1，右边2，右下，左下依次为3到6页，栅格ID排列如图
61－72（左下）49－60（右下）37 25
（右边2） I I （右边1）
1－12（主AB）13－24（2页） 48 36
这里注意一个问题，为什么有的UI可以实现96个（FB,DUF等）或者更多呢
这是因为额外栅格的存在，这些UI把空闲的额外栅格加以利用罢了
调用这些额外栅格的动作键应该用其对应的函数
【闪动】当执行自动攻击或者自动射击技能时，改动作键就处于闪动状态
【CD】CoolDown的简写
【信息提示】即GameTooltip，当鼠标指向某个东西时显示的提示信息
【光环】包括buff，debuff，物品附加属性等
【arg1..N】arg为事件触发是传入的参数，可以为0到多个
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
源代码及注释
－－－－－－－－－－－－－－－－－－－－－－－ActionButtonTemplate.xml
【动作键】【模板】
背景层放置【图标】
层的从下到上为：BackGround，ArtWork，OverLay
【闪动】效果的纹理
该【动作键】的快捷键信息
该【动作键】数量信息
注意，这里没有Size标签，所以它为自动大小
该【动作键】名字，例如：宏的名字
直接应用【CD】模板，没有测试过，还望高人赐教，或者等我以后试
【图标】边框纹理，如果该【栅格】已放置【图标】，则显示这个纹理
若没有放置，则显示UI-Quickslot，它比UI-Quickslot2稍微小点
立体效果，而且UI-Quickslot的显示位置也依赖UI-Quickslot2
但是【图标】的实际放置位置却并不依赖这个位置，由BackGround层决定
点击【动作键】时的纹理
鼠标经过【栅格】时的纹理
等待施法时【栅格】的纹理，例如：你点击加血法术到选择目标那段时间显示
－－－－－－－－－－－－－－－－－－－－－－－－ActionBarFrame.xml
ActionButton_OnLoad();
ActionButton_OnEvent(event);
if ( IsShiftKeyDown() ) then
安住shift再点【动作键】，即拖拉【图标】
PickupAction(ActionButton_GetPagedID(this));
鼠标吸附该【图标】
else
否则执行该【动作键】命令
MacroFrame_EditMacro();
UseAction(ActionButton_GetPagedID(this), 1);
UseAction(slot [,checkCursor] [,onSelf])函数
slot参数为该【动作键】ID号
checkCursor参数为是否在其他事件中返回是鼠标点击，0或者1
onSelf参数为是否对自己施法，0或者1
end
ActionButton_UpdateState();
点击后应该更新【动作键】状态
if ( LOCK_ACTIONBAR ~= "1" ) then
如果【动作键】并未设定为锁定
PickupAction(ActionButton_GetPagedID(this));
ActionButton_UpdateState();
end
if ( LOCK_ACTIONBAR ~= "1" ) then
PlaceAction(ActionButton_GetPagedID(this));
PlaceAction，放下鼠标上吸附的【动作键】
注意，这里并不要求一定要放在栅格上，因为你可以摧毁一个【动作键】
ActionButton_UpdateState();
end
ActionButton_SetTooltip();
经过【动作键】时，显示【信息提示】
this.updateTooltip = nil;
GameTooltip:Hide();
ActionButton_OnUpdate(arg1);
更新【闪动】效果
下面定义了主【动作条】
MainMenuBarArtFrame，即默认最下面的一条工具栏，包括了主【动作条】，人物工具条，背包
但是注意，并不包括两旁的2只鹰的纹理
左下和右下的【动作条】都依据主【动作条】的位置
【信息提示】和【额外栅格】并不依据这个偏移,但是它会根据左下和右下【动作条】的出现而更改高度
若仅改变该偏移，则如果该人物有【额外栅格】，则人物的主【动作条】将会在原位又出现一个
－－－－－－－－－－－－－－－－－－－－－－－－ActionButton.lua
CURRENT_ACTIONBAR_PAGE = 1;
当前【动作条ID】
NUM_ACTIONBAR_PAGES = 6;
【动作条ID】总数
NUM_ACTIONBAR_BUTTONS = 12;
每个【动作条】的【动作键】数
ATTACK_BUTTON_FLASH_TIME = 0.4;
【闪动】效果时间间隔，为0.4S
BOTTOMLEFT_ACTIONBAR_PAGE = 6;
初始左下【动作条ID】
BOTTOMRIGHT_ACTIONBAR_PAGE = 5;
初始右下【动作条ID】
LEFT_ACTIONBAR_PAGE = 4;
初始右边2【动作条ID】
RIGHT_ACTIONBAR_PAGE = 3;
初始右边1【动作条ID】
-- Table of actionbar pages and whether they're viewable or not
VIEWABLE_ACTION_BAR_PAGES = {1, 1, 1, 1, 1, 1};
初始化为每页【动作条】都能够显示，0为隐藏
function ActionButtonDown(id)
实现按下【动作键】
if ( BonusActionBarFrame:IsVisible() ) then
如果是【额外动作键】
local button = getglobal("BonusActionButton"..id);
if ( button:GetButtonState() == "NORMAL" ) then
若未按下
button:SetButtonState("PUSHED");
end
return;
该函数用if-else是同样的
end
local button = getglobal("ActionButton"..id);
if ( button:GetButtonState() == "NORMAL" ) then
button:SetButtonState("PUSHED");
end
end
由上下2个函数可以看出，暴雪对【动作键】和【额外动作键】同样对待
这个也是其他UI可以利用【额外栅格】的基础
function ActionButtonUp(id, onSelf)
if ( BonusActionBarFrame:IsVisible() ) then
local button = getglobal("BonusActionButton"..id);
if ( button:GetButtonState() == "PUSHED" ) then
button:SetButtonState("NORMAL");
-- Used to save a macro
MacroFrame_EditMacro();
UseAction(ActionButton_GetPagedID(button), 0);
if ( IsCurrentAction(ActionButton_GetPagedID(button)) ) then
IsCurrentAction，等待施法，并不是正在吟唱
button:SetChecked(1);
设定该【动作键】正处于等待状态
else
button:SetChecked(0);
end
end
return;
end
local button = getglobal("ActionButton"..id);
if ( button:GetButtonState() == "PUSHED" ) then
button:SetButtonState("NORMAL");
-- Used to save a macro
MacroFrame_EditMacro();
UseAction(ActionButton_GetPagedID(button), 0, onSelf);
if ( IsCurrentAction(ActionButton_GetPagedID(button)) ) then
button:SetChecked(1);
else
button:SetChecked(0);
end
end
end
function ActionBar_PageUp()
CURRENT_ACTIONBAR_PAGE = CURRENT_ACTIONBAR_PAGE + 1;
local nextPage;
for i=CURRENT_ACTIONBAR_PAGE, NUM_ACTIONBAR_PAGES do
if ( VIEWABLE_ACTION_BAR_PAGES[i] ) then
如果该页能显示
nextPage = i;
break;
end
end
if ( not nextPage ) then
如果没有找到能够显示的下一页
CURRENT_ACTIONBAR_PAGE = 1;
else
CURRENT_ACTIONBAR_PAGE = nextPage;
end
ChangeActionBarPage();
这个函数变换将当主【动作条】变换到CURRENT_ACTIONBAR_PAGE指向的【动作条】
end
function ActionBar_PageDown()
CURRENT_ACTIONBAR_PAGE = CURRENT_ACTIONBAR_PAGE - 1;
local prevPage;
for i=CURRENT_ACTIONBAR_PAGE, 1, -1 do
if ( VIEWABLE_ACTION_BAR_PAGES[i] ) then
prevPage = i;
break;
end
end
if ( not prevPage ) then
for i=NUM_ACTIONBAR_PAGES, 1, -1 do
把“1”换成“CURRENT_ACTIONBAR_PAGE+1”也是可以的
把这个for循环对比ActionBar_PageUp的同一地方
可见，暴雪员工相当的肯定在上翻的时候第1页是可以显示的
而在下翻的时候显得信心不足，还重复检查了一次NUM_ACTIONBAR_PAGES到CURRENT_ACTIONBAR_PAGE
这是因为左下、右下AB的出现只是修改5，6页的可见性，并不影响1页的可见性
所以在下翻的时候需要对1到6页均做可见性检查
但是，重复检查的区间的确是多余的，估计是暴雪员工偷懒
因为“1”比“CURRENT_ACTIONBAR_PAGE+1”要好写得多
if ( VIEWABLE_ACTION_BAR_PAGES[i] ) then
prevPage = i;
break;
end
end
end
CURRENT_ACTIONBAR_PAGE = prevPage;
ChangeActionBarPage();
end
function ActionButton_OnLoad()
this.showgrid = 0;
显示空【栅格】的标志
this.flashing = 0;
处于【闪动】的标志
this.flashtime = 0;
【闪动】时间间隔计算的中间量
ActionButton_Update();
this:RegisterForDrag("LeftButton", "RightButton");
对this所指向的窗体注册鼠标拖拉行为，参数至少一个，也可以注册多个
参数为LeftButton，RightButton，表示使用某个鼠标键执行
this:RegisterForClicks("LeftButtonUp", "RightButtonUp");
对this所指向的窗体注册鼠标点击行为，参数至少一个，也可以注册多个
参数为LeftButtonDown，LeftButtonUp，RightButtonDown，RightButtonUp
注意，在OnClick标签中传入的arg1参数只返回LeftButton或者RightButton
this:RegisterEvent("PLAYER_ENTERING_WORLD");
this:RegisterEvent("UPDATE_BONUS_ACTIONBAR");
当【额外栅格】更新时触发
this:RegisterEvent("ACTIONBAR_SHOWGRID");
当拖拉【图标】时触发，arg1为LeftButton或者RightButton
this:RegisterEvent("ACTIONBAR_HIDEGRID");
当停止拖拉【图标】时触发
this:RegisterEvent("ACTIONBAR_PAGE_CHANGED");
this:RegisterEvent("ACTIONBAR_SLOT_CHANGED");
当【栅格】内容变更时触发，arg1为变更【栅格ID】
this:RegisterEvent("ACTIONBAR_UPDATE_STATE");
当【栅格】状态更新时触发，包括了【CD】和可用性鉴定
但是不包括自动攻击和自动射击事件
arg1为鼠标LeftButton，RightButton，也可能为nil
this:RegisterEvent("ACTIONBAR_UPDATE_USABLE");
当更新【图标】可用性后触发
this:RegisterEvent("ACTIONBAR_UPDATE_COOLDOWN");
当更新【CD】后触发
当【CD】开始的时候，arg1返回使用的鼠标按钮LeftButton或者RightButton
当【CD】结束的时候，arg1返回nil
this:RegisterEvent("UPDATE_INVENTORY_ALERTS");
当变更装备时或者经过一定时间后触发
this:RegisterEvent("PLAYER_AURAS_CHANGED");
当玩家【光环】改变时触发，包括了【光环】的消失和出现
注意，属性完全相同【光环】重复释放并不能触发该事件
this:RegisterEvent("PLAYER_TARGET_CHANGED");
当玩家的目标变更时触发，包括取消和选定目标
arg1为该目标持续时间，单位分钟，小数保留3位
this:RegisterEvent("UNIT_AURASTATE");
当某单位短时间【光环】改变时触发，需进一步测试
this:RegisterEvent("UNIT_INVENTORY_CHANGED");
当玩家装备变更时或者当观察玩家装备并发生装备变更时触发
this:RegisterEvent("CRAFT_SHOW");
this:RegisterEvent("CRAFT_CLOSE");
工艺窗口的显示与关闭，arg1为鼠标点击键
this:RegisterEvent("TRADE_SKILL_SHOW");
this:RegisterEvent("TRADE_SKILL_CLOSE");
交易技能制作物品窗口的显示与关闭，arg1为鼠标点击键
this:RegisterEvent("UNIT_HEALTH");
当任何一个单位的血量发生变化时触发，arg1参数为该单位ID
player，pet，target，mouseover，party1..4，partypet1..4，raid1..40，raidpet1..40，npc
注意，该事件拥有很高的优先级，特别当参数为player时
this:RegisterEvent("UNIT_MANA");
当任何一个单位的魔法量发生变化时触发，arg1参数为该单位ID
this:RegisterEvent("UNIT_RAGE");
当任何一个单位的怒气值发生变化时触发，arg1参数为该单位ID
this:RegisterEvent("UNIT_FOCUS");
当任何一个单位的焦距值发生变化时触发，arg1参数为该单位ID
注意，该事件实际上已经废除，因为现在猎人使用MANA，而不是FOCUS
this:RegisterEvent("UNIT_ENERGY");
当任何一个单位的能量发生变化时触发，arg1参数为该单位ID
this:RegisterEvent("PLAYER_ENTER_COMBAT");
当玩家进入自动攻击状态时触发，自动射击不包括在内
注意，仅当你使用自动攻击时触发该事件
使用其他任何技能或者攻击行为都不可触发
this:RegisterEvent("PLAYER_LEAVE_COMBAT");
离开自动攻击状态或者死亡时触发
this:RegisterEvent("PLAYER_COMBO_POINTS");
当连击点变更时触发，arg1总返回player，而并不时连击点数
this:RegisterEvent("UPDATE_BINDINGS");
当快捷键更改时触发
this:RegisterEvent("START_AUTOREPEAT_SPELL");
当自动射击开始时触发，而不是自动攻击
this:RegisterEvent("STOP_AUTOREPEAT_SPELL");
离开自动射击状态或者死亡时触发
ActionButton_UpdateHotkeys();
end
function ActionButton_UpdateHotkeys(actionButtonType)
if ( not actionButtonType ) then
actionButtonType = "ACTIONBUTTON";
end
local hotkey = getglobal(this:GetName().."HotKey");
该对象在模板中为Fontstring
local action = actionButtonType..this:GetID();
actionButtonType，为该类命令的名字
this:GetID，得到该命令在该类中的ID号
注意，这2个字符串组成了最终的命令的名字
如NUMPAD2，NUMPAD为类型，2为ID
但是有些类型就一个命令无ID，如LEFT
hotkey:SetText(KeyBindingFrame_GetLocalizedName(GetBindingKey(action), "KEY_"));
GetBindingKey得到命令的快捷键名字，后面加上KEY_是为了显示命令的字串
例如：KEY_NUMPAD2就显示为“数字键盘2”
KeyBindingFrame_GetLocalizedName，由这个函数在快捷键窗口中显示该命令的快捷键
end
function ActionButton_Update()
-- Special case code for bonus bar buttons
-- Prevents the button from updating if the bonusbar is still in an animation transition
if ( this.isBonus and this.inTransition ) then
ActionButton_UpdateUsable();
ActionButton_UpdateCooldown();
return;
end
local icon = getglobal(this:GetName().."Icon");
local buttonCooldown = getglobal(this:GetName().."Cooldown");
local texture = GetActionTexture(ActionButton_GetPagedID(this));
if ( texture ) then
icon:SetTexture(texture);
icon:Show();
如果该【栅格】有【图标】，即若为【动作键】则显示
this.rangeTimer = TOOLTIP_UPDATE_TIME;
每隔TOOLTIP_UPDATE_TIME事件间隔更新一次距离信息
TOOLTIP_UPDATE_TIME为0.2S
this:SetNormalTexture("Interface//Buttons//UI-Quickslot2");
-- Save texture if the button is a bonus button, will be needed later
if ( this.isBonus ) then
判断自己是否为【额外栅格】
this.texture = texture;
end
else
icon:Hide();
buttonCooldown:Hide();
this.rangeTimer = nil;
this:SetNormalTexture("Interface//Buttons//UI-Quickslot");
getglobal(this:GetName().."HotKey"):SetVertexColor(0.6, 0.6, 0.6);
end
ActionButton_UpdateCount();
if ( HasAction(ActionButton_GetPagedID(this)) ) then
判断该【栅格】是否有【图标】，即是否为【动作键】
this:Show();
ActionButton_UpdateState();
ActionButton_UpdateUsable();
ActionButton_UpdateCooldown();
ActionButton_UpdateFlash();
elseif ( this.showgrid == 0 ) then
this:Hide();
else
这里表示，当该【栅格】没有【图标】
但是显示空【栅格】选项开启时，不显示公共CD效果
buttonCooldown:Hide();
end
if ( GameTooltip:IsOwned(this) ) then
判断该【动作键】是否拥有【信息提示】
ActionButton_SetTooltip();
else
this.updateTooltip = nil;
end
-- Update Macro Text
local macroName = getglobal(this:GetName().."Name");
macroName:SetText(GetActionText(ActionButton_GetPagedID(this)));
GetActionText返回宏的名字
end
function ActionButton_ShowGrid(button)
if ( not button ) then
button = this;
end
button.showgrid = button.showgrid+1;
getglobal(button:GetName().."NormalTexture"):SetVertexColor(1.0, 1.0, 1.0, 0.5);
SetVertexColor（R,G,B）这个函数需要注意，可能学过3D的都知道，这个是顶点着色，取值0到1小数
顶点着色并不是直接设置RGB的数值，而是在原有的RGB数值上乘以顶点着色指定的RGB百分比修正值
例如：一个色块RGB为50，100，30，如果你写入SetVertexColor（0.5,0,1)，结果RGB为25，0，30
button:Show();
end
function ActionButton_HideGrid(button)
if ( not button ) then
button = this;
end
button.showgrid = button.showgrid-1;
if ( button.showgrid == 0 and not HasAction(ActionButton_GetPagedID(button)) ) then
把这里判断showgrid变量为0和这一对函数对showgrid的操作联系起来看
就像是用堆栈实现括号配对一样保证了显示和隐藏的规范
button:Hide();
end
end
function ActionButton_UpdateState()
if ( IsCurrentAction(ActionButton_GetPagedID(this)) or IsAutoRepeatAction(ActionButton_GetPagedID(this)) ) then
IsAutoRepeatAction，自动射击
IsAttackAction，自动攻击
this:SetChecked(1);
else
this:SetChecked(0);
end
end
function ActionButton_UpdateUsable()
注意，这个函数的主体是个技能按钮模板，所以针对的是一个【动作键】
所以，当你拖动某个【图标】时，其他【图标】并不会跟着更新
local icon = getglobal(this:GetName().."Icon");
模板中定义
local normalTexture = getglobal(this:GetName().."NormalTexture");
local isUsable, notEnoughMana = IsUsableAction(ActionButton_GetPagedID(this));
得到当前技能栅格的ID，这个是所有栅格ID号，包括73～96的
if ( isUsable ) then
是否在射程，当前在其他游戏规则中是否可用，是否在CD等
icon:SetVertexColor(1.0, 1.0, 1.0);
normalTexture:SetVertexColor(1.0, 1.0, 1.0);
elseif ( notEnoughMana ) then
是否足够魔法、怒气、能量
icon:SetVertexColor(0.5, 0.5, 1.0);
normalTexture:SetVertexColor(0.5, 0.5, 1.0);
else
icon:SetVertexColor(0.4, 0.4, 0.4);
这个是灰色效果，当你拖拉【图标】时，原【栅格】则为这个效果
normalTexture:SetVertexColor(1.0, 1.0, 1.0);
end
end
function ActionButton_UpdateCount()
local text = getglobal(this:GetName().."Count");
在模板中数量为Fontstring
if ( IsConsumableAction(ActionButton_GetPagedID(this)) ) then
判断是否改【栅格】的物品为消费品
text:SetText(GetActionCount(ActionButton_GetPagedID(this)));
else
text:SetText("");
end
end
function ActionButton_UpdateCooldown()
local cooldown = getglobal(this:GetName().."Cooldown");
在模板中该【CD】定义为一个Model
local start, duration, enable = GetActionCooldown(ActionButton_GetPagedID(this));
CooldownFrame_SetTimer(cooldown, start, duration, enable);
end
function ActionButton_OnEvent(event)
if ( event == "ACTIONBAR_SLOT_CHANGED" ) then
if ( arg1 == -1 or arg1 == ActionButton_GetPagedID(this) ) then
如果变更的【栅格】不明或者变更的【栅格】为自己则更新
ActionButton_Update();
end
return;
end
if ( event == "PLAYER_ENTERING_WORLD" or event == "ACTIONBAR_PAGE_CHANGED" ) then
总结起来是，当游戏环境有大的变化时，更新自己
ActionButton_Update();
return;
end
if ( event == "UPDATE_BONUS_ACTIONBAR" ) then
if ( this.isBonus ) then
ActionButton_Update();
end
return;
end
if ( event == "ACTIONBAR_SHOWGRID" ) then
ActionButton_ShowGrid();
return;
end
if ( event == "ACTIONBAR_HIDEGRID" ) then
ActionButton_HideGrid();
return;
end
if ( event == "UPDATE_BINDINGS" ) then
ActionButton_UpdateHotkeys();
return;
end
-- All event handlers below this line MUST only be valid when the button is visible
if ( not this:IsVisible() ) then
如果该【图标】不可见，那么直接返回，即下面的所有事件均要求该【图标】可见，即应该为一个【动作键】
return;
end
if ( event == "UNIT_HEALTH" or event == "UNIT_MANA" or event == "UNIT_RAGE" or event == "UNIT_FOCUS" or event == "UNIT_ENERGY" ) then
if ( arg1 == "player" ) then
如果发生在玩家身上，应该判断所有技能的可用性
ActionButton_UpdateUsable();
end
elseif ( event == "PLAYER_TARGET_CHANGED" or event == "PLAYER_AURAS_CHANGED" ) then
ActionButton_UpdateUsable();
elseif ( event == "UNIT_AURASTATE" ) then
if ( arg1 == "player" or arg1 == "target" ) then
ActionButton_UpdateUsable();
end
elseif ( event == "UNIT_INVENTORY_CHANGED" ) then
if ( arg1 == "player" ) then
ActionButton_Update();
end
elseif ( event == "ACTIONBAR_UPDATE_STATE" ) then
ActionButton_UpdateState();
elseif ( event == "ACTIONBAR_UPDATE_USABLE" or event == "UPDATE_INVENTORY_ALERTS" or event == "ACTIONBAR_UPDATE_COOLDOWN" ) then
ActionButton_UpdateUsable();
ActionButton_UpdateCooldown();
elseif ( event == "CRAFT_SHOW" or event == "CRAFT_CLOSE" or event == "TRADE_SKILL_SHOW" or event == "TRADE_SKILL_CLOSE" ) then
ActionButton_UpdateState();
elseif ( event == "PLAYER_ENTER_COMBAT" ) then
if ( IsAttackAction(ActionButton_GetPagedID(this)) ) then
ActionButton_StartFlash();
end
elseif ( event == "PLAYER_LEAVE_COMBAT" ) then
if ( IsAttackAction(ActionButton_GetPagedID(this)) ) then
ActionButton_StopFlash();
end
elseif ( event == "PLAYER_COMBO_POINTS" ) then
ActionButton_UpdateUsable();
elseif ( event == "START_AUTOREPEAT_SPELL" ) then
if ( IsAutoRepeatAction(ActionButton_GetPagedID(this)) ) then
ActionButton_StartFlash();
end
elseif ( event == "STOP_AUTOREPEAT_SPELL" ) then
if ( ActionButton_IsFlashing() and not IsAttackAction(ActionButton_GetPagedID(this)) ) then
如果该技能在【闪动】，并且不是自动攻击
ActionButton_StopFlash();
end
end
end
function ActionButton_SetTooltip()
if ( GetCVar("UberTooltips") == "1" ) then
Uber，乳房。。。。。
这句应该是判断是否属于一般类型，母类型
UberTooltips详细信息提示
GameTooltip_SetDefaultAnchor(GameTooltip, this);
一般位于屏幕右下角，会根据【动作条】的多少自动改变位置
else
如果这个【栅格】的【信息提示】不属于默认的形式则
if ( this:GetParent() == MultiBarBottomRight or this:GetParent() == MultiBarRight or this:GetParent() == MultiBarLeft ) then
【动作条】MultiBarBottomRight右下，MultiBarRight右方，MultiBarLeft左边下
GameTooltip:SetOwner(this, "ANCHOR_LEFT");
这里解释下SetOwner函数，GameTooltip:SetOwner(owner, anchor);
其中owner是参照物，anchor是对齐方式，取值如下：
ANCHOR_TOPRIGHT 相当于 SetPoint("BOTTOMRIGHT",object,"TOPRIGHT")
ANCHOR_RIGHT 相当于 SetPoint("BOTTOMLEFT",object,"TOPRIGHT")
ANCHOR_BOTTOMRIGHT 相当于 SetPoint("TOPLEFT",object,"BOTTOMRIGHT")
ANCHOR_TOPLEFT 相当于 SetPoint("BOTTOMLEFT",object,"TOPLEFT")
ANCHOR_LEFT 相当于 SetPoint("BOTTOMRIGHT",object,"TOPLEFT")
ANCHOR_BOTTOMLEFT 相当于 SetPoint("TOPRIGHT",object,"BOTTOMLEFT")
else
GameTooltip:SetOwner(this, "ANCHOR_RIGHT");
end
end
if ( GameTooltip:SetAction(ActionButton_GetPagedID(this)) ) then
SetAction，返回值为该【信息提示】是否需要实时更新
this.updateTooltip = TOOLTIP_UPDATE_TIME;
else
this.updateTooltip = nil;
end
end
function ActionButton_OnUpdate(elapsed)
if ( ActionButton_IsFlashing() ) then
this.flashtime = this.flashtime - elapsed;
if ( this.flashtime <= 0 ) then
flashtime初始为0，即第一次flash的时间并不为0.4，而是第一个elapsed决定
local overtime = -this.flashtime;
overtime，该函数的一个中间量，用语变化符号
if ( overtime >= ATTACK_BUTTON_FLASH_TIME ) then
这个if为了下面给flashtime更新是不出现负数考虑
注意，ERROR文本框的文本并不和这里的时间挂钩
overtime = 0;
end
this.flashtime = ATTACK_BUTTON_FLASH_TIME - overtime;
更新flashtime，使得从第二次开始间隔一个ATTACK_BUTTON_FLASH_TIME
local flashTexture = getglobal(this:GetName().."Flash");
if ( flashTexture:IsVisible() ) then
效果的实现即为反复显示这个flash纹理
flashTexture:Hide();
else
flashTexture:Show();
end
end
end
-- Handle range indicator
if ( this.rangeTimer ) then
if ( this.rangeTimer < 0 ) then
local count = getglobal(this:GetName().."HotKey");
if ( IsActionInRange( ActionButton_GetPagedID(this)) == 0 ) then
IsActionInRange，返回指定【动作键】是否在距离之内
返回nil表示该【栅格】无【图标】，或者没有选定目标
返回0表示不在距离之内，返回1表示在距离之内
注意，如果你没有试图释放这个【动作键】在目标身上，它可能总返回1
count:SetVertexColor(1.0, 0.1, 0.1);
else
count:SetVertexColor(0.6, 0.6, 0.6);
end
this.rangeTimer = TOOLTIP_UPDATE_TIME;
else
this.rangeTimer = this.rangeTimer - elapsed;
end
end
if ( not this.updateTooltip ) then
return;
end
this.updateTooltip = this.updateTooltip - elapsed;
if ( this.updateTooltip > 0 ) then
return;
end
if ( GameTooltip:IsOwned(this) ) then
ActionButton_SetTooltip();
else
this.updateTooltip = nil;
end
end
function ActionButton_GetPagedID(button)
if( button == nil ) then
message("nil button passed into ActionButton_GetPagedID(), contact Jeff");
严重错误需要弹出消息框
return 0;
end
if ( button.isBonus and CURRENT_ACTIONBAR_PAGE == 1 ) then
如果是【额外动作条】并且当前【动作条ID】为1
local offset = GetBonusBarOffset();
GetBonusBarOffset，得到【额外动作条】的偏移量
返回1到3，分别对应1到3号战士姿态，或者德鲁依外形，或者是盗贼状态
if ( offset == 0 and BonusActionBarFrame and BonusActionBarFrame.lastBonusBar ) then
应该是判断当意外失去【额外动作条】定位时，定位于最近一次改变的
注意，如果该职业无【额外动作条】时，偏移量也为0
offset = BonusActionBarFrame.lastBonusBar;
end
return (button:GetID() + ((NUM_ACTIONBAR_PAGES + offset - 1) * NUM_ACTIONBAR_BUTTONS));
注意NUM_ACTIONBAR_PAGES + offset用的是加法，所以我们肯定暴雪偷偷藏了24个【额外栅格】
elseif ( button:GetParent():GetName() == "MultiBarBottomLeft" ) then
return (button:GetID() + ((BOTTOMLEFT_ACTIONBAR_PAGE - 1) * NUM_ACTIONBAR_BUTTONS));
elseif ( button:GetParent():GetName() == "MultiBarBottomRight" ) then
return (button:GetID() + ((BOTTOMRIGHT_ACTIONBAR_PAGE - 1) * NUM_ACTIONBAR_BUTTONS));
elseif ( button:GetParent():GetName() == "MultiBarLeft" ) then
return (button:GetID() + ((LEFT_ACTIONBAR_PAGE - 1) * NUM_ACTIONBAR_BUTTONS));
elseif ( button:GetParent():GetName() == "MultiBarRight" ) then
return (button:GetID() + ((RIGHT_ACTIONBAR_PAGE - 1) * NUM_ACTIONBAR_BUTTONS));
else
return (button:GetID() + ((CURRENT_ACTIONBAR_PAGE - 1) * NUM_ACTIONBAR_BUTTONS))
end
end
function ActionButton_UpdateFlash()
local pagedID = ActionButton_GetPagedID(this);
if ( (IsAttackAction(pagedID) and IsCurrentAction(pagedID)) or IsAutoRepeatAction(pagedID) ) then
ActionButton_StartFlash();
else
ActionButton_StopFlash();
end
end
function ActionButton_StartFlash()
this.flashing = 1;
this.flashtime = 0;
ActionButton_UpdateState();
end
function ActionButton_StopFlash()
this.flashing = 0;
getglobal(this:GetName().."Flash"):Hide();
ActionButton_UpdateState();
end
function ActionButton_IsFlashing()
if ( this.flashing == 1 ) then
return 1;
else
return nil;
end
end
－－－－－－－－－－－－－－－－－－－－－总结一下
常量
TOOLTIP_UPDATE_TIME 【信息提示】更新间隔
CURRENT_ACTIONBAR_PAGE 当前【动作条ID】
NUM_ACTIONBAR_PAGES 总页码
NUM_ACTIONBAR_BUTTONS 一个【动作条】的【栅格】数
ATTACK_BUTTON_FLASH_TIME 【闪动】间隔
BOTTOMLEFT_ACTIONBAR_PAGE 左下【动作条ID】
BOTTOMRIGHT_ACTIONBAR_PAGE 右下【动作条ID】
LEFT_ACTIONBAR_PAGE 右边2【动作条ID】
RIGHT_ACTIONBAR_PAGE 右边1【动作条ID】
事件
ACTIONBAR_PAGE_CHANGED 【动作条】翻页
UPDATE_BONUS_ACTIONBAR 【额外动作条】更新
ACTIONBAR_SHOWGRID 显示【栅格】
ACTIONBAR_HIDEGRID 隐藏【栅格】
ACTIONBAR_SLOT_CHANGED 【栅格】内容变更
ACTIONBAR_UPDATE_STATE 【动作键】更新状态
ACTIONBAR_UPDATE_USABLE 【动作键】更新可用性
ACTIONBAR_UPDATE_COOLDOWN 【动作键】更新【CD】
UPDATE_INVENTORY_ALERTS 装备警告
PLAYER_AURAS_CHANGED 【光环】改变
PLAYER_TARGET_CHANGED 目标改变
UNIT_AURASTATE 单位【光环】改变
UNIT_INVENTORY_CHANGED 单位装备改变
CRAFT_SHOW 工艺窗口显示
CRAFT_CLOSE 工艺窗口隐藏
TRADE_SKILL_SHOW 交易技能窗口显示
TRADE_SKILL_CLOSE 交易技能窗口隐藏
UNIT_HEALTH 单位血量改变（优先级极高）
UNIT_MANA 单位魔法改变
UNIT_RAGE 单位怒气改变
UNIT_FOCUS 单位焦距改变（已废除）
UNIT_ENERGY 单位能量改变
PLAYER_ENTER_COMBAT 开始自动攻击
PLAYER_LEAVE_COMBAT 结束自动攻击
PLAYER_COMBO_POINTS 连击点改变
UPDATE_BINDINGS 快捷键更新
START_AUTOREPEAT_SPELL 开始自动射击
STOP_AUTOREPEAT_SPELL 结束自动射击
函数
IsShiftKeyDown Shift键是否按下
PickupAction 吸附【图标】
PlaceAction 放置【图标】
UseAction 使用【动作键】
GetButtonState 得到【动作键】状态
SetButtonState 设置【动作键】状态
Frame:RegisterForDrag 注册拖拉行为
Frame:RegisterForClicks 注册点击行为
GetBindingKey 得到快捷键
HasAction 【栅格】是否放置了【图标】
Frame:SetVertexColor 顶点色彩修正
IsAutoRepeatAction 是否正在自动射击
IsAttackAction 是否正在自动攻击
IsUsableAction 【动作键】是否可用
IsConsumableAction 是否为消费品
GetActionCooldown 得到【CD】
GetCVar 有待测试
GameTooltip:SetAction 设置【信息提示】
Frame:IsVisible 是否可见
IsActionInRange 是否在距离之内
GetBonusBarOffset 得到【额外动作条】偏移量
累死了。。。。。。明天再贴图片和排版彩色
http://wowbbs.game.mop.com/forumdisplay.php?fid=138
这个帖子我已经贴了图片