# Functions

Returns	Syntax	Description	Example
A random number	`RAND()` no parameters	Generates a random number	`RAND()` will output a random value between 0 and 1, e.g. `0.625` `RAND()*10` will output a random value between 0 and 10, e.g. `6.25`
Rounded number	`ROUND(value, digits)` value (Number): the number to be rounded. digits (Integer): the number of decimal places to round to.	Rounds a number to the specified number of decimal places	Example: `ROUND(3.14159, 2)` → `3.14`
Number of characters in the string, including spaces	`LEN("value")` value (String): the input string whose length is to be determined	Returns the length of a string	`LEN("hello")` will output a value of `5`
Either `trueValue` or `falseValue`depending on the condition	`IF(condition,trueValue,falseValue)` condition (Expression): A logical expression that evaluates to true or false trueValue (Any): The value returned if the condition is true falseValue (Any): The value returned if the condition is false	Returns one value if a condition is true and another value if it is false	`IF` `(temperature` `<` `10, “cold”, “hot")` if `temperature` `=` `5` , the result is "cold", but if `temperature` `=` `15` , the result is "hot".
Result of the evaluated expression	`EVAL` `(expression)`	Re-evaluates a string as an expression and returns the result. expression (String): a valid expression in string format to be evaluated.	`EVAL(”5` `+` `5”)` `=` `10`
Numeric value represented by the string, or an error if the conversion is not possible	`TO_NUMBER(value)`	Converts a string to its numerical representation, if possible.	`TO_NUMBER`(”5”) returns the number representation of the string, in this case 5, if possible. If the input is not a valid number (e.g., "abc"), it returns an error.
Time passed between frames as a floating-point number, typically measured in seconds	`DELTA_TIME`	Retrieves the time elapsed between the current frame and the previous frame. Commonly used in “on update” interactions to ensure smooth and consistent motion or timing.	If `DELTA_TIME` returns `0.016` (16 milliseconds), it can be used for animations or movement calculations: `position += speed * DELTA_TIME`
Value from the target range that corresponds to the key in the lookup range	`XLOOKUP(dataset, key, lookupRange, targetRange)` `dataset (Array)` the dataset containing the lookup and target ranges. `key (Any)` the value to search for in the lookup range. `lookupRange (Array)` the range where the key will be searched. `targetRange (Array)` the range from which the corresponding value will be returned. Note: the `dataset` argument is required. XLOOKUP only accepts the 4-argument form; the 3-argument form `XLOOKUP(key, lookupRange, targetRange)` is not supported and will return unexpected results without raising an error.	Searches for a key in a lookup range and returns the corresponding value from a target range.	`XLOOKUP`(salesData, "Product A", salesData["A"], salesData["B"]) → Returns the value from column B in the row where column A equals "Product A"
Value of the specified property from the target entity, which could include objects, settings, or other accessible data types	`GET(target, propertyName)`	Retrieves the value of a specified property from a target entity. This can be used to access various attributes, settings, or metadata across different types of objects or entities.	`GET(OBJ("Box"), "position")` → Retrieves the position of the object named "Box”
Reference to the specified object, which can then be used in other functions or operations	`OBJ(name)` name (String) the name of the object to retrieve	Retrieves a reference to an object by its name. This is used to interact with specific objects.	`OBJ`("Box") → Retrieves the object named "Box" for further interaction
	`UI`	Same as above
	`VAR`	Same as above
	`PARENT_OF`	Same as above
	`CHILDREN_OF`	Same as above
Contextual reference to the current object, component, or environment	`SELF`
In an interaction, returns the trigger	`TRIGGER`	In an interaction, returns the trigger or event that initiated the action.	Interaction: trigger ”on click”, action “set variable” → TRIGGER() will return the object name clicked
Scalar value representing the dot product of the two vectors. A positive result indicates alignment, zero indicates perpendicularity, and a negative result indicates opposing directions	`DOT(v1, v2)` `v1 (Vector)` the first input vector `v2 (Vector)` the second input vector	Calculates the dot product of two vectors. The dot product is a scalar value that represents the magnitude of one vector projected onto another.	`DOT([1, 0, 0], [0, 1, 0])` → 0 (vectors are perpendicular)
Vector that is perpendicular to both input vectors	`CROSS(v1, v2)`	Calculates the cross product of two vectors. The cross product results in a new vector that is perpendicular to both input vectors and represents the area of the parallelogram formed by the vectors.	`CROSS([1, 0, 0], [0, 1, 0]) → [0, 0, 1]` a vector perpendicular to both input vectors
Scalar value representing the length of the vector	`MAGNITUDE(vector)`	Calculates the magnitude (length) of a vector. The magnitude represents the distance of the vector from the origin in space.	`MAGNITUDE([3, 4, 0])` → 5 (calculated as √(3² + 4² + 0²))
Unit vector with the same direction as the input vector but a magnitude of 1	`NORMALIZE(vector)`	Converts a vector into a unit vector (a vector with a magnitude of 1) while maintaining its direction.	`NORMALIZE([3, 4, 0])` → [0.6, 0.8, 0] (calculated by dividing each component by the magnitude, √(3² + 4² + 0²) = 5).
A value or vector between `v1` and v2 based on the interpolation factor `factor`	`LERP(v1, v2, factor)` `v1 (Number or Vector)` the starting value or vector of the interpolation `v2 (Number or Vector)` the ending value or vector of the interpolation `factor (Number)` the interpolation factor, a value between 0 and 1, where 0 represents `v1` and 1 represents `v2`	Performs linear interpolation between two values or vectors based on a given ratio.	`LERP([0, 0], [10, 10], 0.5)` → [5, 5] (halfway between the two vectors)

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.vectary.com/documentation/3d-configurator/variables-and-expressions/functions.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.