Module `Point`

Core - POINT_VEC classes define an extensive API to manage 3D points in the simulation space.

Banner Image

Demo Missions

POINT_VEC Demo Missions source code

POINT_VEC Demo Missions, only for beta testers

ALL Demo Missions pack of the last release

YouTube Channel

API CHANGE HISTORY

The underlying change log documents the API changes. Please read this carefully. The following notation is used:

Added parts are expressed in bold type face.
Removed parts are expressed in italic type face.

Hereby the change log:

2017-03-03: POINT_VEC3:Explosion( ExplosionIntensity ) added.
2017-03-03: POINT_VEC3:IlluminationBomb() added.

2017-02-18: POINT_VEC3:NewFromVec2( Vec2, LandHeightAdd ) added.

2016-08-12: POINT_VEC3:Translate( Distance, Angle ) added.

2016-08-06: Made PointVec3 and Vec3, PointVec2 and Vec2 terminology used in the code consistent.

Replaced method PointVec3() to Vec3() where the code manages a Vec3. Replaced all references to the method.
Replaced method PointVec2() to Vec2() where the code manages a Vec2. Replaced all references to the method.
Replaced method RandomPointVec3() to RandomVec3() where the code manages a Vec3. Replaced all references to the method. .

Authors:

FlightControl : Design & Programming

Contributions:

Global(s)

POINT_VEC2

POINT_VEC2 class, extends Point#POINT_VEC3

The Point#POINT_VEC2 class defines a 2D point in the simulator.

POINT_VEC3

POINT_VEC3 class, extends Base#BASE

POINT_VEC3 defines a 3D point in the simulator and with its methods, you can use or manipulate the point in 3D space.

Type `POINT_VEC2`

POINT_VEC2:AddAlt(Altitude)	Add to the current land height an altitude.
POINT_VEC2:AddX(x)	Add to the x coordinate of the POINT_VEC2.
POINT_VEC2:AddY(y)	Add to the y coordinate of the POINT_VEC2.
POINT_VEC2:DistanceFromPointVec2(PointVec2Reference)	Calculate the distance from a reference #POINT_VEC2.
POINT_VEC2:DistanceFromVec2(Vec2Reference)	Calculate the distance from a reference DCSTypes#Vec2.
POINT_VEC2:GetAlt()	Return the altitude (height) of the land at the POINT_VEC2.
POINT_VEC2:GetAltitudeText()	Return no text for the altitude of the POINT_VEC2.
POINT_VEC2:GetLat()	Return Return the Lat(itude) coordinate of the POINTVEC2 (ie: (parent)POINTVEC3.x).
POINT_VEC2:GetLon()	Return the Lon(gitude) coordinate of the POINTVEC2 (ie: (parent)POINTVEC3.z).
POINT_VEC2:GetX()	Return the x coordinate of the POINT_VEC2.
POINT_VEC2:GetY()	Return the y coordinate of the POINT_VEC2.
POINT_VEC2:New(x, y, LandHeightAdd)	POINT_VEC2 constructor.
POINT_VEC2:NewFromVec2(Vec2, LandHeightAdd)	Create a new POINT_VEC2 object from Vec2 coordinates.
POINT_VEC2:NewFromVec3(Vec3)	Create a new POINT_VEC2 object from Vec3 coordinates.
POINT_VEC2:SetAlt(Altitude)	Set the altitude of the POINT_VEC2.
POINT_VEC2:SetLat(x)	Set the Lat(itude) coordinate of the POINTVEC2 (ie: POINTVEC3.x).
POINT_VEC2:SetLon(y, z)	Set the Lon(gitude) coordinate of the POINTVEC2 (ie: POINTVEC3.z).
POINT_VEC2:SetX(x)	Set the x coordinate of the POINT_VEC2.
POINT_VEC2:SetY(y)	Set the y coordinate of the POINT_VEC2.
POINT_VEC2:Translate(Distance, Angle)	Add a Distance in meters from the POINTVEC2 orthonormal plane, with the given angle, and calculate the new POINTVEC2.
POINT_VEC2.x	The x coordinate in meters.
POINT_VEC2.y	the y coordinate in meters.
POINT_VEC2.z

Type `POINT_VEC3`

POINT_VEC3:AddX(x)	Add to the x coordinate of the POINT_VEC3.
POINT_VEC3:AddY(y)	Add to the y coordinate of the POINT_VEC3.
POINT_VEC3:AddZ(z)	Add to the z coordinate of the POINT_VEC3.
POINT_VEC3:Explosion(ExplosionIntensity)	Creates an explosion at the point of a certain intensity.
POINT_VEC3:Flare(FlareColor, (, Azimuth)	Flares the point in a color.
POINT_VEC3.FlareColor
POINT_VEC3:FlareGreen((, Azimuth)	Flare the POINT_VEC3 Green.
POINT_VEC3:FlareRed(Azimuth)	Flare the POINT_VEC3 Red.
POINT_VEC3:FlareWhite((, Azimuth)	Flare the POINT_VEC3 White.
POINT_VEC3:FlareYellow((, Azimuth)	Flare the POINT_VEC3 Yellow.
POINT_VEC3:Get2DDistance(TargetPointVec3)	Return the 2D distance in meters between the target POINTVEC3 and the POINTVEC3.
POINT_VEC3:Get3DDistance(TargetPointVec3)	Return the 3D distance in meters between the target POINTVEC3 and the POINTVEC3.
POINT_VEC3:GetAltitudeText()	Return the altitude text of the POINT_VEC3.
POINT_VEC3:GetAngleDegrees(DirectionVec3)	Return an angle in degrees from the POINT_VEC3 using a direction vector in Vec3 format.
POINT_VEC3:GetAngleRadians(DirectionVec3)	Return an angle in radians from the POINT_VEC3 using a direction vector in Vec3 format.
POINT_VEC3:GetBRText(TargetPointVec3)	Return a BR string from a POINTVEC3 to the POINTVEC3.
POINT_VEC3:GetDirectionVec3(TargetPointVec3)	Return a direction vector Vec3 from POINTVEC3 to the POINTVEC3.
POINT_VEC3:GetNorthCorrectionRadians()	Get a correction in radians of the real magnetic north of the POINT_VEC3.
POINT_VEC3:GetRandomPointVec2InRadius(OuterRadius, InnerRadius)	Return a random POINTVEC2 within an Outer Radius and optionally NOT within an Inner Radius of the POINTVEC3.
POINT_VEC3:GetRandomPointVec3InRadius(OuterRadius, InnerRadius)	Return a random POINTVEC3 within an Outer Radius and optionally NOT within an Inner Radius of the POINTVEC3.
POINT_VEC3:GetRandomVec2InRadius(OuterRadius, InnerRadius)	Return a random Vec2 within an Outer Radius and optionally NOT within an Inner Radius of the POINT_VEC3.
POINT_VEC3:GetRandomVec3InRadius(OuterRadius, InnerRadius)	Return a random Vec3 within an Outer Radius and optionally NOT within an Inner Radius of the POINT_VEC3.
POINT_VEC3:GetVec2()	Return the coordinates of the POINT_VEC3 in Vec2 format.
POINT_VEC3:GetVec3()	Return the coordinates of the POINT_VEC3 in Vec3 format.
POINT_VEC3:GetX()	Return the x coordinate of the POINT_VEC3.
POINT_VEC3:GetY()	Return the y coordinate of the POINT_VEC3.
POINT_VEC3:GetZ()	Return the z coordinate of the POINT_VEC3.
POINT_VEC3:IlluminationBomb()	Creates an illumination bomb at the point.
POINT_VEC3:IsMetric()	Gets if the POINT_VEC3 is metric or NM.
POINT_VEC3.Metric
POINT_VEC3:New(x, y, z)	Create a new POINT_VEC3 object.
POINT_VEC3:NewFromVec2(Vec2, LandHeightAdd)	Create a new POINT_VEC3 object from Vec2 coordinates.
POINT_VEC3:NewFromVec3(Vec3)	Create a new POINT_VEC3 object from Vec3 coordinates.
POINT_VEC3.RoutePointAction
POINT_VEC3:RoutePointAir(AltType, Type, Action, Speed, SpeedLocked)	Build an air type route point.
POINT_VEC3.RoutePointAltType
POINT_VEC3:RoutePointGround(Speed, Formation)	Build an ground type route point.
POINT_VEC3.RoutePointType
POINT_VEC3:SetMetric(Metric)	Sets the POINT_VEC3 metric or NM.
POINT_VEC3:SetX(x)	Set the x coordinate of the POINT_VEC3.
POINT_VEC3:SetY(y)	Set the y coordinate of the POINT_VEC3.
POINT_VEC3:SetZ(z)	Set the z coordinate of the POINT_VEC3.
POINT_VEC3:Smoke(SmokeColor)	Smokes the point in a color.
POINT_VEC3:SmokeBlue()	Smoke the POINT_VEC3 Blue.
POINT_VEC3.SmokeColor
POINT_VEC3:SmokeGreen()	Smoke the POINT_VEC3 Green.
POINT_VEC3:SmokeOrange()	Smoke the POINT_VEC3 Orange.
POINT_VEC3:SmokeRed()	Smoke the POINT_VEC3 Red.
POINT_VEC3:SmokeWhite()	Smoke the POINT_VEC3 White.
POINT_VEC3:ToStringBR(AngleRadians, Distance)	Provides a Bearing / Range string
POINT_VEC3:ToStringLL(AngleRadians, Distance, acc, DMS)	Provides a Bearing / Range string
POINT_VEC3:Translate(Distance, Angle)	Add a Distance in meters from the POINTVEC3 horizontal plane, with the given angle, and calculate the new POINTVEC3.
POINT_VEC3.x	The x coordinate in 3D space.
POINT_VEC3.y	The y coordinate in 3D space.
POINT_VEC3.z	The z coordiante in 3D space.

Type `POINT_VEC3.RoutePointAction`

POINT_VEC3.RoutePointAction.FromParkingArea	"From Parking Area"
POINT_VEC3.RoutePointAction.TurningPoint	"Turning Point"

Type `POINT_VEC3.RoutePointAltType`

POINT_VEC3.RoutePointAltType.BARO

"BARO"

Type `POINT_VEC3.RoutePointType`

POINT_VEC3.RoutePointType.TakeOffParking	"TakeOffParking"
POINT_VEC3.RoutePointType.TurningPoint	"Turning Point"

Global(s)

#POINT_VEC2 POINT_VEC2

POINT_VEC2 class, extends Point#POINT_VEC3

The Point#POINT_VEC2 class defines a 2D point in the simulator.

The height coordinate (if needed) will be the land height + an optional added height specified.

POINT_VEC2 constructor

A new POINT_VEC2 instance can be created with:

Point#POINT_VEC2.New(): a 2D point, taking an additional height parameter.
Point#POINT_VEC2.NewFromVec2(): a 2D point created from a DCSTypes#Vec2.

Manupulate the X, Altitude, Y coordinates of the 2D point

A POINT_VEC2 class works in 2D space, with an altitude setting. It contains internally an X, Altitude, Y coordinate. Methods exist to manupulate these coordinates.

The current X, Altitude, Y axis can be retrieved with the methods POINT_VEC2.GetX(), POINT_VEC2.GetAlt(), POINT_VEC2.GetY() respectively. The methods POINT_VEC2.SetX(), POINT_VEC2.SetAlt(), POINT_VEC2.SetY() change the respective axis with a new value. The current Lat(itude), Alt(itude), Lon(gitude) values can also be retrieved with the methods POINT_VEC2.GetLat(), POINT_VEC2.GetAlt(), POINT_VEC2.GetLon() respectively. The current axis values can be changed by using the methods POINT_VEC2.AddX(), POINT_VEC2.AddAlt(), POINT_VEC2.AddY() to add or substract a value from the current respective axis value. Note that the Set and Add methods return the current POINT_VEC2 object, so these manipulation methods can be chained... For example:

 local Vec2 = PointVec2:AddX( 100 ):AddY( 2000 ):GetVec2()

#POINT_VEC3 POINT_VEC3

POINT_VEC3 class, extends Base#BASE

POINT_VEC3 defines a 3D point in the simulator and with its methods, you can use or manipulate the point in 3D space.

Important Note: Most of the functions in this section were taken from MIST, and reworked to OO concepts. In order to keep the credibility of the the author, I want to emphasize that the formulas embedded in the MIST framework were created by Grimes or previous authors, who you can find on the Eagle Dynamics Forums.

POINT_VEC3 constructor

A new POINT_VEC3 object can be created with:

POINT_VEC3.New(): a 3D point.
POINT_VEC3.NewFromVec3(): a 3D point created from a DCSTypes#Vec3.

Manupulate the X, Y, Z coordinates of the POINT_VEC3

A POINT_VEC3 class works in 3D space. It contains internally an X, Y, Z coordinate. Methods exist to manupulate these coordinates.

The current X, Y, Z axis can be retrieved with the methods POINT_VEC3.GetX(), POINT_VEC3.GetY(), POINT_VEC3.GetZ() respectively. The methods POINT_VEC3.SetX(), POINT_VEC3.SetY(), POINT_VEC3.SetZ() change the respective axis with a new value. The current axis values can be changed by using the methods POINT_VEC3.AddX(), POINT_VEC3.AddY(), POINT_VEC3.AddZ() to add or substract a value from the current respective axis value. Note that the Set and Add methods return the current POINT_VEC3 object, so these manipulation methods can be chained... For example:

 local Vec3 = PointVec3:AddX( 100 ):AddZ( 150 ):GetVec3()

Create waypoints for routes

A POINT_VEC3 can prepare waypoints for Ground and Air groups to be embedded into a Route.

POINT_VEC3.RoutePointAir(): Build an air route point.
POINT_VEC3.RoutePointGround(): Build a ground route point.

Route points can be used in the Route methods of the Group#GROUP class.

Smoke, flare, explode, illuminate

At the point a smoke, flare, explosion and illumination bomb can be triggered. Use the following methods:

Smoke

POINT_VEC3.Smoke(): To smoke the point in a certain color.
POINT_VEC3.SmokeBlue(): To smoke the point in blue.
POINT_VEC3.SmokeRed(): To smoke the point in red.
POINT_VEC3.SmokeOrange(): To smoke the point in orange.
POINT_VEC3.SmokeWhite(): To smoke the point in white.
POINT_VEC3.SmokeGreen(): To smoke the point in green.

Flare

POINT_VEC3.Flare(): To flare the point in a certain color.
POINT_VEC3.FlareRed(): To flare the point in red.
POINT_VEC3.FlareYellow(): To flare the point in yellow.
POINT_VEC3.FlareWhite(): To flare the point in white.
POINT_VEC3.FlareGreen(): To flare the point in green.

Explode

POINT_VEC3.Explosion(): To explode the point with a certain intensity.

Illuminate

POINT_VEC3.IlluminationBomb(): To illuminate the point.

3D calculation methods

Various calculation methods exist to use or manipulate 3D space. Find below a short description of each method:

Distance

POINT_VEC3.Get3DDistance(): Obtain the distance from the current 3D point to the provided 3D point in 3D space.
POINT_VEC3.Get2DDistance(): Obtain the distance from the current 3D point to the provided 3D point in 2D space.

Angle

POINT_VEC3.GetAngleDegrees(): Obtain the angle in degrees from the current 3D point with the provided 3D direction vector.
POINT_VEC3.GetAngleRadians(): Obtain the angle in radians from the current 3D point with the provided 3D direction vector.
POINT_VEC3.GetDirectionVec3(): Obtain the 3D direction vector from the current 3D point to the provided 3D point.

Translation

POINT_VEC3.Translate(): Translate the current 3D point towards an other 3D point using the given Distance and Angle.

Get the North correction of the current location

POINT_VEC3.GetNorthCorrection(): Obtains the north correction at the current 3D point.

Point Randomization

Various methods exist to calculate random locations around a given 3D point.

POINT_VEC3.GetRandomPointVec2InRadius(): Provides a random 2D point around the current 3D point, in the given inner to outer band.
POINT_VEC3.GetRandomPointVec3InRadius(): Provides a random 3D point around the current 3D point, in the given inner to outer band.
POINT_VEC3.GetRandomVec2InRadius(): Provides a random 2D vector around the current 3D point, in the given inner to outer band.
POINT_VEC3.GetRandomVec3InRadius(): Provides a random 3D vector around the current 3D point, in the given inner to outer band.

Metric system

POINT_VEC3.IsMetric(): Returns if the 3D point is Metric or Nautical Miles.
POINT_VEC3.SetMetric(): Sets the 3D point to Metric or Nautical Miles.

Coorinate text generation

POINT_VEC3.ToStringBR(): Generates a Bearing & Range text in the format of DDD for DI where DDD is degrees and DI is distance.
POINT_VEC3.ToStringLL(): Generates a Latutude & Longutude text.

Type `Point`

Type `POINT_VEC2`

Field(s)

POINT_VEC2:AddAlt(Altitude)

Add to the current land height an altitude.

Parameter

#number Altitude : The Altitude to add. If nothing (nil) is given, then the current land altitude is set.

Return value

#POINT_VEC2:

POINT_VEC2:AddX(x)

Add to the x coordinate of the POINT_VEC2.

Parameter

#number x : The x coordinate.

Return value

#POINT_VEC2:

POINT_VEC2:AddY(y)

Add to the y coordinate of the POINT_VEC2.

Parameter

#number y : The y coordinate.

Return value

#POINT_VEC2:

POINT_VEC2:DistanceFromPointVec2(PointVec2Reference)

Calculate the distance from a reference #POINT_VEC2.

Parameter

#POINT_VEC2 PointVec2Reference : The reference #POINT_VEC2.

Return value

Dcs.DCSTypes#Distance: The distance from the reference #POINT_VEC2 in meters.

POINT_VEC2:DistanceFromVec2(Vec2Reference)

Calculate the distance from a reference DCSTypes#Vec2.

Parameter

Dcs.DCSTypes#Vec2 Vec2Reference : The reference DCSTypes#Vec2.

Return value

Dcs.DCSTypes#Distance: The distance from the reference DCSTypes#Vec2 in meters.

POINT_VEC2:GetAlt()

Return the altitude (height) of the land at the POINT_VEC2.

Return value

#number: The land altitude.

POINT_VEC2:GetAltitudeText()

Return no text for the altitude of the POINT_VEC2.

Return value

#string: Empty string.

POINT_VEC2:GetLat()

Return Return the Lat(itude) coordinate of the POINTVEC2 (ie: (parent)POINTVEC3.x).

Return value

#number: The x coodinate.

POINT_VEC2:GetLon()

Return the Lon(gitude) coordinate of the POINTVEC2 (ie: (parent)POINTVEC3.z).

Return value

#number: The y coodinate.

POINT_VEC2:GetX()

Return the x coordinate of the POINT_VEC2.

Return value

#number: The x coodinate.

POINT_VEC2:GetY()

Return the y coordinate of the POINT_VEC2.

Return value

#number: The y coodinate.

POINT_VEC2:New(x, y, LandHeightAdd)

POINT_VEC2 constructor.

Parameters

Dcs.DCSTypes#Distance x : The x coordinate of the Vec3 point, pointing to the North.
Dcs.DCSTypes#Distance y : The y coordinate of the Vec3 point, pointing to the Right.
Dcs.DCSTypes#Distance LandHeightAdd : (optional) The default height if required to be evaluated will be the land height of the x, y coordinate. You can specify an extra height to be added to the land height.

Return value

Core.Point#POINT_VEC2:

POINT_VEC2:NewFromVec2(Vec2, LandHeightAdd)

Create a new POINT_VEC2 object from Vec2 coordinates.

Parameters

Dcs.DCSTypes#Vec2 Vec2 : The Vec2 point.
LandHeightAdd :

Return value

Core.Point#POINT_VEC2: self

POINT_VEC2:NewFromVec3(Vec3)

Create a new POINT_VEC2 object from Vec3 coordinates.

Parameter

Dcs.DCSTypes#Vec3 Vec3 : The Vec3 point.

Return value

Core.Point#POINT_VEC2: self

POINT_VEC2:SetAlt(Altitude)

Set the altitude of the POINT_VEC2.

Parameter

#number Altitude : The land altitude. If nothing (nil) is given, then the current land altitude is set.

Return value

#POINT_VEC2:

POINT_VEC2:SetLat(x)

Set the Lat(itude) coordinate of the POINTVEC2 (ie: POINTVEC3.x).

Parameter

#number x : The x coordinate.

Return value

#POINT_VEC2:

POINT_VEC2:SetLon(y, z)

Set the Lon(gitude) coordinate of the POINTVEC2 (ie: POINTVEC3.z).

Parameters

#number y : The y coordinate.
z :

Return value

#POINT_VEC2:

POINT_VEC2:SetX(x)

Set the x coordinate of the POINT_VEC2.

Parameter

#number x : The x coordinate.

Return value

#POINT_VEC2:

POINT_VEC2:SetY(y)

Set the y coordinate of the POINT_VEC2.

Parameter

#number y : The y coordinate.

Return value

#POINT_VEC2:

POINT_VEC2:Translate(Distance, Angle)

Add a Distance in meters from the POINTVEC2 orthonormal plane, with the given angle, and calculate the new POINTVEC2.

Parameters

Dcs.DCSTypes#Distance Distance : The Distance to be added in meters.
Dcs.DCSTypes#Angle Angle : The Angle in degrees.

Return value

#POINT_VEC2: The new calculated POINT_VEC2.

Dcs.DCSTypes#Distance POINT_VEC2.x: The x coordinate in meters.

Dcs.DCSTypes#Distance POINT_VEC2.y: the y coordinate in meters.

POINT_VEC2.z

Type `POINT_VEC3`

The POINT_VEC3 class

Field(s)

POINT_VEC3:AddX(x)

Add to the x coordinate of the POINT_VEC3.

Parameter

#number x : The x coordinate value to add to the current x coodinate.

Return value

#POINT_VEC3:

POINT_VEC3:AddY(y)

Add to the y coordinate of the POINT_VEC3.

Parameter

#number y : The y coordinate value to add to the current y coodinate.

Return value

#POINT_VEC3:

POINT_VEC3:AddZ(z)

Add to the z coordinate of the POINT_VEC3.

Parameter

#number z : The z coordinate value to add to the current z coodinate.

Return value

#POINT_VEC3:

POINT_VEC3:Explosion(ExplosionIntensity)

Creates an explosion at the point of a certain intensity.

Parameter

#number ExplosionIntensity :

POINT_VEC3:Flare(FlareColor, (, Azimuth)

Flares the point in a color.

Parameters

Utilities.Utils#FLARECOLOR FlareColor :
Dcs.DCSTypes#Azimuth ( : ptional) Azimuth The azimuth of the flare direction. The default azimuth is 0.
Azimuth :

Utilities.Utils#FLARECOLOR POINT_VEC3.FlareColor

POINT_VEC3:FlareGreen((, Azimuth)

Flare the POINT_VEC3 Green.

Parameters

Dcs.DCSTypes#Azimuth ( : ptional) Azimuth The azimuth of the flare direction. The default azimuth is 0.
Azimuth :

POINT_VEC3:FlareRed(Azimuth)

Flare the POINT_VEC3 Red.

Parameter

Azimuth :

POINT_VEC3:FlareWhite((, Azimuth)

Flare the POINT_VEC3 White.

Parameters

Dcs.DCSTypes#Azimuth ( : ptional) Azimuth The azimuth of the flare direction. The default azimuth is 0.
Azimuth :

POINT_VEC3:FlareYellow((, Azimuth)

Flare the POINT_VEC3 Yellow.

Parameters

Dcs.DCSTypes#Azimuth ( : ptional) Azimuth The azimuth of the flare direction. The default azimuth is 0.
Azimuth :

POINT_VEC3:Get2DDistance(TargetPointVec3)

Return the 2D distance in meters between the target POINTVEC3 and the POINTVEC3.

Parameter

#POINT_VEC3 TargetPointVec3 : The target POINT_VEC3.

Return value

Dcs.DCSTypes#Distance: Distance The distance in meters.

POINT_VEC3:Get3DDistance(TargetPointVec3)

Return the 3D distance in meters between the target POINTVEC3 and the POINTVEC3.

Parameter

#POINT_VEC3 TargetPointVec3 : The target POINT_VEC3.

Return value

Dcs.DCSTypes#Distance: Distance The distance in meters.

POINT_VEC3:GetAltitudeText()

Return the altitude text of the POINT_VEC3.

Return value

#string: Altitude text.

POINT_VEC3:GetAngleDegrees(DirectionVec3)

Return an angle in degrees from the POINT_VEC3 using a direction vector in Vec3 format.

Parameter

Dcs.DCSTypes#Vec3 DirectionVec3 : The direction vector in Vec3 format.

Return value

#number: DirectionRadians The angle in degrees.

POINT_VEC3:GetAngleRadians(DirectionVec3)

Return an angle in radians from the POINT_VEC3 using a direction vector in Vec3 format.

Parameter

Dcs.DCSTypes#Vec3 DirectionVec3 : The direction vector in Vec3 format.

Return value

#number: DirectionRadians The angle in radians.

POINT_VEC3:GetBRText(TargetPointVec3)

Return a BR string from a POINTVEC3 to the POINTVEC3.

Parameter

#POINT_VEC3 TargetPointVec3 : The target POINT_VEC3.

Return value

#string: The BR text.

POINT_VEC3:GetDirectionVec3(TargetPointVec3)

Return a direction vector Vec3 from POINTVEC3 to the POINTVEC3.

Parameter

#POINT_VEC3 TargetPointVec3 : The target POINT_VEC3.

Return value

Dcs.DCSTypes#Vec3: DirectionVec3 The direction vector in Vec3 format.

POINT_VEC3:GetNorthCorrectionRadians()

Get a correction in radians of the real magnetic north of the POINT_VEC3.

Return value

#number: CorrectionRadians The correction in radians.

POINT_VEC3:GetRandomPointVec2InRadius(OuterRadius, InnerRadius)

Return a random POINTVEC2 within an Outer Radius and optionally NOT within an Inner Radius of the POINTVEC3.

Parameters

Dcs.DCSTypes#Distance OuterRadius :
Dcs.DCSTypes#Distance InnerRadius :

Return value

#POINT_VEC2:

POINT_VEC3:GetRandomPointVec3InRadius(OuterRadius, InnerRadius)

Return a random POINTVEC3 within an Outer Radius and optionally NOT within an Inner Radius of the POINTVEC3.

Parameters

Dcs.DCSTypes#Distance OuterRadius :
Dcs.DCSTypes#Distance InnerRadius :

Return value

#POINT_VEC3:

POINT_VEC3:GetRandomVec2InRadius(OuterRadius, InnerRadius)

Return a random Vec2 within an Outer Radius and optionally NOT within an Inner Radius of the POINT_VEC3.

Parameters

Dcs.DCSTypes#Distance OuterRadius :
Dcs.DCSTypes#Distance InnerRadius :

Return value

Dcs.DCSTypes#Vec2: Vec2

POINT_VEC3:GetRandomVec3InRadius(OuterRadius, InnerRadius)

Return a random Vec3 within an Outer Radius and optionally NOT within an Inner Radius of the POINT_VEC3.

Parameters

Dcs.DCSTypes#Distance OuterRadius :
Dcs.DCSTypes#Distance InnerRadius :

Return value

Dcs.DCSTypes#Vec3: Vec3

POINT_VEC3:GetVec2()

Return the coordinates of the POINT_VEC3 in Vec2 format.

Return value

Dcs.DCSTypes#Vec2: The Vec2 coodinate.

POINT_VEC3:GetVec3()

Return the coordinates of the POINT_VEC3 in Vec3 format.

Return value

Dcs.DCSTypes#Vec3: The Vec3 coodinate.

POINT_VEC3:GetX()

Return the x coordinate of the POINT_VEC3.

Return value

#number: The x coodinate.

POINT_VEC3:GetY()

Return the y coordinate of the POINT_VEC3.

Return value

#number: The y coodinate.

POINT_VEC3:GetZ()

Return the z coordinate of the POINT_VEC3.

Return value

#number: The z coodinate.

POINT_VEC3:IlluminationBomb(): Creates an illumination bomb at the point.

POINT_VEC3:IsMetric()

Gets if the POINT_VEC3 is metric or NM.

Return value

#boolean: Metric true means metric, false means NM.

POINT_VEC3.Metric

POINT_VEC3:New(x, y, z)

Create a new POINT_VEC3 object.

Parameters

Dcs.DCSTypes#Distance x : The x coordinate of the Vec3 point, pointing to the North.
Dcs.DCSTypes#Distance y : The y coordinate of the Vec3 point, pointing Upwards.
Dcs.DCSTypes#Distance z : The z coordinate of the Vec3 point, pointing to the Right.