// Copyright (c) 2016-2018 Kiwano - Nomango // // 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. #pragma once #include "../macros.h" #include "../base/Resource.h" #include "../2d/include-forwards.h" #include "../renderer/GifImage.h" #include "../third-party/tinyxml2/tinyxml2.h" namespace kiwano { // 资源缓存 class KGE_API ResourceCache : public Singleton { KGE_DECLARE_SINGLETON(ResourceCache); public: // 从 JSON 文件加载资源信息 bool LoadFromJsonFile(String const& file_path); // 从 JSON 加载资源信息 bool LoadFromJson(Json const& json_data); // 从 XML 文件加载资源信息 bool LoadFromXmlFile(String const& file_path); // 从 XML 文档对象加载资源信息 bool LoadFromXml(tinyxml2::XMLDocument* doc); // 添加图片 bool AddFrame(String const& id, Resource const& res); // 添加图片 bool AddFrame(String const& id, FramePtr frame); // 添加 GIF 图片 bool AddGifImage(String const& id, Resource const& res); // 添加 GIF 图片 bool AddGifImage(String const& id, GifImagePtr image); // 添加序列帧 size_t AddFrameSequence(String const& id, Vector const& frames); // 添加序列帧 size_t AddFrameSequence(String const& id, Vector const& frames); // 添加序列帧 // 按行列数裁剪图片 size_t AddFrameSequence(String const& id, Resource const& frame, int cols, int rows = 1); // 添加序列帧 // 按指定裁剪矩形裁剪图片 size_t AddFrameSequence(String const& id, Resource const& frame, Vector const& crop_rects); // 添加序列帧 size_t AddFrameSequence(String const& id, FrameSequencePtr frames); // 添加对象 bool AddObj(String const& id, ObjectPtr obj); // 获取图片资源 FramePtr GetFrame(String const& id) const; // 获取 GIF 图片资源 GifImagePtr GetGifImage(String const& id) const; // 获取序列帧 FrameSequencePtr GetFrameSequence(String const& id) const; // 删除指定资源 void Delete(String const& id); // 清空所有资源 void Clear(); template _Ty* Get(String const& id) const { auto iter = cache_.find(id); if (iter == cache_.end()) return nullptr; return dynamic_cast<_Ty*>((*iter).second.get()); } protected: ResourceCache(); virtual ~ResourceCache(); protected: UnorderedMap cache_; }; }