OOVector.m File Reference

#include "OOMaths.h"

Include dependency graph for OOVector.m:

Go to the source code of this file.

Functions
Vector	OORandomUnitVector (void)
Vector	OOVectorRandomSpatial (OOScalar maxLength)
Vector	OOVectorRandomRadial (OOScalar maxLength)
Vector	OORandomPositionInBoundingBox (BoundingBox bb)

Variables
const Vector	kZeroVector = { 0.0f, 0.0f, 0.0f }
const Vector	kBasisXVector = { 1.0f, 0.0f, 0.0f }
const Vector	kBasisYVector = { 0.0f, 1.0f, 0.0f }
const Vector	kBasisZVector = { 0.0f, 0.0f, 1.0f }
const Vector2D	kZeroVector2D = { 0.0f, 0.0f }
const Vector2D	kBasisXVector2D = { 1.0f, 0.0f }
const Vector2D	kBasisYVector2D = { 0.0f, 1.0f }
const BoundingBox	kZeroBoundingBox = {{ 0.0f, 0.0f, 0.0f }, { 0.0f, 0.0f, 0.0f }}

Function Documentation

OORandomPositionInBoundingBox()

Vector OORandomPositionInBoundingBox

(

BoundingBox

bb

)

Definition at line 121 of file OOVector.m.

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

References randf().

Referenced by ShipEntity::becomeExplosion, and ShipEntity::releaseCargoPodsDebris.

Here is the call graph for this function:

Here is the caller graph for this function:

OORandomUnitVector()

Vector OORandomUnitVector

(

void

)

Definition at line 83 of file OOVector.m.

{
    Vector              v;
    float               m;
    
    do
    {
        v = make_vector(randf() - 0.5f, randf() - 0.5f, randf() - 0.5f);
        m = magnitude2(v);
    }
    while (m > 0.25f || m == 0.0f); // We're confining to a sphere of radius 0.5 using the sqared magnitude; 0.5 squared is 0.25.
    
    return vector_normal(v);
}

References randf().

Referenced by OOParticleSystem::initWithPosition:velocity:count:minSpeed:maxSpeed:duration:baseColor:, and OOVectorRandomRadial().

Here is the call graph for this function:

Here is the caller graph for this function:

OOVectorRandomRadial()

Vector OOVectorRandomRadial

(

OOScalar

maxLength

)

Definition at line 115 of file OOVector.m.

{
    return vector_multiply_scalar(OORandomUnitVector(), randf() * maxLength);
}

References OORandomUnitVector(), and randf().

Referenced by HeadUpDisplay(Private)::drawScanner:.

Here is the call graph for this function:

Here is the caller graph for this function:

OOVectorRandomSpatial()

Vector OOVectorRandomSpatial

(

OOScalar

maxLength

)

Definition at line 99 of file OOVector.m.

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

References randf().

Referenced by ShipEntity(PureAI)::setDestinationToJinkPosition.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

kBasisXVector

const Vector kBasisXVector = { 1.0f, 0.0f, 0.0f }

Definition at line 29 of file OOVector.m.

{ 1.0f, 0.0f, 0.0f };

Referenced by ShipEntity::absoluteIJKForSubentity, OOMesh(Private)::calculateVertexNormalsAndTangentsWithFaceRefs:, OOMesh(Private)::calculateVertexTangentsWithFaceRefs:, HeadUpDisplay(Private)::drawDirectionCue:, Universe::getActiveViewMatrix:forwardVector:upVector:, OOMesh(Private)::getNormal:andTangent:forVertex:inSmoothGroup:, OOMatrixForBillboard(), ShipEntity::setUpShipFromDictionary:, and Verify_Vector().

kBasisXVector2D

const Vector2D kBasisXVector2D = { 1.0f, 0.0f }

Definition at line 34 of file OOVector.m.

{ 1.0f, 0.0f };

kBasisYVector

const Vector kBasisYVector = { 0.0f, 1.0f, 0.0f }

Definition at line 30 of file OOVector.m.

{ 0.0f, 1.0f, 0.0f };

Referenced by ShipEntity::absoluteIJKForSubentity, Universe::drawUniverse, Universe::getActiveViewMatrix:forwardVector:upVector:, HeadUpDisplay::hudRotateViewpointForVirtualDepth, PlanetEntity::miniaturize, and ShipEntity::setUpShipFromDictionary:.

kBasisYVector2D

const Vector2D kBasisYVector2D = { 0.0f, 1.0f }

Definition at line 35 of file OOVector.m.

{ 0.0f, 1.0f };

kBasisZVector

const Vector kBasisZVector = { 0.0f, 0.0f, 1.0f }

Definition at line 31 of file OOVector.m.

{ 0.0f, 0.0f, 1.0f };

Referenced by ShipEntity::absoluteIJKForSubentity, ShipEntity::ballTrackLeadingTarget:atTarget:, OOMesh(Private)::calculateVertexNormalsAndTangentsWithFaceRefs:, WormholeEntity::disgorgeShips, HeadUpDisplay(Private)::drawCompass:, HeadUpDisplay(Private)::drawDirectionCue:, Universe::drawUniverse, ShipEntity::dumpItem:, ShipEntity::fireDirectLaserShotAt:, Universe::getActiveViewMatrix:forwardVector:upVector:, OOMesh(Private)::getNormal:andTangent:forVertex:inSmoothGroup:, OOMatrixForBillboard(), quaternion_rotation_between(), ShipEntity::setUpShipFromDictionary:, Universe::spawnShip:, and ShipEntity::trackPrimaryTarget:delta_t:.

kZeroBoundingBox

const BoundingBox kZeroBoundingBox = {{ 0.0f, 0.0f, 0.0f }, { 0.0f, 0.0f, 0.0f }}

Definition at line 38 of file OOVector.m.

{{ 0.0f, 0.0f, 0.0f }, { 0.0f, 0.0f, 0.0f }};

Referenced by OODrawable::boundingBox, and OOMesh::init.

kZeroVector

const Vector kZeroVector = { 0.0f, 0.0f, 0.0f }

Definition at line 28 of file OOVector.m.

{ 0.0f, 0.0f, 0.0f };

Referenced by ShipEntity::behaviour_attack_broadside:, ShipEntity::behaviour_attack_fly_from_target:, ShipEntity::behaviour_attack_target:, ShipEntity::behaviour_running_defense:, OOMesh(Private)::calculateVertexNormalsAndTangentsWithFaceRefs:, OOMesh(Private)::calculateVertexTangentsWithFaceRefs:, OOMesh(Private)::checkNormalsAndAdjustWinding, ShipEntity::collideWithShip:, HeadUpDisplay(Private)::drawDirectionCue:, OOECMBlastEntity::drawImmediate:translucent:, Universe::drawUniverse, PlayerEntity::engageAutopilotToStation:, ShipEntity::fireMissileWithIdentifier:andTarget:, Universe::firstEntityTargetedByPlayerPrecisely, PlayerEntity::getDestroyedBy:damageType:, OOMesh(Private)::getNormal:andTangent:forVertex:inSmoothGroup:, ShipEntity::getWeaponOffsetFrom:withKey:inMode:, HeadUpDisplay::hudRotateViewpointForVirtualDepth, OOMesh::init, OOSoundSource::init, Octree::isHitByLine:v0:, PlayerEntity::leaveDock:, PlayerEntity::leaveWitchspace, ShipEntity::missileTrackPrimaryTarget:, OODebugDrawBasisAtOrigin(), OODebugDrawColoredVectorAtOrigin(), OODebugDrawNormalAtOrigin(), OODebugDrawVectorAtOrigin(), PlayerEntity(OOPrivate)::performInFlightUpdates:, PlayerShipSetCustomView(), StationEntity::portUpVectorForShip:, ShipEntity::positionOffsetForAlignment:, ShipEntity::positionOffsetForShipInRotationToAlignment, Octree::randomPoint, ShipEntity(Private)::refreshEscortPositions, OOExhaustPlumeEntity::resetPlume, PlayerEntity::setCustomViewDataFromDictionary:withScaling:, PlayerEntity::setDefaultViewOffsets, ShipEntity::setEvasiveJink:, PlayerEntity::setUpAndConfirmOK:saveGame:, OOVisualEffectEntity::setUpVisualEffectFromDictionary:, SystemSetPopulator(), ShipEntity::trackDestination:delta_t:, ShipEntity::trackPrimaryTarget:delta_t:, ShipEntity::trackSideTarget:delta_t:, ShipEntity::update:, OOShipRegistry(OODataLoader)::validateNewStyleFlasherDeclaration:forShip:fatalError:, OOShipRegistry(OODataLoader)::validateNewStyleStandardSubentityDeclaration:forShip:fatalError:, Verify_Vector(), PlayerEntity::viewpointOffset, PlayerEntity::weaponViewOffset, and ShipEntity::witchspaceLeavingEffects.

kZeroVector2D

const Vector2D kZeroVector2D = { 0.0f, 0.0f }

Definition at line 33 of file OOVector.m.

{ 0.0f, 0.0f };