Click or drag to resize

3.2.2 Units

When using the API and defining coordinates of a job element or setting the marking speed e. g., you need to know the units in which these values have to be handed over. These are always the same throughout all methods or properties when not stated otherwise.
Attention: The units displayed in the GUI may differ from the ones given in this table:

Units used in the API

Quantity

Unit

Example

Note

Length

micrometre (µm)

MarkableRectangle r = new MarkableRectangle { Size = new dvec2( 20000, 10000 ) };

Creates a rectangle with a size of 20 mm x 10 mm.

Angle

radian (rad)

r.Rotate(0.5);

Rotates the rectangle by 0.5 rad ≈ 28.6°; to convert degrees into rad the formula rad = degree*π/180 can be used.

Time

microsecond (µs)

r.MarkerProfile.DefaultPen.JumpDelay = 500;

Sets the jump delay of the rectangle's default pen to 0.5 seconds.

Timeout

milliseconds (ms)

scanController.SerialController.Ports[0].ReadTimeout = 1000;

Sets the read timeout of a serial controller port of a BaseScanController object to 1 s.

Velocity

meter per second (m/s)

r.MarkerProfile.DefaultPen.MarkSpeed = 10;

Sets the mark speed of the rectangle's default pen to 10 m/s; equivalent to 10 µm/µs.

Frequency

megahertz (MHz)

r.MarkerProfile.DefaultPen.LaserFrequency = 0.05;

Sets the laser frequency 0.05 MHz; equivalent to 50 kHz.

Laser power

Value between 0 and 1.

r.MarkerProfile.DefaultPen.LaserPower = 0.75;

Sets the laser power to 75 % of its maximal power.