mirror of
https://github.com/4ian/GDevelop.git
synced 2025-10-15 10:19:04 +00:00
493 lines
17 KiB
C++
493 lines
17 KiB
C++
/*
|
|
* GDevelop Core
|
|
* Copyright 2008-2016 Florian Rival (Florian.Rival@gmail.com). All rights
|
|
* reserved. This project is released under the MIT License.
|
|
*/
|
|
#include "AllBuiltinExtensions.h"
|
|
#include "GDCore/Tools/Localization.h"
|
|
|
|
using namespace std;
|
|
namespace gd {
|
|
|
|
void GD_CORE_API
|
|
BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
|
|
gd::PlatformExtension& extension) {
|
|
extension.SetExtensionInformation(
|
|
"BuiltinMathematicalTools",
|
|
_("Mathematical tools"),
|
|
"A set of mathematical functions that can be used in expressions.",
|
|
"Florian Rival",
|
|
"Open source (MIT License)");
|
|
extension.AddInstructionOrExpressionGroupMetadata(_("Mathematical tools"))
|
|
.SetIcon("res/mathfunction.png");
|
|
|
|
extension
|
|
.AddExpression("Random",
|
|
_("Random integer"),
|
|
_("Random integer"),
|
|
"",
|
|
"res/dice-6.svg")
|
|
.SetHelpPath("/all-features/expressions")
|
|
.AddParameter("expression", _("Maximum value"));
|
|
|
|
extension
|
|
.AddExpression("RandomInRange",
|
|
_("Random integer in range"),
|
|
_("Random integer in range"),
|
|
"",
|
|
"res/dice-6.svg")
|
|
.SetHelpPath("/all-features/expressions")
|
|
.AddParameter("expression", _("Minimum value"))
|
|
.AddParameter("expression", _("Maximum value"));
|
|
|
|
extension
|
|
.AddExpression("RandomFloat",
|
|
_("Random float"),
|
|
_("Random float"),
|
|
"",
|
|
"res/dice-6.svg")
|
|
.SetHelpPath("/all-features/expressions")
|
|
.AddParameter("expression", _("Maximum value"));
|
|
|
|
extension
|
|
.AddExpression("RandomFloatInRange",
|
|
_("Random float in range"),
|
|
_("Random float in range"),
|
|
"",
|
|
"res/dice-6.svg")
|
|
.SetHelpPath("/all-features/expressions")
|
|
.AddParameter("expression", _("Minimum value"))
|
|
.AddParameter("expression", _("Maximum value"));
|
|
|
|
extension
|
|
.AddExpression("RandomWithStep",
|
|
_("Random value in steps"),
|
|
_("Random value in steps"),
|
|
"",
|
|
"res/dice-6.svg")
|
|
.SetHelpPath("/all-features/expressions")
|
|
.AddParameter("expression", _("Minimum value"))
|
|
.AddParameter("expression", _("Maximum value"))
|
|
.AddParameter("expression", _("Step"));
|
|
|
|
extension
|
|
.AddExpression("normalize",
|
|
_("Normalize a value between `min` and `max` to a value "
|
|
"between 0 and 1."),
|
|
_("Remap a value between 0 and 1."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Value"))
|
|
.AddParameter("expression", _("Min"))
|
|
.AddParameter("expression", _("Max"));
|
|
|
|
extension
|
|
.AddExpression("clamp",
|
|
_("Clamp (restrict a value to a given range)"),
|
|
_("Restrict a value to a given range"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Value"))
|
|
.AddParameter("expression", _("Min"))
|
|
.AddParameter("expression", _("Max"));
|
|
|
|
extension
|
|
.AddExpression("AngleDifference",
|
|
_("Difference between two angles"),
|
|
_("Difference between two angles"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("First angle, in degrees"))
|
|
.AddParameter("expression", _("Second angle, in degrees"));
|
|
|
|
extension
|
|
.AddExpression("AngleBetweenPositions",
|
|
_("Angle between two positions"),
|
|
_("Compute the angle between two positions (in degrees)."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("First point X position"))
|
|
.AddParameter("expression", _("First point Y position"))
|
|
.AddParameter("expression", _("Second point X position"))
|
|
.AddParameter("expression", _("Second point Y position"));
|
|
|
|
extension
|
|
.AddExpression("DistanceBetweenPositions",
|
|
_("Distance between two positions"),
|
|
_("Compute the distance between two positions."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("First point X position"))
|
|
.AddParameter("expression", _("First point Y position"))
|
|
.AddParameter("expression", _("Second point X position"))
|
|
.AddParameter("expression", _("Second point Y position"));
|
|
|
|
extension
|
|
.AddExpression("mod",
|
|
_("Modulo"),
|
|
_("Compute \"x mod y\". GDevelop does NOT support the \% "
|
|
"operator. Use this mod(x, y) function instead."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("x (as in x mod y)"))
|
|
.AddParameter("expression", _("y (as in x mod y)"));
|
|
|
|
extension
|
|
.AddExpression("min",
|
|
_("Minimum of two numbers"),
|
|
_("Minimum of two numbers"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("First expression"))
|
|
.AddParameter("expression", _("Second expression"));
|
|
|
|
extension
|
|
.AddExpression("max",
|
|
_("Maximum of two numbers"),
|
|
_("Maximum of two numbers"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("First expression"))
|
|
.AddParameter("expression", _("Second expression"));
|
|
|
|
extension
|
|
.AddExpression("abs",
|
|
_("Absolute value"),
|
|
_("Return the non-negative value by removing the sign. "
|
|
"The absolute value of -8 is 8."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("acos",
|
|
_("Arccosine"),
|
|
_("Arccosine, return an angle (in radian). "
|
|
"`ToDeg` allows to convert it to degrees."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("acosh",
|
|
_("Hyperbolic arccosine"),
|
|
_("Hyperbolic arccosine"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("asin",
|
|
_("Arcsine"),
|
|
_("Arcsine, return an angle (in radian). "
|
|
"`ToDeg` allows to convert it to degrees."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"asinh", _("Arcsine"), _("Arcsine"), "", "res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("atan",
|
|
_("Arctangent"),
|
|
_("Arctangent, return an angle (in radian). "
|
|
"`ToDeg` allows to convert it to degrees."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("atan2",
|
|
_("2 argument arctangent"),
|
|
_("2 argument arctangent (atan2)"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Y"))
|
|
.AddParameter("expression", _("X"));
|
|
|
|
extension
|
|
.AddExpression("atanh",
|
|
_("Hyperbolic arctangent"),
|
|
_("Hyperbolic arctangent"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"cbrt", _("Cube root"), _("Cube root"), "", "res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("ceil",
|
|
_("Ceil (round up)"),
|
|
_("Round number up to an integer"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("ceilTo",
|
|
_("Ceil (round up) to a decimal point"),
|
|
_("Round number up to the Nth decimal place"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"))
|
|
.AddParameter("expression", _("Expression"), "", true);
|
|
|
|
extension
|
|
.AddExpression("floor",
|
|
_("Floor (round down)"),
|
|
_("Round number down to an integer"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("floorTo",
|
|
_("Floor (round down) to a decimal point"),
|
|
_("Round number down to the Nth decimal place"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"))
|
|
.AddParameter("expression", _("Expression"), "", true);
|
|
|
|
extension
|
|
.AddExpression(
|
|
"cos",
|
|
_("Cosine"),
|
|
_("Cosine of an angle (in radian). "
|
|
"If you want to use degrees, use`ToRad`: `sin(ToRad(45))`."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("cosh",
|
|
_("Hyperbolic cosine"),
|
|
_("Hyperbolic cosine"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("cot",
|
|
_("Cotangent"),
|
|
_("Cotangent of a number"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("csc",
|
|
_("Cosecant"),
|
|
_("Cosecant of a number"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"int", _("Round"), _("Round a number"), "", "res/mathfunction.png")
|
|
.SetHidden()
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"rint", _("Round"), _("Round a number"), "", "res/mathfunction.png")
|
|
.SetHidden()
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"round", _("Round"), _("Round a number"), "", "res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("roundTo",
|
|
_("Round to a decimal point"),
|
|
_("Round a number to the Nth decimal place"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Number to Round"))
|
|
.AddParameter("expression", _("Decimal Places"), "", true);
|
|
|
|
extension
|
|
.AddExpression("exp",
|
|
_("Exponential"),
|
|
_("Exponential of a number"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"log", _("Logarithm"), _("Logarithm"), "", "res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"ln", _("Logarithm"), _("Logarithm"), "", "res/mathfunction.png")
|
|
.SetHidden()
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("log2",
|
|
_("Base-2 logarithm"),
|
|
_("Base 2 Logarithm"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("log10",
|
|
_("Base-10 logarithm"),
|
|
_("Base-10 logarithm"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("nthroot",
|
|
_("Nth root"),
|
|
_("Nth root of a number"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Number"))
|
|
.AddParameter("expression", _("N"));
|
|
|
|
extension
|
|
.AddExpression("pow",
|
|
_("Power"),
|
|
_("Raise a number to power n"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Number"))
|
|
.AddParameter("expression", _("The exponent (n in x^n)"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"sec", _("Secant"), _("Secant"), "", "res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("sign",
|
|
_("Sign of a number"),
|
|
_("Return the sign of a number (1,-1 or 0)"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"sin",
|
|
_("Sine"),
|
|
_("Sine of an angle (in radian). "
|
|
"If you want to use degrees, use`ToRad`: `sin(ToRad(45))`."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("sinh",
|
|
_("Hyperbolic sine"),
|
|
_("Hyperbolic sine"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("sqrt",
|
|
_("Square root"),
|
|
_("Square root of a number"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"tan",
|
|
_("Tangent"),
|
|
_("Tangent of an angle (in radian). "
|
|
"If you want to use degrees, use`ToRad`: `tan(ToRad(45))`."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("tanh",
|
|
_("Hyperbolic tangent"),
|
|
_("Hyperbolic tangent"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("trunc",
|
|
_("Truncation"),
|
|
_("Truncate a number"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Expression"));
|
|
|
|
extension
|
|
.AddExpression("lerp",
|
|
_("Lerp (Linear interpolation)"),
|
|
_("Linearly interpolate a to b by x"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("a (in a+(b-a)*x)"))
|
|
.AddParameter("expression", _("b (in a+(b-a)*x)"))
|
|
.AddParameter("expression", _("x (in a+(b-a)*x)"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"XFromAngleAndDistance",
|
|
_("X position from angle and distance"),
|
|
_("Compute the X position when given an angle and distance "
|
|
"relative to the origin (0;0). This is also known as "
|
|
"getting the cartesian coordinates of a 2D vector, using "
|
|
"its polar coordinates."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Angle, in degrees"))
|
|
.AddParameter("expression", _("Distance"));
|
|
|
|
extension
|
|
.AddExpression(
|
|
"YFromAngleAndDistance",
|
|
_("Y position from angle and distance"),
|
|
_("Compute the Y position when given an angle and distance "
|
|
"relative to the origin (0;0). This is also known as "
|
|
"getting the cartesian coordinates of a 2D vector, using "
|
|
"its polar coordinates."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Angle, in degrees"))
|
|
.AddParameter("expression", _("Distance"));
|
|
|
|
extension
|
|
.AddExpression("Pi",
|
|
_("Number Pi (3.1415...)"),
|
|
_("The number Pi (3.1415...)"),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.SetHelpPath("/all-features/expressions");
|
|
|
|
extension
|
|
.AddExpression("lerpAngle",
|
|
_("Lerp (Linear interpolation) between two angles"),
|
|
_("Linearly interpolates between two angles (in degrees) "
|
|
"by taking the shortest direction around the circle."),
|
|
"",
|
|
"res/mathfunction.png")
|
|
.AddParameter("expression", _("Starting angle, in degrees"))
|
|
.AddParameter("expression", _("Destination angle, in degrees"))
|
|
.AddParameter("expression", _("Interpolation value between 0 and 1."));
|
|
}
|
|
|
|
} // namespace gd
|