OpenSpace expects the models to be in the unit Meter, however there are many models that are developed in a different unit, for example Centimeters or Feet. Previously this scaling problem has been solved by applying a
StaticScale to the model. In the release 0.17.0 there is a new tool that makes this easier. If you are aware that your model has been developed in Centimeters, or any other unit than Meters, you can specify that in the asset file with the key
GeometryFile = models .. "/ISS.fbx", ModelScale = "Centimeter",
This will make OpenSpace interpret every unit in the model as Centimeters instead of Meters. If this scale would not be applied then every Centimeter in the model would be interpreted as Meters, and this would make the model look 100 times bigger than intended. So with the
ModelScale the model is scaled down with the specified unit.
In some cases it would be useful to instead scale the model up with a specified unit. For example if the model was developed in a Meter unit software but every Meter was treated as a Foot by the modeler. In this case OpenSpace would interpret the Meters as Meters instead of as Feet and the model would appear smaller than what the modeler intended. If the
ModelScale is applied to this model in a similar manner as before, OpenSpace would scale it down making the model even smaller. So in this case the
ModelScale needs to be inverted, scaling the model up, to show the model in the size that the modeler intended and this can be done with the key
GeometryFile = model .. "/JWSTFBX.osmodel", ModelScale = "Foot", InvertModelScale = true,
It is also possible to give the
ModelScale key a numerical value instead of a unit name to scale the model by an arbitrary value. If the value is smaller than 1 then the model is scaled down and if the value is bigger than 1 the model is scaled up.
GeometryFile = models .. "/ISS.fbx", ModelScale = 0.01,
In short if the model was developed in a unit other than Meters then use the
ModelScale key to scale the model down with that unit. However, if the model was developed in Meters but intended to be interpreted as another unit then the scale needs to be inverted with the key