2023-01-10 15:26:54 +01:00
|
|
|
/**************************************************************************/
|
|
|
|
/* marshalls.h */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* 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. */
|
|
|
|
/**************************************************************************/
|
2018-01-05 00:50:27 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
#ifndef MARSHALLS_H
|
|
|
|
#define MARSHALLS_H
|
|
|
|
|
2018-09-11 18:13:45 +02:00
|
|
|
#include "core/reference.h"
|
|
|
|
#include "core/typedefs.h"
|
|
|
|
#include "core/variant.h"
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
/**
|
2021-10-28 14:15:02 +02:00
|
|
|
* Miscellaneous helpers for marshalling data types, and encoding
|
|
|
|
* in an endian independent way
|
|
|
|
*/
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
union MarshallFloat {
|
|
|
|
uint32_t i; ///< int
|
|
|
|
float f; ///< float
|
|
|
|
};
|
|
|
|
|
|
|
|
union MarshallDouble {
|
|
|
|
uint64_t l; ///< long long
|
|
|
|
double d; ///< double
|
|
|
|
};
|
|
|
|
|
|
|
|
static inline unsigned int encode_uint16(uint16_t p_uint, uint8_t *p_arr) {
|
2017-03-05 16:44:50 +01:00
|
|
|
for (int i = 0; i < 2; i++) {
|
|
|
|
*p_arr = p_uint & 0xFF;
|
|
|
|
p_arr++;
|
|
|
|
p_uint >>= 8;
|
2014-02-10 02:10:30 +01:00
|
|
|
}
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
return sizeof(uint16_t);
|
2014-02-10 02:10:30 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
static inline unsigned int encode_uint32(uint32_t p_uint, uint8_t *p_arr) {
|
2017-03-05 16:44:50 +01:00
|
|
|
for (int i = 0; i < 4; i++) {
|
|
|
|
*p_arr = p_uint & 0xFF;
|
|
|
|
p_arr++;
|
|
|
|
p_uint >>= 8;
|
2014-02-10 02:10:30 +01:00
|
|
|
}
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
return sizeof(uint32_t);
|
2014-02-10 02:10:30 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
static inline unsigned int encode_float(float p_float, uint8_t *p_arr) {
|
|
|
|
MarshallFloat mf;
|
2017-03-05 16:44:50 +01:00
|
|
|
mf.f = p_float;
|
|
|
|
encode_uint32(mf.i, p_arr);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
return sizeof(uint32_t);
|
2014-02-10 02:10:30 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
static inline unsigned int encode_uint64(uint64_t p_uint, uint8_t *p_arr) {
|
2017-03-05 16:44:50 +01:00
|
|
|
for (int i = 0; i < 8; i++) {
|
|
|
|
*p_arr = p_uint & 0xFF;
|
|
|
|
p_arr++;
|
|
|
|
p_uint >>= 8;
|
2014-02-10 02:10:30 +01:00
|
|
|
}
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
return sizeof(uint64_t);
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline unsigned int encode_double(double p_double, uint8_t *p_arr) {
|
|
|
|
MarshallDouble md;
|
2017-03-05 16:44:50 +01:00
|
|
|
md.d = p_double;
|
|
|
|
encode_uint64(md.l, p_arr);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
return sizeof(uint64_t);
|
|
|
|
}
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
static inline int encode_cstring(const char *p_string, uint8_t *p_data) {
|
|
|
|
int len = 0;
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
while (*p_string) {
|
|
|
|
if (p_data) {
|
2017-03-05 16:44:50 +01:00
|
|
|
*p_data = (uint8_t)*p_string;
|
2014-02-10 02:10:30 +01:00
|
|
|
p_data++;
|
|
|
|
}
|
|
|
|
p_string++;
|
|
|
|
len++;
|
|
|
|
};
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2021-05-05 12:44:11 +02:00
|
|
|
if (p_data) {
|
2021-05-04 14:28:27 +02:00
|
|
|
*p_data = 0;
|
2021-05-05 12:44:11 +02:00
|
|
|
}
|
2017-03-05 16:44:50 +01:00
|
|
|
return len + 1;
|
2014-02-10 02:10:30 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
static inline uint16_t decode_uint16(const uint8_t *p_arr) {
|
2017-03-05 16:44:50 +01:00
|
|
|
uint16_t u = 0;
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
for (int i = 0; i < 2; i++) {
|
2014-02-10 02:10:30 +01:00
|
|
|
uint16_t b = *p_arr;
|
2017-03-05 16:44:50 +01:00
|
|
|
b <<= (i * 8);
|
|
|
|
u |= b;
|
2014-02-10 02:10:30 +01:00
|
|
|
p_arr++;
|
|
|
|
}
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
return u;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline uint32_t decode_uint32(const uint8_t *p_arr) {
|
2017-03-05 16:44:50 +01:00
|
|
|
uint32_t u = 0;
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
for (int i = 0; i < 4; i++) {
|
2014-02-10 02:10:30 +01:00
|
|
|
uint32_t b = *p_arr;
|
2017-03-05 16:44:50 +01:00
|
|
|
b <<= (i * 8);
|
|
|
|
u |= b;
|
2014-02-10 02:10:30 +01:00
|
|
|
p_arr++;
|
|
|
|
}
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
return u;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline float decode_float(const uint8_t *p_arr) {
|
|
|
|
MarshallFloat mf;
|
|
|
|
mf.i = decode_uint32(p_arr);
|
|
|
|
return mf.f;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline uint64_t decode_uint64(const uint8_t *p_arr) {
|
2017-03-05 16:44:50 +01:00
|
|
|
uint64_t u = 0;
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
for (int i = 0; i < 8; i++) {
|
|
|
|
uint64_t b = (*p_arr) & 0xFF;
|
|
|
|
b <<= (i * 8);
|
|
|
|
u |= b;
|
2014-02-10 02:10:30 +01:00
|
|
|
p_arr++;
|
|
|
|
}
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
return u;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline double decode_double(const uint8_t *p_arr) {
|
|
|
|
MarshallDouble md;
|
2017-03-05 16:44:50 +01:00
|
|
|
md.l = decode_uint64(p_arr);
|
2014-02-10 02:10:30 +01:00
|
|
|
return md.d;
|
|
|
|
}
|
|
|
|
|
2017-08-18 15:59:31 +02:00
|
|
|
class EncodedObjectAsID : public Reference {
|
|
|
|
GDCLASS(EncodedObjectAsID, Reference);
|
|
|
|
|
|
|
|
ObjectID id;
|
|
|
|
|
|
|
|
protected:
|
|
|
|
static void _bind_methods();
|
|
|
|
|
|
|
|
public:
|
|
|
|
void set_object_id(ObjectID p_id);
|
|
|
|
ObjectID get_object_id() const;
|
|
|
|
|
|
|
|
EncodedObjectAsID();
|
|
|
|
};
|
|
|
|
|
2022-02-14 21:04:05 +01:00
|
|
|
Error decode_variant(Variant &r_variant, const uint8_t *p_buffer, int p_len, int *r_len = nullptr, bool p_allow_objects = false, int p_depth = 0);
|
2021-07-30 15:43:01 +02:00
|
|
|
Error encode_variant(const Variant &p_variant, uint8_t *r_buffer, int &r_len, bool p_full_objects = false, int p_depth = 0);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2022-07-25 12:33:41 +02:00
|
|
|
#endif // MARSHALLS_H
|