DCS func getPosition - Revision history

Gcask: Adding information on orientation vector + example.

2024-07-22T13:16:05Z

Adding information on orientation vector + example.

Loophole 62ndFF at 09:09, 28 January 2023

2023-01-28T09:09:41Z

Grimes at 23:56, 20 March 2022

2022-03-20T23:56:41Z

Grimes at 11:32, 7 March 2022

2022-03-07T11:32:04Z

Grimes: 1 revision imported

2018-04-12T00:12:22Z

1 revision imported

New page

{{Template:dcs_funcs

|fName= getPosition

|vNum= 1.2.0

|par1= [[DCS_Class_Object|Object]]

|par2= [[DCS_Class_Spot| Spot]]

|par3=

|par4=

|desc= Returns a pos3 table of the objects current position and orientation in 3D space. X, Y, Z values are unit vectors defining the objects orientation. Coordinates are dependent on the position of the maps origin. In the case of the Caucuses theater, the origin is located in the Crimean region of the map.

Function also works with [[DCS_Class_Unit|Unit]], [[DCS_Class_Weapon|Weapon]], [[DCS_Class_Static_Object|Static Object]], [[DCS_Class_Scenery_Object|Scenery Object]], [[DCS_Class_Airbase|Airbase]]

|rtnType= vec3

|rtnExample= Position 3 is a table consisting of the point and orientation tables.
Position3 = { p = Vec3,
x = Vec3,
y = Vec3,
z = Vec3 }

|reqType1= Class

|reqName1= Self

|reqType2=

|reqName2=

|optType1=

|optType2=

|related=
[[DCS_Class_Object|'''Object Functions:''']] {{listofScriptingObjectFuncs}}

|examples=

|notes=
}}
[[Category:Class Functions|getPosition]]

@@ Line 13: / Line 13: @@
 |par4=
-|desc= Returns a Position3 table of the objects current position and orientation in 3D space. X, Y, Z values are unit vectors defining the objects orientation. Coordinates are dependent on the position of the maps origin. In the case of the Caucuses theater, the origin is located in the Crimean region of the map.
+|desc= Returns a Position3 table of the objects current position and orientation in 3D space.
 Function also works with [[DCS_Class_Unit|Unit]], [[DCS_Class_Weapon|Weapon]], [[DCS_Class_Static_Object|Static Object]], [[DCS_Class_Scenery_Object|Scenery Object]], [[DCS_Class_Airbase|Airbase]]
@@ Line 20: / Line 29: @@
 |rtnExample= Position 3 is a table consisting of the point and orientation tables.
-  Position3 = {   p = Vec3,
+  Position3 = {
-                 x = Vec3,
+   p = Vec3, -- Object world position, same as getPoint().
-                 y = Vec3,
+   x = Vec3, -- forward vector
-                 z = Vec3 }
+   y = Vec3, -- up vector
 |reqType1= Class
@@ Line 46: / Line 57: @@
      local Heading = math.atan2(unitpos.x.z, unitpos.x.x)
      local Pitch = math.asin(unitpos.x.y)
 |notes=

← Older revision		Revision as of 23:56, 20 March 2022
Line 50:		Line 50:
	}}		}}
	[[Category:Class Functions\|getPosition]]		[[Category:Class Functions\|getPosition]]
		+	[[Category:Game Patch 1.2.0\|getPosition]]

@@ Line 40: / Line 40: @@
 [[DCS_Class_Object|'''Object Functions:''']] {{listofScriptingObjectFuncs}}
-|examples=
+|examples= Assigns a value for the heading and pitch of the unit.
 |notes=
 }}
 [[Category:Class Functions|getPosition]]