GetSectorFloorZ

From ZDoom Wiki

int GetSectorFloorZ (int tag, int x, int y);

Usage

This returns the sector floor height at coordinates [x, y].

Parameters

• tag: Tag of the sector.
• x, y: Coordinates of the point (not fixed point value!).

Return value

Returns the sector floor height at coordinates [x, y] as a fixed point value. When used on sectors which share tags, it will return the floor height of the sector with the lowest sector number and the matching tag. If the sector is flat, this will just return the floor height no matter where the coordinates are specified, so [0, 0] is as good as anywhere.

Examples

This script should be run via an “Actor enters sector” special, or by assigning it to the lines around a platform. It makes the platform raise every time the player stands on it, and when it is too high from the surrounding floor (assumed to be 0.0) then it reports that the player cannot climb on to the platform another time.

script 1 (int sector)
{
    Floor_RaiseByValue (sector, 10, 8);
    TagWait (sector);
 
    if (GetSectorFloorZ (sector, 0, 0) > 24.0)
        Print (s:"This platform is too\nhigh to climb on!");
}

Another use of this command is creating lifts which run to a number of floors one after the other and then return to their start floor. This command can detect if they are at specific floors.