2023-01-05 13:25:55 +01:00
|
|
|
/**************************************************************************/
|
|
|
|
/* resource_format_text.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
|
|
|
|
2019-02-12 17:18:13 +01:00
|
|
|
#ifndef RESOURCE_FORMAT_TEXT_H
|
|
|
|
#define RESOURCE_FORMAT_TEXT_H
|
2015-10-10 14:09:09 +02:00
|
|
|
|
2021-06-11 14:51:48 +02:00
|
|
|
#include "core/io/file_access.h"
|
2018-09-11 18:13:45 +02:00
|
|
|
#include "core/io/resource_loader.h"
|
|
|
|
#include "core/io/resource_saver.h"
|
2020-11-07 23:33:38 +01:00
|
|
|
#include "core/variant/variant_parser.h"
|
2015-10-10 14:09:09 +02:00
|
|
|
#include "scene/resources/packed_scene.h"
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2020-02-28 12:27:04 +01:00
|
|
|
class ResourceLoaderText {
|
2021-02-09 18:24:36 +01:00
|
|
|
bool translation_remapped = false;
|
2015-11-24 14:42:05 +01:00
|
|
|
String local_path;
|
|
|
|
String res_path;
|
|
|
|
String error_text;
|
|
|
|
|
2022-03-23 10:08:58 +01:00
|
|
|
Ref<FileAccess> f;
|
2015-11-24 14:42:05 +01:00
|
|
|
|
|
|
|
VariantParser::StreamFile stream;
|
|
|
|
|
|
|
|
struct ExtResource {
|
2023-03-05 01:09:18 +01:00
|
|
|
Ref<ResourceLoader::LoadToken> load_token;
|
2015-11-24 14:42:05 +01:00
|
|
|
String path;
|
|
|
|
String type;
|
|
|
|
};
|
|
|
|
|
2021-02-09 18:24:36 +01:00
|
|
|
bool is_scene = false;
|
2015-11-24 14:42:05 +01:00
|
|
|
String res_type;
|
|
|
|
|
2021-02-09 18:24:36 +01:00
|
|
|
bool ignore_resource_parsing = false;
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2022-05-13 15:04:37 +02:00
|
|
|
HashMap<String, ExtResource> ext_resources;
|
|
|
|
HashMap<String, Ref<Resource>> int_resources;
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2021-02-09 18:24:36 +01:00
|
|
|
int resources_total = 0;
|
|
|
|
int resource_current = 0;
|
2015-11-24 14:42:05 +01:00
|
|
|
String resource_type;
|
2023-01-19 19:12:25 +01:00
|
|
|
String script_class;
|
2015-11-24 14:42:05 +01:00
|
|
|
|
|
|
|
VariantParser::Tag next_tag;
|
|
|
|
|
2021-02-11 18:18:45 +01:00
|
|
|
ResourceFormatLoader::CacheMode cache_mode = ResourceFormatLoader::CACHE_MODE_REUSE;
|
2020-04-20 04:19:21 +02:00
|
|
|
|
2021-02-09 18:24:36 +01:00
|
|
|
bool use_sub_threads = false;
|
|
|
|
float *progress = nullptr;
|
2020-02-28 12:27:04 +01:00
|
|
|
|
2021-02-09 18:24:36 +01:00
|
|
|
mutable int lines = 0;
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2021-07-23 21:01:18 +02:00
|
|
|
ResourceUID::ID res_uid = ResourceUID::INVALID_ID;
|
|
|
|
|
2022-05-13 15:04:37 +02:00
|
|
|
HashMap<String, String> remaps;
|
2015-11-29 00:56:14 +01:00
|
|
|
|
2020-02-28 12:27:04 +01:00
|
|
|
static Error _parse_sub_resources(void *p_self, VariantParser::Stream *p_stream, Ref<Resource> &r_res, int &line, String &r_err_str) { return reinterpret_cast<ResourceLoaderText *>(p_self)->_parse_sub_resource(p_stream, r_res, line, r_err_str); }
|
|
|
|
static Error _parse_ext_resources(void *p_self, VariantParser::Stream *p_stream, Ref<Resource> &r_res, int &line, String &r_err_str) { return reinterpret_cast<ResourceLoaderText *>(p_self)->_parse_ext_resource(p_stream, r_res, line, r_err_str); }
|
2015-11-29 00:56:14 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
Error _parse_sub_resource(VariantParser::Stream *p_stream, Ref<Resource> &r_res, int &line, String &r_err_str);
|
|
|
|
Error _parse_ext_resource(VariantParser::Stream *p_stream, Ref<Resource> &r_res, int &line, String &r_err_str);
|
2015-11-29 00:56:14 +01:00
|
|
|
|
2017-12-15 12:38:24 +01:00
|
|
|
// for converter
|
|
|
|
class DummyResource : public Resource {
|
|
|
|
public:
|
|
|
|
};
|
2015-11-29 00:56:14 +01:00
|
|
|
|
2017-12-15 12:38:24 +01:00
|
|
|
struct DummyReadData {
|
2022-07-14 14:18:18 +02:00
|
|
|
bool no_placeholders = false;
|
2022-05-13 15:04:37 +02:00
|
|
|
HashMap<Ref<Resource>, int> external_resources;
|
|
|
|
HashMap<String, Ref<Resource>> rev_external_resources;
|
|
|
|
HashMap<Ref<Resource>, int> resource_index_map;
|
|
|
|
HashMap<String, Ref<Resource>> resource_map;
|
2017-12-15 12:38:24 +01:00
|
|
|
};
|
|
|
|
|
2022-04-05 12:40:26 +02:00
|
|
|
static Error _parse_sub_resource_dummys(void *p_self, VariantParser::Stream *p_stream, Ref<Resource> &r_res, int &line, String &r_err_str) { return _parse_sub_resource_dummy(static_cast<DummyReadData *>(p_self), p_stream, r_res, line, r_err_str); }
|
|
|
|
static Error _parse_ext_resource_dummys(void *p_self, VariantParser::Stream *p_stream, Ref<Resource> &r_res, int &line, String &r_err_str) { return _parse_ext_resource_dummy(static_cast<DummyReadData *>(p_self), p_stream, r_res, line, r_err_str); }
|
2017-12-15 12:38:24 +01:00
|
|
|
|
|
|
|
static Error _parse_sub_resource_dummy(DummyReadData *p_data, VariantParser::Stream *p_stream, Ref<Resource> &r_res, int &line, String &r_err_str);
|
|
|
|
static Error _parse_ext_resource_dummy(DummyReadData *p_data, VariantParser::Stream *p_stream, Ref<Resource> &r_res, int &line, String &r_err_str);
|
|
|
|
|
|
|
|
VariantParser::ResourceParser rp;
|
2015-11-29 00:56:14 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
friend class ResourceFormatLoaderText;
|
2022-12-05 19:01:59 +01:00
|
|
|
friend class ResourceFormatSaverText;
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2021-02-09 18:24:36 +01:00
|
|
|
Error error = OK;
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2022-05-03 01:43:50 +02:00
|
|
|
Ref<Resource> resource;
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2017-12-15 12:38:24 +01:00
|
|
|
Ref<PackedScene> _parse_node_tag(VariantParser::ResourceParser &parser);
|
|
|
|
|
2015-11-24 14:42:05 +01:00
|
|
|
public:
|
2020-02-28 12:27:04 +01:00
|
|
|
Ref<Resource> get_resource();
|
|
|
|
Error load();
|
2022-12-05 19:01:59 +01:00
|
|
|
Error set_uid(Ref<FileAccess> p_f, ResourceUID::ID p_uid);
|
2020-02-28 12:27:04 +01:00
|
|
|
int get_stage() const;
|
|
|
|
int get_stage_count() const;
|
|
|
|
void set_translation_remapped(bool p_remapped);
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2022-03-23 10:08:58 +01:00
|
|
|
void open(Ref<FileAccess> p_f, bool p_skip_first_tag = false);
|
|
|
|
String recognize(Ref<FileAccess> p_f);
|
2023-01-19 19:12:25 +01:00
|
|
|
String recognize_script_class(Ref<FileAccess> p_f);
|
2022-03-23 10:08:58 +01:00
|
|
|
ResourceUID::ID get_uid(Ref<FileAccess> p_f);
|
|
|
|
void get_dependencies(Ref<FileAccess> p_f, List<String> *p_dependencies, bool p_add_types);
|
2022-05-13 15:04:37 +02:00
|
|
|
Error rename_dependencies(Ref<FileAccess> p_f, const String &p_path, const HashMap<String, String> &p_map);
|
2022-07-14 14:18:18 +02:00
|
|
|
Error get_classes_used(HashSet<StringName> *r_classes);
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2022-07-14 14:18:18 +02:00
|
|
|
Error save_as_binary(const String &p_path);
|
2020-02-28 12:27:04 +01:00
|
|
|
ResourceLoaderText();
|
2015-11-24 14:42:05 +01:00
|
|
|
};
|
|
|
|
|
|
|
|
class ResourceFormatLoaderText : public ResourceFormatLoader {
|
|
|
|
public:
|
2018-01-30 15:03:46 +01:00
|
|
|
static ResourceFormatLoaderText *singleton;
|
2022-05-03 01:43:50 +02:00
|
|
|
virtual Ref<Resource> load(const String &p_path, const String &p_original_path = "", Error *r_error = nullptr, bool p_use_sub_threads = false, float *r_progress = nullptr, CacheMode p_cache_mode = CACHE_MODE_REUSE);
|
2017-03-05 16:44:50 +01:00
|
|
|
virtual void get_recognized_extensions_for_type(const String &p_type, List<String> *p_extensions) const;
|
2015-11-24 14:42:05 +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;
|
2022-07-14 14:18:18 +02:00
|
|
|
virtual void get_classes_used(const String &p_path, HashSet<StringName> *r_classes);
|
|
|
|
|
2015-11-24 14:42:05 +01:00
|
|
|
virtual String get_resource_type(const String &p_path) const;
|
2023-01-19 19:12:25 +01:00
|
|
|
virtual String get_resource_script_class(const String &p_path) const;
|
2021-07-23 21:01:18 +02:00
|
|
|
virtual ResourceUID::ID get_resource_uid(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);
|
2022-05-13 15:04:37 +02:00
|
|
|
virtual Error rename_dependencies(const String &p_path, const HashMap<String, String> &p_map);
|
2017-12-15 12:38:24 +01:00
|
|
|
|
|
|
|
static Error convert_file_to_binary(const String &p_src_path, const String &p_dst_path);
|
2018-01-30 15:03:46 +01:00
|
|
|
|
|
|
|
ResourceFormatLoaderText() { singleton = this; }
|
2015-11-24 14:42:05 +01:00
|
|
|
};
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
class ResourceFormatSaverTextInstance {
|
2015-10-10 14:09:09 +02:00
|
|
|
String local_path;
|
|
|
|
|
|
|
|
Ref<PackedScene> packed_scene;
|
|
|
|
|
2021-02-09 18:24:36 +01:00
|
|
|
bool takeover_paths = false;
|
|
|
|
bool relative_paths = false;
|
|
|
|
bool bundle_resources = false;
|
|
|
|
bool skip_editor = false;
|
2019-02-22 00:49:42 +01:00
|
|
|
|
|
|
|
struct NonPersistentKey { //for resource properties generated on the fly
|
2022-05-03 01:43:50 +02:00
|
|
|
Ref<Resource> base;
|
2019-02-22 00:49:42 +01:00
|
|
|
StringName property;
|
|
|
|
bool operator<(const NonPersistentKey &p_key) const { return base == p_key.base ? property < p_key.property : base < p_key.base; }
|
|
|
|
};
|
|
|
|
|
2022-12-17 22:20:27 +01:00
|
|
|
RBMap<NonPersistentKey, Variant> non_persistent_map;
|
2019-02-22 00:49:42 +01:00
|
|
|
|
2022-05-19 17:00:06 +02:00
|
|
|
HashSet<Ref<Resource>> resource_set;
|
2022-05-03 01:43:50 +02:00
|
|
|
List<Ref<Resource>> saved_resources;
|
2022-05-13 15:04:37 +02:00
|
|
|
HashMap<Ref<Resource>, String> external_resources;
|
|
|
|
HashMap<Ref<Resource>, String> internal_resources;
|
2015-12-31 04:31:00 +01:00
|
|
|
|
2019-04-11 19:35:23 +02:00
|
|
|
struct ResourceSort {
|
2022-05-03 01:43:50 +02:00
|
|
|
Ref<Resource> resource;
|
2021-07-21 02:36:56 +02:00
|
|
|
String id;
|
2019-05-20 13:51:51 +02:00
|
|
|
bool operator<(const ResourceSort &p_right) const {
|
2021-07-21 02:36:56 +02:00
|
|
|
return id.naturalnocasecmp_to(p_right.id) < 0;
|
2019-04-11 19:35:23 +02:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
void _find_resources(const Variant &p_variant, bool p_main = false);
|
2015-12-31 04:31:00 +01:00
|
|
|
|
2022-05-03 01:43:50 +02:00
|
|
|
static String _write_resources(void *ud, const Ref<Resource> &p_resource);
|
|
|
|
String _write_resource(const Ref<Resource> &res);
|
2015-10-10 14:09:09 +02:00
|
|
|
|
|
|
|
public:
|
2022-05-03 01:43:50 +02:00
|
|
|
Error save(const String &p_path, const Ref<Resource> &p_resource, uint32_t p_flags = 0);
|
2015-10-10 14:09:09 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
class ResourceFormatSaverText : public ResourceFormatSaver {
|
|
|
|
public:
|
2017-03-05 16:44:50 +01:00
|
|
|
static ResourceFormatSaverText *singleton;
|
2022-06-03 01:33:42 +02:00
|
|
|
virtual Error save(const Ref<Resource> &p_resource, const String &p_path, uint32_t p_flags = 0);
|
2022-12-05 19:01:59 +01:00
|
|
|
virtual Error set_uid(const String &p_path, ResourceUID::ID p_uid);
|
2022-05-03 01:43:50 +02:00
|
|
|
virtual bool recognize(const Ref<Resource> &p_resource) const;
|
|
|
|
virtual void get_recognized_extensions(const Ref<Resource> &p_resource, List<String> *p_extensions) const;
|
2015-10-10 14:09:09 +02:00
|
|
|
|
|
|
|
ResourceFormatSaverText();
|
|
|
|
};
|
|
|
|
|
2019-02-12 17:18:13 +01:00
|
|
|
#endif // RESOURCE_FORMAT_TEXT_H
|