Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

What Are Variables

A variable can be seen as container to store a value. There are variable types for single values:

  • Integers contain positive and negative numbers like 3, 15457, -644, or 7432854.
  • Floats are numbers with digits such as 3.14, -8454.9644, or 7.73211.
  • Strings contain text enclosed in quotes, e.g. "Warning: Domains have different resolution settings!", or "Object successfully loaded."
  • Booleans are True or False.

Other variable types are able to store more than value:

  • Vectors contain three values. Typical examples are position, velocity, or rotation.
  • Lists can store huge amounts of data like a domain's particles, a project's objects, or all density values of a particle simulation.

Assigning Variables

Assigning a value to a variable is easy:

...

  • Always use meaningful variable names to avoid confusion and keep your scripts readable.
  • When a name is used again its original value will be overwritten.
  • Only use the following characters for variable names: A-Z, a-z, 0-9, and the underscore
  • Lists can contain different variable types, even other lists or variables, e.g. mixedValues = ["Cube01", 3.14, 200, ["DY_Emitter01", "DY_Emitter02"]]

Working with Variables

With variables it is possible to perform all kinds of calculations, but the data type (integer, float, vector) has to be exactly the same, or . Otherwise you will get errors or a false results:

  • vector3 = Vector.new(0,1,0) + Vector.new(1,0,1)
  • mass    = 677.533 / 2.0
  • newId   = 3 * 100

...

You cannot perform calculations with lists and Booleans, but strings can be concatenated and repeated:

  • newName = "Sphere"+"_Imported"
  • warning = "Don't touch this parameter! " * 3