ZDoom Line Specials

199:Ceiling_LowerByValueTimes8

Name

Ceiling_LowerByValueTimes8 — lowers selected ceilings a specified amount.

Synopsis

Ceiling_LowerByValueTimes8 (tag, speed, height);
Ceiling_LowerByValueTimes8 (
  tag,       // tag of affected sector(s)
  speed,     // how quickly the ceiling lowers
  height     // how far to lower the ceiling
);

Parameters

tag
Only sectors with this tag will move their ceilings.
speed
How fast to lower the ceiling.
height
How far to lower the ceiling. To determine the actual height the ceiling moves, this parameter is multiplied by 8.

ACS

This special's function is the same whether you activate it on a line or use it in a script.

Remarks

This special is equivalent to Ceiling_LowerByValue (tag, speed, height*8). When you are writing a script, there is no reason to use this special instead of Ceiling_LowerByValue. Ceiling_LowerByValue has finer control over how far the ceiling moves, and you don't have to do any math to know how far the ceiling will move when you use the special. Ceiling_LowerByValueTimes8 is meant to be used on lines where a height of 255 is not enough, because specials on lines can only take paremeters in the range [0,255].

If more than one sector matches the specified tag, the sectors will move their ceilings independantly. If a ceiling is blocked in one sector, the other sectors will still be able to move their ceilings.

If tag is zero, then the sector on the back side of the activating line will be used.

Example

The following will lower the ceilings in all sectors tagged 1 by 32 units. 4 is used as the height because when you divide 32 by 8, the result is 4.

Ceiling_LowerByValueTimes8 (1, 16, 4);

First Available In

Hexen

See Also

Ceiling Specials | Ceiling_LowerAndCrush | Ceiling_LowerByValue | Ceiling_LowerInstant