Numbers

On this page

Edit

Clamp #

Clamps a variable between two values. Intended to use on real values (numbers) only.

If value of the variable < minimum allowed value, returns minimum allowed value.
If value of the variable > maximum allowed value, returns maximum allowed value.
If value of the variable is within the allowed range, returns the original value.

Do not use Math: Clamp on strings, as this will result in a syntax error and SAMMI crashing.

Box Name	Type	Description
Variable Name	String	Name of the variable to clamp.
Minimum Value Allowed	Number	Minimum value allowed.
Maximum Value Allowed	Number	Maximum value allowed.

Value	Clamp Min	Clamp Max	Result
20	50	120	50
75	50	120	75
980	50	120	120

Edit

Random #

Returns a variable with a random value (number) between minimum and maximum possible value.
This is a basic command you can use for showing random images, playing random videos/sounds, picking a random viewer from chat etc.
If you wish to have more power over randomizing values (like adding weights), it is best to use Arrays instead.

Float is a number that has a decimal point.

Box Name	Type	Description
Variable Name	String	Name of the variable to save the random value.
Minimum Value Allowed	Number	Minimum value possible.
Maximum Value Allowed	Number	Maximum value possible.
Allow Float	checkbox	checked = random value returned can never be the maximum or minimum value itself unchecked = random value returned can be anything including maximum and minimum possible value Any float value in minimum or maximum value is omitted if Float is set to False.

Edit

Hex String to Number #

Converts a hexadecimal string into a real (decimal) number.

Box Name	Type	Description
Save Variable As	String	Name of a variable to save the converted value.
Hex String Variable		Hex string variable to convert.

Hex string value	Returned real value
A	10
1d	29
1F4	500

Edit

Number to Hex String #

Converts a number to a hex string.

Box Name	Type	Description
Save Variable As	String	Name of a variable to save the hex value
Variable/Number		Variable or Number you want to covert to hex
Byte Count	Number	Byte count of the hex string

Edit

String to Number #

Turns a string value into a real value (number).

returns 0 if the string does not start with a number or .
stops the conversion if it encounters any non number in the string and returns the current converted value
converting a value that’s already real returns the same value
removes any leading zeroes and rounds the number to 2 decimal points
string X beginning with a . will be converted to 0.X
accepts strings with scientific notation

Box Name	Type	Description
Save Variable As	String	Name of a variable to save the real value.
String Variable	String	Name of a variable containing the string to convert.

String Variable value	Returned real value
“Hello World”	0
“Hello World 123”	0
“123 Hello World”	123
“123 Hello World 456”	123
“.99”	0.99
“1.239999”	1.24
“000010”	10
“10e-2”	0,10
“10e+2”	1000
10	10

Edit

Swap Red & Blue #

Swaps red and blue value for a color in DEC format and returns its DEC value. Useful for converting HTML colors to SAMMI or OBS colors.
SAMMI uses BGR colors while OBS uses ABGR colors, instead of RGB colors.

If you have a Hex string (like #1f9250) use Hex String To Number to get a decimal number which you can use to swap red and blue values

As mentioned above, OBS uses ABGR. If you're converting for use in OBS, add the number 4278190080 after conversion to make it work. Check the example below.

Box Name	Type	Description
Variable Name	String	Name of the variable containing the color value to swap red and blue.

Edit

Number to String #

Turns a real value (number) into a string value.

Box Name	Type	Description
Save Variable As	String	Name of a variable to save the string value.
Number/Variable	Number	Number to convert.