Widget API: Texture:SetTexCoordModifiesRect

Revision as of 10:54, 22 July 2006 by WoWWiki>Mikk
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Widget API ← Texture < SetTexCoordModifiesRect

Set whether subsequent 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

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:

File:SetTexCoordModifiesRect-1.jpg
SetTexCoord( 0, 0.5  ,  0, 0.8 );

Rather than stretching over the 150x150 rectangle, the display rectangle becomes smaller.

File:SetTexCoordModifiesRect-2.jpg
SetTexCoord( -0.3, 1  ,  0, 0.8 );

Setting coordinates outside 0--1 produces interesting results...

File:SetTexCoordModifiesRect-3.jpg
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.

File:SetTexCoordModifiesRect-4.jpg