DCS func getPosition
From DCS World Wiki - Hoggitworld.com
| Envrioment: | Mission Scripting | ||
| Function: | getPosition | Added with: 1.2.0 | |
| Member Of: | Object, Spot | ||
| Syntax: | Position3 Object.getPosition(Class Self ) | ||
| Description: | Returns a Position3 table of the objects current position and orientation in 3D space.
Function also works with Unit, Weapon, Static Object, Scenery Object, Airbase
| ||
| Return Value: | Position3 | ||
| Return Example: | Position 3 is a table consisting of the point and orientation tables.
Position3 = {
p = Vec3, -- Object world position, same as getPoint().
x = Vec3, -- forward vector
y = Vec3, -- up vector
z = Vec3 -- right vector
}
| ||
| Examples: | Assigns a value for the heading and pitch of the unit.
local unit = Unit.getByName('Bob')
local unitpos = unit:getPosition()
local Heading = math.atan2(unitpos.x.z, unitpos.x.x)
local Pitch = math.asin(unitpos.x.y)
Spawn a crate 10 meters in front of the unit. local unit = Unit.getByName('Alice')
local unitpos = unit:getPosition()
local tenMetersInFront = {
x = unitpos.p.x + 10 * unitpos.x.x,
y = unitpos.p.y + 10 * unitpos.x.y,
z = unitpos.p.z + 10 * unitpos.x.z
}
coalition.addStaticObject(unit:getCoalition(), {
name = "Alice's cargo",
type = "uh1h_cargo",
x = tenMetersInFront.x,
y = tenMetersInFront.z -- y/z switcheroo converting from Vec3 to Vec2
})
| ||
| Related Functions: | Object Functions: isExist, destroy, getCategory, getTypeName, getDesc, hasAttribute, getName, getPoint, getPosition, getVelocity, inAir | ||
| Notes: | |||
