WoW:API Texture SetTexCoord: Difference between revisions

WoW:API Texture SetTexCoord (source)

Revision as of 13:56, 26 August 2009

406 bytes removed , 26 August 2009

boilerplate

Anonymous user

WoWWiki>Starlightblunder

@@ Line 1: / Line 1: @@
 {{widgetmethod}}
+Limits the region of a texture drawn by the Texture widget.
-Limit the region of a texture drawn by the Texture widget.
-<!-- List return values and arguments as well as function name, follow Blizzard usage convention for args -->
   obj:SetTexCoord(left,right,top,bottom);
   obj:SetTexCoord(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);
-== Parameters ==
+== Arguments ==
-=== Arguments ===
 :(left,right,top,bottom)
-: Number - '''0 -- 1''' &nbsp; - actually, not bounded, but 0-1 is the texture's actual area
+:: 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 - '''0 -- 1''' &nbsp; - actually, not bounded, but 0-1 is the texture's actual area
+:: Number - point coordinates; top left corner of the image is (0, 0); bottom right corner is (1, 1).
-== Note ==
+== Notes ==
-:The function cuts a sub-region out of the texture to display ingame.
+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.
+* 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.<BR>Basically the four points you specify still have to form a rectangle, but you can rotate and place it more freely.<BR>Experience with matrices is recommended since they can help you find the final coordinates of your points.
+* The more complex 8-argument form allows for arbitrary affine transformations, see [[SetTexCoord Transformations]] for details.
-:The example below cuts out the lower left quarter of the texture file.
 == Example ==
-  getglobal("MyAddOnTexture" .. id):SetTexCoord(0, 0.5, 0.5, 1);
+Displays the bottom-right quarter of the image.
+  texture: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)
-: 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)
-__NOTOC__