UnitsAndConstants

Units and constants

---

This file is automatically generated from java files. Do Not Edit It.

---

Introduction

Units can be used to qualify the values of numeric variables. By default, unqualified values are considered as:

• meters for distances, lengths...
• seconds for durations
• cubic meters for volumes
• kilograms for masses

So, an expression like:

float foo <- 1;

will be considered as 1 meter if foo is a distance, or 1 second if it is a duration, or 1 meter/second if it is a speed. If one wants to specify the unit, it can be done very simply by adding the unit symbol (° or #) followed by an unit name after the numeric value, like:

float foo <- 1 °centimeter;

or

float foo <- 1 #centimeter;

In that case, the numeric value of foo will be automatically translated to 0.01 (meter). It is recommended to always use float as the type of the variables that might be qualified by units (otherwise, for example in the previous case, they might be truncated to 0). Several units names are allowed as qualifiers of numeric variables. These units represent the basic metric and US units. Composed and derived units (like velocity, acceleration, special volumes or surfaces) can be obtained by combining these units using the * and / operators. For instance:

float one_kmh <- 1 °km / °h const: true;
float one_millisecond <-1 °sec / 1000;
float one_cubic_inch <- 1 °sqin * 1 °inch;
... etc ...

Table of Contents

<wiki:toc max_depth="3" />

---

Colors

In addition to the previous units, GAML provides a direct access to the 147 named colors defined in CSS (see http://www.cssportal.com/css3-color-names/). E.g,

rgb my_color <- °teal;