Texture:SetMask()

[zork]

Since when do we have this function?
http://wowprogramming.com/docs/widgets/Texture/SetMask

Is it a new api function in legion?

Until now we only had function to mask minimap textures.

[semlar]

Heh, I knew this sounded familiar.

I extracted the exact same blp file that the interface uses this function with ("Interface\\CharacterFrame\\TempPortraitAlphaMask"), and it does nothing but make my texture disappear when I try to call SetMask with it.

It works when you reference the texture that's inside the game files, but it doesn't appear to be possible to create your own masks.

[Resike]

You can use any built in Blizzard textures to mask another texture, SetPortraitTexture works very similar, it masks a round circle on the square race icons.

There is a hexagon texture, masked with the HOTS icon from the game:

local frame = CreateFrame("Frame", nil, UIParent)
frame:SetPoint("Center", 0, 0)
frame:SetSize(100, 100)
 
local icon = frame:CreateTexture("Texture", "Background")
icon:SetTexture("Interface\\Icons\\Ability_Ambush")
icon:SetMask("Interface\\ChatFrame\\UI-ChatIcon-HotS")
icon:SetAllPoints(frame)

The problem is that the resolution/edges are highly based on the quailty of the masker AND the original image.

Another instresting masker images:

icon:SetMask("Interface\\DialogFrame\\DialogAlertIcon")
icon:SetMask("Interface\\DialogFrame\\UI-Dialog-Icon-AlertNew")
icon:SetMask("Interface\\GuildFrame\\GuildLogoMask_R")
icon:SetMask("Interface\\ARCHEOLOGY\\Arch-Keystone-Mask")
icon:SetMask("Interface\\GLUES\\Models\\UI_Dwarf\\UI_Goblin_GodRaysMask")
icon:SetMask("Interface\\GLUES\\Models\\UI_DeathKnight\\IceCrown_CloudsA02_MASK01")
icon:SetMask("Interface\\FriendsFrame\\PlusManz-Horde")

The possibilites are endless.

[Miiru]

I noticed it being used in Blizzard_EncounterJournal.lua when they added the suggesting part.

[lightspark]

Originally Posted by zork Since when do we have this function? http://wowprogramming.com/docs/widgets/Texture/SetMask Is it a new api function in legion? Until now we only had function to mask minimap textures.

For quite a while, I've been using it since late Cata or early MoP. There's a caveat though, if you want to crop/transform a texture by :SetTexCoord(), you first need to remove the mask, if any, transform the texture, and then re-apply the mask.

texture:SetMask(nil)
texture:SetTexCoord(0, 1, 0, 1)
texture:SetMask("texture-path-here")

[zork]

lightspark can you post a more detailed example? Maybe even with screenshots?

[lightspark]

Originally Posted by zork lightspark can you post a more detailed example? Maybe even with screenshots?

I have an animated day/night indicator in my UI, it has round shape, cuz I made be a background of minimap calendar button, so I had to apply round mask to rectangular texture.

Old screenshot piece of an early prototype:


Here is code that adjusts texture according to daytime.

I used default blizz textures for both artwork and mask:

[zork]

Thanks. To bad one can only use masks predefined wow textures. But good to know anyway. Cool idea btw.

[lightspark]

Originally Posted by zork Thanks. To bad one can only use masks predefined wow textures. But good to know anyway. Cool idea btw.

You are welcome Thank you

[Miiru]

What would be the safest way to completely remove the mask? (if there is any)