ZDoom Line Specials

194:Ceiling_RaiseInstant

Name

Ceiling_RaiseInstant — instantly raises selected ceilings a specified amount.

Synopsis

Ceiling_RaiseInstant (tag, unused, height);
Ceiling_RaiseInstant (
  tag,       // tag of affected sector(s)
  unused,    // unused
  height     // how far to raise the ceiling
);

Parameters

tag
Only sectors with this tag will move their ceilings.
unused
This is a placeholder so that Ceiling_RaiseByValueTimes8 and Ceiling_RaiseInstant can be used interchangeably.
height
How far to raise 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

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

If you want to instantly move a ceiling some distance that is not a multiple of eight, you can use Ceiling_RaiseByValue with a speed equal to eight times the height:

Ceiling_RaiseByValue (1, 160, 20);

Example

The following will instantly raise 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_RaiseInstant (1, 0, 4);

This is equivalent to the following Ceiling_RaiseByValue call:

Ceiling_RaiseByValue (1, 256, 32);

First Available In

ZDoom 1.16

See Also

Ceiling Specials | Ceiling_RaiseByValue | Ceiling_RaiseByValueTimes8