Also available as Markdown and JSON, or read the original wiki page.
Translates relative position from object model space to world space in PositionAGL format.
This command will take into account vectorUp of the object when calculating relative coordinates. For the PositionASL version of this command, see modelToWorldWorld.
Important
For scaled objects, the relative position will first be multiplied by the object scale.
For example, if the object scale is 2,
_obj modelToWorld [0,1,0]will be offset 2 meters from the model center ([0,0,0]).
model modelToWorld position
Parameters:
model: Objectposition: PositionRelative - [x,y,z] offset relative to the model centreReturns: PositionAGL - translated world position
_aboveAndBehindPlayer = player modelToWorld [0,-1,3];
vectorModelToWorld · modelToWorldVisual · worldToModel · modelToWorldWorld · modelToWorldVisualWorld · selectionPosition
The worldPos parameter appears to be a relative offset to the position of object, so it can often simply be [0,0,0].
Example: to position an object _obj relative to the position of another object _relObj with on offset of _offset, try:
_offset = [_x,_y,_z];
_worldPos = _relObj modelToWorld _offset;
_obj setPos _worldPos;
The object model space has got its Z-Axis along the object's vectorUp, its Y-Axis along the object's vectorDir, while its X-Axis goes along vectorDir x VectorUp (meaning as the X-Axis in a right-handed cartesian coordiante system).
If your object requires a new direction, ensure you call setDir prior to setPosATL when using modelToWorld. Calling setDir afterwards will skew its position otherwise.
_ladder setDir _angle;
_ladder setPosATL (_building modelToWorld [_x, _y, _z]);
The z height returned changes dynamically with the height of waves beneath the object, if the object is located over sea. The z height returned by getPosATL and getPosASL does not change like this. This was tested by continuously retrieving the position of a static object, like the cross in the empty/corpses category, placed over sea or land. modelToWorld behaves similar to getPos but it does not give the same result, therefore
_obj modelToWorld [0.0, 0.0, 0.0]
is not the same as
getPos _obj;
.