上篇开启了一个新的插件系列,从零开始记录插件winda的制作过程;在上期中,我们在游戏的插件列表里, 正确显示了winda;
之后给它添加了一些基本的描述, 视频最后还打印了字符串,证明我们的插件运行完好;
宏命令/wd
今天我们来给插件做第一个交互,宏命令/wd
魔兽世界的宏实际就是游戏功能的一种封装,可以利用宏来方便的实现一些游戏特定的功能;例如我们常用的
/use 物品
代表使用某个道具或者装备
/cast 技能
代表使用某个法术
魔兽世界中的宏是添加了一种与游戏内功能便捷交互的方式,方便玩家与插件做沟通;再深层次的解释就是用宏代替代码的功能;
下面的宏会打印一串文字:
-- 宏命令
-- 下面两句用于定义宏命令
SLASH_WINDA1 = "/wd"
SLASH_WINDA2 = "/winda"
-- 下面用来定义宏命令的事件
SlashCmdList["WINDA"] = function()
print("Hello, winda!")
end
** 需要注意的点是SLASH_后面接的WINDA,与下面部分括号中的“WINDA”要一致;SLASH_WINDA后面的数字也是必须的,这样可以设置多个宏命令来完成同一个功能**
写完后保存,在聊天栏输入/wd,即会出现我们的显示文字;
创建空白窗口
上面的例子可能还不太够直白,我们来添加一个可以显示的窗口演示它;
使用CreateFrame创建一个窗口,下面一段代码可以创建窗口;
下面代码中 -- 后面的为注释部分,在代码中不起作用,为解释部分,作文档用
-- 创建一个可以显示的框
local f = CreateFrame("Frame", "WindaGUI", UIParent, "BackdropTemplate")
-- 设置大小
f:SetWidth(200)
f:SetHeight(200)
-- 设置框的层级和位置
f:SetFrameLevel(1)
f:SetPoint("CENTER", 0, 0)
f:SetFrameStrata("HIGH")
-- 为显示框添加背景和边缘材质
f:SetBackdrop({
bgFile = "Interface/Tooltips/ChatBubble-Background",
edgeFile = "Interface/Tooltips/UI-Tooltip-Border",
tile = false,
tileEdge = false,
tileSize = 0,
edgeSize = 1,
insets = { left = 1, right = 1, top = 1, bottom = 1 }
})
-- 上面的文件路径将在之后的文章会讲到
-- 如何使用系统资源来完成纹理加载
-- 设置边缘颜色,
f:SetBackdropBorderColor(0, 0, 0, 1)
-- 默认情况下是显示的状态,这里将它隐藏
f:Hide()
通过以上代码创建了一个叫做f的窗口, f可以控制该窗口的所有操作,默认情况下f是显示的,这里先将它隐藏;
宏命令事件
接下来在宏命令的事件中,添加一个逻辑,输入/wd就显示窗口,再次输入就隐藏,像下面这样
SlashCmdList["WINDA"] = function()
if f:IsShown() then -- 如果f是显示的
f:Hide() -- 将f隐藏
print("窗口消失")
else -- f未显示
f:Show() -- 将f显示
print("窗口出现")
end
end
为了方便观察,我们不妨分别在显示和隐藏时, 打印相应的文字,如上;
于是,宏命令的交互便产生了
小地图按钮
我们再来添加一个小地图按钮,完成跟刚才一样的操作; 小地图按钮可以如下面这样写;
第一段创建一个小地图按钮,绑定在小地图上:
-- 小地图按钮
local mf = CreateFrame("Button", "MiniMapButton", Minimap)
mf:SetWidth(32)
mf:SetHeight(32)
mf:SetFrameStrata("LOW")
mf:Raise()
mf:SetPoint("TOPLEFT", Minimap, "BOTTOMLEFT", 0, 0)
-- 设置普通情况下材质显示以及高亮状态下的材质显示
-- 括号中的是文件路径,与上面的f中提到的同为系统文件
-- 之后会详细讲如何使用系统材质
mf:SetNormalTexture("Interface\\BUTTONS\\UI-Quickslot-Depress")
mf:SetHighlightTexture("Interface\\buttons\\iconborder-glowring")
第二段我们为小地图按钮添加一个可见的图标
-- 创建小地图上的图标
local icon = mf:CreateTexture(nil, "BACKGROUND")
icon:SetWidth(32)
icon:SetHeight(32)
icon:SetPoint("CENTER", mf, "CENTER", 0, 0)
icon:SetTexture("Interface\\Icons\\INV_Misc_Coin_08")
mf.icon = icon
当鼠标划过小地图时,我们还要显示一些提示,这个功能由第三段代码完成
-- 按钮上的提示
mf:SetScript("OnEnter", function()
GameTooltip:SetOwner(mf, "ANCHOR_LEFT")
GameTooltip:AddLine("|cff1eff00左键:|r 隐藏/显示")
GameTooltip:Show()
end)
mf:SetScript("OnLeave", function()
GameTooltip:Hide()
end)
最后第四段为点击小地图图标添加功能,该功能跟前面的宏命令的内容是一样的
-- 按钮点击
mf:SetScript("OnClick", function()
if f:IsShown() then
f:Hide()
print("窗口消失")
else
f:Show()
print("窗口出现")
end
end)
以上
总结一下今天的成果,本节中我们为winda创建了自己的宏命令;当使用宏命令时,可以显示我们自己创建的窗口,同时我们还创建了小地图图标,完成了与宏命令同样的交互功能;
这里是WoWer的空间,喜欢的朋友记得点点关注呀!!!
我在听风,也在等你