2016-06-18 14:46:12 +02:00
|
|
|
/*************************************************************************/
|
2019-02-12 17:18:13 +01:00
|
|
|
/* resource_format_text.h */
|
2016-06-18 14:46:12 +02:00
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
2017-08-27 14:16:55 +02:00
|
|
|
/* https://godotengine.org */
|
2016-06-18 14:46:12 +02:00
|
|
|
/*************************************************************************/
|
2022-01-03 21:27:34 +01:00
|
|
|
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
|
2016-06-18 14:46:12 +02: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
|
|
|
|
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;
|
|
|
|
|
2021-02-09 18:24:36 +01:00
|
|
|
FileAccess *f = nullptr;
|
2015-11-24 14:42:05 +01:00
|
|
|
|
|
|
|
VariantParser::StreamFile stream;
|
|
|
|
|
|
|
|
struct ExtResource {
|
2020-02-28 12:27:04 +01:00
|
|
|
RES cache;
|
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
|
|
|
|
2021-07-21 02:36:56 +02:00
|
|
|
Map<String, ExtResource> ext_resources;
|
|
|
|
Map<String, RES> 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;
|
|
|
|
|
|
|
|
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;
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
Map<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 {
|
|
|
|
Map<RES, int> external_resources;
|
2021-07-21 02:36:56 +02:00
|
|
|
Map<String, RES> rev_external_resources;
|
|
|
|
Map<RES, int> resource_index_map;
|
|
|
|
Map<String, RES> 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;
|
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
|
|
|
|
|
|
|
RES resource;
|
|
|
|
|
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
|
|
|
void set_local_path(const String &p_local_path);
|
|
|
|
Ref<Resource> get_resource();
|
|
|
|
Error load();
|
|
|
|
int get_stage() const;
|
|
|
|
int get_stage_count() const;
|
|
|
|
void set_translation_remapped(bool p_remapped);
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
void open(FileAccess *p_f, bool p_skip_first_tag = false);
|
2015-11-24 14:42:05 +01:00
|
|
|
String recognize(FileAccess *p_f);
|
2021-07-23 21:01:18 +02:00
|
|
|
ResourceUID::ID get_uid(FileAccess *p_f);
|
2015-11-24 14:42:05 +01:00
|
|
|
void get_dependencies(FileAccess *p_f, List<String> *p_dependencies, bool p_add_types);
|
2017-03-05 16:44:50 +01:00
|
|
|
Error rename_dependencies(FileAccess *p_f, const String &p_path, const Map<String, String> &p_map);
|
2015-11-24 14:42:05 +01:00
|
|
|
|
2017-12-15 12:38:24 +01:00
|
|
|
Error save_as_binary(FileAccess *p_f, const String &p_path);
|
2020-02-28 12:27:04 +01:00
|
|
|
ResourceLoaderText();
|
|
|
|
~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;
|
2021-02-11 18:18:45 +01: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, 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;
|
2015-11-24 14:42:05 +01:00
|
|
|
virtual String get_resource_type(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);
|
|
|
|
virtual Error rename_dependencies(const String &p_path, const Map<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;
|
|
|
|
FileAccess *f = nullptr;
|
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;
|
|
|
|
|
2015-10-10 14:09:09 +02:00
|
|
|
Set<RES> resource_set;
|
|
|
|
List<RES> saved_resources;
|
2021-07-21 02:36:56 +02:00
|
|
|
Map<RES, String> external_resources;
|
|
|
|
Map<RES, String> internal_resources;
|
2015-12-31 04:31:00 +01:00
|
|
|
|
2019-04-11 19:35:23 +02:00
|
|
|
struct ResourceSort {
|
|
|
|
RES 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
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
static String _write_resources(void *ud, const RES &p_resource);
|
|
|
|
String _write_resource(const RES &res);
|
2015-10-10 14:09:09 +02:00
|
|
|
|
|
|
|
public:
|
2017-03-05 16:44:50 +01:00
|
|
|
Error save(const String &p_path, const RES &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;
|
|
|
|
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;
|
2015-10-10 14:09:09 +02:00
|
|
|
|
|
|
|
ResourceFormatSaverText();
|
|
|
|
};
|
|
|
|
|
2019-02-12 17:18:13 +01:00
|
|
|
#endif // RESOURCE_FORMAT_TEXT_H
|