mirror of
				https://github.com/godotengine/godot.git
				synced 2025-10-31 05:31:01 +00:00 
			
		
		
		
	 b5334d14f7
			
		
	
	
		b5334d14f7
		
			
		
	
	
	
	
		
			
			Happy new year to the wonderful Godot community!
2020 has been a tough year for most of us personally, but a good year for
Godot development nonetheless with a huge amount of work done towards Godot
4.0 and great improvements backported to the long-lived 3.2 branch.
We've had close to 400 contributors to engine code this year, authoring near
7,000 commit! (And that's only for the `master` branch and for the engine code,
there's a lot more when counting docs, demos and other first-party repos.)
Here's to a great year 2021 for all Godot users 🎆
		
	
			
		
			
				
	
	
		
			254 lines
		
	
	
	
		
			7.5 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			254 lines
		
	
	
	
		
			7.5 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| /*************************************************************************/
 | |
| /*  java_class_wrapper.h                                                 */
 | |
| /*************************************************************************/
 | |
| /*                       This file is part of:                           */
 | |
| /*                           GODOT ENGINE                                */
 | |
| /*                      https://godotengine.org                          */
 | |
| /*************************************************************************/
 | |
| /* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur.                 */
 | |
| /* Copyright (c) 2014-2021 Godot Engine contributors (cf. AUTHORS.md).   */
 | |
| /*                                                                       */
 | |
| /* 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.                */
 | |
| /*************************************************************************/
 | |
| 
 | |
| #ifndef JAVA_CLASS_WRAPPER_H
 | |
| #define JAVA_CLASS_WRAPPER_H
 | |
| 
 | |
| #include "core/object/reference.h"
 | |
| 
 | |
| #ifdef ANDROID_ENABLED
 | |
| #include <android/log.h>
 | |
| #include <jni.h>
 | |
| #endif
 | |
| 
 | |
| #ifdef ANDROID_ENABLED
 | |
| class JavaObject;
 | |
| #endif
 | |
| 
 | |
| class JavaClass : public Reference {
 | |
| 	GDCLASS(JavaClass, Reference);
 | |
| 
 | |
| #ifdef ANDROID_ENABLED
 | |
| 	enum ArgumentType{
 | |
| 		ARG_TYPE_VOID,
 | |
| 		ARG_TYPE_BOOLEAN,
 | |
| 		ARG_TYPE_BYTE,
 | |
| 		ARG_TYPE_CHAR,
 | |
| 		ARG_TYPE_SHORT,
 | |
| 		ARG_TYPE_INT,
 | |
| 		ARG_TYPE_LONG,
 | |
| 		ARG_TYPE_FLOAT,
 | |
| 		ARG_TYPE_DOUBLE,
 | |
| 		ARG_TYPE_STRING, //special case
 | |
| 		ARG_TYPE_CLASS,
 | |
| 		ARG_ARRAY_BIT = 1 << 16,
 | |
| 		ARG_NUMBER_CLASS_BIT = 1 << 17,
 | |
| 		ARG_TYPE_MASK = (1 << 16) - 1
 | |
| 	};
 | |
| 
 | |
| 	Map<StringName, Variant> constant_map;
 | |
| 
 | |
| 	struct MethodInfo {
 | |
| 		bool _static = false;
 | |
| 		Vector<uint32_t> param_types;
 | |
| 		Vector<StringName> param_sigs;
 | |
| 		uint32_t return_type = 0;
 | |
| 		jmethodID method;
 | |
| 	};
 | |
| 
 | |
| 	_FORCE_INLINE_ static void _convert_to_variant_type(int p_sig, Variant::Type &r_type, float &likelihood) {
 | |
| 		likelihood = 1.0;
 | |
| 		r_type = Variant::NIL;
 | |
| 
 | |
| 		switch (p_sig) {
 | |
| 			case ARG_TYPE_VOID:
 | |
| 				r_type = Variant::NIL;
 | |
| 				break;
 | |
| 			case ARG_TYPE_BOOLEAN | ARG_NUMBER_CLASS_BIT:
 | |
| 			case ARG_TYPE_BOOLEAN:
 | |
| 				r_type = Variant::BOOL;
 | |
| 				break;
 | |
| 			case ARG_TYPE_BYTE | ARG_NUMBER_CLASS_BIT:
 | |
| 			case ARG_TYPE_BYTE:
 | |
| 				r_type = Variant::INT;
 | |
| 				likelihood = 0.1;
 | |
| 				break;
 | |
| 			case ARG_TYPE_CHAR | ARG_NUMBER_CLASS_BIT:
 | |
| 			case ARG_TYPE_CHAR:
 | |
| 				r_type = Variant::INT;
 | |
| 				likelihood = 0.2;
 | |
| 				break;
 | |
| 			case ARG_TYPE_SHORT | ARG_NUMBER_CLASS_BIT:
 | |
| 			case ARG_TYPE_SHORT:
 | |
| 				r_type = Variant::INT;
 | |
| 				likelihood = 0.3;
 | |
| 				break;
 | |
| 			case ARG_TYPE_INT | ARG_NUMBER_CLASS_BIT:
 | |
| 			case ARG_TYPE_INT:
 | |
| 				r_type = Variant::INT;
 | |
| 				likelihood = 1.0;
 | |
| 				break;
 | |
| 			case ARG_TYPE_LONG | ARG_NUMBER_CLASS_BIT:
 | |
| 			case ARG_TYPE_LONG:
 | |
| 				r_type = Variant::INT;
 | |
| 				likelihood = 0.5;
 | |
| 				break;
 | |
| 			case ARG_TYPE_FLOAT | ARG_NUMBER_CLASS_BIT:
 | |
| 			case ARG_TYPE_FLOAT:
 | |
| 				r_type = Variant::FLOAT;
 | |
| 				likelihood = 1.0;
 | |
| 				break;
 | |
| 			case ARG_TYPE_DOUBLE | ARG_NUMBER_CLASS_BIT:
 | |
| 			case ARG_TYPE_DOUBLE:
 | |
| 				r_type = Variant::FLOAT;
 | |
| 				likelihood = 0.5;
 | |
| 				break;
 | |
| 			case ARG_TYPE_STRING:
 | |
| 				r_type = Variant::STRING;
 | |
| 				break;
 | |
| 			case ARG_TYPE_CLASS:
 | |
| 				r_type = Variant::OBJECT;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_VOID:
 | |
| 				r_type = Variant::NIL;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_BOOLEAN:
 | |
| 				r_type = Variant::ARRAY;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_BYTE:
 | |
| 				r_type = Variant::PACKED_BYTE_ARRAY;
 | |
| 				likelihood = 1.0;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_CHAR:
 | |
| 				r_type = Variant::PACKED_BYTE_ARRAY;
 | |
| 				likelihood = 0.5;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_SHORT:
 | |
| 				r_type = Variant::PACKED_INT32_ARRAY;
 | |
| 				likelihood = 0.3;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_INT:
 | |
| 				r_type = Variant::PACKED_INT32_ARRAY;
 | |
| 				likelihood = 1.0;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_LONG:
 | |
| 				r_type = Variant::PACKED_INT32_ARRAY;
 | |
| 				likelihood = 0.5;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_FLOAT:
 | |
| 				r_type = Variant::PACKED_FLOAT32_ARRAY;
 | |
| 				likelihood = 1.0;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_DOUBLE:
 | |
| 				r_type = Variant::PACKED_FLOAT32_ARRAY;
 | |
| 				likelihood = 0.5;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_STRING:
 | |
| 				r_type = Variant::PACKED_STRING_ARRAY;
 | |
| 				break;
 | |
| 			case ARG_ARRAY_BIT | ARG_TYPE_CLASS:
 | |
| 				r_type = Variant::ARRAY;
 | |
| 				break;
 | |
| 		}
 | |
| 	}
 | |
| 
 | |
| 	_FORCE_INLINE_ static bool _convert_object_to_variant(JNIEnv *env, jobject obj, Variant &var, uint32_t p_sig);
 | |
| 
 | |
| 	bool _call_method(JavaObject *p_instance, const StringName &p_method, const Variant **p_args, int p_argcount, Callable::CallError &r_error, Variant &ret);
 | |
| 
 | |
| 	friend class JavaClassWrapper;
 | |
| 	Map<StringName, List<MethodInfo>> methods;
 | |
| 	jclass _class;
 | |
| #endif
 | |
| 
 | |
| public:
 | |
| 	virtual Variant call(const StringName &p_method, const Variant **p_args, int p_argcount, Callable::CallError &r_error) override;
 | |
| 
 | |
| 	JavaClass();
 | |
| };
 | |
| 
 | |
| class JavaObject : public Reference {
 | |
| 	GDCLASS(JavaObject, Reference);
 | |
| 
 | |
| #ifdef ANDROID_ENABLED
 | |
| 	Ref<JavaClass> base_class;
 | |
| 	friend class JavaClass;
 | |
| 
 | |
| 	jobject instance;
 | |
| #endif
 | |
| 
 | |
| public:
 | |
| 	virtual Variant call(const StringName &p_method, const Variant **p_args, int p_argcount, Callable::CallError &r_error) override;
 | |
| 
 | |
| #ifdef ANDROID_ENABLED
 | |
| 	JavaObject(const Ref<JavaClass> &p_base, jobject *p_instance);
 | |
| 	~JavaObject();
 | |
| #endif
 | |
| };
 | |
| 
 | |
| class JavaClassWrapper : public Object {
 | |
| 	GDCLASS(JavaClassWrapper, Object);
 | |
| 
 | |
| #ifdef ANDROID_ENABLED
 | |
| 	Map<String, Ref<JavaClass>> class_cache;
 | |
| 	friend class JavaClass;
 | |
| 	jclass activityClass;
 | |
| 	jmethodID findClass;
 | |
| 	jmethodID getDeclaredMethods;
 | |
| 	jmethodID getFields;
 | |
| 	jmethodID getParameterTypes;
 | |
| 	jmethodID getReturnType;
 | |
| 	jmethodID getModifiers;
 | |
| 	jmethodID getName;
 | |
| 	jmethodID Class_getName;
 | |
| 	jmethodID Field_getName;
 | |
| 	jmethodID Field_getModifiers;
 | |
| 	jmethodID Field_get;
 | |
| 	jmethodID Boolean_booleanValue;
 | |
| 	jmethodID Byte_byteValue;
 | |
| 	jmethodID Character_characterValue;
 | |
| 	jmethodID Short_shortValue;
 | |
| 	jmethodID Integer_integerValue;
 | |
| 	jmethodID Long_longValue;
 | |
| 	jmethodID Float_floatValue;
 | |
| 	jmethodID Double_doubleValue;
 | |
| 	jobject classLoader;
 | |
| 
 | |
| 	bool _get_type_sig(JNIEnv *env, jobject obj, uint32_t &sig, String &strsig);
 | |
| #endif
 | |
| 
 | |
| 	static JavaClassWrapper *singleton;
 | |
| 
 | |
| protected:
 | |
| 	static void _bind_methods();
 | |
| 
 | |
| public:
 | |
| 	static JavaClassWrapper *get_singleton() { return singleton; }
 | |
| 
 | |
| 	Ref<JavaClass> wrap(const String &p_class);
 | |
| 
 | |
| #ifdef ANDROID_ENABLED
 | |
| 	JavaClassWrapper(jobject p_activity = nullptr);
 | |
| #else
 | |
| 	JavaClassWrapper();
 | |
| #endif
 | |
| };
 | |
| 
 | |
| #endif // JAVA_CLASS_WRAPPER_H
 |