plugins/include/float.inc
author David Anderson <dvander@alliedmods.net>
Thu Jan 11 08:46:41 2007 +0000 (2007-01-11)
changeset 285 eeccbf66d620
parent 261 2342df60789c
child 374 39ab08027d9e
permissions -rw-r--r--
filled out info about pausing
faluco@242
     1
/**
faluco@242
     2
 * :TODO: license info
faluco@242
     3
 */
faluco@242
     4
faluco@242
     5
#if defined _float_included
faluco@242
     6
 #endinput
faluco@242
     7
#endif
faluco@242
     8
#define _float_included
faluco@242
     9
faluco@242
    10
/**
faluco@242
    11
 * @GLOBAL@
faluco@242
    12
 *   All the trigonometric functions take in or return its values in RADIANS.
faluco@242
    13
 *   Use DegToRad or RadToDeg stocks to convert the radix units.
faluco@242
    14
 */
faluco@242
    15
faluco@242
    16
/* Different methods of rounding */
faluco@242
    17
enum floatround_method
faluco@242
    18
{
faluco@242
    19
	floatround_round = 0,
faluco@242
    20
	floatround_floor,
faluco@242
    21
	floatround_ceil,
faluco@242
    22
	floatround_tozero
faluco@242
    23
};
faluco@242
    24
faluco@242
    25
/**
faluco@242
    26
 * Converts an integer into a floating point value.
faluco@242
    27
 *
faluco@242
    28
 * @param value			Integer to convert.
faluco@242
    29
 * @return				Floating point value.
faluco@242
    30
 */
faluco@242
    31
native Float:float(value);
faluco@242
    32
faluco@242
    33
/**
faluco@242
    34
 * Converts a string into a floating point value.
faluco@242
    35
 *
faluco@242
    36
 * @param str			String to convert.
faluco@242
    37
 * @return				Converted floating point number.
faluco@242
    38
 */
faluco@242
    39
native Float:FloatStr(const String:str[]);
faluco@242
    40
faluco@242
    41
/**
faluco@242
    42
 * Multiplies two floats together.
faluco@242
    43
 *
faluco@242
    44
 * @param oper1			First value.
faluco@242
    45
 * @param oper2			Second value.
faluco@242
    46
 * @return				oper1*oper2.
faluco@242
    47
 */
faluco@242
    48
native Float:FloatMul(Float:oper1, Float:oper2);
faluco@242
    49
faluco@242
    50
/**
faluco@242
    51
 * Divides the dividend by the divisor.
faluco@242
    52
 *
faluco@242
    53
 * @param dividend		First value.
faluco@242
    54
 * @param divisor		Second value.
faluco@242
    55
 * @return				dividend/divisor.
faluco@242
    56
 */
faluco@242
    57
native Float:FloatDiv(Float:dividend, Float:divisor);
faluco@242
    58
faluco@242
    59
/**
faluco@242
    60
 * Adds two floats together.
faluco@242
    61
 *
faluco@242
    62
 * @param oper1			First value.
faluco@242
    63
 * @param oper2			Second value.
faluco@242
    64
 * @return				oper1+oper2.
faluco@242
    65
 */
faluco@242
    66
native Float:FloatAdd(Float:oper1, Float:oper2);
faluco@242
    67
faluco@242
    68
/**
faluco@242
    69
 * Subtracts oper2 from oper1.
faluco@242
    70
 *
faluco@242
    71
 * @param oper1			First value.
faluco@242
    72
 * @param oper2			Second value.
faluco@242
    73
 * @return				oper1-oper2.
faluco@242
    74
 */
faluco@242
    75
native Float:FloatSub(Float:oper1, Float:oper2);
faluco@242
    76
faluco@242
    77
/**
faluco@242
    78
 * Returns the decimal part of a float.
faluco@242
    79
 *
faluco@242
    80
 * @param value			Input value.
faluco@242
    81
 * @return				Decimal part.
faluco@242
    82
 */
faluco@242
    83
native Float:FloatFraction(Float:value);
faluco@242
    84
faluco@242
    85
/**
faluco@242
    86
 * Rounds a float into an integer number.
faluco@242
    87
 *
faluco@242
    88
 * @param value			Input value to be rounded.
faluco@242
    89
 * @param method		Rounding method to use.
faluco@242
    90
 * @return				Rounded value.
faluco@242
    91
 */
faluco@242
    92
native FloatRound(Float:value, floatround_method:method=floatround_round);
faluco@242
    93
faluco@242
    94
/**
faluco@242
    95
 * Compares two floats.
faluco@242
    96
 *
faluco@242
    97
 * @param fOne			First value.
faluco@242
    98
 * @param fTwo			Second value.
faluco@242
    99
 * @return				Returns 1 if the first argument is greater than the second argument.
faluco@242
   100
 *                      Returns -1 if the first argument is smaller than the second argument.
faluco@242
   101
 *                      Returns 0 if both arguments are equal.
faluco@242
   102
 */
faluco@242
   103
native FloatCompare(Float:fOne, Float:fTwo);
faluco@242
   104
faluco@242
   105
/**
faluco@242
   106
 * Returns the square root of the input value, equivalent to floatpower(value, 0.5).
faluco@242
   107
 *
faluco@242
   108
 * @param value			Input value.
faluco@242
   109
 * @return				Square root of the value.
faluco@242
   110
 */
faluco@242
   111
native Float:SquareRoot(Float:value);
faluco@242
   112
faluco@242
   113
/**
faluco@242
   114
 * Returns the value raised to the power of the exponent.
faluco@242
   115
 *
faluco@242
   116
 * @param value			Value to be raised.
faluco@242
   117
 * @param exponent		Value to raise the base.
faluco@242
   118
 * @return				value^exponent.
faluco@242
   119
 */
faluco@242
   120
native Float:Pow(Float:value, Float:exponent);
faluco@242
   121
faluco@242
   122
/**
faluco@242
   123
 * Returns the value of raising the input by e.
faluco@242
   124
 *
faluco@242
   125
 * @param value			Input value.
faluco@242
   126
 * @return				exp(value).
faluco@242
   127
 */
faluco@242
   128
native Float:Exponential(Float:value);
faluco@242
   129
faluco@242
   130
/**
faluco@242
   131
 * Returns the logarithm of any base specified.
faluco@242
   132
 *
faluco@242
   133
 * @param value			Input value.
faluco@242
   134
 * @param base			Logarithm base to use, default is 10.
faluco@242
   135
 * @return				log(value)/log(base).
faluco@242
   136
 */
faluco@242
   137
native Float:Logarithm(Float:value, Float:base=10.0);
faluco@242
   138
faluco@242
   139
/**
faluco@242
   140
 * Returns the sine of the argument.
faluco@242
   141
 *
faluco@242
   142
 * @param value			Input value in radians.
faluco@242
   143
 * @return				sin(value).
faluco@242
   144
 */
faluco@242
   145
native Float:Sine(Float:value);
faluco@242
   146
faluco@242
   147
/**
faluco@242
   148
 * Returns the cosine of the argument.
faluco@242
   149
 *
faluco@242
   150
 * @param value			Input value in radians.
faluco@242
   151
 * @return				cos(value).
faluco@242
   152
 */
faluco@242
   153
native Float:Cosine(Float:value);
faluco@242
   154
faluco@242
   155
/**
faluco@242
   156
 * Returns the tangent of the argument.
faluco@242
   157
 *
faluco@242
   158
 * @param value			Input value in radians.
faluco@242
   159
 * @return				tan(value).
faluco@242
   160
 */
faluco@242
   161
native Float:Tangent(Float:value);
faluco@242
   162
faluco@242
   163
/**
faluco@242
   164
 * Returns the absolute value.
faluco@242
   165
 *
faluco@242
   166
 * @param value			Input value.
faluco@242
   167
 * @return				abs(value).
faluco@242
   168
 */
faluco@242
   169
native Float:FloatAbs(Float:value);
faluco@242
   170
faluco@242
   171
/**
faluco@242
   172
 * Returns the arctangent of the input value.
faluco@242
   173
 *
faluco@242
   174
 * @param angle			Input value.
faluco@242
   175
 * @return				atan(value) in radians.
faluco@242
   176
 */
faluco@242
   177
native Float:ArcTangent(Float:angle);
faluco@242
   178
faluco@242
   179
/**
faluco@242
   180
 * Returns the arccosine of the input value.
faluco@242
   181
 *
faluco@242
   182
 * @param angle			Input value.
faluco@242
   183
 * @return				acos(value) in radians.
faluco@242
   184
 */
faluco@242
   185
native Float:ArcCosine(Float:angle);
faluco@242
   186
faluco@242
   187
/**
faluco@242
   188
 * Returns the arcsine of the input value.
faluco@242
   189
 *
faluco@242
   190
 * @param angle			Input value.
faluco@242
   191
 * @return				asin(value) in radians.
faluco@242
   192
 */
faluco@242
   193
native Float:ArcSine(Float:angle);
faluco@242
   194
faluco@242
   195
/**
faluco@242
   196
 * Returns the arctangent2 of the input values.
faluco@242
   197
 *
faluco@242
   198
 * @param x				Horizontal value.
faluco@242
   199
 * @param y				Vertical value.
faluco@242
   200
 * @return				atan2(value) in radians.
faluco@242
   201
 */
faluco@244
   202
native Float:ArcTangent2(Float:x, Float:y);
faluco@242
   203
faluco@242
   204
/**
faluco@242
   205
 * User defined operators.
faluco@242
   206
 *
faluco@242
   207
 */
faluco@242
   208
#pragma rational Float
faluco@242
   209
faluco@242
   210
native Float:operator*(Float:oper1, Float:oper2) = FloatMul;
faluco@242
   211
native Float:operator/(Float:oper1, Float:oper2) = FloatDiv;
faluco@242
   212
native Float:operator+(Float:oper1, Float:oper2) = FloatAdd;
faluco@242
   213
native Float:operator-(Float:oper1, Float:oper2) = FloatSub;
faluco@242
   214
faluco@242
   215
stock Float:operator++(Float:oper)
faluco@242
   216
	return oper+1.0;
faluco@242
   217
faluco@242
   218
stock Float:operator--(Float:oper)
faluco@242
   219
	return oper-1.0;
faluco@242
   220
faluco@242
   221
stock Float:operator-(Float:oper)
faluco@242
   222
	return oper^Float:((-1)^((-1)/2));				/* IEEE values are sign/magnitude */
faluco@242
   223
faluco@242
   224
stock Float:operator*(Float:oper1, oper2)
faluco@242
   225
	return FloatMul(oper1, float(oper2));			/* "*" is commutative */
faluco@242
   226
faluco@242
   227
stock Float:operator/(Float:oper1, oper2)
faluco@242
   228
	return FloatDiv(oper1, float(oper2));
faluco@242
   229
faluco@242
   230
stock Float:operator/(oper1, Float:oper2)
faluco@242
   231
	return FloatDiv(float(oper1), oper2);
faluco@242
   232
faluco@242
   233
stock Float:operator+(Float:oper1, oper2)
faluco@242
   234
	return FloatAdd(oper1, float(oper2));			/* "+" is commutative */
faluco@242
   235
faluco@242
   236
stock Float:operator-(Float:oper1, oper2)
faluco@242
   237
	return FloatSub(oper1, float(oper2));
faluco@242
   238
faluco@242
   239
stock Float:operator-(oper1, Float:oper2)
faluco@242
   240
	return FloatSub(float(oper1), oper2);
faluco@242
   241
faluco@242
   242
stock bool:operator==(Float:oper1, Float:oper2)
faluco@242
   243
	return FloatCompare(oper1, oper2) == 0;
faluco@242
   244
faluco@242
   245
stock bool:operator==(Float:oper1, oper2)
faluco@242
   246
	return FloatCompare(oper1, float(oper2)) == 0; 	/* "==" is commutative */
faluco@242
   247
faluco@242
   248
stock bool:operator!=(Float:oper1, Float:oper2)
faluco@242
   249
	return FloatCompare(oper1, oper2) != 0;
faluco@242
   250
faluco@242
   251
stock bool:operator!=(Float:oper1, oper2)
faluco@242
   252
	return FloatCompare(oper1, float(oper2)) != 0; 	/* "==" is commutative */
faluco@242
   253
faluco@242
   254
stock bool:operator>(Float:oper1, Float:oper2)
faluco@242
   255
	return FloatCompare(oper1, oper2) > 0;
faluco@242
   256
faluco@242
   257
stock bool:operator>(Float:oper1, oper2)
faluco@242
   258
	return FloatCompare(oper1, float(oper2)) > 0;
faluco@242
   259
faluco@242
   260
stock bool:operator>(oper1, Float:oper2)
faluco@242
   261
	return FloatCompare(float(oper1), oper2) > 0;
faluco@242
   262
faluco@242
   263
stock bool:operator>=(Float:oper1, Float:oper2)
faluco@242
   264
	return FloatCompare(oper1, oper2) >= 0;
faluco@242
   265
faluco@242
   266
stock bool:operator>=(Float:oper1, oper2)
faluco@242
   267
	return FloatCompare(oper1, float(oper2)) >= 0;
faluco@242
   268
faluco@242
   269
stock bool:operator>=(oper1, Float:oper2)
faluco@242
   270
	return FloatCompare(float(oper1), oper2) >= 0;
faluco@242
   271
faluco@242
   272
stock bool:operator<(Float:oper1, Float:oper2)
faluco@242
   273
	return FloatCompare(oper1, oper2) < 0;
faluco@242
   274
faluco@242
   275
stock bool:operator<(Float:oper1, oper2)
faluco@242
   276
	return FloatCompare(oper1, float(oper2)) < 0;
faluco@242
   277
faluco@242
   278
stock bool:operator<(oper1, Float:oper2)
faluco@242
   279
	return FloatCompare(float(oper1), oper2) < 0;
faluco@242
   280
faluco@242
   281
stock bool:operator<=(Float:oper1, Float:oper2)
faluco@242
   282
	return FloatCompare(oper1, oper2) <= 0;
faluco@242
   283
faluco@242
   284
stock bool:operator<=(Float:oper1, oper2)
faluco@242
   285
	return FloatCompare(oper1, float(oper2)) <= 0;
faluco@242
   286
faluco@242
   287
stock bool:operator<=(oper1, Float:oper2)
faluco@242
   288
	return FloatCompare(float(oper1), oper2) <= 0;
faluco@242
   289
faluco@242
   290
stock bool:operator!(Float:oper)
faluco@242
   291
	return (_:oper & ((-1)/2)) == 0;		/* -1 = all bits to 1; /2 = remove most significant bit (sign)
faluco@242
   292
											works on both 32bit and 64bit systems; no constant required */
faluco@242
   293
faluco@242
   294
/**
faluco@242
   295
 * Forbidden operators.
faluco@242
   296
 *
faluco@242
   297
 */
faluco@242
   298
forward operator%(Float:oper1, Float:oper2);
faluco@242
   299
forward operator%(Float:oper1, oper2);
faluco@261
   300
forward operator%(oper1, Float:oper2);
faluco@261
   301
faluco@261
   302
#define FLOAT_PI 3.1415926535897932384626433832795
faluco@261
   303
faluco@261
   304
stock Float:DegToRad(Float:angle)
faluco@261
   305
{
faluco@261
   306
	return (angle*FLOAT_PI)/180;
faluco@261
   307
}
faluco@261
   308
faluco@261
   309
stock Float:RadToDeg(Float:angle)
faluco@261
   310
{
faluco@261
   311
	return (angle*180)/FLOAT_PI;
faluco@261
   312
}