WoW:API Texture SetTexCoordModifiesRect - Revision history

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

2023-08-15T04:47:34Z

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

← Older revision	Revision as of 04:47, 15 August 2023
(No difference)

WoWWiki>Corwin MacGregor: section pointer from banner template to relevant information in Notes section at bottom of article

2010-03-29T01:44:51Z

section pointer from banner template to relevant information in Notes section at bottom of article

← Older revision		Revision as of 01:44, 29 March 2010
Line 1:		Line 1:
	{{widgetmethod}} {{removedapi\|3.3.3}}		{{widgetmethod}} {{removedapi\|3.3.3\|See [[#Notes]] below for work-around}}

	Set whether subsequent [[API Texture SetTexCoord\|SetTexCoord()]] operations also modify the rendering rectangle of a Texture object to maintain texture scaling when the texture coordinates are modified. This adjustment is only implemented for rectangular regions and may yield undesirable results for rotation or shearing transformations.		Set whether subsequent [[API Texture SetTexCoord\|SetTexCoord()]] operations also modify the rendering rectangle of a Texture object to maintain texture scaling when the texture coordinates are modified. This adjustment is only implemented for rectangular regions and may yield undesirable results for rotation or shearing transformations.
Line 56:		Line 56:
	\|}		\|}
	</div>		</div>

			== Notes ==
			This API has been deprecated in 3.3.3 in favor of modified implementation to be made available in a future release. {{ref web \|url=http://forums.worldofwarcraft.com/thread.html?topicId=20437376853&sid=1&pageNo=5#86 \| title=Reason, and workaround }}<br/>

WoWWiki>Starlightblunder: tag order

2010-03-26T12:57:56Z

tag order

← Older revision		Revision as of 12:57, 26 March 2010
Line 1:		Line 1:
	{{widgetmethod}}		{{widgetmethod}} {{removedapi\|3.3.3}}

	Set whether subsequent [[API Texture SetTexCoord\|SetTexCoord()]] operations also modify the rendering rectangle of a Texture object to maintain texture scaling when the texture coordinates are modified. This adjustment is only implemented for rectangular regions and may yield undesirable results for rotation or shearing transformations.		Set whether subsequent [[API Texture SetTexCoord\|SetTexCoord()]] operations also modify the rendering rectangle of a Texture object to maintain texture scaling when the texture coordinates are modified. This adjustment is only implemented for rectangular regions and may yield undesirable results for rotation or shearing transformations.

WoWWiki>Flickering: Added details of what this actually does

2006-07-22T21:03:47Z

Added details of what this actually does

← Older revision		Revision as of 21:03, 22 July 2006
Line 1:		Line 1:
	{{widgetmethod}}		{{widgetmethod}}

	Set whether subsequent [[API Texture SetTexCoord\|SetTexCoord()]] operations ~~should~~ modify the ~~display~~ rectangle ~~rather than stretch/shrink~~ the texture.		Set whether subsequent [[API Texture SetTexCoord\|SetTexCoord()]] operations also modify the rendering rectangle of a Texture object to maintain texture scaling when the texture coordinates are modified. This adjustment is only implemented for rectangular regions and may yield undesirable results for rotation or shearing transformations.

	MyTexture:SetTexCoordModifiesRect(enableFlag)		MyTexture:SetTexCoordModifiesRect(enableFlag)

Line 8:		Line 9:
	:::'''false''' (default) to stretch/shrink the texture on SetTexCoord calls.		:::'''false''' (default) to stretch/shrink the texture on SetTexCoord calls.
	:::'''true''' to modify the display rectangle's dimensions instead.		:::'''true''' to modify the display rectangle's dimensions instead.

			== Details ==
			By default a Texture object renders the underlying texture image across the entire surface of the Texture region, so setting TexCoords that represent a subset of the underlying image results in a scaled or stretched result. If SetTexCoordModifiesRect is set to true, then the rendering rectangle is adjusted relative to the Texture region, so that sizing/scaling will be preserved relative to the original (0,1,0,1) coordinates. The new rendering area has the same BOTTOMLEFT corner as the Texture region, but then a width and height defined as follows:

			T is a texture with a display width of W and display height of H.
			T:SetTexCoordModifiesRect(true) is called
			T:SetTexCoord(x1,x2, y1,y2) is then executed

			The texture image is then rendered onto a screen region with the same BOTTOMLEFT corner as T, but with a width of W * (abs(x2-x1)) and height of H * (abs(y2-y1))

	== Examples ==		== Examples ==

WoWWiki>Mikk at 10:54, 22 July 2006

2006-07-22T10:54:21Z

New page

{{widgetmethod}}

Set whether subsequent [[API Texture SetTexCoord|SetTexCoord()]] operations should modify the display rectangle rather than stretch/shrink the texture.
MyTexture:SetTexCoordModifiesRect(enableFlag)

== Parameters ==
:;enableFlag: Boolean:
:::'''false''' (default) to stretch/shrink the texture on SetTexCoord calls.
:::'''true''' to modify the display rectangle's dimensions instead.

== Examples ==

<div style="max-width: 60em; margin-left: 3%">
{| cellpadding=10 style="background: transparent;"
|- valign=top
|We start out with a plain 150x150 texture drawn on top of a light blue 150x150 plate.

And then we do:
MyTexture:SetTexCoordModifiesRect(enableFlag)

... and watch what happens below:
|[[Image:SetTexCoordModifiesRect-1.jpg]]
|- valign=top
|
SetTexCoord( 0, 0.5  ,  0, 0.8 );

Rather than stretching over the 150x150 rectangle, the display rectangle becomes smaller.
|[[Image:SetTexCoordModifiesRect-2.jpg]]
|- valign=top
|
SetTexCoord( -0.3, 1  ,  0, 0.8 );

Setting coordinates outside 0--1 produces interesting results...
|[[Image:SetTexCoordModifiesRect-3.jpg]]
|- valign=top
|
SetTexCoordModifiesRect(false)
SetTexCoord( 0, 1  ,  0, 1 );

Note how unsetting ModifiesRect does not automatically return the display rectangle to its normal state.

You have to ''first'' change the texcoords to 0,1,0,1 to restore the rectangle, ''then'' you can turn ModifiesRect off.
|[[Image:SetTexCoordModifiesRect-4.jpg]]
|}
</div>