godot-module-template/engine/scene/3d/remote_transform_3d.cpp
2025-04-12 18:40:44 +02:00

243 lines
8.4 KiB
C++

/**************************************************************************/
/* remote_transform_3d.cpp */
/**************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/**************************************************************************/
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
/* */
/* 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. */
/**************************************************************************/
#include "remote_transform_3d.h"
void RemoteTransform3D::_update_cache() {
cache = ObjectID();
if (has_node(remote_node)) {
Node *node = get_node(remote_node);
if (!node || this == node || node->is_ancestor_of(this) || is_ancestor_of(node)) {
return;
}
cache = node->get_instance_id();
}
}
void RemoteTransform3D::_update_remote() {
if (!is_inside_tree()) {
return;
}
if (cache.is_null()) {
return;
}
Node3D *target_node = ObjectDB::get_instance<Node3D>(cache);
if (!target_node) {
return;
}
if (!target_node->is_inside_tree()) {
return;
}
Transform3D our_trans = use_global_coordinates ? get_global_transform() : get_transform();
if (update_remote_position && update_remote_rotation && update_remote_scale) {
if (use_global_coordinates) {
target_node->set_global_transform(our_trans);
} else {
target_node->set_transform(our_trans);
}
} else {
Transform3D target_trans = use_global_coordinates ? target_node->get_global_transform() : target_node->get_transform();
if (update_remote_rotation && update_remote_scale) {
target_trans.basis = our_trans.basis;
} else if (update_remote_rotation) {
for (int i = 0; i < 3; i++) {
Vector3 our_col = our_trans.basis.get_column(i);
Vector3 target_col = target_trans.basis.get_column(i);
target_trans.basis.set_column(i, our_col.normalized() * target_col.length());
}
} else if (update_remote_scale) {
for (int i = 0; i < 3; i++) {
Vector3 our_col = our_trans.basis.get_column(i);
Vector3 target_col = target_trans.basis.get_column(i);
target_trans.basis.set_column(i, target_col.normalized() * our_col.length());
}
}
if (update_remote_position) {
target_trans.origin = our_trans.origin;
}
if (use_global_coordinates) {
target_node->set_global_transform(target_trans);
} else {
target_node->set_transform(target_trans);
}
}
}
void RemoteTransform3D::_notification(int p_what) {
switch (p_what) {
case NOTIFICATION_ENTER_TREE: {
_update_cache();
} break;
case NOTIFICATION_RESET_PHYSICS_INTERPOLATION: {
if (cache.is_valid()) {
_update_remote();
Node3D *n = ObjectDB::get_instance<Node3D>(cache);
if (n) {
n->reset_physics_interpolation();
}
}
} break;
case NOTIFICATION_LOCAL_TRANSFORM_CHANGED:
case NOTIFICATION_TRANSFORM_CHANGED: {
if (!is_inside_tree()) {
break;
}
if (cache.is_valid()) {
_update_remote();
}
} break;
}
}
void RemoteTransform3D::set_remote_node(const NodePath &p_remote_node) {
if (remote_node == p_remote_node) {
return;
}
remote_node = p_remote_node;
if (is_inside_tree()) {
_update_cache();
_update_remote();
}
update_configuration_warnings();
}
NodePath RemoteTransform3D::get_remote_node() const {
return remote_node;
}
void RemoteTransform3D::set_use_global_coordinates(const bool p_enable) {
if (use_global_coordinates == p_enable) {
return;
}
use_global_coordinates = p_enable;
set_notify_transform(use_global_coordinates);
set_notify_local_transform(!use_global_coordinates);
_update_remote();
}
bool RemoteTransform3D::get_use_global_coordinates() const {
return use_global_coordinates;
}
void RemoteTransform3D::set_update_position(const bool p_update) {
if (update_remote_position == p_update) {
return;
}
update_remote_position = p_update;
_update_remote();
}
bool RemoteTransform3D::get_update_position() const {
return update_remote_position;
}
void RemoteTransform3D::set_update_rotation(const bool p_update) {
if (update_remote_rotation == p_update) {
return;
}
update_remote_rotation = p_update;
_update_remote();
}
bool RemoteTransform3D::get_update_rotation() const {
return update_remote_rotation;
}
void RemoteTransform3D::set_update_scale(const bool p_update) {
if (update_remote_scale == p_update) {
return;
}
update_remote_scale = p_update;
_update_remote();
}
bool RemoteTransform3D::get_update_scale() const {
return update_remote_scale;
}
void RemoteTransform3D::force_update_cache() {
_update_cache();
}
PackedStringArray RemoteTransform3D::get_configuration_warnings() const {
PackedStringArray warnings = Node3D::get_configuration_warnings();
if (!has_node(remote_node) || !Object::cast_to<Node3D>(get_node(remote_node))) {
warnings.push_back(RTR("The \"Remote Path\" property must point to a valid Node3D or Node3D-derived node to work."));
}
return warnings;
}
void RemoteTransform3D::_bind_methods() {
ClassDB::bind_method(D_METHOD("set_remote_node", "path"), &RemoteTransform3D::set_remote_node);
ClassDB::bind_method(D_METHOD("get_remote_node"), &RemoteTransform3D::get_remote_node);
ClassDB::bind_method(D_METHOD("force_update_cache"), &RemoteTransform3D::force_update_cache);
ClassDB::bind_method(D_METHOD("set_use_global_coordinates", "use_global_coordinates"), &RemoteTransform3D::set_use_global_coordinates);
ClassDB::bind_method(D_METHOD("get_use_global_coordinates"), &RemoteTransform3D::get_use_global_coordinates);
ClassDB::bind_method(D_METHOD("set_update_position", "update_remote_position"), &RemoteTransform3D::set_update_position);
ClassDB::bind_method(D_METHOD("get_update_position"), &RemoteTransform3D::get_update_position);
ClassDB::bind_method(D_METHOD("set_update_rotation", "update_remote_rotation"), &RemoteTransform3D::set_update_rotation);
ClassDB::bind_method(D_METHOD("get_update_rotation"), &RemoteTransform3D::get_update_rotation);
ClassDB::bind_method(D_METHOD("set_update_scale", "update_remote_scale"), &RemoteTransform3D::set_update_scale);
ClassDB::bind_method(D_METHOD("get_update_scale"), &RemoteTransform3D::get_update_scale);
ADD_PROPERTY(PropertyInfo(Variant::NODE_PATH, "remote_path", PROPERTY_HINT_NODE_PATH_VALID_TYPES, "Node3D"), "set_remote_node", "get_remote_node");
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "use_global_coordinates"), "set_use_global_coordinates", "get_use_global_coordinates");
ADD_GROUP("Update", "update_");
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "update_position"), "set_update_position", "get_update_position");
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "update_rotation"), "set_update_rotation", "get_update_rotation");
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "update_scale"), "set_update_scale", "get_update_scale");
}
RemoteTransform3D::RemoteTransform3D() {
set_notify_transform(use_global_coordinates);
set_notify_local_transform(!use_global_coordinates);
}