bgc-c/basic-geometry/vector3.h

581 lines
19 KiB
C

#ifndef _BASIC_GEOMETRY_VECTOR3_H_
#define _BASIC_GEOMETRY_VECTOR3_H_
#include "basis.h"
#include "angle.h"
#include <math.h>
// ================== Vector3 =================== //
typedef struct
{
float x1, x2, x3;
} vector3_fp32_t;
typedef struct
{
double x1, x2, x3;
} vector3_fp64_t;
// =================== Reset ==================== //
inline void vector3_reset_fp32(vector3_fp32_t* vector)
{
vector->x1 = 0.0f;
vector->x2 = 0.0f;
vector->x3 = 0.0f;
}
inline void vector3_reset_fp64(vector3_fp64_t* vector)
{
vector->x1 = 0.0;
vector->x2 = 0.0;
vector->x3 = 0.0;
}
// ==================== Set ===================== //
inline void vector3_set_values_fp32(const float x1, const float x2, const float x3, vector3_fp32_t* to)
{
to->x1 = x1;
to->x2 = x2;
to->x3 = x3;
}
inline void vector3_set_values_fp64(const double x1, const double x2, const double x3, vector3_fp64_t* to)
{
to->x1 = x1;
to->x2 = x2;
to->x3 = x3;
}
// ==================== Copy ==================== //
inline void vector3_copy_fp32(const vector3_fp32_t* from, vector3_fp32_t* to)
{
to->x1 = from->x1;
to->x2 = from->x2;
to->x3 = from->x3;
}
inline void vector3_copy_fp64(const vector3_fp64_t* from, vector3_fp64_t* to)
{
to->x1 = from->x1;
to->x2 = from->x2;
to->x3 = from->x3;
}
// ================== Convert =================== //
inline void vector3_convert__fp64_to_fp32(const vector3_fp64_t* from, vector3_fp32_t* to)
{
to->x1 = (float) from->x1;
to->x2 = (float) from->x2;
to->x3 = (float) from->x3;
}
inline void vector3_convert__fp32_to_fp64(const vector3_fp32_t* from, vector3_fp64_t* to)
{
to->x1 = from->x1;
to->x2 = from->x2;
to->x3 = from->x3;
}
// ==================== Swap ==================== //
inline void vector3_swap_fp32(vector3_fp32_t* vector1, vector3_fp32_t* vector2)
{
const float x1 = vector2->x1;
const float x2 = vector2->x2;
const float x3 = vector2->x3;
vector2->x1 = vector1->x1;
vector2->x2 = vector1->x2;
vector2->x3 = vector1->x3;
vector1->x1 = x1;
vector1->x2 = x2;
vector1->x3 = x3;
}
inline void vector3_swap_fp64(vector3_fp64_t* vector1, vector3_fp64_t* vector2)
{
const double x1 = vector2->x1;
const double x2 = vector2->x2;
const double x3 = vector2->x3;
vector2->x1 = vector1->x1;
vector2->x2 = vector1->x2;
vector2->x3 = vector1->x3;
vector1->x1 = x1;
vector1->x2 = x2;
vector1->x3 = x3;
}
// ==================== Invert ================== //
inline void vector3_invert_fp32(vector3_fp32_t* vector)
{
vector->x1 = -vector->x1;
vector->x2 = -vector->x2;
vector->x3 = -vector->x3;
}
inline void vector3_invert_fp64(vector3_fp64_t* vector)
{
vector->x1 = -vector->x1;
vector->x2 = -vector->x2;
vector->x3 = -vector->x3;
}
// ================ Make Inverted =============== //
inline void vector3_set_inverted_fp32(const vector3_fp32_t* vector, vector3_fp32_t* result)
{
result->x1 = -vector->x1;
result->x2 = -vector->x2;
result->x3 = -vector->x3;
}
inline void vector3_set_inverted_fp64(const vector3_fp64_t* vector, vector3_fp64_t* result)
{
result->x1 = -vector->x1;
result->x2 = -vector->x2;
result->x3 = -vector->x3;
}
// ============== Make Inverted Twin ============ //
inline void vector3_set_inverted_fp32_to_fp64(const vector3_fp32_t* vector, vector3_fp64_t* result)
{
result->x1 = -vector->x1;
result->x2 = -vector->x2;
result->x3 = -vector->x3;
}
inline void vector3_set_inverted_fp64_to_fp32(const vector3_fp64_t* vector, vector3_fp32_t* result)
{
result->x1 = (float) -vector->x1;
result->x2 = (float) -vector->x2;
result->x3 = (float) -vector->x3;
}
// =================== Module =================== //
inline float vector3_get_square_modulus_fp32(const vector3_fp32_t* vector)
{
return vector->x1 * vector->x1 + vector->x2 * vector->x2 + vector->x3 * vector->x3;
}
inline double vector3_get_square_modulus_fp64(const vector3_fp64_t* vector)
{
return vector->x1 * vector->x1 + vector->x2 * vector->x2 + vector->x3 * vector->x3;
}
inline float vector3_get_modulus_fp32(const vector3_fp32_t* vector)
{
return sqrtf(vector3_get_square_modulus_fp32(vector));
}
inline double vector3_get_modulus_fp64(const vector3_fp64_t* vector)
{
return sqrt(vector3_get_square_modulus_fp64(vector));
}
// ================= Comparison ================= //
inline int vector3_fp32_is_zero(const vector3_fp32_t* vector)
{
return vector3_get_square_modulus_fp32(vector) <= FP32_SQUARE_EPSYLON;
}
inline int vector3_fp64_is_zero(const vector3_fp64_t* vector)
{
return vector3_get_square_modulus_fp64(vector) <= FP64_SQUARE_EPSYLON;
}
inline int vector3_fp32_is_unit(const vector3_fp32_t* vector)
{
const float square_modulus = vector3_get_square_modulus_fp32(vector);
return 1.0f - FP32_TWO_EPSYLON <= square_modulus && square_modulus <= 1.0f + FP32_TWO_EPSYLON;
}
inline int vector3_fp64_is_unit(const vector3_fp64_t* vector)
{
const double square_modulus = vector3_get_square_modulus_fp64(vector);
return 1.0f - FP64_TWO_EPSYLON <= square_modulus && square_modulus <= 1.0f + FP64_TWO_EPSYLON;
}
// ==================== Add ===================== //
inline void vector3_add_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2, vector3_fp32_t* sum)
{
sum->x1 = vector1->x1 + vector2->x1;
sum->x2 = vector1->x2 + vector2->x2;
sum->x3 = vector1->x3 + vector2->x3;
}
inline void vector3_add_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2, vector3_fp64_t* sum)
{
sum->x1 = vector1->x1 + vector2->x1;
sum->x2 = vector1->x2 + vector2->x2;
sum->x3 = vector1->x3 + vector2->x3;
}
// ==================== Sum ===================== //
inline void vector3_set_sum_fp32_to_fp64(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2, vector3_fp64_t* sum)
{
sum->x1 = vector1->x1 + vector2->x1;
sum->x2 = vector1->x2 + vector2->x2;
sum->x3 = vector1->x3 + vector2->x3;
}
inline void vector3_set_sum_fp64_to_fp32(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2, vector3_fp32_t* sum)
{
sum->x1 = (float)(vector1->x1 + vector2->x1);
sum->x2 = (float)(vector1->x2 + vector2->x2);
sum->x3 = (float)(vector1->x3 + vector2->x3);
}
// ================= Add scaled ================= //
inline void vector3_add_scaled_fp32(const vector3_fp32_t* basic_vector, const vector3_fp32_t* scalable_vector, const float scale, vector3_fp32_t* result)
{
result->x1 = basic_vector->x1 + scalable_vector->x1 * scale;
result->x2 = basic_vector->x2 + scalable_vector->x2 * scale;
result->x3 = basic_vector->x3 + scalable_vector->x3 * scale;
}
inline void vector3_add_scaled_fp64(const vector3_fp64_t* basic_vector, const vector3_fp64_t* scalable_vector, const double scale, vector3_fp64_t* result)
{
result->x1 = basic_vector->x1 + scalable_vector->x1 * scale;
result->x2 = basic_vector->x2 + scalable_vector->x2 * scale;
result->x3 = basic_vector->x3 + scalable_vector->x3 * scale;
}
// ================ Subtraction ================= //
inline void vector3_subtract_fp32(const vector3_fp32_t* minuend, const vector3_fp32_t* subtrahend, vector3_fp32_t* difference)
{
difference->x1 = minuend->x1 - subtrahend->x1;
difference->x2 = minuend->x2 - subtrahend->x2;
difference->x3 = minuend->x3 - subtrahend->x3;
}
inline void vector3_subtract_fp64(const vector3_fp64_t* minuend, const vector3_fp64_t* subtrahend, vector3_fp64_t* difference)
{
difference->x1 = minuend->x1 - subtrahend->x1;
difference->x2 = minuend->x2 - subtrahend->x2;
difference->x3 = minuend->x3 - subtrahend->x3;
}
// ================= Difference ================= //
inline void vector3_set_difference_fp32_to_fp64(const vector3_fp32_t* minuend, const vector3_fp32_t* subtrahend, vector3_fp64_t* difference)
{
difference->x1 = minuend->x1 - subtrahend->x1;
difference->x2 = minuend->x2 - subtrahend->x2;
difference->x3 = minuend->x3 - subtrahend->x3;
}
inline void vector3_set_difference_fp64_to_fp32(const vector3_fp64_t* minuend, const vector3_fp64_t* subtrahend, vector3_fp64_t* difference)
{
difference->x1 = (float)(minuend->x1 - subtrahend->x1);
difference->x2 = (float)(minuend->x2 - subtrahend->x2);
difference->x3 = (float)(minuend->x3 - subtrahend->x3);
}
// =============== Multiplication =============== //
inline void vector3_multiply_fp32(const vector3_fp32_t* multiplicand, const float multiplier, vector3_fp32_t* product)
{
product->x1 = multiplicand->x1 * multiplier;
product->x2 = multiplicand->x2 * multiplier;
product->x3 = multiplicand->x3 * multiplier;
}
inline void vector3_multiply_fp64(const vector3_fp64_t* multiplicand, const double multiplier, vector3_fp64_t* product)
{
product->x1 = multiplicand->x1 * multiplier;
product->x2 = multiplicand->x2 * multiplier;
product->x3 = multiplicand->x3 * multiplier;
}
// =============== Multiplication =============== //
inline void vector3_set_product_fp32_to_fp64(const vector3_fp32_t* multiplicand, const double multiplier, vector3_fp64_t* product)
{
product->x1 = multiplicand->x1 * multiplier;
product->x2 = multiplicand->x2 * multiplier;
product->x3 = multiplicand->x3 * multiplier;
}
inline void vector3_set_product_fp64_to_fp32(const vector3_fp64_t* multiplicand, const double multiplier, vector3_fp32_t* product)
{
product->x1 = (float)(multiplicand->x1 * multiplier);
product->x2 = (float)(multiplicand->x2 * multiplier);
product->x3 = (float)(multiplicand->x3 * multiplier);
}
// ================== Division ================== //
inline void vector3_divide_fp32(const vector3_fp32_t* dividend, const float divisor, vector3_fp32_t* quotient)
{
vector3_multiply_fp32(dividend, 1.0f / divisor, quotient);
}
inline void vector3_divide_fp64(const vector3_fp64_t* dividend, const double divisor, vector3_fp64_t* quotient)
{
vector3_multiply_fp64(dividend, 1.0 / divisor, quotient);
}
// ================== Quotient ================== //
inline void vector3_set_quotient_fp32_to_fp64(const vector3_fp32_t* dividend, const double divisor, vector3_fp64_t* quotient)
{
vector3_set_product_fp32_to_fp64(dividend, 1.0 / divisor, quotient);
}
inline void vector3_set_quotient_fp64_to_fp32(const vector3_fp64_t* dividend, const double divisor, vector3_fp32_t* quotient)
{
vector3_set_product_fp64_to_fp32(dividend, 1.0f / divisor, quotient);
}
// ================== Average2 ================== //
inline void vector3_mean_of_two_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2, vector3_fp32_t* result)
{
result->x1 = (vector1->x1 + vector2->x1) * 0.5f;
result->x2 = (vector1->x2 + vector2->x2) * 0.5f;
result->x3 = (vector1->x3 + vector2->x3) * 0.5f;
}
inline void vector3_mean_of_two_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2, vector3_fp64_t* result)
{
result->x1 = (vector1->x1 + vector2->x1) * 0.5;
result->x2 = (vector1->x2 + vector2->x2) * 0.5;
result->x3 = (vector1->x3 + vector2->x3) * 0.5;
}
// ================== Average3 ================== //
inline void vector3_mean_of_three_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2, const vector3_fp32_t* vector3, vector3_fp32_t* result)
{
result->x1 = (vector1->x1 + vector2->x1 + vector3->x1) * FP32_ONE_THIRD;
result->x2 = (vector1->x2 + vector2->x2 + vector3->x2) * FP32_ONE_THIRD;
result->x3 = (vector1->x3 + vector2->x3 + vector3->x3) * FP32_ONE_THIRD;
}
inline void vector3_mean_of_three_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2, const vector3_fp64_t* vector3, vector3_fp64_t* result)
{
result->x1 = (vector1->x1 + vector2->x1 + vector3->x1) * FP64_ONE_THIRD;
result->x2 = (vector1->x2 + vector2->x2 + vector3->x2) * FP64_ONE_THIRD;
result->x3 = (vector1->x3 + vector2->x3 + vector3->x3) * FP64_ONE_THIRD;
}
// =============== Scalar Product =============== //
inline float vector3_scalar_product_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2)
{
return vector1->x1 * vector2->x1 + vector1->x2 * vector2->x2 + vector1->x3 * vector2->x3;
}
inline double vector3_scalar_product_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2)
{
return vector1->x1 * vector2->x1 + vector1->x2 * vector2->x2 + vector1->x3 * vector2->x3;
}
// =============== Triple Product =============== //
inline float vector3_triple_product_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2, const vector3_fp32_t* vector3)
{
return vector1->x1 * (vector2->x2 * vector3->x3 - vector2->x3 * vector3->x2)
+ vector1->x2 * (vector2->x3 * vector3->x1 - vector2->x1 * vector3->x3)
+ vector1->x3 * (vector2->x1 * vector3->x2 - vector2->x2 * vector3->x1);
}
inline double vector3_triple_product_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2, const vector3_fp64_t* vector3)
{
return vector1->x1 * (vector2->x2 * vector3->x3 - vector2->x3 * vector3->x2)
+ vector1->x2 * (vector2->x3 * vector3->x1 - vector2->x1 * vector3->x3)
+ vector1->x3 * (vector2->x1 * vector3->x2 - vector2->x2 * vector3->x1);
}
// =============== Cross Product ================ //
inline void vector3_cross_product_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2, vector3_fp32_t* result)
{
const float x1 = vector1->x2 * vector2->x3 - vector1->x3 * vector2->x2;
const float x2 = vector1->x3 * vector2->x1 - vector1->x1 * vector2->x3;
const float x3 = vector1->x1 * vector2->x2 - vector1->x2 * vector2->x1;
result->x1 = x1;
result->x2 = x2;
result->x3 = x3;
}
inline void vector3_cross_product_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2, vector3_fp64_t* result)
{
const double x1 = vector1->x2 * vector2->x3 - vector1->x3 * vector2->x2;
const double x2 = vector1->x3 * vector2->x1 - vector1->x1 * vector2->x3;
const double x3 = vector1->x1 * vector2->x2 - vector1->x2 * vector2->x1;
result->x1 = x1;
result->x2 = x2;
result->x3 = x3;
}
// ============ Double Cross Product ============ //
inline void vector3_double_cross_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2, const vector3_fp32_t* vector3, vector3_fp32_t* result)
{
const float ac = vector3_scalar_product_fp32(vector1, vector3);
const float ab = vector3_scalar_product_fp32(vector1, vector2);
result->x1 = vector2->x1 * ac - vector3->x1 * ab;
result->x2 = vector2->x2 * ac - vector3->x2 * ab;
result->x3 = vector2->x3 * ac - vector3->x3 * ab;
}
inline void vector3_double_cross_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2, const vector3_fp64_t* vector3, vector3_fp64_t* result)
{
const double ac = vector3_scalar_product_fp64(vector1, vector3);
const double ab = vector3_scalar_product_fp64(vector1, vector2);
result->x1 = vector2->x1 * ac - vector3->x1 * ab;
result->x2 = vector2->x2 * ac - vector3->x2 * ab;
result->x3 = vector2->x3 * ac - vector3->x3 * ab;
}
// =============== Normalization ================ //
inline int vector3_normalize_fp32(vector3_fp32_t* vector)
{
const float square_modulus = vector3_get_square_modulus_fp32(vector);
if (1.0f - FP32_TWO_EPSYLON <= square_modulus && square_modulus <= 1.0f + FP32_TWO_EPSYLON) {
return 1;
}
if (square_modulus <= FP32_SQUARE_EPSYLON) {
vector3_reset_fp32(vector);
return 0;
}
vector3_multiply_fp32(vector, sqrtf(1.0f / square_modulus), vector);
return 1;
}
inline int vector3_normalize_fp64(vector3_fp64_t* vector)
{
const double square_modulus = vector3_get_square_modulus_fp64(vector);
if (1.0 - FP64_TWO_EPSYLON <= square_modulus && square_modulus <= 1.0 + FP64_TWO_EPSYLON) {
return 1;
}
if (square_modulus <= FP64_SQUARE_EPSYLON) {
vector3_reset_fp64(vector);
return 0;
}
vector3_multiply_fp64(vector, sqrt(1.0 / square_modulus), vector);
return 1;
}
// =============== Set Normalized =============== //
inline int vector3_set_normalized_fp32(const vector3_fp32_t* vector, vector3_fp32_t* result)
{
vector3_copy_fp32(vector, result);
return vector3_normalize_fp32(result);
}
inline int vector3_set_normalized_fp64(const vector3_fp64_t* vector, vector3_fp64_t* result)
{
vector3_copy_fp64(vector, result);
return vector3_normalize_fp64(result);
}
// =================== Angle ==================== //
float vector3_get_angle_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2, const angle_unit_t unit);
double vector3_get_angle_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2, const angle_unit_t unit);
// =============== Square Distance ============== //
inline float vector3_get_square_distance_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2)
{
const float dx1 = (vector1->x1 - vector2->x1);
const float dx2 = (vector1->x2 - vector2->x2);
const float dx3 = (vector1->x3 - vector2->x3);
return dx1 * dx1 + dx2 * dx2 + dx3 * dx3;
}
inline double vector3_get_square_distance_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2)
{
const double dx1 = (vector1->x1 - vector2->x1);
const double dx2 = (vector1->x2 - vector2->x2);
const double dx3 = (vector1->x3 - vector2->x3);
return dx1 * dx1 + dx2 * dx2 + dx3 * dx3;
}
// ================== Distance ================== //
inline float vector3_get_distance_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2)
{
return sqrtf(vector3_get_square_distance_fp32(vector1, vector2));
}
inline double vector3_get_distance_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2)
{
return sqrt(vector3_get_square_distance_fp64(vector1, vector2));
}
// ================== Are Equal ================= //
inline int vector3_are_equal_fp32(const vector3_fp32_t* vector1, const vector3_fp32_t* vector2)
{
const float square_modulus1 = vector3_get_square_modulus_fp32(vector1);
const float square_modulus2 = vector3_get_square_modulus_fp32(vector2);
const float square_modulus3 = vector3_get_square_distance_fp32(vector1, vector2);
// 3.0f means dimension amount
if (square_modulus1 < FP32_EPSYLON_EFFECTIVENESS_LIMIT || square_modulus2 < FP32_EPSYLON_EFFECTIVENESS_LIMIT) {
return square_modulus3 < (3.0f * FP32_SQUARE_EPSYLON);
}
if (square_modulus1 <= square_modulus2) {
return square_modulus3 <= (3.0f * FP32_SQUARE_EPSYLON) * square_modulus2;
}
return square_modulus3 <= (3.0f * FP32_SQUARE_EPSYLON) * square_modulus1;
}
inline int vector3_are_equal_fp64(const vector3_fp64_t* vector1, const vector3_fp64_t* vector2)
{
const double square_modulus1 = vector3_get_square_modulus_fp64(vector1);
const double square_modulus2 = vector3_get_square_modulus_fp64(vector2);
const double square_modulus3 = vector3_get_square_distance_fp64(vector1, vector2);
// 3.0 means dimension amount
if (square_modulus1 < FP64_EPSYLON_EFFECTIVENESS_LIMIT || square_modulus2 < FP64_EPSYLON_EFFECTIVENESS_LIMIT) {
return square_modulus3 < (3.0 * FP64_SQUARE_EPSYLON);
}
if (square_modulus1 <= square_modulus2) {
return square_modulus3 <= (3.0 * FP64_SQUARE_EPSYLON) * square_modulus2;
}
return square_modulus3 <= (3.0 * FP64_SQUARE_EPSYLON) * square_modulus1;
}
#endif