The Noob says: Huh? What is a SecureUnitButtonTemplate?

Arachiel · 08-24-07, 04:34 PM

Hello!

First of all: My deep respect to all you who already programmed an Addon and thank you for your great work!
You inspired me to try programming myself, even though I didn't have ANY idea of XML, LUA or ANY programming language at all (i still don't get it -_-).
To cut things short: I sat down with all guidance gained and tried programming an Addon which would add a button to the UI that could be pressed to set "focus" on the current target or does nothing if the player didn't have a target. If pressed again the player would "clear" his "focus".
After hours messing with XML and Photoshop (completing the needed graphics and setting up the XML file) I finally started to work on (an until then empty) LUA file and though:
"Oookeeh. All you need is the proper API function and then find out how it works. Let's search WoWWiki for the API-List."
"Aaah, there it is. FocusUnit("unit") - Perfect! ....... What does "PROTECTED" mean?"
"AIIIEEE!!! Does that mean I can't program the button, because of some stupid bots?!?"
"AAAIIIIIEEEE!!! All my labor was in vain!?!?"
"Wait a second - there is a link to 'API Secure Templates'."
"...."
".... I don't get it." *bursts into tears*

Although my tears have dried by now, I still don't have the slightest idea how to go on with the addon - supposed i CAN continue!
My question would be: Is it possible to make the Addon I planned? How do I use the SecureUnitButtonTemplate? I couldn't make that out from WoWWiki alone.

I'm sorry to bother you all with my inferiority, but I just didn't want the whole day to go to waste. Thank you for the trouble reading my post. >_<

PS: I don't know wether this interests or bugs you but here is the XML I made so far.

<Script file="FocusEye.lua"/>

<Button name="FocusButton" parent="UIParent" toplevel="true" hidden="false" enableMouse="true" movable="true">
<NormalTexture file="Interface\AddOns\FocusEye\Focussed"/>
<DisabledTexture file="Interface\AddOns\FocusEye\Clear"/>
<Size>
<AbsDimension x="20" y="20"/>
</Size>
<Anchors>
<Anchor point="TOPRIGHT"/>
<Offset>
<AbsDimension x="-200" y="-200"/>
</Offset>
</Anchor>
</Anchors>

<Scripts>
<OnClick>
FocusToggle();
</OnClick>
</Scripts>

</Button>

The LUA didn't develop at all, since I don't know which function to use/since I'm afraid everything was good for nothing...

function FocusToggle()
if
elseif
end
end

Lousy, right? Sorry to get on your nerves.

PPS: Sorry about my warped english!

mulesh · 08-25-07, 07:38 AM

You could do this soooo much easier by making a simple focus macro.

Code:

/clearfocus [button:RightButton] [target=focus, dead] [target=focus, noexists]
/focus [target=focus, noexists]

If you have a target it will make it your focus, if your focus doesnt exist it will clear, if your focus is dead it will clear, if you right-click it will clear.

Arachiel · 08-25-07, 12:14 PM

Why thank you!
Yet that is my current status. The reason why I want to make this an AddOn is the quicker dispersion among friends and the fact I can make the Button look different if "focus" is active or not. Also I want to do it as a exercise to learn programming WoW-Stuff. ^-^

By the way - i refrained from using the already postet XML, since I'm starting to understand the SecureUnitButtonTemplate (yes, my working day was boring). I will edit this post, when I can show my progress without ashaming myself again.
Thank you for your answer Mulesh!

^.^

**Seerah** · 08-25-07, 05:19 PM

I'm not a coder, but I was under the impression you had to use XML for secure buttons - is this incorrect?

mulesh · 08-25-07, 06:17 PM

I think this will work, havent play-tested it, but I have a good feeling

XML file:

Code:

<Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/
..\FrameXML\UI.xsd">

<Script file="FocusEye.lua"/>

<Button name="FocusButton" parent="UIParent" toplevel="true" hidden="false" enableMouse="true" movable="true" inherits="SecureActionButtonTemplate">
  <Layers>
    <Layer level="ARTWORK">
      <Texture name="MyTexture" file="Interface\AddOns\FocusEye\Clear"/>
    </Layer>
  </Layers>
  <Size>
    <AbsDimension x="20" y="20"/>
  </Size>
  <Anchors>
    <Anchor point="TOPRIGHT"/>
      <Offset>
        <AbsDimension x="-200" y="-200"/>
      </Offset>
    </Anchor>
  </Anchors>

  <Scripts>
    <OnLoad>this:RegisterForDrag("LeftButton"); thisRegisterForClicks("LeftButtonUp");
    <OnClick>FocusToggle();</OnClick>
    <OnDragStart>this:StartMoving();</OnDragStart>
    <OnDragStop>this:StopMovingOrSizing();</OnDragStop>
    <OnEnter>FocusEnter();</OnEnter>
    <OnLeave>FocusLeave();</OnLeave>
  </Scripts>

</Button>
</Ui>

LUA file:

Code:

function FocusToggle()
  if UnitExists("focus") then
    FocusUnit("none");
    FocusButton:SetTexute(Interface\AddOns\FocusEye\Clear);
  elseif UnitExists("target") then
    FocusUnit("target");
    FocusButton:SetTexture(Interface\AddOns\FocusEye\Focussed);
  end
end

function FocusEnter()
  GameTooltip:SetOwner(this, "ANCHOR_RIGHT");
  GameTooltip:SetText("Focus\nLeft-Click to set focus");
  GameTooltip:Show();
end

function FocusLeave()
  GameTooltip:Hide();
end

I added some tooltip code and some script events for dragging.

Good luck!

Arachiel · 08-28-07, 02:39 PM

Thank you for your help, Mulesh.
Alas, as I mentioned earlier the "FocusUnit()" command does not work anymore. Therefore your beautiful coding has been for nougth. T_T
I also think Seerah is right. I tried messing with the LUA again, but nothing good came from it. Therefor I simply left it blank and voilá: The XML worked even without it.

The last few days I spend my (little) free time trying to understand the Templates and I think, the UnitTemplate only acts as a UnitFrame (I am possibly wrong T_T) and can only make the current target my focus. But until now I haven't found any way to clear focus via UnitTemplate.

Instead I stumbled across the "Macro"-Attribute for the ActionTemplate.
I am using the following Macro to set and clear my focus:

Code:

/focus [target=focus, noexists]; [target=none, noexists][target=none]

When I click the Button and no focus is set, it will be set. If focus=true, it will clear focus.

I embedded this macro into the ActionTemplate...

Code:

<Button name="FocusButton" inherits="SecureActionButtonTemplate">
	<Size>
		<AbsDimension x="36" y="36"/>
	</Size>
	<Anchors>
		<Anchor point="CENTER"/>
	</Anchors>
	<NormalTexture>
		<Color r="1" g="0" b="0" a="0.5"/>
	</NormalTexture>
	<Scripts>
		<OnLoad>
        FocusButton:SetAttribute("type1", "macro")			
        FocusButton:SetAttribute("macrotext", "/focus [target=focus, noexists]; [target=none, noexists][target=none]")
        </OnLoad>
	</Scripts>
</Button>

To my surprise, it did not work! Neither do the conditionals "modifier" or "button" work, since the Button does only accept leftclicks.
I once more reached my limit and have no idea what to do...
Would you mind looking at "my" code and help me?
I hope I don't get on your nerves.... -_-

Arachiel · 08-30-07, 01:28 AM

YAHOOO!

I did it! It works!
I just had to remove the ";" in "/focus [target=focus, noexists]; [target=none, noexists][target=none]" and now it works!
Superb!
Now I have to implement the graphics and move it away from the center. But that should be a piece of cake, considering the help here and HOWTOs elsewhere.
Thank you for reading this. ^-^

Jazradel · 08-30-07, 01:50 AM

That's not really very elegant. Can't check the documentation, but:
SetAttribute("focus","target")
Would achieve it wouldn't it?

Arachiel · 08-30-07, 06:14 AM

It's not that I don't want to be elegant. I just wanted a solution. I'm sure, that there are BETTER solutions, but I haven't found it. Hey - I'm a noob after all. ^0^

Btw. SetAttribute("focus","target") does not work. Just tested it. T_T