2014-02-10 09:10:30 +08:00
|
|
|
/*************************************************************************/
|
|
|
|
/* vector3.cpp */
|
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
2017-08-27 20:16:55 +08:00
|
|
|
/* https://godotengine.org */
|
2014-02-10 09:10:30 +08:00
|
|
|
/*************************************************************************/
|
2022-01-04 04:27:34 +08:00
|
|
|
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
|
2014-02-10 09:10:30 +08:00
|
|
|
/* */
|
|
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
|
|
/* a copy of this software and associated documentation files (the */
|
|
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
|
|
/* the following conditions: */
|
|
|
|
/* */
|
|
|
|
/* The above copyright notice and this permission notice shall be */
|
|
|
|
/* included in all copies or substantial portions of the Software. */
|
|
|
|
/* */
|
|
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
|
|
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
|
|
/*************************************************************************/
|
2018-01-05 07:50:27 +08:00
|
|
|
|
2014-02-10 09:10:30 +08:00
|
|
|
#include "vector3.h"
|
2018-09-12 00:13:45 +08:00
|
|
|
|
2019-02-09 13:24:02 +08:00
|
|
|
#include "core/math/basis.h"
|
2022-02-19 23:47:24 +08:00
|
|
|
#include "core/math/vector2.h"
|
|
|
|
#include "core/math/vector3i.h"
|
|
|
|
#include "core/string/ustring.h"
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2021-08-15 22:45:37 +08:00
|
|
|
void Vector3::rotate(const Vector3 &p_axis, const real_t p_phi) {
|
2017-03-05 23:44:50 +08:00
|
|
|
*this = Basis(p_axis, p_phi).xform(*this);
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2021-08-15 22:45:37 +08:00
|
|
|
Vector3 Vector3::rotated(const Vector3 &p_axis, const real_t p_phi) const {
|
2014-02-10 09:10:30 +08:00
|
|
|
Vector3 r = *this;
|
2017-03-05 23:44:50 +08:00
|
|
|
r.rotate(p_axis, p_phi);
|
2014-02-10 09:10:30 +08:00
|
|
|
return r;
|
|
|
|
}
|
|
|
|
|
2021-08-15 22:45:37 +08:00
|
|
|
void Vector3::set_axis(const int p_axis, const real_t p_value) {
|
2017-03-05 23:44:50 +08:00
|
|
|
ERR_FAIL_INDEX(p_axis, 3);
|
|
|
|
coord[p_axis] = p_value;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
2020-05-14 20:29:06 +08:00
|
|
|
|
2021-08-15 22:45:37 +08:00
|
|
|
real_t Vector3::get_axis(const int p_axis) const {
|
2017-03-05 23:44:50 +08:00
|
|
|
ERR_FAIL_INDEX_V(p_axis, 3, 0);
|
2016-10-02 02:54:31 +08:00
|
|
|
return operator[](p_axis);
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2021-02-01 13:10:52 +08:00
|
|
|
Vector3 Vector3::clamp(const Vector3 &p_min, const Vector3 &p_max) const {
|
|
|
|
return Vector3(
|
|
|
|
CLAMP(x, p_min.x, p_max.x),
|
|
|
|
CLAMP(y, p_min.y, p_max.y),
|
|
|
|
CLAMP(z, p_min.z, p_max.z));
|
|
|
|
}
|
|
|
|
|
2021-08-15 22:45:37 +08:00
|
|
|
void Vector3::snap(const Vector3 p_step) {
|
2020-12-22 02:02:57 +08:00
|
|
|
x = Math::snapped(x, p_step.x);
|
|
|
|
y = Math::snapped(y, p_step.y);
|
|
|
|
z = Math::snapped(z, p_step.z);
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
2020-05-14 20:29:06 +08:00
|
|
|
|
2021-08-15 22:45:37 +08:00
|
|
|
Vector3 Vector3::snapped(const Vector3 p_step) const {
|
2017-03-05 23:44:50 +08:00
|
|
|
Vector3 v = *this;
|
2020-12-22 02:02:57 +08:00
|
|
|
v.snap(p_step);
|
2016-10-02 02:54:31 +08:00
|
|
|
return v;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2021-02-01 13:42:00 +08:00
|
|
|
Vector3 Vector3::limit_length(const real_t p_len) const {
|
|
|
|
const real_t l = length();
|
|
|
|
Vector3 v = *this;
|
|
|
|
if (l > 0 && p_len < l) {
|
|
|
|
v /= l;
|
|
|
|
v *= p_len;
|
|
|
|
}
|
|
|
|
|
|
|
|
return v;
|
|
|
|
}
|
|
|
|
|
2021-08-15 22:45:37 +08:00
|
|
|
Vector3 Vector3::cubic_interpolate(const Vector3 &p_b, const Vector3 &p_pre_a, const Vector3 &p_post_b, const real_t p_weight) const {
|
2022-02-11 11:43:21 +08:00
|
|
|
Vector3 res = *this;
|
|
|
|
res.x = Math::cubic_interpolate(res.x, p_b.x, p_pre_a.x, p_post_b.x, p_weight);
|
|
|
|
res.y = Math::cubic_interpolate(res.y, p_b.y, p_pre_a.y, p_post_b.y, p_weight);
|
|
|
|
res.z = Math::cubic_interpolate(res.z, p_b.z, p_pre_a.z, p_post_b.z, p_weight);
|
|
|
|
return res;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2019-04-08 05:40:56 +08:00
|
|
|
Vector3 Vector3::move_toward(const Vector3 &p_to, const real_t p_delta) const {
|
|
|
|
Vector3 v = *this;
|
|
|
|
Vector3 vd = p_to - v;
|
|
|
|
real_t len = vd.length();
|
2022-02-24 15:17:00 +08:00
|
|
|
return len <= p_delta || len < (real_t)CMP_EPSILON ? p_to : v + vd / len * p_delta;
|
2019-04-08 05:40:56 +08:00
|
|
|
}
|
|
|
|
|
2022-02-19 23:47:24 +08:00
|
|
|
Vector2 Vector3::octahedron_encode() const {
|
|
|
|
Vector3 n = *this;
|
|
|
|
n /= Math::abs(n.x) + Math::abs(n.y) + Math::abs(n.z);
|
|
|
|
Vector2 o;
|
|
|
|
if (n.z >= 0.0f) {
|
|
|
|
o.x = n.x;
|
|
|
|
o.y = n.y;
|
|
|
|
} else {
|
|
|
|
o.x = (1.0f - Math::abs(n.y)) * (n.x >= 0.0f ? 1.0f : -1.0f);
|
|
|
|
o.y = (1.0f - Math::abs(n.x)) * (n.y >= 0.0f ? 1.0f : -1.0f);
|
|
|
|
}
|
|
|
|
o.x = o.x * 0.5f + 0.5f;
|
|
|
|
o.y = o.y * 0.5f + 0.5f;
|
|
|
|
return o;
|
|
|
|
}
|
|
|
|
|
|
|
|
Vector3 Vector3::octahedron_decode(const Vector2 &p_oct) {
|
|
|
|
Vector2 f(p_oct.x * 2.0f - 1.0f, p_oct.y * 2.0f - 1.0f);
|
|
|
|
Vector3 n(f.x, f.y, 1.0f - Math::abs(f.x) - Math::abs(f.y));
|
|
|
|
float t = CLAMP(-n.z, 0.0f, 1.0f);
|
|
|
|
n.x += n.x >= 0 ? -t : t;
|
|
|
|
n.y += n.y >= 0 ? -t : t;
|
|
|
|
return n.normalized();
|
|
|
|
}
|
|
|
|
|
2021-11-30 01:02:42 +08:00
|
|
|
Basis Vector3::outer(const Vector3 &p_with) const {
|
|
|
|
Vector3 row0(x * p_with.x, x * p_with.y, x * p_with.z);
|
|
|
|
Vector3 row1(y * p_with.x, y * p_with.y, y * p_with.z);
|
|
|
|
Vector3 row2(z * p_with.x, z * p_with.y, z * p_with.z);
|
2019-10-07 22:26:27 +08:00
|
|
|
|
|
|
|
return Basis(row0, row1, row2);
|
|
|
|
}
|
|
|
|
|
2019-10-15 04:33:45 +08:00
|
|
|
bool Vector3::is_equal_approx(const Vector3 &p_v) const {
|
|
|
|
return Math::is_equal_approx(x, p_v.x) && Math::is_equal_approx(y, p_v.y) && Math::is_equal_approx(z, p_v.z);
|
|
|
|
}
|
|
|
|
|
2014-02-10 09:10:30 +08:00
|
|
|
Vector3::operator String() const {
|
2021-02-25 22:54:50 +08:00
|
|
|
return "(" + String::num_real(x, false) + ", " + String::num_real(y, false) + ", " + String::num_real(z, false) + ")";
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
2022-02-19 23:47:24 +08:00
|
|
|
|
|
|
|
Vector3::operator Vector3i() const {
|
|
|
|
return Vector3i(x, y, z);
|
|
|
|
}
|