2017-03-05 14:47:28 +00:00
|
|
|
/*************************************************************************/
|
2017-11-16 17:38:18 +00:00
|
|
|
/* gdscript_function.h */
|
2017-03-05 14:47:28 +00:00
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
2017-08-27 12:16:55 +00:00
|
|
|
/* https://godotengine.org */
|
2017-03-05 14:47:28 +00:00
|
|
|
/*************************************************************************/
|
2021-01-01 19:13:46 +00:00
|
|
|
/* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2021 Godot Engine contributors (cf. AUTHORS.md). */
|
2017-03-05 14:47:28 +00: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-04 23:50:27 +00:00
|
|
|
|
2017-11-16 17:38:18 +00:00
|
|
|
#ifndef GDSCRIPT_FUNCTION_H
|
|
|
|
#define GDSCRIPT_FUNCTION_H
|
2016-06-01 01:28:27 +00:00
|
|
|
|
2020-11-07 22:33:38 +00:00
|
|
|
#include "core/object/reference.h"
|
|
|
|
#include "core/object/script_language.h"
|
2018-09-11 16:13:45 +00:00
|
|
|
#include "core/os/thread.h"
|
2020-11-07 22:33:38 +00:00
|
|
|
#include "core/string/string_name.h"
|
|
|
|
#include "core/templates/pair.h"
|
|
|
|
#include "core/templates/self_list.h"
|
|
|
|
#include "core/variant/variant.h"
|
2020-11-26 14:56:32 +00:00
|
|
|
#include "gdscript_utility_functions.h"
|
2016-06-01 01:28:27 +00:00
|
|
|
|
2017-11-16 17:38:18 +00:00
|
|
|
class GDScriptInstance;
|
2016-06-01 01:28:27 +00:00
|
|
|
class GDScript;
|
|
|
|
|
2021-03-09 15:32:35 +00:00
|
|
|
class GDScriptDataType {
|
|
|
|
private:
|
|
|
|
GDScriptDataType *container_element_type = nullptr;
|
|
|
|
|
|
|
|
public:
|
2020-05-12 15:01:17 +00:00
|
|
|
enum Kind {
|
2019-01-30 01:12:41 +00:00
|
|
|
UNINITIALIZED,
|
2018-05-30 02:16:54 +00:00
|
|
|
BUILTIN,
|
|
|
|
NATIVE,
|
|
|
|
SCRIPT,
|
2019-01-30 01:12:41 +00:00
|
|
|
GDSCRIPT,
|
2020-05-12 15:01:17 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
Kind kind = UNINITIALIZED;
|
|
|
|
|
|
|
|
bool has_type = false;
|
|
|
|
Variant::Type builtin_type = Variant::NIL;
|
2018-05-30 02:16:54 +00:00
|
|
|
StringName native_type;
|
2020-09-09 23:26:07 +00:00
|
|
|
Script *script_type = nullptr;
|
|
|
|
Ref<Script> script_type_ref;
|
2018-05-30 02:16:54 +00:00
|
|
|
|
2019-03-04 11:25:59 +00:00
|
|
|
bool is_type(const Variant &p_variant, bool p_allow_implicit_conversion = false) const {
|
2020-05-14 14:41:43 +00:00
|
|
|
if (!has_type) {
|
2020-05-10 10:56:01 +00:00
|
|
|
return true; // Can't type check
|
2020-05-14 14:41:43 +00:00
|
|
|
}
|
2018-05-30 02:16:56 +00:00
|
|
|
|
|
|
|
switch (kind) {
|
2019-01-30 01:12:41 +00:00
|
|
|
case UNINITIALIZED:
|
|
|
|
break;
|
2018-05-30 02:16:56 +00:00
|
|
|
case BUILTIN: {
|
|
|
|
Variant::Type var_type = p_variant.get_type();
|
2019-03-04 11:25:59 +00:00
|
|
|
bool valid = builtin_type == var_type;
|
2021-03-09 15:32:35 +00:00
|
|
|
if (valid && builtin_type == Variant::ARRAY && has_container_element_type()) {
|
|
|
|
Array array = p_variant;
|
|
|
|
if (array.is_typed()) {
|
|
|
|
Variant::Type array_builtin_type = (Variant::Type)array.get_typed_builtin();
|
|
|
|
StringName array_native_type = array.get_typed_class_name();
|
|
|
|
Ref<Script> array_script_type_ref = array.get_typed_script();
|
|
|
|
|
|
|
|
if (array_script_type_ref.is_valid()) {
|
|
|
|
valid = (container_element_type->kind == SCRIPT || container_element_type->kind == GDSCRIPT) && container_element_type->script_type == array_script_type_ref.ptr();
|
|
|
|
} else if (array_native_type != StringName()) {
|
|
|
|
valid = container_element_type->kind == NATIVE && container_element_type->native_type == array_native_type;
|
|
|
|
} else {
|
|
|
|
valid = container_element_type->kind == BUILTIN && container_element_type->builtin_type == array_builtin_type;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
valid = false;
|
|
|
|
}
|
|
|
|
} else if (!valid && p_allow_implicit_conversion) {
|
2019-03-04 11:25:59 +00:00
|
|
|
valid = Variant::can_convert_strict(var_type, builtin_type);
|
|
|
|
}
|
|
|
|
return valid;
|
2018-05-30 02:16:56 +00:00
|
|
|
} break;
|
|
|
|
case NATIVE: {
|
|
|
|
if (p_variant.get_type() == Variant::NIL) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
if (p_variant.get_type() != Variant::OBJECT) {
|
|
|
|
return false;
|
|
|
|
}
|
2020-01-16 13:53:34 +00:00
|
|
|
|
2020-02-13 19:03:10 +00:00
|
|
|
Object *obj = p_variant.get_validated_object();
|
|
|
|
if (!obj) {
|
2020-01-16 13:53:34 +00:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!ClassDB::is_parent_class(obj->get_class_name(), native_type)) {
|
|
|
|
// Try with underscore prefix
|
|
|
|
StringName underscore_native_type = "_" + native_type;
|
|
|
|
if (!ClassDB::is_parent_class(obj->get_class_name(), underscore_native_type)) {
|
|
|
|
return false;
|
2019-01-15 21:50:48 +00:00
|
|
|
}
|
2018-05-30 02:16:56 +00:00
|
|
|
}
|
|
|
|
return true;
|
|
|
|
} break;
|
|
|
|
case SCRIPT:
|
|
|
|
case GDSCRIPT: {
|
|
|
|
if (p_variant.get_type() == Variant::NIL) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
if (p_variant.get_type() != Variant::OBJECT) {
|
|
|
|
return false;
|
|
|
|
}
|
2020-01-16 13:53:34 +00:00
|
|
|
|
2020-02-13 19:03:10 +00:00
|
|
|
Object *obj = p_variant.get_validated_object();
|
|
|
|
if (!obj) {
|
2020-01-16 13:53:34 +00:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2020-04-01 23:20:12 +00:00
|
|
|
Ref<Script> base = obj && obj->get_script_instance() ? obj->get_script_instance()->get_script() : nullptr;
|
2018-05-30 02:16:56 +00:00
|
|
|
bool valid = false;
|
|
|
|
while (base.is_valid()) {
|
|
|
|
if (base == script_type) {
|
|
|
|
valid = true;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
base = base->get_base_script();
|
|
|
|
}
|
|
|
|
return valid;
|
|
|
|
} break;
|
|
|
|
}
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
operator PropertyInfo() const {
|
|
|
|
PropertyInfo info;
|
|
|
|
if (has_type) {
|
|
|
|
switch (kind) {
|
2019-01-30 01:12:41 +00:00
|
|
|
case UNINITIALIZED:
|
|
|
|
break;
|
2018-05-30 02:16:56 +00:00
|
|
|
case BUILTIN: {
|
|
|
|
info.type = builtin_type;
|
|
|
|
} break;
|
|
|
|
case NATIVE: {
|
|
|
|
info.type = Variant::OBJECT;
|
|
|
|
info.class_name = native_type;
|
|
|
|
} break;
|
|
|
|
case SCRIPT:
|
|
|
|
case GDSCRIPT: {
|
|
|
|
info.type = Variant::OBJECT;
|
|
|
|
info.class_name = script_type->get_instance_base_type();
|
|
|
|
} break;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
info.type = Variant::NIL;
|
|
|
|
info.usage |= PROPERTY_USAGE_NIL_IS_VARIANT;
|
|
|
|
}
|
|
|
|
return info;
|
|
|
|
}
|
|
|
|
|
2021-03-09 15:32:35 +00:00
|
|
|
void set_container_element_type(const GDScriptDataType &p_element_type) {
|
|
|
|
container_element_type = memnew(GDScriptDataType(p_element_type));
|
|
|
|
}
|
|
|
|
|
|
|
|
GDScriptDataType get_container_element_type() const {
|
|
|
|
ERR_FAIL_COND_V(container_element_type == nullptr, GDScriptDataType());
|
|
|
|
return *container_element_type;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool has_container_element_type() const {
|
|
|
|
return container_element_type != nullptr;
|
|
|
|
}
|
|
|
|
|
|
|
|
void unset_container_element_type() {
|
|
|
|
if (container_element_type) {
|
|
|
|
memdelete(container_element_type);
|
|
|
|
}
|
|
|
|
container_element_type = nullptr;
|
|
|
|
}
|
|
|
|
|
|
|
|
GDScriptDataType() = default;
|
|
|
|
|
|
|
|
GDScriptDataType &operator=(const GDScriptDataType &p_other) {
|
|
|
|
kind = p_other.kind;
|
|
|
|
has_type = p_other.has_type;
|
|
|
|
builtin_type = p_other.builtin_type;
|
|
|
|
native_type = p_other.native_type;
|
|
|
|
script_type = p_other.script_type;
|
|
|
|
script_type_ref = p_other.script_type_ref;
|
|
|
|
unset_container_element_type();
|
|
|
|
if (p_other.has_container_element_type()) {
|
|
|
|
set_container_element_type(p_other.get_container_element_type());
|
|
|
|
}
|
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
|
|
|
|
GDScriptDataType(const GDScriptDataType &p_other) {
|
|
|
|
*this = p_other;
|
|
|
|
}
|
|
|
|
|
|
|
|
~GDScriptDataType() {
|
|
|
|
unset_container_element_type();
|
|
|
|
}
|
2018-05-30 02:16:54 +00:00
|
|
|
};
|
|
|
|
|
2017-11-16 17:38:18 +00:00
|
|
|
class GDScriptFunction {
|
2016-06-01 01:28:27 +00:00
|
|
|
public:
|
|
|
|
enum Opcode {
|
|
|
|
OPCODE_OPERATOR,
|
2020-11-13 19:47:45 +00:00
|
|
|
OPCODE_OPERATOR_VALIDATED,
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_EXTENDS_TEST,
|
2018-08-26 16:31:23 +00:00
|
|
|
OPCODE_IS_BUILTIN,
|
2020-11-16 15:59:53 +00:00
|
|
|
OPCODE_SET_KEYED,
|
|
|
|
OPCODE_SET_KEYED_VALIDATED,
|
|
|
|
OPCODE_SET_INDEXED_VALIDATED,
|
|
|
|
OPCODE_GET_KEYED,
|
|
|
|
OPCODE_GET_KEYED_VALIDATED,
|
|
|
|
OPCODE_GET_INDEXED_VALIDATED,
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_SET_NAMED,
|
2020-11-16 15:59:53 +00:00
|
|
|
OPCODE_SET_NAMED_VALIDATED,
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_GET_NAMED,
|
2020-11-16 15:59:53 +00:00
|
|
|
OPCODE_GET_NAMED_VALIDATED,
|
2017-01-04 20:37:45 +00:00
|
|
|
OPCODE_SET_MEMBER,
|
|
|
|
OPCODE_GET_MEMBER,
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_ASSIGN,
|
|
|
|
OPCODE_ASSIGN_TRUE,
|
|
|
|
OPCODE_ASSIGN_FALSE,
|
2018-05-30 02:16:56 +00:00
|
|
|
OPCODE_ASSIGN_TYPED_BUILTIN,
|
2021-03-09 15:32:35 +00:00
|
|
|
OPCODE_ASSIGN_TYPED_ARRAY,
|
2018-05-30 02:16:56 +00:00
|
|
|
OPCODE_ASSIGN_TYPED_NATIVE,
|
|
|
|
OPCODE_ASSIGN_TYPED_SCRIPT,
|
|
|
|
OPCODE_CAST_TO_BUILTIN,
|
|
|
|
OPCODE_CAST_TO_NATIVE,
|
|
|
|
OPCODE_CAST_TO_SCRIPT,
|
2020-11-18 14:37:08 +00:00
|
|
|
OPCODE_CONSTRUCT, // Only for basic types!
|
|
|
|
OPCODE_CONSTRUCT_VALIDATED, // Only for basic types!
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_CONSTRUCT_ARRAY,
|
2021-03-09 15:32:35 +00:00
|
|
|
OPCODE_CONSTRUCT_TYPED_ARRAY,
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_CONSTRUCT_DICTIONARY,
|
|
|
|
OPCODE_CALL,
|
|
|
|
OPCODE_CALL_RETURN,
|
2020-05-01 22:14:56 +00:00
|
|
|
OPCODE_CALL_ASYNC,
|
2020-11-26 14:56:32 +00:00
|
|
|
OPCODE_CALL_UTILITY,
|
|
|
|
OPCODE_CALL_UTILITY_VALIDATED,
|
|
|
|
OPCODE_CALL_GDSCRIPT_UTILITY,
|
2020-11-18 13:32:28 +00:00
|
|
|
OPCODE_CALL_BUILTIN_TYPE_VALIDATED,
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_CALL_SELF_BASE,
|
2020-11-17 13:44:52 +00:00
|
|
|
OPCODE_CALL_METHOD_BIND,
|
|
|
|
OPCODE_CALL_METHOD_BIND_RET,
|
|
|
|
// ptrcall have one instruction per return type.
|
|
|
|
OPCODE_CALL_PTRCALL_NO_RETURN,
|
|
|
|
OPCODE_CALL_PTRCALL_BOOL,
|
|
|
|
OPCODE_CALL_PTRCALL_INT,
|
|
|
|
OPCODE_CALL_PTRCALL_FLOAT,
|
|
|
|
OPCODE_CALL_PTRCALL_STRING,
|
|
|
|
OPCODE_CALL_PTRCALL_VECTOR2,
|
|
|
|
OPCODE_CALL_PTRCALL_VECTOR2I,
|
|
|
|
OPCODE_CALL_PTRCALL_RECT2,
|
|
|
|
OPCODE_CALL_PTRCALL_RECT2I,
|
|
|
|
OPCODE_CALL_PTRCALL_VECTOR3,
|
|
|
|
OPCODE_CALL_PTRCALL_VECTOR3I,
|
|
|
|
OPCODE_CALL_PTRCALL_TRANSFORM2D,
|
|
|
|
OPCODE_CALL_PTRCALL_PLANE,
|
|
|
|
OPCODE_CALL_PTRCALL_QUAT,
|
|
|
|
OPCODE_CALL_PTRCALL_AABB,
|
|
|
|
OPCODE_CALL_PTRCALL_BASIS,
|
|
|
|
OPCODE_CALL_PTRCALL_TRANSFORM,
|
|
|
|
OPCODE_CALL_PTRCALL_COLOR,
|
|
|
|
OPCODE_CALL_PTRCALL_STRING_NAME,
|
|
|
|
OPCODE_CALL_PTRCALL_NODE_PATH,
|
|
|
|
OPCODE_CALL_PTRCALL_RID,
|
|
|
|
OPCODE_CALL_PTRCALL_OBJECT,
|
|
|
|
OPCODE_CALL_PTRCALL_CALLABLE,
|
|
|
|
OPCODE_CALL_PTRCALL_SIGNAL,
|
|
|
|
OPCODE_CALL_PTRCALL_DICTIONARY,
|
|
|
|
OPCODE_CALL_PTRCALL_ARRAY,
|
|
|
|
OPCODE_CALL_PTRCALL_PACKED_BYTE_ARRAY,
|
|
|
|
OPCODE_CALL_PTRCALL_PACKED_INT32_ARRAY,
|
|
|
|
OPCODE_CALL_PTRCALL_PACKED_INT64_ARRAY,
|
|
|
|
OPCODE_CALL_PTRCALL_PACKED_FLOAT32_ARRAY,
|
|
|
|
OPCODE_CALL_PTRCALL_PACKED_FLOAT64_ARRAY,
|
|
|
|
OPCODE_CALL_PTRCALL_PACKED_STRING_ARRAY,
|
|
|
|
OPCODE_CALL_PTRCALL_PACKED_VECTOR2_ARRAY,
|
|
|
|
OPCODE_CALL_PTRCALL_PACKED_VECTOR3_ARRAY,
|
|
|
|
OPCODE_CALL_PTRCALL_PACKED_COLOR_ARRAY,
|
2020-05-01 22:14:56 +00:00
|
|
|
OPCODE_AWAIT,
|
|
|
|
OPCODE_AWAIT_RESUME,
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_JUMP,
|
|
|
|
OPCODE_JUMP_IF,
|
|
|
|
OPCODE_JUMP_IF_NOT,
|
|
|
|
OPCODE_JUMP_TO_DEF_ARGUMENT,
|
|
|
|
OPCODE_RETURN,
|
2021-04-02 13:34:44 +00:00
|
|
|
OPCODE_RETURN_TYPED_BUILTIN,
|
|
|
|
OPCODE_RETURN_TYPED_ARRAY,
|
|
|
|
OPCODE_RETURN_TYPED_NATIVE,
|
|
|
|
OPCODE_RETURN_TYPED_SCRIPT,
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_ITERATE_BEGIN,
|
2020-10-07 12:36:48 +00:00
|
|
|
OPCODE_ITERATE_BEGIN_INT,
|
|
|
|
OPCODE_ITERATE_BEGIN_FLOAT,
|
|
|
|
OPCODE_ITERATE_BEGIN_VECTOR2,
|
|
|
|
OPCODE_ITERATE_BEGIN_VECTOR2I,
|
|
|
|
OPCODE_ITERATE_BEGIN_VECTOR3,
|
|
|
|
OPCODE_ITERATE_BEGIN_VECTOR3I,
|
|
|
|
OPCODE_ITERATE_BEGIN_STRING,
|
|
|
|
OPCODE_ITERATE_BEGIN_DICTIONARY,
|
|
|
|
OPCODE_ITERATE_BEGIN_ARRAY,
|
|
|
|
OPCODE_ITERATE_BEGIN_PACKED_BYTE_ARRAY,
|
|
|
|
OPCODE_ITERATE_BEGIN_PACKED_INT32_ARRAY,
|
|
|
|
OPCODE_ITERATE_BEGIN_PACKED_INT64_ARRAY,
|
|
|
|
OPCODE_ITERATE_BEGIN_PACKED_FLOAT32_ARRAY,
|
|
|
|
OPCODE_ITERATE_BEGIN_PACKED_FLOAT64_ARRAY,
|
|
|
|
OPCODE_ITERATE_BEGIN_PACKED_STRING_ARRAY,
|
|
|
|
OPCODE_ITERATE_BEGIN_PACKED_VECTOR2_ARRAY,
|
|
|
|
OPCODE_ITERATE_BEGIN_PACKED_VECTOR3_ARRAY,
|
|
|
|
OPCODE_ITERATE_BEGIN_PACKED_COLOR_ARRAY,
|
|
|
|
OPCODE_ITERATE_BEGIN_OBJECT,
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_ITERATE,
|
2020-10-07 12:36:48 +00:00
|
|
|
OPCODE_ITERATE_INT,
|
|
|
|
OPCODE_ITERATE_FLOAT,
|
|
|
|
OPCODE_ITERATE_VECTOR2,
|
|
|
|
OPCODE_ITERATE_VECTOR2I,
|
|
|
|
OPCODE_ITERATE_VECTOR3,
|
|
|
|
OPCODE_ITERATE_VECTOR3I,
|
|
|
|
OPCODE_ITERATE_STRING,
|
|
|
|
OPCODE_ITERATE_DICTIONARY,
|
|
|
|
OPCODE_ITERATE_ARRAY,
|
|
|
|
OPCODE_ITERATE_PACKED_BYTE_ARRAY,
|
|
|
|
OPCODE_ITERATE_PACKED_INT32_ARRAY,
|
|
|
|
OPCODE_ITERATE_PACKED_INT64_ARRAY,
|
|
|
|
OPCODE_ITERATE_PACKED_FLOAT32_ARRAY,
|
|
|
|
OPCODE_ITERATE_PACKED_FLOAT64_ARRAY,
|
|
|
|
OPCODE_ITERATE_PACKED_STRING_ARRAY,
|
|
|
|
OPCODE_ITERATE_PACKED_VECTOR2_ARRAY,
|
|
|
|
OPCODE_ITERATE_PACKED_VECTOR3_ARRAY,
|
|
|
|
OPCODE_ITERATE_PACKED_COLOR_ARRAY,
|
|
|
|
OPCODE_ITERATE_OBJECT,
|
2021-04-08 14:55:24 +00:00
|
|
|
OPCODE_STORE_NAMED_GLOBAL,
|
2021-04-16 15:04:08 +00:00
|
|
|
OPCODE_TYPE_ADJUST_BOOL,
|
|
|
|
OPCODE_TYPE_ADJUST_INT,
|
|
|
|
OPCODE_TYPE_ADJUST_FLOAT,
|
|
|
|
OPCODE_TYPE_ADJUST_STRING,
|
|
|
|
OPCODE_TYPE_ADJUST_VECTOR2,
|
|
|
|
OPCODE_TYPE_ADJUST_VECTOR2I,
|
|
|
|
OPCODE_TYPE_ADJUST_RECT2,
|
|
|
|
OPCODE_TYPE_ADJUST_RECT2I,
|
|
|
|
OPCODE_TYPE_ADJUST_VECTOR3,
|
|
|
|
OPCODE_TYPE_ADJUST_VECTOR3I,
|
|
|
|
OPCODE_TYPE_ADJUST_TRANSFORM2D,
|
|
|
|
OPCODE_TYPE_ADJUST_PLANE,
|
|
|
|
OPCODE_TYPE_ADJUST_QUAT,
|
|
|
|
OPCODE_TYPE_ADJUST_AABB,
|
|
|
|
OPCODE_TYPE_ADJUST_BASIS,
|
|
|
|
OPCODE_TYPE_ADJUST_TRANSFORM,
|
|
|
|
OPCODE_TYPE_ADJUST_COLOR,
|
|
|
|
OPCODE_TYPE_ADJUST_STRING_NAME,
|
|
|
|
OPCODE_TYPE_ADJUST_NODE_PATH,
|
|
|
|
OPCODE_TYPE_ADJUST_RID,
|
|
|
|
OPCODE_TYPE_ADJUST_OBJECT,
|
|
|
|
OPCODE_TYPE_ADJUST_CALLABLE,
|
|
|
|
OPCODE_TYPE_ADJUST_SIGNAL,
|
|
|
|
OPCODE_TYPE_ADJUST_DICTIONARY,
|
|
|
|
OPCODE_TYPE_ADJUST_ARRAY,
|
|
|
|
OPCODE_TYPE_ADJUST_PACKED_BYTE_ARRAY,
|
|
|
|
OPCODE_TYPE_ADJUST_PACKED_INT32_ARRAY,
|
|
|
|
OPCODE_TYPE_ADJUST_PACKED_INT64_ARRAY,
|
|
|
|
OPCODE_TYPE_ADJUST_PACKED_FLOAT32_ARRAY,
|
|
|
|
OPCODE_TYPE_ADJUST_PACKED_FLOAT64_ARRAY,
|
|
|
|
OPCODE_TYPE_ADJUST_PACKED_STRING_ARRAY,
|
|
|
|
OPCODE_TYPE_ADJUST_PACKED_VECTOR2_ARRAY,
|
|
|
|
OPCODE_TYPE_ADJUST_PACKED_VECTOR3_ARRAY,
|
|
|
|
OPCODE_TYPE_ADJUST_PACKED_COLOR_ARRAY,
|
2016-06-01 01:28:27 +00:00
|
|
|
OPCODE_ASSERT,
|
|
|
|
OPCODE_BREAKPOINT,
|
|
|
|
OPCODE_LINE,
|
|
|
|
OPCODE_END
|
|
|
|
};
|
|
|
|
|
|
|
|
enum Address {
|
2017-03-05 15:44:50 +00:00
|
|
|
ADDR_BITS = 24,
|
|
|
|
ADDR_MASK = ((1 << ADDR_BITS) - 1),
|
|
|
|
ADDR_TYPE_MASK = ~ADDR_MASK,
|
2021-04-08 14:55:24 +00:00
|
|
|
ADDR_TYPE_STACK = 0,
|
|
|
|
ADDR_TYPE_CONSTANT = 1,
|
2017-03-05 15:44:50 +00:00
|
|
|
ADDR_TYPE_MEMBER = 2,
|
2021-04-08 14:55:24 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
enum FixedAddresses {
|
|
|
|
ADDR_STACK_SELF = 0,
|
|
|
|
ADDR_STACK_CLASS = 1,
|
|
|
|
ADDR_STACK_NIL = 2,
|
|
|
|
ADDR_SELF = ADDR_STACK_SELF | (ADDR_TYPE_STACK << ADDR_BITS),
|
|
|
|
ADDR_CLASS = ADDR_STACK_CLASS | (ADDR_TYPE_STACK << ADDR_BITS),
|
|
|
|
ADDR_NIL = ADDR_STACK_NIL | (ADDR_TYPE_STACK << ADDR_BITS),
|
2016-06-01 01:28:27 +00:00
|
|
|
};
|
|
|
|
|
2020-11-13 13:31:14 +00:00
|
|
|
enum Instruction {
|
|
|
|
INSTR_BITS = 20,
|
|
|
|
INSTR_MASK = ((1 << INSTR_BITS) - 1),
|
|
|
|
INSTR_ARGS_MASK = ~INSTR_MASK,
|
|
|
|
};
|
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
struct StackDebug {
|
|
|
|
int line;
|
|
|
|
int pos;
|
|
|
|
bool added;
|
|
|
|
StringName identifier;
|
|
|
|
};
|
2016-06-01 01:28:27 +00:00
|
|
|
|
|
|
|
private:
|
2017-11-16 17:38:18 +00:00
|
|
|
friend class GDScriptCompiler;
|
2020-07-28 18:17:49 +00:00
|
|
|
friend class GDScriptByteCodeGenerator;
|
2016-06-01 01:28:27 +00:00
|
|
|
|
|
|
|
StringName source;
|
|
|
|
|
|
|
|
mutable Variant nil;
|
2020-11-13 13:31:14 +00:00
|
|
|
mutable Variant *_constants_ptr = nullptr;
|
|
|
|
int _constant_count = 0;
|
|
|
|
const StringName *_global_names_ptr = nullptr;
|
|
|
|
int _global_names_count = 0;
|
|
|
|
const int *_default_arg_ptr = nullptr;
|
|
|
|
int _default_arg_count = 0;
|
2020-11-13 19:47:45 +00:00
|
|
|
int _operator_funcs_count = 0;
|
|
|
|
const Variant::ValidatedOperatorEvaluator *_operator_funcs_ptr = nullptr;
|
2020-11-16 15:59:53 +00:00
|
|
|
int _setters_count = 0;
|
|
|
|
const Variant::ValidatedSetter *_setters_ptr = nullptr;
|
|
|
|
int _getters_count = 0;
|
|
|
|
const Variant::ValidatedGetter *_getters_ptr = nullptr;
|
|
|
|
int _keyed_setters_count = 0;
|
|
|
|
const Variant::ValidatedKeyedSetter *_keyed_setters_ptr = nullptr;
|
|
|
|
int _keyed_getters_count = 0;
|
|
|
|
const Variant::ValidatedKeyedGetter *_keyed_getters_ptr = nullptr;
|
|
|
|
int _indexed_setters_count = 0;
|
|
|
|
const Variant::ValidatedIndexedSetter *_indexed_setters_ptr = nullptr;
|
|
|
|
int _indexed_getters_count = 0;
|
|
|
|
const Variant::ValidatedIndexedGetter *_indexed_getters_ptr = nullptr;
|
2020-11-18 13:32:28 +00:00
|
|
|
int _builtin_methods_count = 0;
|
|
|
|
const Variant::ValidatedBuiltInMethod *_builtin_methods_ptr = nullptr;
|
2020-11-18 14:37:08 +00:00
|
|
|
int _constructors_count = 0;
|
|
|
|
const Variant::ValidatedConstructor *_constructors_ptr = nullptr;
|
2020-11-26 14:56:32 +00:00
|
|
|
int _utilities_count = 0;
|
|
|
|
const Variant::ValidatedUtilityFunction *_utilities_ptr = nullptr;
|
|
|
|
int _gds_utilities_count = 0;
|
|
|
|
const GDScriptUtilityFunctions::FunctionPtr *_gds_utilities_ptr = nullptr;
|
2020-11-17 13:44:52 +00:00
|
|
|
int _methods_count = 0;
|
|
|
|
MethodBind **_methods_ptr = nullptr;
|
2020-11-13 13:31:14 +00:00
|
|
|
const int *_code_ptr = nullptr;
|
|
|
|
int _code_size = 0;
|
|
|
|
int _argument_count = 0;
|
|
|
|
int _stack_size = 0;
|
|
|
|
int _instruction_args_size = 0;
|
2020-11-17 13:44:52 +00:00
|
|
|
int _ptrcall_args_size = 0;
|
|
|
|
|
2020-11-13 13:31:14 +00:00
|
|
|
int _initial_line = 0;
|
|
|
|
bool _static = false;
|
|
|
|
MultiplayerAPI::RPCMode rpc_mode = MultiplayerAPI::RPC_MODE_DISABLED;
|
|
|
|
|
|
|
|
GDScript *_script = nullptr;
|
2016-06-01 01:28:27 +00:00
|
|
|
|
|
|
|
StringName name;
|
|
|
|
Vector<Variant> constants;
|
|
|
|
Vector<StringName> global_names;
|
|
|
|
Vector<int> default_arguments;
|
2020-11-13 19:47:45 +00:00
|
|
|
Vector<Variant::ValidatedOperatorEvaluator> operator_funcs;
|
2020-11-16 15:59:53 +00:00
|
|
|
Vector<Variant::ValidatedSetter> setters;
|
|
|
|
Vector<Variant::ValidatedGetter> getters;
|
|
|
|
Vector<Variant::ValidatedKeyedSetter> keyed_setters;
|
|
|
|
Vector<Variant::ValidatedKeyedGetter> keyed_getters;
|
|
|
|
Vector<Variant::ValidatedIndexedSetter> indexed_setters;
|
|
|
|
Vector<Variant::ValidatedIndexedGetter> indexed_getters;
|
2020-11-18 13:32:28 +00:00
|
|
|
Vector<Variant::ValidatedBuiltInMethod> builtin_methods;
|
2020-11-18 14:37:08 +00:00
|
|
|
Vector<Variant::ValidatedConstructor> constructors;
|
2020-11-26 14:56:32 +00:00
|
|
|
Vector<Variant::ValidatedUtilityFunction> utilities;
|
|
|
|
Vector<GDScriptUtilityFunctions::FunctionPtr> gds_utilities;
|
2020-11-17 13:44:52 +00:00
|
|
|
Vector<MethodBind *> methods;
|
2016-06-01 01:28:27 +00:00
|
|
|
Vector<int> code;
|
2018-05-30 02:16:54 +00:00
|
|
|
Vector<GDScriptDataType> argument_types;
|
|
|
|
GDScriptDataType return_type;
|
2016-06-01 01:28:27 +00:00
|
|
|
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
|
|
Vector<StringName> arg_names;
|
2020-11-29 02:37:57 +00:00
|
|
|
Vector<Variant> default_arg_values;
|
2016-06-01 01:28:27 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
List<StackDebug> stack_debug;
|
|
|
|
|
2021-04-08 14:55:24 +00:00
|
|
|
_FORCE_INLINE_ Variant *_get_variant(int p_address, GDScriptInstance *p_instance, Variant *p_stack, String &r_error) const;
|
2020-02-19 19:27:19 +00:00
|
|
|
_FORCE_INLINE_ String _get_call_error(const Callable::CallError &p_err, const String &p_where, const Variant **argptrs) const;
|
2016-06-01 01:28:27 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
friend class GDScriptLanguage;
|
2016-06-01 01:28:27 +00:00
|
|
|
|
2020-11-13 13:31:14 +00:00
|
|
|
SelfList<GDScriptFunction> function_list{ this };
|
2016-06-01 01:28:27 +00:00
|
|
|
#ifdef DEBUG_ENABLED
|
|
|
|
CharString func_cname;
|
2020-11-13 13:31:14 +00:00
|
|
|
const char *_func_cname = nullptr;
|
2016-06-01 01:28:27 +00:00
|
|
|
|
|
|
|
struct Profile {
|
|
|
|
StringName signature;
|
2020-11-13 13:31:14 +00:00
|
|
|
uint64_t call_count = 0;
|
|
|
|
uint64_t self_time = 0;
|
|
|
|
uint64_t total_time = 0;
|
|
|
|
uint64_t frame_call_count = 0;
|
|
|
|
uint64_t frame_self_time = 0;
|
|
|
|
uint64_t frame_total_time = 0;
|
|
|
|
uint64_t last_frame_call_count = 0;
|
|
|
|
uint64_t last_frame_self_time = 0;
|
|
|
|
uint64_t last_frame_total_time = 0;
|
2016-06-01 01:28:27 +00:00
|
|
|
} profile;
|
|
|
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
public:
|
|
|
|
struct CallState {
|
2021-02-08 09:57:18 +00:00
|
|
|
GDScript *script = nullptr;
|
|
|
|
GDScriptInstance *instance = nullptr;
|
2020-04-29 11:38:00 +00:00
|
|
|
#ifdef DEBUG_ENABLED
|
2020-05-05 10:53:05 +00:00
|
|
|
StringName function_name;
|
2020-04-29 11:38:00 +00:00
|
|
|
String script_path;
|
|
|
|
#endif
|
2016-06-01 01:28:27 +00:00
|
|
|
Vector<uint8_t> stack;
|
2021-02-08 09:57:18 +00:00
|
|
|
int stack_size = 0;
|
|
|
|
uint32_t alloca_size = 0;
|
|
|
|
int ip = 0;
|
|
|
|
int line = 0;
|
|
|
|
int defarg = 0;
|
2016-06-01 01:28:27 +00:00
|
|
|
Variant result;
|
|
|
|
};
|
|
|
|
|
|
|
|
_FORCE_INLINE_ bool is_static() const { return _static; }
|
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
const int *get_code() const; //used for debug
|
2016-06-01 01:28:27 +00:00
|
|
|
int get_code_size() const;
|
|
|
|
Variant get_constant(int p_idx) const;
|
|
|
|
StringName get_global_name(int p_idx) const;
|
|
|
|
StringName get_name() const;
|
|
|
|
int get_max_stack_size() const;
|
|
|
|
int get_default_argument_count() const;
|
|
|
|
int get_default_argument_addr(int p_idx) const;
|
2018-05-30 02:16:54 +00:00
|
|
|
GDScriptDataType get_return_type() const;
|
|
|
|
GDScriptDataType get_argument_type(int p_idx) const;
|
2018-11-24 22:46:13 +00:00
|
|
|
GDScript *get_script() const { return _script; }
|
2016-06-28 14:49:18 +00:00
|
|
|
StringName get_source() const { return source; }
|
2016-06-01 01:28:27 +00:00
|
|
|
|
2020-03-17 06:33:00 +00:00
|
|
|
void debug_get_stack_member_state(int p_line, List<Pair<StringName, int>> *r_stackvars) const;
|
2016-06-01 01:28:27 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
_FORCE_INLINE_ bool is_empty() const { return _code_size == 0; }
|
2016-06-01 01:28:27 +00:00
|
|
|
|
|
|
|
int get_argument_count() const { return _argument_count; }
|
|
|
|
StringName get_argument_name(int p_idx) const {
|
|
|
|
#ifdef TOOLS_ENABLED
|
2017-03-05 15:44:50 +00:00
|
|
|
ERR_FAIL_INDEX_V(p_idx, arg_names.size(), StringName());
|
2016-06-01 01:28:27 +00:00
|
|
|
return arg_names[p_idx];
|
2017-08-22 17:01:57 +00:00
|
|
|
#else
|
2016-06-01 01:28:27 +00:00
|
|
|
return StringName();
|
2017-08-22 17:01:57 +00:00
|
|
|
#endif
|
2016-06-01 01:28:27 +00:00
|
|
|
}
|
|
|
|
Variant get_default_argument(int p_idx) const {
|
2017-03-05 15:44:50 +00:00
|
|
|
ERR_FAIL_INDEX_V(p_idx, default_arguments.size(), Variant());
|
2016-06-01 01:28:27 +00:00
|
|
|
return default_arguments[p_idx];
|
|
|
|
}
|
2020-11-29 02:37:57 +00:00
|
|
|
#ifdef TOOLS_ENABLED
|
|
|
|
const Vector<Variant> &get_default_arg_values() const {
|
|
|
|
return default_arg_values;
|
|
|
|
}
|
|
|
|
#endif // TOOLS_ENABLED
|
2016-06-01 01:28:27 +00:00
|
|
|
|
2020-04-01 23:20:12 +00:00
|
|
|
Variant call(GDScriptInstance *p_instance, const Variant **p_args, int p_argcount, Callable::CallError &r_err, CallState *p_state = nullptr);
|
2016-06-01 01:28:27 +00:00
|
|
|
|
2020-08-17 13:00:42 +00:00
|
|
|
#ifdef DEBUG_ENABLED
|
|
|
|
void disassemble(const Vector<String> &p_code_lines) const;
|
|
|
|
#endif
|
|
|
|
|
2018-05-13 05:07:56 +00:00
|
|
|
_FORCE_INLINE_ MultiplayerAPI::RPCMode get_rpc_mode() const { return rpc_mode; }
|
2017-11-16 17:38:18 +00:00
|
|
|
GDScriptFunction();
|
|
|
|
~GDScriptFunction();
|
2016-06-01 01:28:27 +00:00
|
|
|
};
|
|
|
|
|
2017-11-16 17:38:18 +00:00
|
|
|
class GDScriptFunctionState : public Reference {
|
|
|
|
GDCLASS(GDScriptFunctionState, Reference);
|
|
|
|
friend class GDScriptFunction;
|
2021-02-08 09:57:18 +00:00
|
|
|
GDScriptFunction *function = nullptr;
|
2017-11-16 17:38:18 +00:00
|
|
|
GDScriptFunction::CallState state;
|
2020-02-19 19:27:19 +00:00
|
|
|
Variant _signal_callback(const Variant **p_args, int p_argcount, Callable::CallError &r_error);
|
2018-06-28 15:40:11 +00:00
|
|
|
Ref<GDScriptFunctionState> first_state;
|
2017-03-05 15:44:50 +00:00
|
|
|
|
2020-05-05 10:53:05 +00:00
|
|
|
SelfList<GDScriptFunctionState> scripts_list;
|
|
|
|
SelfList<GDScriptFunctionState> instances_list;
|
|
|
|
|
2016-06-01 01:28:27 +00:00
|
|
|
protected:
|
|
|
|
static void _bind_methods();
|
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
public:
|
2017-05-17 12:47:17 +00:00
|
|
|
bool is_valid(bool p_extended_check = false) const;
|
2017-03-05 15:44:50 +00:00
|
|
|
Variant resume(const Variant &p_arg = Variant());
|
2020-05-05 10:53:05 +00:00
|
|
|
|
|
|
|
void _clear_stack();
|
|
|
|
|
2017-11-16 17:38:18 +00:00
|
|
|
GDScriptFunctionState();
|
|
|
|
~GDScriptFunctionState();
|
2016-06-01 01:28:27 +00:00
|
|
|
};
|
|
|
|
|
2017-11-16 17:38:18 +00:00
|
|
|
#endif // GDSCRIPT_FUNCTION_H
|