WoW:API Texture SetTexCoord: Difference between revisions

m
Move page script moved page API Texture SetTexCoord to WoW:API Texture SetTexCoord without leaving a redirect
m (Move page script moved page API Texture SetTexCoord to WoW:API Texture SetTexCoord without leaving a redirect)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{widgetmethod}}
{{widgetmethod}}
Limits the region of a texture drawn by the Texture widget.
Sets the region of a texture drawn by the {{api|Texture|t=w}} widget.
obj:SetTexCoord(left,right,top,bottom);
obj:SetTexCoord(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);


== Arguments ==
obj:SetTexCoord(left,right,top,bottom)
:(left,right,top,bottom)
obj:SetTexCoord(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy)
:: Number - side coordinates; top left corner of the image is (0, 0); bottom right corner is (1, 1).


:(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);
== Parameters ==
:: Number - point coordinates; top left corner of the image is (0, 0); bottom right corner is (1, 1).
=== Arguments ===
:;left, right, top, bottom - number
:: side coordinates; top left corner of the image is (0, 0); bottom right corner is (1, 1).


== Notes ==
:;ULx, ULy, LLx, LLy, URx, URy, LRx, LRy - number
The function cuts a sub-region out of the texture to display ingame.
:: point coordinates; top left corner of the image is (0, 0); bottom right corner is (1, 1).
* 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.
=== Returns ===
:none
 
== Details ==
The function can be used to cut a sub-region out of the texture to display in game.


== Example ==
== Example ==
texture:SetTexCoord(0, 0.5, 0.5, 1)
Displays the bottom-left quarter of the image.
Displays the bottom-left quarter of the image.
texture:SetTexCoord(0, 0.5, 0.5, 1);


==Details==
local ULx,ULy,LLx,LLy,URx,URy,LRx,LRy = texture:GetTexCoord()
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)
texture:SetTexCoord(ULx*0.5,ULy,LLx*0.5,LLy,URx,URy,LRx,LRy)
local w = texture:GetWidth();
texture:SetWidth(w * 0.5)
 
Change the "view" of a texture to the right, to one half, while maintaining aspect ratio and scale.
 
== Notes ==
* the coordinates are normalized, and that the origin is the ''top'' left corner.
* 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
* Unless you want to do rotations, use the ''(left,right,top,bottom)'' notation.
* The more complex 8-argument form allows for arbitrary affine transformations, and transformations based on previous values.
 
== See also ==
* {{api|Texture:GetTexCoord|t=w}}()
* [[SetTexCoord Transformations]]
Anonymous user