/**************************************************************************/ /* 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. */ /**************************************************************************/ #ifndef RESOURCE_FORMAT_TEXT_H #define RESOURCE_FORMAT_TEXT_H #include "core/io/file_access.h" #include "core/io/resource_loader.h" #include "core/io/resource_saver.h" #include "core/variant/variant_parser.h" #include "scene/resources/packed_scene.h" class ResourceLoaderText { public: enum { // Version 2: Changed names for Basis, AABB, Vectors, etc. // Version 3: New string ID for ext/subresources, breaks forward compat. // Version 4: PackedByteArray can be base64 encoded, and PackedVector4Array was added. FORMAT_VERSION = 4, // For compat, save as version 3 if not using PackedVector4Array or no big PackedByteArray. FORMAT_VERSION_COMPAT = 3, }; private: bool translation_remapped = false; String local_path; String res_path; String error_text; Ref f; VariantParser::StreamFile stream; struct ExtResource { Ref load_token; String path; String type; }; bool is_scene = false; int format_version; String res_type; bool ignore_resource_parsing = false; HashMap ext_resources; HashMap> int_resources; int resources_total = 0; int resource_current = 0; String resource_type; String script_class; VariantParser::Tag next_tag; ResourceFormatLoader::CacheMode cache_mode = ResourceFormatLoader::CACHE_MODE_REUSE; ResourceFormatLoader::CacheMode cache_mode_for_external = ResourceFormatLoader::CACHE_MODE_REUSE; bool use_sub_threads = false; float *progress = nullptr; mutable int lines = 0; ResourceUID::ID res_uid = ResourceUID::INVALID_ID; HashMap remaps; static Error _parse_sub_resources(void *p_self, VariantParser::Stream *p_stream, Ref &r_res, int &line, String &r_err_str) { return reinterpret_cast(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 &r_res, int &line, String &r_err_str) { return reinterpret_cast(p_self)->_parse_ext_resource(p_stream, r_res, line, r_err_str); } Error _parse_sub_resource(VariantParser::Stream *p_stream, Ref &r_res, int &line, String &r_err_str); Error _parse_ext_resource(VariantParser::Stream *p_stream, Ref &r_res, int &line, String &r_err_str); struct DummyReadData { bool no_placeholders = false; HashMap, int> external_resources; HashMap> rev_external_resources; HashMap, int> resource_index_map; HashMap> resource_map; }; static Error _parse_sub_resource_dummys(void *p_self, VariantParser::Stream *p_stream, Ref &r_res, int &line, String &r_err_str) { return _parse_sub_resource_dummy(static_cast(p_self), p_stream, r_res, line, r_err_str); } static Error _parse_ext_resource_dummys(void *p_self, VariantParser::Stream *p_stream, Ref &r_res, int &line, String &r_err_str) { return _parse_ext_resource_dummy(static_cast(p_self), p_stream, r_res, line, r_err_str); } static Error _parse_sub_resource_dummy(DummyReadData *p_data, VariantParser::Stream *p_stream, Ref &r_res, int &line, String &r_err_str); static Error _parse_ext_resource_dummy(DummyReadData *p_data, VariantParser::Stream *p_stream, Ref &r_res, int &line, String &r_err_str); void _printerr(); VariantParser::ResourceParser rp; friend class ResourceFormatLoaderText; friend class ResourceFormatSaverText; Error error = OK; Ref resource; Ref _parse_node_tag(VariantParser::ResourceParser &parser); public: Ref get_resource(); Error load(); Error set_uid(Ref p_f, ResourceUID::ID p_uid); int get_stage() const; int get_stage_count() const; void set_translation_remapped(bool p_remapped); void open(Ref p_f, bool p_skip_first_tag = false); String recognize(Ref p_f); String recognize_script_class(Ref p_f); ResourceUID::ID get_uid(Ref p_f); void get_dependencies(Ref p_f, List *p_dependencies, bool p_add_types); Error rename_dependencies(Ref p_f, const String &p_path, const HashMap &p_map); Error get_classes_used(HashSet *r_classes); ResourceLoaderText(); }; class ResourceFormatLoaderText : public ResourceFormatLoader { public: static ResourceFormatLoaderText *singleton; virtual Ref 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) override; virtual void get_recognized_extensions_for_type(const String &p_type, List *p_extensions) const override; virtual void get_recognized_extensions(List *p_extensions) const override; virtual bool handles_type(const String &p_type) const override; virtual void get_classes_used(const String &p_path, HashSet *r_classes) override; virtual String get_resource_type(const String &p_path) const override; virtual String get_resource_script_class(const String &p_path) const override; virtual ResourceUID::ID get_resource_uid(const String &p_path) const override; virtual void get_dependencies(const String &p_path, List *p_dependencies, bool p_add_types = false) override; virtual Error rename_dependencies(const String &p_path, const HashMap &p_map) override; ResourceFormatLoaderText() { singleton = this; } }; class ResourceFormatSaverTextInstance { String local_path; Ref packed_scene; bool takeover_paths = false; bool relative_paths = false; bool bundle_resources = false; bool skip_editor = false; struct NonPersistentKey { //for resource properties generated on the fly Ref base; StringName property; bool operator<(const NonPersistentKey &p_key) const { return base == p_key.base ? property < p_key.property : base < p_key.base; } }; RBMap non_persistent_map; HashSet> resource_set; List> saved_resources; HashMap, String> external_resources; HashMap, String> internal_resources; bool use_compat = true; struct ResourceSort { Ref resource; String id; bool operator<(const ResourceSort &p_right) const { return id.naturalnocasecmp_to(p_right.id) < 0; } }; void _find_resources(const Variant &p_variant, bool p_main = false); static String _write_resources(void *ud, const Ref &p_resource); String _write_resource(const Ref &res); public: Error save(const String &p_path, const Ref &p_resource, uint32_t p_flags = 0); }; class ResourceFormatSaverText : public ResourceFormatSaver { public: static ResourceFormatSaverText *singleton; virtual Error save(const Ref &p_resource, const String &p_path, uint32_t p_flags = 0) override; virtual Error set_uid(const String &p_path, ResourceUID::ID p_uid) override; virtual bool recognize(const Ref &p_resource) const override; virtual void get_recognized_extensions(const Ref &p_resource, List *p_extensions) const override; ResourceFormatSaverText(); }; #endif // RESOURCE_FORMAT_TEXT_H