class vectorSource

Constants 4

static const vector Up = "0 1 0"

Referenced by CameraToolsMenuClient.OnRPC(), Car.DetectFlippedUsingWheels(), CarScript.EOnPostSimulate()

Show 11 more

, CrossHairSelector.FloatingCrossHair(), DayZSpectator.EOnFrame(), EffectArea.PlaceParticles(), FireworksBase.CanBeIgnitedBy(), GameInventory.SetGroundPosByOwnerBounds(), ImprovisedExplosive.OnPlacementComplete(), MiscGameplayFunctions.FilterObstructedObjectsByGrouping(), Transport.DetectFlippedUsingSurface(), Transport.IsAreaAtDoorFree(), Perpend(), and Weapon_Base.ApproximateWeaponLiftTransform()

static const vector Aside = "1 0 0"

Referenced by MiscGameplayFunctions.FilterObstructedObjectsByGrouping()

static const vector Forward = "0 0 1"

Referenced by ActionBuryBody.Can(), ActionDigInStash.Can(), ActionDigOutStash.Can()

Show 4 more

, ActionDigWorms.Can(), DayZPlayerImplementThrowing.CheckFreeSpace(), FireplaceBase.OnAttachmentRuined(), and MiscGameplayFunctions.DropAllItemsInInventoryInBounds()

static const vector Zero = "0 0 0"

Referenced by ActionBase.HandleReciveData(), ActionBase.ReadFromContext(), ActionBase.WriteToContext(), and 127 more

Methods 28

proto string ToString(bool beautify = true)

Vector to string

beautify: If true verbose vector in more human readable form "<1, 1, 1>" instead of simple form "1 1 1"

Returns: string Converted vector as parsed string

vector v = "1 0 1";
Print( v.ToString() );
Print( v.ToString(false) );

>> '<1, 0, 1>'
>> '1 0 1'

Referenced by ActionTarget.DumpToString(), CameraToolsMenu.OnClick(), CameraToolsMenu.SetCameraData()

Show 16 more

, ContaminatedArea_Dynamic.SetupZoneData(), DynamicMusicPlayer.DisplayDebugStats(), PluginAdminLog.PlayerTeleportedLog(), PluginCharPlacement.CheckInit(), PluginConfigDebugProfile.CustomLocationsAdd(), PluginConfigDebugProfile.SetItemDebugPos(), PluginUniversalTemperatureSourceServer.GatherTemperatureSources(), RecoilBase.ApplyMouseOffset(), SceneObject.GetPositionAsString(), ScriptCamera.DebugInfo(), ScriptConsoleAddLocation.SetPosition(), ScriptConsoleEnfScriptTab.PrintS(), ScriptConsoleGeneralTab.Init(), ScriptConsoleGeneralTab.OnClick(), ScriptConsoleGeneralTab.OnItemSelected(), and ScriptConsoleGeneralTab.ProcessTeleportText()

proto float Normalize()

Normalizes vector. Returns length

Returns: float Length of origin vector

vector vec = "1 0 1";
float length = vec.Normalize();
Print( vec );
Print( length );

>> vec = <0.707107,0,0.707107>
>> length = 1.41421

Referenced by ActionCreateIndoorFireplace.ActionCondition(), ActionCreateIndoorOven.ActionCondition(), ActionFishingNew.OnUpdate(), and 48 more

proto native float Length()

Returns length of vector (magnitude)

Returns: float Length of vector

vector vec = "1 0 1";
float length = vec.Length();
Print( length );

>> length = 1.41421

Referenced by CarScript.CheckContactCache(), CarScript.EOnPostSimulate(), DayZCreatureAI.ModCommandHandlerBefore()

Show 29 more

, DayZGame.FirearmEffects(), EffBulletImpactBase.EvaluateEffect(), EffBulletImpactBase.Event_OnStarted(), EntityAI.RegisterTransportHit(), Fence.IsFacingCamera(), Fence.IsFacingPlayer(), Fence.IsPlayerInside(), Hit_MeatBones.Event_OnStarted(), Hologram.AlignProjectionOnTerrain(), Hologram.GetProjectionDiameter(), Hologram.GetProjectionRadius(), InventoryItem.GetImpactSurfaceTypeEx(), InventoryItem.ProcessImpactSoundEx(), PlayerBase.OnReceivedHit(), ScriptConsoleGeneralTab.Update(), ScriptConsoleGeneralTab.UpdateMousePos(), ScriptConsoleSoundsTab.UpdateMousePos(), ShelterBase.IsPlayerInside(), ShelterSite.IsFacingCamera(), ShelterSite.IsPlayerInside(), TerritoryFlag.IsFacingCamera(), TerritoryFlag.IsFacingPlayer(), TerritoryFlag.IsPlayerInside(), Transport.GetMomentum(), Watchtower.IsFacingCamera(), Watchtower.IsFacingPlayer(), Watchtower.IsPlayerInside(), Weapon_Base.LiftWeaponCheckEx(), and WeaponLiftDiag.DrawDiag()

proto native float LengthSq()

Returns squared length (magnitudeSqr)

Returns: float Length of vector

vector vec = "1 1 0";
float length = vec.LengthSq();
Print( length );

>> length = 2

Referenced by DayZPlayerUtils.GetMeleeTarget(), InventoryGrid.UpdateItems(), InventoryGrid.UpdateQuickbarItems()

Show 1 more

, PlayerBase.BrokenLegWalkShock()

proto static native float Distance(vector v1, vector v2)

Returns the distance between tips of two 3D vectors.

v1: vector 3D Vector 1
v2: vector 3D Vector 2

Returns: float Distance

float dist = vector.Distance( "1 2 3", "4 5 6" );
Print( dist );

>> dist = 5.19615

Referenced by BotSelectNearestTarget(), Achievements.OnPlayerKilled(), ActionCreateIndoorFireplace.ActionCondition(), and 69 more

proto static native float DistanceSq(vector v1, vector v2)

Returns the square distance between tips of two 3D vectors.

v1: vector 3D Vector 1
v2: vector 3D Vector 2

Returns: float Squere distance

float dist = vector.DistanceSq( "0 0 0", "0 5 0" );
Print( dist );

>> dist = 25

Referenced by ActionBase.IsInReach(), ActionEmptyMagazine.OnExecuteServer(), ActionEnterLadder.ActionCondition(), and 69 more

vector Perpend()

Returns perpendicular vector. Perpendicular vector is computed as cross product between input vector and up vector (0, 1, 0).

Returns: vector perpendicular vector

vector vec = "1 0 0";
Print( vec.Perpend() );

>> <0,0,1>

References Up

Referenced by ComponentEnergyManager.DrawArrow(), PluginDeveloper.SpawnEntityOnGroundPatternGrid(), Shape.CreateArrow()

Show 2 more

, Shape.CreateBridgeArrow(), and Trap_RabbitSnare.AlignCatch()

static vector Direction(vector p1, vector p2)

Returns direction vector from point p1 to point p2

p1: vector point from
p2: vector point to

Returns: vector direction vector

Referenced by ActionFishingNew.OnUpdate(), ActionFishingNew.TrySpawnCatch(), CameraToolsMenu.Update()

Show 4 more

, CarScript.CarScript(), ScriptedLightBase.AttachOnMemoryPoint(), Transport.DetectFlippedUsingSurface(), and WeaponParticlesBase.CheckOrientationOverride()

static vector RandomDir()

Returns randomly generated unit vector

Returns: randomly generated unit vector

vector vec = vector.RandomDir();
Print(vec);
Print(vec.Length());

>> <-0.179424,0.966825,0.181816>
>> 1

References Normalized(), Math.RandomFloatInclusive(), and Vector()

static vector RandomDir2D()

Returns randomly generated XZ unit vector with the Y(up) axis set to 0

Returns: randomly generated XZ unit vector

vector vec = vector.RandomDir();
Print(vec);
Print(vec.Length());

>> <0.631697,0,0.775216>
>> 1

References Normalized(), Math.RandomFloatInclusive(), and Vector()

Referenced by ContaminatedArea_Dynamic.SpawnItems(), and SpookyEventBase.GetSoundPos()

static float Dot(vector v1, vector v2)

Returns Dot product of vector v1 and vector v2

v1: vector input vector
v2: vector input vector

Returns: vector direction vector

Referenced by ActionCreateIndoorFireplace.ActionCondition(), ActionCreateIndoorOven.ActionCondition(), ActionPlaceFireplaceIndoor.ActionCondition()

Show 30 more

, ActionPlaceOvenIndoor.ActionCondition(), ActionPushCar.GetDirectionDot(), ActionTargets.DistSqrPoint2Line(), BoatScript.OnContact(), BoxDraw.InverseTransformPointByMatrix(), Car.DetectFlippedUsingWheels(), CarScript.CheckContactCache(), CarScript.OnContact(), DayZAnimal.ComputeHitDirectionAngleDeg(), DayZPlayerImplement.EvaluateDamageHitAnimation(), DayZPlayerImplement.EvaluateDeathAnimation(), DayZPlayerImplementMeleeCombat.HitZoneSelectionRaycast(), DayZPlayerImplementMeleeCombat.IsEntityBehindEntityInAngle(), EffBulletImpactBase.Event_OnStarted(), FireplaceBase.OnAttachmentRuined(), FireworksBase.CanBeIgnitedBy(), MiscGameplayFunctions.DropAllItemsInInventoryInBounds(), MiscGameplayFunctions.FilterObstructedObjectsByGrouping(), MiscGameplayFunctions.IsPlayerOrientedTowardPos(), Transport.DetectFlippedUsingSurface(), RotateAroundZero(), RotateAroundZeroDeg(), RotateAroundZeroRad(), VicinityItemManager.ExcludeFromContainer_Phase1(), Watchtower.IsFacingCamera(), Watchtower.IsFacingPlayer(), Weapon_Base.LiftWeaponCheckEx(), ZombieBase.ComputeHitDirectionAngle(), ZombieBase.ComputeHitDirectionAngleEx(), and ZombieBase.EvaluateCrawlTransitionAnimation()

vector GetRelAngles()

Returns relative angles between -180 and 180, not 0 to 360

Returns: float Relative angles

vector angles = "-45 190 160";
Print( angles.GetRelAngles() );

>> <-45,-170,160>

proto float VectorToYaw()

Returns yaw of vector

vec: vector Vector to convert yaw

Returns: float Yaw of vector

vector v1 = "0 1 0";
vector v2 = "0.7 0.7 0";
Print( v1.ToYaw() );
Print( v2.ToYaw() );

>> 90
>> 45

proto native static vector YawToVector(float yaw)

Returns vector of yaw

yaw: float Value of yaw

Returns: vector Yaw converted in vector

Print( vector.Yaw2Vector(90) );
Print( vector.Yaw2Vector(45) );

>> <0,1,0>
>> <0.707107,0.707107,0>

Referenced by RecoilBase.PostInit()

proto vector VectorToAngles()

Converts vector to spherical coordinates with radius = 1

Returns: vector spherical coordinates (yaw, pitch, roll in degrees)

vector v1 = "1 0 1";
vector v2 = "1 1 1";
Print( v1.VectorToAngles() );
Print( v2.VectorToAngles() );

>> <45,-0,0>
>> <45,35.2644,0>

proto vector AnglesToVector()

Converts spherical coordinates (yaw, pitch, roll in degrees) to unit length vector

Returns: normalized direction vector

vector v1 = "45 0 0";
vector v2 = "15 60 0";
Print( v1.AnglesToVector() );
Print( v2.AnglesToVector() );

>> <0.707107,0,0.707107>
>> <0.12941,0.866025,0.482963>

Referenced by BleedingSource.DrawDebugShape(), CrossHairSelector.FloatingCrossHair(), DayZPlayerImplementMeleeCombat.IsEntityBehindEntityInAngle()

Show 8 more

, DayZPlayerImplementThrowing.HandleThrowing(), Fence.IsPlayerInside(), Raycaster.DoMeasurement(), ShelterBase.IsPlayerInside(), ShelterSite.IsPlayerInside(), TerritoryFlag.IsPlayerInside(), Watchtower.IsPlayerInside(), and Weapon_Base.LiftWeaponCheckEx()

proto void RotationMatrixFromAngles(out vector mat[3])

Creates rotation matrix from angles

ang: vector which contains angles
out mat: vector created rotation matrix

      vector mat[3];
vector ang = "70 15 45";
  	ang.RotationMatrixFromAngles( mat );
  	Print( mat );

>> <0.330366,0.0885213,-0.939693>,<0.458809,0.854988,0.241845>,<0.824835,-0.511037,0.241845>

Referenced by Transport.IsAreaAtDoorFree()

proto vector Multiply4(vector mat[4])

Transforms position

mat: vector[4] transformation matrix
vec: vector position to transform

Returns: vector transformed position

vector mat[4] = { "1 0 0 0", "0 1 0 0", "0 0 1 1", "3 1 2 1" }; // translation matrix
vector pos = "1 1 1";
Print( pos.Multiply4(mat) );

>> <4,2,3>

Referenced by DayZIntroScene.DayZIntroScene(), PluginCharPlacement.CalculatePos(), and Weapon_Base.ApproximateWeaponLiftTransform()

proto vector Multiply3(vector mat[3])

Transforms vector

mat: vector[3] transformation matrix
vec: vector vector to transform

Returns: vector transformed vector

vector mat[3] = { "2 0 0", "0 3 0", "0 0 1" }; // scale matrix
vector vec = "1 1 1";
Print( vec.Multiply3(mat) );

>> <2,3,1>

proto vector InvMultiply4(vector mat[4])

Invert-transforms position

mat: vector[4] transformation matrix
vec: vector position to transform

Returns: vector transformed position

vector mat[4] = { "1 0 0 0", "0 1 0 0", "0 0 1 1", "3 1 2 1" }; // translation matrix
vector pos = "1 1 1";
Print( pos.InvMultiply4(mat) );

>> <-2,0,-1>

Referenced by DayZPlayerCamera3rdPersonVehicle.OnUpdate()

proto vector InvMultiply3(vector mat[3])

Invert-transforms vector

mat: vector[3] transformation matrix
vec: vector vector to transform

Returns: vector transformed vector

vector mat[3] = { "1.5 2.5 0", "0.1 1.3 0", "0 0 1" }; // rotation matrix
vector vec = "1 1 1";
Print( vec.InvMultiply3(mat) );

>> <4,1.4,1>

Referenced by BoatHud.GetSpeedometer(), CarScript.EOnPostSimulate(), DayZPlayerCamera3rdPersonVehicle.OnUpdate()

Show 1 more

, Weapon_Base.ApproximateWeaponLiftTransform()

proto static native vector Lerp(vector v1, vector v2, float t)

Lerp between two vectors

vector v1 = Vector(0,0,0);
vector v2 = Vector(5,6,1);
Print( vector.Lerp(v1, v2, 0.5) );

Referenced by PPERequester_HeavyMetalPoisoning_3.SetEffectProgress()

static vector RotateAroundZeroDeg(vector vec, vector axis, float angle)

Rotate a vector around 0,0,0 by an angle in degrees

vec: vector to rotate
axis: axis to rotate around
cosAngle: angle in degrees

Returns: vector transformed vector

References Math.Cos(), Dot(), Math.Sin()

Show 1 more

, Math.DEG2RAD

Referenced by Weapon_Base.ApproximateWeaponLiftTransform()

static vector RotateAroundZeroRad(vector vec, vector axis, float angle)

Rotate a vector around 0,0,0 by an angle in radians

vec: vector to rotate
axis: axis to rotate around
cosAngle: angle in radians

Returns: vector transformed vector

References Math.Cos(), Dot(), and Math.Sin()

static vector RotateAroundZero(vector pos, vector axis, float cosAngle, float sinAngle)

Rotate a vector around 0,0,0

pos: vector to rotate
axis: axis to rotate around
cosAngle: cos of angle
sinAngle: sin of angle

Returns: vector transformed vector

References Dot()

Referenced by EffectArea.PlaceParticles(), GameInventory.SetGroundPosByOwnerBounds(), MiscGameplayFunctions.FilterObstructedObjectsByGrouping()

Show 1 more

, RotateAroundPoint()

static vector RotateAroundPoint(vector point, vector pos, vector axis, float cosAngle, float sinAngle)

Rotate a vector around point

point: point to rotate around
pos: vector to rotate
axis: axis to rotate around
cosAngle: cos of angle
sinAngle: sin of angle

Returns: vector transformed vector

References RotateAroundZero()

static vector ArrayToVec(float arr[])

Convert static array of floats into a vector

arr: vector in array format

Returns: vector resulting vector

References Vector()

Referenced by ArrowManagerPlayer.Load(), and ObjectSpawnerHandler.SpawnObject()