WoW:API Texture SetTexCoord - Revision history

Move page script: Move page script moved page API Texture SetTexCoord to WoW:API Texture SetTexCoord without leaving a redirect

2023-08-15T04:47:34Z

Move page script moved page API Texture SetTexCoord to API Texture SetTexCoord without leaving a redirect

← Older revision

Revision as of 04:47, 15 August 2023

Bear: /* Example */

2015-01-17T22:27:06Z

Example

← Older revision		Revision as of 22:27, 17 January 2015
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(ULx0.5,ULy,LLx0.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]]

WoWWiki>Lamprey: /* Example */

2011-04-19T10:05:20Z

Example

← Older revision		Revision as of 10:05, 19 April 2011
Line 17:		Line 17:

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

	==Details==		==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)

WoWWiki>Starlightblunder: boilerplate

2009-08-26T13:56:34Z

boilerplate

← Older revision		Revision as of 13:56, 26 August 2009
Line 1:		Line 1:
	{{widgetmethod}}		{{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(left,right,top,bottom);
	obj:SetTexCoord(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);		obj:SetTexCoord(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);

	~~== Parameters ==~~		== Arguments ==
	=== Arguments ===
	:(left,right,top,bottom)		:(left,right,top,bottom)
	: Number - ~~'''~~0 -- 1~~'''   - 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);		:(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);
	: Number - ~~'''~~0 -- 1~~'''   - 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 ==		== 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==		==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__~~

WoWWiki>Pcj at 16:23, 4 December 2007

2007-12-04T16:23:59Z

← Older revision		Revision as of 16:23, 4 December 2007
Line 1:		Line 1:
	{{widgetmethod}}		{{widgetmethod}}

	~~<center>'''SetTexCoord''' ''-Documentation by [[user:tcxxs\|tcxxs]]-''</center>~~

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

WoWWiki>WoWWiki-Prisma: /* Note */

2007-09-14T07:31:34Z

Note

← Older revision		Revision as of 07:31, 14 September 2007
Line 18:		Line 18:

	== Note ==		== Note ==
	:The function ~~cut~~ a sub-region,use the ~~new TopLeftPoint is~~ (left,top~~),new BottomRight is (right~~,bottom)~~,so you can use the function to rotate the texture or sub-region~~. The more complex 8-argument form allows for arbitrary affine transformations, see [[SetTexCoord Transformations]] for details.		: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.<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 example below cuts out the lower left quarter of the texture file.

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

WoWWiki>Baudzilla: Changed origin from bottom left to top left

2007-02-07T10:30:57Z

Changed origin from bottom left to top left

← Older revision		Revision as of 10:30, 7 February 2007
Line 24:		Line 24:
	==Details==		==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 ''~~bottom~~'' left corner.		: 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__		__NOTOC__

WoWWiki>Mikk: /* Parameters */ Clarify 0-1

2006-08-12T13:35:11Z

Parameters: Clarify 0-1

← Older revision		Revision as of 13:35, 12 August 2006
Line 12:		Line 12:
	=== Arguments ===		=== Arguments ===
	:(left,right,top,bottom)		:(left,right,top,bottom)
	: Number - ~~(no bounds~~, ~~though~~ 0-1 ~~represents those pixels within~~ the texture)		: Number - '''0 -- 1'''   - actually, not bounded, but 0-1 is the texture's actual area

	:(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);		:(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);
	: Number - ~~(no bounds~~, ~~though~~ 0-1 ~~represents those pixels within~~ the texture)		: Number - '''0 -- 1'''   - actually, not bounded, but 0-1 is the texture's actual area

	== Note ==		== Note ==

WoWWiki>Flickering: /* Arguments */ Fixed ranges

2006-07-22T20:20:47Z

Arguments: Fixed ranges

← Older revision		Revision as of 20:20, 22 July 2006
Line 12:		Line 12:
	=== Arguments ===		=== Arguments ===
	:(left,right,top,bottom)		:(left,right,top,bottom)
	: Number - (~~range:~~ 0-1)		: Number - (no bounds, though 0-1 represents those pixels within the texture)

	:(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);		:(ULx,ULy,LLx,LLy,URx,URy,LRx,LRy);
	: Number - (~~range:~~ 0-1)		: Number - (no bounds, though 0-1 represents those pixels within the texture)


	== Note ==		== Note ==

WoWWiki>Mikk: {{widgetmethod}}

2006-06-10T13:30:36Z

← Older revision		Revision as of 13:30, 10 June 2006
Line 1:		Line 1:
			{{widgetmethod}}

	<center>'''SetTexCoord''' ''-Documentation by [[user:tcxxs\|tcxxs]]-''</center>		<center>'''SetTexCoord''' ''-Documentation by [[user:tcxxs\|tcxxs]]-''</center>

Line 25:		Line 27:
	: 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 ''bottom'' left corner.		: 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 ''bottom'' left corner.

	~~----~~
	__NOTOC__		__NOTOC__
	~~{{Template:WoW API}}~~