From ZDoom Wiki
Jump to: navigation, search

Fixed point numbers

ZDoom commonly represents fixed point numbers as 32-bit integers with the integer part of the represented number stored in the top 16 bits, and with the fractional part (65536ths) stored the lower 16 bits.

In other words, the fixed point representation of a number = that number * 65536.

See Fixed point numbers for more information.

Byte angles

This is a value between 0 and 255 representing a direction and is used with some line specials. Some useful values are:


Fixed point angles

These angles are similar to above but the value lies between 0.0 and 1.0 and is represented as a fixed point number. This means the value lies between 0 and 65536, with 0 representing 0.0 and 65536 representing 1.0. It is therefore possible to represent these angles as decimals (e.g. 0.5 is west, 0.25 is north), and use FixedMul and other commands on them.

Converting angles

To convert fixed point angles to byte angles, you can use the following formula:

byte_angle = fixed_point_angle >> 8 

And to convert byte to fixed point angles you use the opposite:

fixed_point_angle = byte_angle << 8

Here are some conversions between different angle representations, in degrees, byte angles, fixed point angle, and integral interpretation of fixed point. The greatest common factor of 360 and 256 is 8, which means that only multiples of 45° can be represented accurately by integers in both degrees and either byte angles or fixed point angles. Angles that cannot be represented internally by an integral value will lose precision through rounding.

Degree Byte Fixed Integer
0 0.0 0
0.0054931640625° 0.00390625 0.0000152587890625 1
0.71 0.002777... 182.0444...
1.40625° 1 0.00390625 256
2.8125° 2 0.0078125 512
3.55 0.013888... 910.222...
5.625° 4 0.015625 1024
10° 7.11 0.02777... 1820.444...
11.25° 8 0.03125 2048
15° 10.67 0.041666... 2730.666...
22.5° 16 0.0625 4096
30° 21.33 0.0833... 5461.333...
36° 0.000390625 0.1 6553.6
45° 32 0.125 8192
90° 64 0.25 16384
135° 96 0.375 24576
180° 128 0.5 32768
270° 192 0.75 49152
360° 256 1.0 65536

Sprite angles

See Sprite article

Byte pitches

Pitches can be represented in byte form, as they only have a range of 180°, rather than 360°. The pitch is a value between -90 and 90 representing vertical pitch and is used with some actors. The value is actually represented in degrees using a signed byte, negative values are upward, positive values are downward, 0 is level. Some useful values are:

45° up
Straight up
45° down
Straight down

Fixed point pitches

Some functions use pitch as a fixed point number. This uses the same fixed point angle values as other angles, so the range is between -0.25 (for 90° up) and 0.25 (for 90° down).

Units of time

A time interval of 1/35 second. Actor logic (state duration) is based on tics.
A time interval of 1/8 second. Sector logic (speed and wait for crushers, doors, lifts, raising stairs, etc.) is based on octics, as well as interpolation points for moving cameras and actor movers.

Vanilla Doom doors wait for 150 tics, roughly 34 octics or 4.3 seconds. Vanilla Doom platforms wait for 105 tics, equivalent to 24 octics or 3 seconds.

Note: Because of a loss of precision with integer division, the duration of a tic is of 28 milliseconds (instead of 28.5714287514...), which means that 35 tics actually make up only 0.98 seconds. There are therefore actually 35.7142857142857... tics in one second. Likewise, octics are internally derived from tics (one octic being 35 tics divided by 8), and the duration of an octic is 122 milliseconds (instead of 122.5 based on the tic, or of 125 based on the second), which means that 8 octics actually make up only 0.976 seconds. There are therefore 8.192721311475409... octics in one second.

Sector movement speed

Many specials take a speed argument, which is usually in eighths of a unit per tic. That is, a value of 8 means to move by one unit per tic, or 35 units per second. A value of 0 will generally not do anything useful.

For reference, the standard Doom and Boom speeds are as follows. Boom uses a standard set of "slow, normal, fast, turbo" speeds for many generalized specials, but they have different meanings for doors, platforms (including moving floors, ceilings, and crushers), and stair building.

Value Boom doors Boom platforms Boom stairs Doom
2 Slow Standard stairs
4 Normal Raising and perpetual platforms; donut
8 Slow Standard floors, ceilings, and crushers
16 Slow Normal Fast Standard doors; fast crushers
32 Normal Fast Turbo Standard platforms; fast floors; fast stairs
64 Fast Turbo Blazing doors; fast platforms
128 Turbo