ACSUtils Wiki

An ACS library for ZDoom-based ports

User Tools

Site Tools


rounding

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
rounding [2017/06/12 18:59]
korshun
rounding [2019/04/20 20:12] (current)
korshun [Rounding]
Line 1: Line 1:
 ===== Rounding ===== ===== Rounding =====
 +
 +ACSUtils provides a full set of functions to round fixed-point numbers to integers.
 +
 +<note important>​Current GZDoom provides built-in functions [[zdoom>​Floor_(ACS_function)|floor]],​ [[zdoom>​ceil]] and [[zdoom>​round]],​ but these functions aren't available in Zandronum 3.0 and **silently return 0** there, because all unimplemented built-in ACS functions return 0.
 +
 +Before using ACSUtils, rename either the built-in functions (by editing ''​zspecial.acs''​) or the ACSUtils functions (by editing ''​acsutils.acs''​) to something else. Otherwise, ACSUtils won't compile.
 +</​note>​
 +
 +==== Rounding modes ====
  
 There are four rounding modes: There are four rounding modes:
Line 8: Line 17:
   * ''​round''​ -- rounds the number to the closest integer   * ''​round''​ -- rounds the number to the closest integer
  
-Rounding ​table:+table that demonstrates the differences between rounding modes:
  
 ^  x   ^ round(x) ^ floor(x) ^ ceil(x) ^ trunc(x) ^ ^  x   ^ round(x) ^ floor(x) ^ ceil(x) ^ trunc(x) ^
-^   2.3|         2|         2|        ​3|         2+^   1.3|         1|         1|        ​2|         1
-^   3.8        4|         3|        ​4|         3+^   1.5   1 or 2|         1|        ​2|         1
-^   5.5|         6|         5|        ​6|         5+^   1.8|         2|         1|        ​2|         1
-^  -2.3|        -2|        -3|       -2|        -2+^  -1.3|        -1|        -2|       -1|        -1
-^  -3.8       -4|        -4|       -3|        -3+^  -1.5 -2 or -1|        -2|       -1|        -1
-^  -5.5|        -5|        -6|       -5|        -5|+^  -1.8|        -2|        -2|       -1|        -1| 
 + 
 +==== Rounding functions in ACSUtils ==== 
 + 
 +Every rounding mode is available as two functions:​ 
 +  * Functions without the ''​i''​ prefix return a fixed, e.g. ''​floor(2.3) == 2.0''​. 
 +  * Functions with the ''​i''​ prefix return an int, e.g. ''​ifloor(2.3) == 2''​.
  
-Every rounding mode is available as two functions. The ones with the ''​i'' ​prefix in the name return an integer, while the ones without return a fixed-point number:+^ Mode  ^ fixed result ^ int result ^ 
 +^ floor | ''​fixed floor(fixed x)'' ​| ''​int ifloor(fixed x)''​ | 
 +^ ceil  | ''​fixed ceil(fixed x)'' ​ | ''​int iceil(fixed x)'' ​ | 
 +^ round | ''​fixed round(fixed x)''​ | ''​int iround(fixed x)''​ | 
 +^ trunc | ''​fixed trunc(fixed x)''​ | ''​int itrunc(fixed x)''​ |
  
-^ Mode  ^ as fixed ^ as int ^ 
-^ floor | [[functions:​floor|floor()]] | [[functions:​ifloor|ifloor()]] | 
-^ ceil  | [[functions:​ceil|ceil()]] | [[functions:​iceil|iceil()]] | 
-^ round | [[functions:​round|round()]] | [[functions:​iround|iround()]] | 
-^ trunc | [[functions:​trunc|trunc()]] | [[functions:​itrunc|itrunc()]] | 
  
rounding.1497283140.txt.gz · Last modified: 2017/06/12 18:59 by korshun