ACSUtils Wiki

An ACS library for ZDoom-based ports

User Tools

Site Tools

Trace: • Character functions • Inventory functions • Changelog
rounding

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
rounding [2019/04/18 19:09] – korshunrounding [2019/08/26 18:02] (current) – korshun
Line 1: Line 1:
-===== Rounding functions =====+====== Rounding====== 
 + 
 +===== Introduction =====
  
 ACSUtils provides a full set of functions to round fixed-point numbers to integers. 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 are not available in Zandronum 3.0 and **silently return 0**, because all unimplemented built-in ACS functions return 0.+<note warning>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.+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> </note>
 +
 +===== Rounding modes =====
  
 There are four rounding modes: There are four rounding modes:
Line 15: Line 19:
   * ''round'' -- rounds the number to the closest integer   * ''round'' -- rounds the number to the closest integer
  
-Example rounding table:+A 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) ^
 ^   1.3|         1|         1|        2|         1| ^   1.3|         1|         1|        2|         1|
-^   1.5|         2|         1|        2|         1|+^   1.5|    1 or 2|         1|        2|         1|
 ^   1.8|         2|         1|        2|         1| ^   1.8|         2|         1|        2|         1|
 ^  -1.3|        -1|        -2|       -1|        -1| ^  -1.3|        -1|        -2|       -1|        -1|
-^  -1.5|        -1|        -2|       -1|        -1|+^  -1.5|  -2 or -1|        -2|       -1|        -1|
 ^  -1.8|        -2|        -2|       -1|        -1| ^  -1.8|        -2|        -2|       -1|        -1|
 +
 +===== Functions =====
  
 Every rounding mode is available as two functions: Every rounding mode is available as two functions:
   * Functions without the ''i'' prefix return a fixed, e.g. ''floor(2.3) == 2.0''.   * 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''.+  * Functions with the ''i'' prefix return an int, e.g. ''ifloor(2.3) == 2''.
  
 ^ Mode  ^ fixed result ^ int result ^ ^ Mode  ^ fixed result ^ int result ^
Line 34: Line 40:
 ^ round | ''fixed round(fixed x)'' | ''int iround(fixed x)'' | ^ round | ''fixed round(fixed x)'' | ''int iround(fixed x)'' |
 ^ trunc | ''fixed trunc(fixed x)'' | ''int itrunc(fixed x)'' | ^ trunc | ''fixed trunc(fixed x)'' | ''int itrunc(fixed x)'' |
 +
  
  
rounding.1555614576.txt.gz · Last modified: by korshun

Page Tools

Flag Counter