Widget API: Texture:SetTexCoord

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ Methods

← Widget API ← Texture < SetTexCoord

Limit the region of a texture drawn by the Texture widget.

obj:SetTexCoord(left,right,top,bottom);
obj:SetTexCoord(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);

Parameters

Arguments

(left,right,top,bottom)

Number - 0 -- 1   - actually, not bounded, but 0-1 is the texture's actual area

(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);

Number - 0 -- 1   - actually, not bounded, but 0-1 is the texture's actual area

Note

The function cuts a sub-region out of the texture to display ingame.

• Unless you want to do rotations, use the (left,right,top,bottom) notation.
• The more complex 8-argument form allows for arbitrary affine transformations, see SetTexCoord Transformations for details.
  Basically the four points you specify still have to form a rectangle, but you can rotate and place it more freely.
  Experience with matrices is recommended since they can help you find the final coordinates of your points.

The example below cuts out the lower left quarter of the texture file.

Example

getglobal("MyAddOnTexture" .. id):SetTexCoord(0, 0.5, 0.5, 1);

Details

Use this function to select a sub-region of a texture for display in a Texture widget. Note that the coordinates are normalised, and that the origin is the top left corner. (Note: Tested in patch 2.0.6, and the origin is in fact in the top left, and not the bottom left as was previously stated)