Homeworld Effects Manual: setLengthDist()

setLengthDist(float value)

Legal values: all real numbers.

Default value: 0

setLengthDist() has no effect if there is a setScale(1) active at the same time, just like setLength().

setLength() acts on differently on different types of objects:

Effects: Other effects usually call setDefaults() before creating anything, so setLengthDist() in the calling file will have no effect. It is possible to have a file that does not call setDefaults() at the beginning and thus depends on the calling file for some attributes, but such files are risky. If the calling file does not provide what the file is expecting, it may produce garbage.

Meshes: setLengthDist() uses units that are the length of the mesh. So setLengthDist(0.5) will make a 50m long mesh be up to 25m longer of shorter than it should be, given its Scale and Length attributes. Many of the meshes used by Homeworld are 1m across, so value is in meters. If LengthDist is greater then Length, some of your objects may end up backwards.

Sprites: Sprites are 2-dimensional and have no length, so setLengthDist() has no effect.

Circles: Circles are 2-dimensional and have no length, so setLengthDist() has no effect.

Lines: value is uncertainty in the length of the line, in meters.

Points: Points do not have length, so setLengthDist() has no effect.