2014-02-10 02:10:30 +01:00
|
|
|
/*************************************************************************/
|
|
|
|
/* resource_format_binary.h */
|
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
2017-08-27 14:16:55 +02:00
|
|
|
/* https://godotengine.org */
|
2014-02-10 02:10:30 +01:00
|
|
|
/*************************************************************************/
|
2020-01-01 11:16:22 +01:00
|
|
|
/* Copyright (c) 2007-2020 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2020 Godot Engine contributors (cf. AUTHORS.md). */
|
2014-02-10 02:10:30 +01: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 00:50:27 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
#ifndef RESOURCE_FORMAT_BINARY_H
|
|
|
|
#define RESOURCE_FORMAT_BINARY_H
|
|
|
|
|
2018-09-11 18:13:45 +02:00
|
|
|
#include "core/io/resource_loader.h"
|
|
|
|
#include "core/io/resource_saver.h"
|
|
|
|
#include "core/os/file_access.h"
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-02-28 12:27:04 +01:00
|
|
|
class ResourceLoaderBinary {
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-06-28 22:00:18 +02:00
|
|
|
bool translation_remapped;
|
2014-02-10 02:10:30 +01:00
|
|
|
String local_path;
|
|
|
|
String res_path;
|
|
|
|
String type;
|
|
|
|
Ref<Resource> resource;
|
2017-11-22 12:34:43 +01:00
|
|
|
uint32_t ver_format;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
FileAccess *f;
|
|
|
|
|
|
|
|
uint64_t importmd_ofs;
|
|
|
|
|
|
|
|
Vector<char> str_buf;
|
|
|
|
List<RES> resource_cache;
|
|
|
|
|
|
|
|
Vector<StringName> string_map;
|
|
|
|
|
2017-02-15 12:29:46 +01:00
|
|
|
StringName _get_string();
|
|
|
|
|
2017-08-08 07:02:49 +02:00
|
|
|
struct ExtResource {
|
2014-02-10 02:10:30 +01:00
|
|
|
String path;
|
|
|
|
String type;
|
2020-02-28 12:27:04 +01:00
|
|
|
RES cache;
|
2014-02-10 02:10:30 +01:00
|
|
|
};
|
|
|
|
|
2020-02-28 12:27:04 +01:00
|
|
|
bool use_sub_threads;
|
|
|
|
float *progress;
|
2017-08-08 07:02:49 +02:00
|
|
|
Vector<ExtResource> external_resources;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-08-08 07:02:49 +02:00
|
|
|
struct IntResource {
|
2014-02-10 02:10:30 +01:00
|
|
|
String path;
|
|
|
|
uint64_t offset;
|
|
|
|
};
|
|
|
|
|
2017-08-08 07:02:49 +02:00
|
|
|
Vector<IntResource> internal_resources;
|
2020-05-01 14:34:23 +02:00
|
|
|
Map<String, RES> internal_index_cache;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
String get_unicode_string();
|
|
|
|
void _advance_padding(uint32_t p_len);
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
Map<String, String> remaps;
|
2014-02-10 02:10:30 +01:00
|
|
|
Error error;
|
|
|
|
|
2020-04-20 04:19:21 +02:00
|
|
|
bool use_nocache;
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
friend class ResourceFormatLoaderBinary;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
Error parse_variant(Variant &r_v);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-02-28 12:27:04 +01:00
|
|
|
Map<String, RES> dependency_cache;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
public:
|
2020-02-28 12:27:04 +01:00
|
|
|
void set_local_path(const String &p_local_path);
|
|
|
|
Ref<Resource> get_resource();
|
|
|
|
Error load();
|
|
|
|
void set_translation_remapped(bool p_remapped);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
void set_remaps(const Map<String, String> &p_remaps) { remaps = p_remaps; }
|
2014-02-10 02:10:30 +01:00
|
|
|
void open(FileAccess *p_f);
|
|
|
|
String recognize(FileAccess *p_f);
|
2015-08-24 01:15:56 +02:00
|
|
|
void get_dependencies(FileAccess *p_f, List<String> *p_dependencies, bool p_add_types);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-02-28 12:27:04 +01:00
|
|
|
ResourceLoaderBinary();
|
|
|
|
~ResourceLoaderBinary();
|
2014-02-10 02:10:30 +01:00
|
|
|
};
|
|
|
|
|
|
|
|
class ResourceFormatLoaderBinary : public ResourceFormatLoader {
|
|
|
|
public:
|
2020-04-20 04:19:21 +02:00
|
|
|
virtual RES load(const String &p_path, const String &p_original_path = "", Error *r_error = nullptr, bool p_use_sub_threads = false, float *r_progress = nullptr, bool p_no_cache = false);
|
2017-03-05 16:44:50 +01:00
|
|
|
virtual void get_recognized_extensions_for_type(const String &p_type, List<String> *p_extensions) const;
|
2014-02-10 02:10:30 +01:00
|
|
|
virtual void get_recognized_extensions(List<String> *p_extensions) const;
|
2017-03-05 16:44:50 +01:00
|
|
|
virtual bool handles_type(const String &p_type) const;
|
2014-02-10 02:10:30 +01:00
|
|
|
virtual String get_resource_type(const String &p_path) const;
|
2017-03-05 16:44:50 +01:00
|
|
|
virtual void get_dependencies(const String &p_path, List<String> *p_dependencies, bool p_add_types = false);
|
|
|
|
virtual Error rename_dependencies(const String &p_path, const Map<String, String> &p_map);
|
2014-02-10 02:10:30 +01:00
|
|
|
};
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
class ResourceFormatSaverBinaryInstance {
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
String local_path;
|
2019-02-24 14:45:08 +01:00
|
|
|
String path;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
bool relative_paths;
|
|
|
|
bool bundle_resources;
|
|
|
|
bool skip_editor;
|
|
|
|
bool big_endian;
|
2014-06-28 04:21:45 +02:00
|
|
|
bool takeover_paths;
|
2014-02-10 02:10:30 +01:00
|
|
|
FileAccess *f;
|
|
|
|
String magic;
|
2015-06-22 05:03:19 +02:00
|
|
|
Set<RES> resource_set;
|
2019-02-22 00:49:42 +01:00
|
|
|
|
|
|
|
struct NonPersistentKey { //for resource properties generated on the fly
|
|
|
|
RES base;
|
|
|
|
StringName property;
|
|
|
|
bool operator<(const NonPersistentKey &p_key) const { return base == p_key.base ? property < p_key.property : base < p_key.base; }
|
|
|
|
};
|
|
|
|
|
|
|
|
Map<NonPersistentKey, RES> non_persistent_map;
|
2017-03-05 16:44:50 +01:00
|
|
|
Map<StringName, int> string_map;
|
2014-02-10 02:10:30 +01:00
|
|
|
Vector<StringName> strings;
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
Map<RES, int> external_resources;
|
2014-02-10 02:10:30 +01:00
|
|
|
List<RES> saved_resources;
|
|
|
|
|
|
|
|
struct Property {
|
|
|
|
int name_idx;
|
|
|
|
Variant value;
|
|
|
|
PropertyInfo pi;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct ResourceData {
|
|
|
|
|
|
|
|
String type;
|
|
|
|
List<Property> properties;
|
|
|
|
};
|
|
|
|
|
2017-12-15 12:38:24 +01:00
|
|
|
static void _pad_buffer(FileAccess *f, int p_bytes);
|
|
|
|
void _write_variant(const Variant &p_property, const PropertyInfo &p_hint = PropertyInfo());
|
2017-03-05 16:44:50 +01:00
|
|
|
void _find_resources(const Variant &p_variant, bool p_main = false);
|
2017-12-15 12:38:24 +01:00
|
|
|
static void save_unicode_string(FileAccess *f, const String &p_string, bool p_bit_on_len = false);
|
2017-03-05 16:44:50 +01:00
|
|
|
int get_string_index(const String &p_string);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
public:
|
|
|
|
Error save(const String &p_path, const RES &p_resource, uint32_t p_flags = 0);
|
2017-12-15 12:38:24 +01:00
|
|
|
static void write_variant(FileAccess *f, const Variant &p_property, Set<RES> &resource_set, Map<RES, int> &external_resources, Map<StringName, int> &string_map, const PropertyInfo &p_hint = PropertyInfo());
|
2014-02-10 02:10:30 +01:00
|
|
|
};
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
class ResourceFormatSaverBinary : public ResourceFormatSaver {
|
2014-02-10 02:10:30 +01:00
|
|
|
public:
|
2017-03-05 16:44:50 +01:00
|
|
|
static ResourceFormatSaverBinary *singleton;
|
|
|
|
virtual Error save(const String &p_path, const RES &p_resource, uint32_t p_flags = 0);
|
|
|
|
virtual bool recognize(const RES &p_resource) const;
|
|
|
|
virtual void get_recognized_extensions(const RES &p_resource, List<String> *p_extensions) const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2015-08-24 01:15:56 +02:00
|
|
|
ResourceFormatSaverBinary();
|
2014-02-10 02:10:30 +01:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif // RESOURCE_FORMAT_BINARY_H
|