/* * Copyright 2019-2025 Andrey Pokidov * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ using System; /* * Author: Andrey Pokidov * Date: 1 Feb 2019 */ namespace BasicGeometry { public struct Vector3FP32 { public static readonly Vector3FP32 ZERO = new Vector3FP32(0.0f, 0.0f, 0.0f); public float x1 = 0.0f; public float x2 = 0.0f; public float x3 = 0.0f; public Vector3FP32(float x1, float x2, float x3) { this.x1 = x1; this.x2 = x2; this.x3 = x3; } public Vector3FP32(in Vector3FP32 vector) { this.x1 = vector.x1; this.x2 = vector.x2; this.x3 = vector.x3; } public Vector3FP32(in Vector3FP64 vector) { this.x1 = (float)vector.x1; this.x2 = (float)vector.x2; this.x3 = (float)vector.x3; } public readonly float GetSquareModule() { return this.x1 * this.x1 + this.x2 * this.x2 + this.x3 * this.x3; } public readonly float GetModule() { return MathF.Sqrt(this.GetSquareModule()); } public int Normalize() { float squareModule = this.GetSquareModule(); if (UtilityFP32.IsSqareValueUnit(squareModule)) { return 1; } if (squareModule <= UtilityFP32.SQUARE_EPSYLON) { this.Reset(); return 0; } float multiplier = MathF.Sqrt(1.0f / squareModule); this.x1 *= multiplier; this.x2 *= multiplier; this.x3 *= multiplier; return 1; } public void Reverse() { this.x1 = -this.x1; this.x2 = -this.x2; this.x3 = -this.x3; } public readonly bool IsZero() { return this.GetSquareModule() <= UtilityFP32.SQUARE_EPSYLON; } public readonly bool IsUnit() { return UtilityFP32.IsSqareValueUnit(this.GetSquareModule()); } public void Reset() { this.x1 = 0.0f; this.x2 = 0.0f; this.x3 = 0.0f; } public void SetValues(float x1, float x2, float x3) { this.x1 = x1; this.x2 = x2; this.x3 = x3; } public void SetValues(in Vector3FP64 vector) { this.x1 = (float)vector.x1; this.x2 = (float)vector.x2; this.x3 = (float)vector.x3; } public void SetValues(in Vector3FP32 vector) { this.x1 = vector.x1; this.x2 = vector.x2; this.x3 = vector.x3; } public void SetReverseOf(in Vector3FP32 vector) { this.x1 = -vector.x1; this.x2 = -vector.x2; this.x3 = -vector.x3; } public void SetReverseOf(in Vector3FP64 vector) { this.x1 = -(float)vector.x1; this.x2 = -(float)vector.x2; this.x3 = -(float)vector.x3; } public void AppendScaled(Vector3FP32 summand, float scale) { this.x1 += summand.x1 * scale; this.x2 += summand.x2 * scale; this.x3 += summand.x3 * scale; } public readonly override string ToString() { return String.Format("SPVector3({0}, {1}, {2})", this.x1, this.x2, this.x3); } public static void Add(in Vector3FP32 vector1, in Vector3FP32 vector2, out Vector3FP32 sum) { sum.x1 = vector1.x1 + vector2.x1; sum.x2 = vector1.x2 + vector2.x2; sum.x3 = vector1.x3 + vector2.x3; } public static void Subtract(in Vector3FP32 minuend, in Vector3FP32 subtrahend, out Vector3FP32 difference) { difference.x1 = minuend.x1 - subtrahend.x1; difference.x2 = minuend.x2 - subtrahend.x2; difference.x3 = minuend.x3 - subtrahend.x3; } public static void Multiply(in Vector3FP32 multiplicand, float multiplier, out Vector3FP32 product) { product.x1 = multiplicand.x1 * multiplier; product.x2 = multiplicand.x2 * multiplier; product.x3 = multiplicand.x3 * multiplier; } public static void Divide(in Vector3FP32 dividend, float divisor, out Vector3FP32 quotient) { Multiply(dividend, 1.0f / divisor, out quotient); } public static void GetMean2(in Vector3FP32 vector1, in Vector3FP32 vector2, out Vector3FP32 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; } public static void GetMean3(in Vector3FP32 vector1, in Vector3FP32 vector2, in Vector3FP32 vector3, out Vector3FP32 result) { result.x1 = (vector1.x1 + vector2.x1 + vector3.x1) * UtilityFP32.ONE_THIRD; result.x2 = (vector1.x2 + vector2.x2 + vector3.x2) * UtilityFP32.ONE_THIRD; result.x3 = (vector1.x3 + vector2.x3 + vector3.x3) * UtilityFP32.ONE_THIRD; } public static float GetScalarProduct(in Vector3FP32 vector1, in Vector3FP32 vector2) { return vector1.x1 * vector2.x1 + vector1.x2 * vector2.x2 + vector1.x3 * vector2.x3; } public static void GetCrossProduct(in Vector3FP32 vector1, in Vector3FP32 vector2, out Vector3FP32 result) { float x1 = vector1.x2 * vector2.x3 - vector1.x3 * vector2.x2; float x2 = vector1.x3 * vector2.x1 - vector1.x1 * vector2.x3; float x3 = vector1.x1 * vector2.x2 - vector1.x2 * vector2.x1; result.x1 = x1; result.x2 = x2; result.x3 = x3; } public static float GetTripleProduct(in Vector3FP32 vector1, in Vector3FP32 vector2, in Vector3FP32 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); } public static void GetDoubleCrossProduct(in Vector3FP32 vector1, in Vector3FP32 vector2, in Vector3FP32 vector3, out Vector3FP32 result) { // [a x [b x c]] = b * (a, c) - c * (a, b) float ac = GetScalarProduct(vector1, vector3); float ab = GetScalarProduct(vector1, vector2); result.x1 = ac * vector2.x1 - ab * vector3.x1; result.x2 = ac * vector2.x2 - ab * vector3.x2; result.x3 = ac * vector2.x3 - ab * vector3.x3; } public static float GetAngle(in Vector3FP32 vector1, in Vector3FP32 vector2, AngleUnit unit) { float squareModule1 = vector1.GetSquareModule(); if (squareModule1 <= UtilityFP32.SQUARE_EPSYLON) { return 0.0f; } float squareModule2 = vector2.GetSquareModule(); if (squareModule2 <= UtilityFP32.SQUARE_EPSYLON) { return 0.0f; } float cosine = Vector3FP32.GetScalarProduct(vector1, vector2) / MathF.Sqrt(squareModule1 * squareModule2); if (1.0f - UtilityFP32.EPSYLON <= cosine) { return 0.0f; } if (cosine <= -(1.0f - UtilityFP32.EPSYLON)) { return AngleFP32.GetHalfCircle(unit); } return RadianFP32.ToUnits(MathF.Acos(cosine), unit); } public static float GetSquareDistance(in Vector3FP32 vector1, in Vector3FP32 vector2) { float dx1 = vector1.x1 - vector2.x1; float dx2 = vector1.x2 - vector2.x2; float dx3 = vector1.x3 - vector2.x3; return dx1 * dx1 + dx2 * dx2 + dx3 * dx3; } public static float GetDistance(in Vector3FP32 vector1, in Vector3FP32 vector2) { return MathF.Sqrt(GetSquareDistance(vector1, vector2)); } public static bool AreEqual(in Vector3FP32 vector1, in Vector3FP32 vector2) { float squareModule1 = vector1.GetSquareModule(); float squareModule2 = vector2.GetSquareModule(); float squareModule3 = GetSquareDistance(vector1, vector2); // 3.0f means dimension amount if (squareModule1 < UtilityFP32.EPSYLON_EFFECTIVENESS_LIMIT || squareModule2 < UtilityFP32.EPSYLON_EFFECTIVENESS_LIMIT) { return squareModule3 < (3.0f * UtilityFP32.SQUARE_EPSYLON); } if (squareModule1 <= squareModule2) { return squareModule3 <= (3.0f * UtilityFP32.SQUARE_EPSYLON) * squareModule2; } return squareModule3 <= (3.0f * UtilityFP32.SQUARE_EPSYLON) * squareModule1; } } }