ACSUtils Wiki

An ACS library for ZDoom-based ports

User Tools

Site Tools

Trace: • Математика • Get ACSUtils version • Random number functions • SHORT_MAX • USHORT_MAX • BCSUtils • Numeric limits • Math • GetCVarFixed • Ternary operator in ACS
math

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
math [2019/08/26 18:16] – korshunmath [2019/08/26 18:26] (current) – [Length] korshun
Line 191: Line 191:
  
 ===== Vector math ===== ===== Vector math =====
 +
 +Vector math functions come in 2D and 3D versions. All vector math functions operate only on fixed-point vectors. No integer versions are available.
 +
 +Vectors are passed as arguments named ''x'', ''y'', ''z''.
 +
 +If a function returns a vector, it uses [[multiple return values]], returning vector components in the same XYZ order, so ''r1'' is X, ''r2'' is Y and ''r3'' is Z.
 +
 +If a function accepts more than one vector, the first vector is passed as ''x1'', ''y1'', ''z1'', and the second one as ''x2'', ''y2'', ''z2''.
 +
  
 ==== Length ==== ==== Length ====
  
-  * 2D: [[zdoom>VectorLength]]+  * 2D: [[zdoom>VectorLength]] -- already built into ZDoom.
   * 3D: ''fixed VectorLength3D(fixed x, fixed y, fixed Z)''   * 3D: ''fixed VectorLength3D(fixed x, fixed y, fixed Z)''
  
-''VectorLength3D'' is implemented efficiently as ''VectorLength(VectorLength(x, y), z)''.+These functions return the length of the input vector. ''VectorLength3D'' is implemented efficiently as ''VectorLength(VectorLength(x, y), z)''.
  
 ==== Dot product ==== ==== Dot product ====
Line 204: Line 213:
   * 3D: ''fixed dot3(fixed x1, fixed y1, fixed z1, fixed x2, fixed y2, fixed z2)''   * 3D: ''fixed dot3(fixed x1, fixed y1, fixed z1, fixed x2, fixed y2, fixed z2)''
  
-These functions return the [[wp>dot product]] of two vectors. They are shorthands for writing out ''FixedMul(x1, x2) + FixedMul(y1, y2) + ...''.+These functions return the sum of components of a vector obtained by componentwise multiplication of the two input vectors, also known as the [[wp>dot product]]. They are shorthands for writing out ''FixedMul(x1, x2) + FixedMul(y1, y2) + ...''.
  
 ==== Normalization ==== ==== Normalization ====
Line 211: Line 220:
   * 3D: ''fixed, fixed, fixed normalize3d(fixed x, fixed y, fixed z)''   * 3D: ''fixed, fixed, fixed normalize3d(fixed x, fixed y, fixed z)''
  
-These functions [[wp>Normalized vector|Normalize]] the input vector and return the result using [[multiple return values]].+These functions return the input vector scaled to have length ''1.0'', also known as [[wp>Normalized vector|normalizing]] the input vector, and return the result using [[multiple return values]].
  
-=== Example usage ===+=== Examples ===
 <code> <code>
 normalize3d(x, y, z); normalize3d(x, y, z);
math.1566843384.txt.gz · Last modified: by korshun

Page Tools

Flag Counter