anglestransform.qc File Reference

#include "anglestransform.qh"

Include dependency graph for anglestransform.qc:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
vector	AnglesTransform_Apply (vector transform, vector v)
	angles transforms angles in fixedmakevectors/fixedvectoangles space
vector	AnglesTransform_ApplyToAngles (vector transform, vector v)
vector	AnglesTransform_ApplyToVAngles (vector transform, vector v)
vector	AnglesTransform_CancelRoll (vector t)
vector	AnglesTransform_FromAngles (vector v)
vector	AnglesTransform_FromVAngles (vector v)
vector	AnglesTransform_Invert (vector transform)
vector	AnglesTransform_LeftDivide (vector from_transform, vector to_transform)
vector	AnglesTransform_Multiply (vector t1, vector t2)
vector	AnglesTransform_Multiply_GetPostShift (vector t0, vector st0, vector t1, vector st1)
vector	AnglesTransform_Normalize (vector t, float minimize_roll)
vector	AnglesTransform_PrePostShift_GetPostShift (vector sf, vector t, vector st)
vector	AnglesTransform_RightDivide (vector to_transform, vector from_transform)
vector	AnglesTransform_ToAngles (vector v)
vector	AnglesTransform_ToVAngles (vector v)
vector	AnglesTransform_TurnDirectionFR (vector transform)
vector	AnglesTransform_TurnDirectionFU (vector transform)

Function Documentation

AnglesTransform_Apply()

vector AnglesTransform_Apply	(	vector	transform,
		vector	v )

angles transforms angles in fixedmakevectors/fixedvectoangles space

Definition at line 5 of file anglestransform.qc.

{
    // optimize code for common horizontal warpzone transform angles
    if (transform.x == 0 && transform.z == 0)
    {
        // NOTE since transform.x is 0 this code works regardless of POSITIVE_PITCH_IS_DOWN
        switch(transform.y)
        {
            case 0:              return v;
            case 90:  case -270: return vec3(-v.y, v.x, v.z);
            case 180: case -180: return vec3(-v.x, -v.y, v.z);
            case 270:  case -90: return vec3(v.y, -v.x, v.z);
        }
    }
    vector forward, right, up;
    FIXED_MAKE_VECTORS(transform, forward, right, up);
    return forward * v.x + right * -v.y + up * v.z;
}

References FIXED_MAKE_VECTORS, vec3, and vector.

Referenced by AnglesTransform_Multiply(), AnglesTransform_Multiply_GetPostShift(), AnglesTransform_PrePostShift_GetPostShift(), Portal_ApplyTransformToPlayerAngle(), Portal_TeleportPlayer(), skel_set_boneabs(), WarpZone_TransformOrigin(), WarpZone_TransformVelocity(), WarpZone_UnTransformOrigin(), and WarpZone_UnTransformVelocity().

AnglesTransform_ApplyToAngles()

vector AnglesTransform_ApplyToAngles	(	vector	transform,
		vector	v )

Definition at line 178 of file anglestransform.qc.

{
    v = AnglesTransform_Multiply(transform, v);
    return v;
}

References AnglesTransform_Multiply(), and vector.

Referenced by CheatCommand(), Portal_TeleportPlayer(), WarpZone_TransformAngles(), and WarpZone_UnTransformAngles().

AnglesTransform_ApplyToVAngles()

vector AnglesTransform_ApplyToVAngles	(	vector	transform,
		vector	v )

Definition at line 183 of file anglestransform.qc.

{
    v.x = -v.x;
    v = AnglesTransform_Multiply(transform, v);
    v.x = -v.x;
    return v;
}

References AnglesTransform_Multiply(), and vector.

Referenced by WarpZone_TransformVAngles(), and WarpZone_UnTransformVAngles().

AnglesTransform_CancelRoll()

vector AnglesTransform_CancelRoll

(

vector

t

)

Definition at line 114 of file anglestransform.qc.

{
    const float epsilon = 30;
    float f;
 
    // constraints:
    // forward vector (NOT SO important)
    // right vector, up vector: screen rotation (MORE important)
    // choose best match among all pitch-yaw only rotations
 
    // FIXME find a better method
 
    f = fabs(t.x - (-90)) / epsilon;
    if (f < 1)
    {
        //t.x = -90;
        t.y += t.z;
        t.z = 0;
    }
    else
    {
        f = fabs(t.x - 90) / epsilon;
        if (f < 1)
        {
            //t.x = 90;
            t.y -= t.z;
            t.z = 0;
        }
    }
    return t;
}

References fabs(), and vector.

Referenced by WarpZone_TransformVAngles(), and WarpZone_UnTransformVAngles().

AnglesTransform_FromAngles()

vector AnglesTransform_FromAngles

(

vector

v

)

Definition at line 190 of file anglestransform.qc.

{
    return v;
}

References vector.

Referenced by attach_sameorigin(), Projectile_Draw(), spiderbot_frame(), turret_track(), and vehicle_aimturret().

AnglesTransform_FromVAngles()

vector AnglesTransform_FromVAngles

(

vector

v

)

Definition at line 198 of file anglestransform.qc.

{
    v.x = -v.x;
    return v;
}

References vector.

Referenced by attach_sameorigin().

AnglesTransform_Invert()

vector AnglesTransform_Invert

(

vector

transform

)

Definition at line 33 of file anglestransform.qc.

{
    vector i_forward, i_up;
    vector forward, right, up;
    FIXED_MAKE_VECTORS(transform, forward, right, up);
    // we want angles that turn forward into '1 0 0', right into '0 1 0' and up into '0 0 1'
    // but these are orthogonal unit vectors!
    // so to invert, we can simply fixedvectoangles the TRANSPOSED matrix
    // TODO is this always -transform?
    i_forward.x = forward.x;
    i_forward.y = -right.x;
    i_forward.z = up.x;
    i_up.x = forward.z;
    i_up.y = -right.z;
    i_up.z = up.z;
    return angles_remove360(fixedvectoangles2(i_forward, i_up));
}

References angles_remove360(), FIXED_MAKE_VECTORS, fixedvectoangles2, and vector.

Referenced by AnglesTransform_LeftDivide(), AnglesTransform_RightDivide(), skel_set_boneabs(), WarpZone_Accumulator_AddInverseTransform(), WarpZone_UnTransformAngles(), WarpZone_UnTransformOrigin(), WarpZone_UnTransformVAngles(), and WarpZone_UnTransformVelocity().

AnglesTransform_LeftDivide()

vector AnglesTransform_LeftDivide	(	vector	from_transform,
		vector	to_transform )

Definition at line 89 of file anglestransform.qc.

{
    return AnglesTransform_Multiply(AnglesTransform_Invert(from_transform), to_transform);
}

References AnglesTransform_Invert(), AnglesTransform_Multiply(), and vector.

Referenced by skel_set_boneabs(), spiderbot_frame(), turret_track(), and vehicle_aimturret().

AnglesTransform_Multiply()

vector AnglesTransform_Multiply	(	vector	t1,
		vector	t2 )

Definition at line 24 of file anglestransform.qc.

{
    vector forward, right, up;
    FIXED_MAKE_VECTORS(t2, forward, right, up);
    forward = AnglesTransform_Apply(t1, forward);
    up = AnglesTransform_Apply(t1, up);
    return angles_remove360(fixedvectoangles2(forward, up));
}

References angles_remove360(), AnglesTransform_Apply(), FIXED_MAKE_VECTORS, fixedvectoangles2, and vector.

Referenced by AnglesTransform_ApplyToAngles(), AnglesTransform_ApplyToVAngles(), AnglesTransform_LeftDivide(), AnglesTransform_RightDivide(), Projectile_Draw(), skeleton_from_frames(), and WarpZone_Accumulator_AddTransform().

AnglesTransform_Multiply_GetPostShift()

vector AnglesTransform_Multiply_GetPostShift	(	vector	t0,
		vector	st0,
		vector	t1,
		vector	st1 )

Definition at line 210 of file anglestransform.qc.

{
    // we want the result of:
    //   t0 * (t1 * p + st1) + st0
    //   t0 * t1 * p + t0 * st1 + st0
    return st0 + AnglesTransform_Apply(t0, st1);
}

References AnglesTransform_Apply(), and vector.

Referenced by WarpZone_Accumulator_AddTransform().

AnglesTransform_Normalize()

vector AnglesTransform_Normalize	(	vector	t,
		float	minimize_roll )

Definition at line 94 of file anglestransform.qc.

{
    float need_flip;
    // first, bring all angles in their range...
    t.x -= 360 * rint(t.x / 360);
    t.y -= 360 * rint(t.y / 360);
    t.z -= 360 * rint(t.z / 360);
    if (minimize_roll)
        need_flip = (t.z > 90 || t.z <= -90);
    else
        need_flip = (t.x > 90 || t.x < -90); // for pitch we prefer to allow exactly -90 degrees for looking straight down
    if (need_flip)
    {
        if (t.x >= 0) t.x  = 180 - t.x;  else  t.x  = -180 - t.x;
        if (t.y > 0)  t.y -= 180;        else  t.y +=  180;
        if (t.z > 0)  t.z -= 180;        else  t.z +=  180;
    }
    return t;
}

References rint(), and vector.

Referenced by spiderbot_frame(), vehicle_aimturret(), WarpZone_TransformVAngles(), and WarpZone_UnTransformVAngles().

AnglesTransform_PrePostShift_GetPostShift()

vector AnglesTransform_PrePostShift_GetPostShift	(	vector	sf,
		vector	t,
		vector	st )

Definition at line 217 of file anglestransform.qc.

{
    return st - AnglesTransform_Apply(t, sf);
}

References AnglesTransform_Apply(), and vector.

Referenced by WarpZone_Accumulator_AddInverseTransform(), and WarpZone_SetUp().

AnglesTransform_RightDivide()

vector AnglesTransform_RightDivide	(	vector	to_transform,
		vector	from_transform )

Definition at line 84 of file anglestransform.qc.

{
    return AnglesTransform_Multiply(to_transform, AnglesTransform_Invert(from_transform));
}

References AnglesTransform_Invert(), AnglesTransform_Multiply(), and vector.

Referenced by Portal_Connect(), and WarpZone_SetUp().

AnglesTransform_ToAngles()

vector AnglesTransform_ToAngles

(

vector

v

)

Definition at line 194 of file anglestransform.qc.

{
    return v;
}

References vector.

Referenced by attach_sameorigin(), detach_sameorigin(), Projectile_Draw(), spiderbot_frame(), turret_track(), and vehicle_aimturret().

AnglesTransform_ToVAngles()

vector AnglesTransform_ToVAngles

(

vector

v

)

Definition at line 203 of file anglestransform.qc.

{
    v.x = -v.x;
    return v;
}

References vector.

Referenced by attach_sameorigin(), and detach_sameorigin().

AnglesTransform_TurnDirectionFR()

vector AnglesTransform_TurnDirectionFR

(

vector

transform

)

Definition at line 51 of file anglestransform.qc.

{
    // turn 180 degrees around v_up
    // changes in-direction to out-direction
    //fixedmakevectors(transform);
    //return angles_remove360(fixedvectoangles2(-1 * v_forward, 1 * v_up));
    transform.x = -transform.x;
    transform.y = 180 + transform.y;
    if (transform.y >= 360)
        transform.y -= 360;
    transform.z = -transform.z;
    // pitch: -s +c
    // yaw:   -s -c
    // roll:  -s +c
    return transform;
}

References vector.

Referenced by Portal_Connect(), and WarpZone_SetUp().

AnglesTransform_TurnDirectionFU()

vector AnglesTransform_TurnDirectionFU

(

vector

transform

)

Definition at line 68 of file anglestransform.qc.

{
    // turn 180 degrees around v_up
    // changes in-direction to out-direction
    //fixedmakevectors(transform);
    //return angles_remove360(fixedvectoangles2(-1 * v_forward, 1 * v_up));
    transform.x = -transform.x;
    transform.y = 180 + transform.y;
    if (transform.y >= 360)
        transform.y -= 360;
    transform.z = 180 - transform.z;
    if (transform.y <= -360)
        transform.y += 360;
    return transform;
}

References vector.