WoW:API Texture SetTexCoord: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
m (Move page script moved page API Texture SetTexCoord to 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]]

Latest revision as of 04:47, 15 August 2023

← Widget API ← Texture < SetTexCoord

Sets 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
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 - number
point coordinates; top left corner of the image is (0, 0); bottom right corner is (1, 1).

Returns

none

Details

The function can be used to cut a sub-region out of the texture to display in game.

Example

texture:SetTexCoord(0, 0.5, 0.5, 1)

Displays the bottom-left quarter of the image. 

local ULx,ULy,LLx,LLy,URx,URy,LRx,LRy = texture:GetTexCoord()
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

Retrieved from "https://addonstudio.org/mw1/index.php?title=WoW:API_Texture_SetTexCoord&oldid=11821"