BlzSetSpecialEffectMatrixScale

Parameters

whichEffect	effect
x	real	scaling ratio (default: 1)
y	real	scaling ratio (default: 1)
z	real	scaling ratio (default: 1)

comment

Sets the effect's 3-dimensional scaling matrix.

If the effect has a general scale set with BlzSetSpecialEffectScale, the final scale will be a result of multiplication.

Example (Lua):

sePath = [[UI\Feedback\selectioncircle\selectioncircle.mdx]]
seXY = AddSpecialEffect(sePath, 0,0)
seX = AddSpecialEffect(sePath, -512,0)
seY = AddSpecialEffect(sePath, 0,512)
seZ = AddSpecialEffect(sePath, 0,0)
se0 = AddSpecialEffect(sePath, 0,0)
seLine = AddSpecialEffect(sePath, 256,0)

BlzSetSpecialEffectMatrixScale(seXY, 10, 10, 1) -- big circle
BlzSetSpecialEffectMatrixScale(seX, 5, 1, 1) -- wide oval
BlzSetSpecialEffectMatrixScale(seY, 1, 5, 1) -- oval stretched north-south
BlzSetSpecialEffectMatrixScale(seZ, 1, 1, 10) -- because SelectionCircle model is flat, you only see it higher above the ground
BlzSetSpecialEffectMatrixScale(seLine, 0.05, 25, 0) -- looks like a thin vertical line
--[[ This special effect will remain for approx. 5s even if removed immediately ]]
DestroyEffect(seXY);DestroyEffect(seX);DestroyEffect(seY);DestroyEffect(seZ);DestroyEffect(se0);DestroyEffect(seLine);

note

See: BlzResetSpecialEffectMatrix, BlzSetSpecialEffectScale

note

The matrix scaling is independent of the regular effect scale. When both are used, they are applied multiplicatively.

patch

1.31.0.11889

Source

common.j

return type

nothing

Source code

native BlzSetSpecialEffectMatrixScale              takes effect whichEffect, real x, real y, real z returns nothing