OOHPVector.m File Reference

#include "OOMaths.h"

Include dependency graph for OOHPVector.m:

Go to the source code of this file.

Functions
HPVector	OORandomUnitHPVector (void)
HPVector	OOHPVectorRandomSpatial (OOHPScalar maxLength)
HPVector	OOHPVectorRandomRadial (OOHPScalar maxLength)
HPVector	OOHPRandomPositionInBoundingBox (BoundingBox bb)
HPVector	OORandomPositionInCylinder (HPVector centre1, OOHPScalar exclusion1, HPVector centre2, OOHPScalar exclusion2, OOHPScalar radius)
HPVector	OORandomPositionInShell (HPVector centre, OOHPScalar inner, OOHPScalar outer)
HPVector	OOProjectHPVectorToPlane (HPVector point, HPVector plane, HPVector normal)

Variables
const HPVector	kZeroHPVector = { 0.0, 0.0, 0.0 }
const HPVector	kBasisXHPVector = { 1.0, 0.0, 0.0 }
const HPVector	kBasisYHPVector = { 0.0, 1.0, 0.0 }
const HPVector	kBasisZHPVector = { 0.0, 0.0, 1.0 }
const HPVector2D	kZeroHPVector2D = { 0.0, 0.0 }
const HPVector2D	kBasisXHPVector2D = { 1.0, 0.0 }
const HPVector2D	kBasisYHPVector2D = { 0.0, 1.0 }

Function Documentation

OOHPRandomPositionInBoundingBox()

HPVector OOHPRandomPositionInBoundingBox

(

BoundingBox

bb

)

Definition at line 104 of file OOHPVector.m.

{
    HPVector result;
    result.x = (OOHPScalar)(bb.min.x + randf() * (bb.max.x - bb.min.x));
    result.y = (OOHPScalar)(bb.min.y + randf() * (bb.max.y - bb.min.y));
    result.z = (OOHPScalar)(bb.min.z + randf() * (bb.max.z - bb.min.z));
    return result;
}

References randf().

Here is the call graph for this function:

OOHPVectorRandomRadial()

HPVector OOHPVectorRandomRadial

(

OOHPScalar

maxLength

)

Definition at line 98 of file OOHPVector.m.

{
    return HPvector_multiply_scalar(OORandomUnitHPVector(), randf() * maxLength);
}

References OORandomUnitHPVector(), and randf().

Referenced by Universe::spawnShip:, and VectorStaticRandomDirectionAndLength().

Here is the call graph for this function:

Here is the caller graph for this function:

OOHPVectorRandomSpatial()

HPVector OOHPVectorRandomSpatial

(

OOHPScalar

maxLength

)

Definition at line 82 of file OOHPVector.m.

{
    HPVector                v;
    OOHPScalar                m;
    
    do
    {
        v = make_HPvector(randf() - 0.5f, randf() - 0.5f, randf() - 0.5f);
        m = HPmagnitude2(v);
    }
    while (m > 0.25);   // We're confining to a sphere of radius 0.5 using the sqared magnitude; 0.5 squared is 0.25.
    
    return HPvector_multiply_scalar(v, maxLength * 2.0);    // 2.0 is to compensate for the 0.5-radius sphere.
}

References randf().

Referenced by Universe::addShipAt:withRole:withinRadius:, Universe::locationByCode:withSun:andPlanet:, OORandomPositionInCylinder(), OORandomPositionInShell(), ShipEntity(PureAI)::setDestinationToCurrentLocation, ShipEntity::updateTrackingCurve, and VectorStaticRandom().

Here is the call graph for this function:

Here is the caller graph for this function:

OOProjectHPVectorToPlane()

HPVector OOProjectHPVectorToPlane	(	HPVector	point,
		HPVector	plane,
		HPVector	normal )

Definition at line 141 of file OOHPVector.m.

{
    return HPvector_subtract(point,HPvector_multiply_scalar(normal,HPdot_product(HPvector_subtract(point, plane), normal)));
}

Referenced by Universe::locationByCode:withSun:andPlanet:.

Here is the caller graph for this function:

OORandomPositionInCylinder()

HPVector OORandomPositionInCylinder	(	HPVector	centre1,
		OOHPScalar	exclusion1,
		HPVector	centre2,
		OOHPScalar	exclusion2,
		OOHPScalar	radius )

Definition at line 113 of file OOHPVector.m.

{
    OOHPScalar exc12 = exclusion1*exclusion1;
    OOHPScalar exc22 = exclusion2*exclusion2;
    if (HPdistance(centre1,centre2) < (exclusion1+exclusion2)*1.2)
    {
        OOLog(@"position.cylinder.error",@"Trying to generate cylinder position in range %f long with exclusions %f and %f",HPdistance(centre1,centre2),exclusion1,exclusion2);
    }
    HPVector result;
    do
    {
        result = HPvector_add(OOHPVectorInterpolate(centre1,centre2,randf()),OOHPVectorRandomSpatial(radius));
    }
    while(HPdistance2(result,centre1)<exc12 || HPdistance2(result,centre2)<exc22);
    return result;
}

References OOHPVectorRandomSpatial(), OOLog, and randf().

Referenced by Universe::locationByCode:withSun:andPlanet:.

Here is the call graph for this function:

Here is the caller graph for this function:

OORandomPositionInShell()

HPVector OORandomPositionInShell	(	HPVector	centre,
		OOHPScalar	inner,
		OOHPScalar	outer )

Definition at line 130 of file OOHPVector.m.

{
    HPVector result;
    OOHPScalar inner2 = inner*inner;
    do
    {
        result = HPvector_add(centre,OOHPVectorRandomSpatial(outer));
    } while(HPdistance2(result,centre)<inner2);
    return result;
}

References OOHPVectorRandomSpatial().

Referenced by Universe::locationByCode:withSun:andPlanet:.

Here is the call graph for this function:

Here is the caller graph for this function:

OORandomUnitHPVector()

HPVector OORandomUnitHPVector

(

void

)

Definition at line 66 of file OOHPVector.m.

{
    HPVector                v;
    OOHPScalar                m;
    
    do
    {
        v = make_HPvector(randf() - 0.5f, randf() - 0.5f, randf() - 0.5f);
        m = HPmagnitude2(v);
    }
    while (m > 0.25 || m == 0.0);   // We're confining to a sphere of radius 0.5 using the sqared magnitude; 0.5 squared is 0.25.
    
    return HPvector_normal(v);
}

References randf().

Referenced by OOHPVectorRandomRadial(), and VectorStaticRandomDirection().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

kBasisXHPVector

const HPVector kBasisXHPVector = { 1.0, 0.0, 0.0 }

Definition at line 29 of file OOHPVector.m.

{ 1.0, 0.0, 0.0 };

kBasisXHPVector2D

const HPVector2D kBasisXHPVector2D = { 1.0, 0.0 }

Definition at line 34 of file OOHPVector.m.

{ 1.0, 0.0 };

kBasisYHPVector

const HPVector kBasisYHPVector = { 0.0, 1.0, 0.0 }

Definition at line 30 of file OOHPVector.m.

{ 0.0, 1.0, 0.0 };

kBasisYHPVector2D

const HPVector2D kBasisYHPVector2D = { 0.0, 1.0 }

Definition at line 35 of file OOHPVector.m.

{ 0.0, 1.0 };

kBasisZHPVector

const HPVector kBasisZHPVector = { 0.0, 0.0, 1.0 }

Definition at line 31 of file OOHPVector.m.

{ 0.0, 0.0, 1.0 };

Referenced by quaternion_rotation_betweenHP(), and Universe::spawnShip:.

kZeroHPVector

const HPVector kZeroHPVector = { 0.0, 0.0, 0.0 }

Definition at line 28 of file OOHPVector.m.

{ 0.0, 0.0, 0.0 };

Referenced by Universe::addShips:withRole:atPosition:withCoordinateSystem:, Universe::addShipsToRoute:withRole:quantity:routeFraction:asGroup:, ShipEntity::calculateTargetPosition, ShipEntity::calculateTrackingCurve, Universe::coordinatesForPosition:withCoordinateSystem:returningScalar:, Universe::countEntitiesMatchingPredicate:parameter:inRange:ofEntity:, Universe::findEntitiesMatchingPredicate:parameter:inRange:ofEntity:, Universe::getSafeVectorFromEntity:toDistance:fromPoint:, Universe::getSunSkimEndPositionForShip:, Universe::getSunSkimStartPositionForShip:, Universe::getWitchspaceExitPosition, Entity::init, JSObjectGetVector(), JSValueToVector(), Universe::legacyPositionFrom:asCoordinateSystem:, Universe::locationByCode:withSun:andPlanet:, Universe::nearestEntityMatchingPredicate:parameter:relativeToEntity:, Universe::populateSystemFromDictionariesWithSun:andPlanet:, ShipEntity(LoadRestore)::savedShipDictionaryWithContext:, ShipEntity(PureAI)::setDestinationToDockingAbort, ShipEntity(PureAI)::setSunSkimStartCoordinates, Universe::spawnShip:, SystemLocationFromCode(), PlayerEntity::takeEnergyDamage:from:becauseOf:weaponIdentifier:, PlayerEntity::takeScrapeDamage:from:, VectorConstruct(), and PlayerEntity::viewpointPosition.

kZeroHPVector2D

const HPVector2D kZeroHPVector2D = { 0.0, 0.0 }

Definition at line 33 of file OOHPVector.m.

{ 0.0, 0.0 };