Factory.cpp 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674
  1. /*
  2. * This source file is part of RmlUi, the HTML/CSS Interface Middleware
  3. *
  4. * For the latest information, see http://github.com/mikke89/RmlUi
  5. *
  6. * Copyright (c) 2008-2010 CodePoint Ltd, Shift Technology Ltd
  7. * Copyright (c) 2019 The RmlUi Team, and contributors
  8. *
  9. * Permission is hereby granted, free of charge, to any person obtaining a copy
  10. * of this software and associated documentation files (the "Software"), to deal
  11. * in the Software without restriction, including without limitation the rights
  12. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  13. * copies of the Software, and to permit persons to whom the Software is
  14. * furnished to do so, subject to the following conditions:
  15. *
  16. * The above copyright notice and this permission notice shall be included in
  17. * all copies or substantial portions of the Software.
  18. *
  19. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  22. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  23. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  24. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  25. * THE SOFTWARE.
  26. *
  27. */
  28. #include "../../Include/RmlUi/Core/Factory.h"
  29. #include "../../Include/RmlUi/Core/Context.h"
  30. #include "../../Include/RmlUi/Core/ContextInstancer.h"
  31. #include "../../Include/RmlUi/Core/Core.h"
  32. #include "../../Include/RmlUi/Core/ElementDocument.h"
  33. #include "../../Include/RmlUi/Core/ElementInstancer.h"
  34. #include "../../Include/RmlUi/Core/ElementText.h"
  35. #include "../../Include/RmlUi/Core/ElementUtilities.h"
  36. #include "../../Include/RmlUi/Core/EventListenerInstancer.h"
  37. #include "../../Include/RmlUi/Core/StreamMemory.h"
  38. #include "../../Include/RmlUi/Core/StyleSheet.h"
  39. #include "../../Include/RmlUi/Core/StyleSheetContainer.h"
  40. #include "../../Include/RmlUi/Core/SystemInterface.h"
  41. #include "../../Include/RmlUi/Core/Elements/ElementForm.h"
  42. #include "../../Include/RmlUi/Core/Elements/ElementFormControlInput.h"
  43. #include "../../Include/RmlUi/Core/Elements/ElementFormControlDataSelect.h"
  44. #include "../../Include/RmlUi/Core/Elements/ElementFormControlSelect.h"
  45. #include "../../Include/RmlUi/Core/Elements/ElementFormControlSelect.h"
  46. #include "../../Include/RmlUi/Core/Elements/ElementFormControlTextArea.h"
  47. #include "../../Include/RmlUi/Core/Elements/ElementTabSet.h"
  48. #include "../../Include/RmlUi/Core/Elements/ElementProgress.h"
  49. #include "../../Include/RmlUi/Core/Elements/ElementDataGrid.h"
  50. #include "../../Include/RmlUi/Core/Elements/ElementDataGridExpandButton.h"
  51. #include "../../Include/RmlUi/Core/Elements/ElementDataGridCell.h"
  52. #include "../../Include/RmlUi/Core/Elements/ElementDataGridRow.h"
  53. #include "ContextInstancerDefault.h"
  54. #include "DataControllerDefault.h"
  55. #include "DataViewDefault.h"
  56. #include "DecoratorTiledBoxInstancer.h"
  57. #include "DecoratorTiledHorizontalInstancer.h"
  58. #include "DecoratorTiledImageInstancer.h"
  59. #include "DecoratorTiledVerticalInstancer.h"
  60. #include "DecoratorNinePatch.h"
  61. #include "DecoratorGradient.h"
  62. #include "ElementHandle.h"
  63. #include "EventInstancerDefault.h"
  64. #include "FontEffectBlur.h"
  65. #include "FontEffectGlow.h"
  66. #include "FontEffectOutline.h"
  67. #include "FontEffectShadow.h"
  68. #include "PluginRegistry.h"
  69. #include "StreamFile.h"
  70. #include "StyleSheetFactory.h"
  71. #include "TemplateCache.h"
  72. #include "XMLNodeHandlerBody.h"
  73. #include "XMLNodeHandlerDefault.h"
  74. #include "XMLNodeHandlerHead.h"
  75. #include "XMLNodeHandlerTemplate.h"
  76. #include "XMLParseTools.h"
  77. #include "Elements/ElementImage.h"
  78. #include "Elements/ElementLabel.h"
  79. #include "Elements/ElementTextSelection.h"
  80. #include "Elements/XMLNodeHandlerDataGrid.h"
  81. #include "Elements/XMLNodeHandlerSelect.h"
  82. #include "Elements/XMLNodeHandlerTabSet.h"
  83. #include "Elements/XMLNodeHandlerTextArea.h"
  84. #include <algorithm>
  85. namespace Rml {
  86. // Element instancers.
  87. using ElementInstancerMap = UnorderedMap< String, ElementInstancer* >;
  88. static ElementInstancerMap element_instancers;
  89. // Decorator instancers.
  90. using DecoratorInstancerMap = UnorderedMap< String, DecoratorInstancer* >;
  91. static DecoratorInstancerMap decorator_instancers;
  92. // Font effect instancers.
  93. using FontEffectInstancerMap = UnorderedMap< String, FontEffectInstancer* >;
  94. static FontEffectInstancerMap font_effect_instancers;
  95. // Data view instancers.
  96. using DataViewInstancerMap = UnorderedMap< String, DataViewInstancer* >;
  97. static DataViewInstancerMap data_view_instancers;
  98. // Data controller instancers.
  99. using DataControllerInstancerMap = UnorderedMap< String, DataControllerInstancer* >;
  100. static DataControllerInstancerMap data_controller_instancers;
  101. // Structural data view instancers.
  102. using StructuralDataViewInstancerMap = SmallUnorderedMap< String, DataViewInstancer* >;
  103. static StructuralDataViewInstancerMap structural_data_view_instancers;
  104. // Structural data view names.
  105. static StringList structural_data_view_attribute_names;
  106. // The context instancer.
  107. static ContextInstancer* context_instancer = nullptr;
  108. // The event instancer
  109. static EventInstancer* event_instancer = nullptr;
  110. // Event listener instancer.
  111. static EventListenerInstancer* event_listener_instancer = nullptr;
  112. // Default instancers are constructed and destroyed on Initialise and Shutdown, respectively.
  113. struct DefaultInstancers {
  114. UniquePtr<ContextInstancer> context_default;
  115. UniquePtr<EventInstancer> event_default;
  116. // Basic elements
  117. ElementInstancerElement element_default;
  118. ElementInstancerText element_text;
  119. ElementInstancerGeneric<ElementImage> element_img;
  120. ElementInstancerGeneric<ElementHandle> element_handle;
  121. ElementInstancerGeneric<ElementDocument> element_body;
  122. // Control elements
  123. ElementInstancerGeneric<ElementForm> form;
  124. ElementInstancerGeneric<ElementFormControlInput> input;
  125. ElementInstancerGeneric<ElementFormControlDataSelect> dataselect;
  126. ElementInstancerGeneric<ElementFormControlSelect> select;
  127. ElementInstancerGeneric<ElementLabel> element_label;
  128. ElementInstancerGeneric<ElementFormControlTextArea> textarea;
  129. ElementInstancerGeneric<ElementTextSelection> selection;
  130. ElementInstancerGeneric<ElementTabSet> tabset;
  131. ElementInstancerGeneric<ElementProgress> progress;
  132. ElementInstancerGeneric<ElementDataGrid> datagrid;
  133. ElementInstancerGeneric<ElementDataGridExpandButton> datagrid_expand;
  134. ElementInstancerGeneric<ElementDataGridCell> datagrid_cell;
  135. ElementInstancerGeneric<ElementDataGridRow> datagrid_row;
  136. // Decorators
  137. DecoratorTiledHorizontalInstancer decorator_tiled_horizontal;
  138. DecoratorTiledVerticalInstancer decorator_tiled_vertical;
  139. DecoratorTiledBoxInstancer decorator_tiled_box;
  140. DecoratorTiledImageInstancer decorator_image;
  141. DecoratorNinePatchInstancer decorator_ninepatch;
  142. DecoratorGradientInstancer decorator_gradient;
  143. // Font effects
  144. FontEffectBlurInstancer font_effect_blur;
  145. FontEffectGlowInstancer font_effect_glow;
  146. FontEffectOutlineInstancer font_effect_outline;
  147. FontEffectShadowInstancer font_effect_shadow;
  148. // Data binding views
  149. DataViewInstancerDefault<DataViewAttribute> data_view_attribute;
  150. DataViewInstancerDefault<DataViewAttributeIf> data_view_attribute_if;
  151. DataViewInstancerDefault<DataViewClass> data_view_class;
  152. DataViewInstancerDefault<DataViewIf> data_view_if;
  153. DataViewInstancerDefault<DataViewVisible> data_view_visible;
  154. DataViewInstancerDefault<DataViewRml> data_view_rml;
  155. DataViewInstancerDefault<DataViewStyle> data_view_style;
  156. DataViewInstancerDefault<DataViewText> data_view_text;
  157. DataViewInstancerDefault<DataViewValue> data_view_value;
  158. DataViewInstancerDefault<DataViewChecked> data_view_checked;
  159. DataViewInstancerDefault<DataViewFor> structural_data_view_for;
  160. // Data binding controllers
  161. DataControllerInstancerDefault<DataControllerValue> data_controller_value;
  162. DataControllerInstancerDefault<DataControllerEvent> data_controller_event;
  163. DataControllerInstancerDefault<DataControllerChecked> data_controller_checked;
  164. };
  165. static UniquePtr<DefaultInstancers> default_instancers;
  166. Factory::Factory()
  167. {
  168. }
  169. Factory::~Factory()
  170. {
  171. }
  172. bool Factory::Initialise()
  173. {
  174. default_instancers = MakeUnique<DefaultInstancers>();
  175. // Default context instancer
  176. if (!context_instancer)
  177. {
  178. default_instancers->context_default = MakeUnique<ContextInstancerDefault>();
  179. context_instancer = default_instancers->context_default.get();
  180. }
  181. // Default event instancer
  182. if (!event_instancer)
  183. {
  184. default_instancers->event_default = MakeUnique<EventInstancerDefault>();
  185. event_instancer = default_instancers->event_default.get();
  186. }
  187. // No default event listener instancer
  188. if (!event_listener_instancer)
  189. event_listener_instancer = nullptr;
  190. // Basic element instancers
  191. RegisterElementInstancer("*", &default_instancers->element_default);
  192. RegisterElementInstancer("img", &default_instancers->element_img);
  193. RegisterElementInstancer("#text", &default_instancers->element_text);
  194. RegisterElementInstancer("handle", &default_instancers->element_handle);
  195. RegisterElementInstancer("body", &default_instancers->element_body);
  196. // Control element instancers
  197. RegisterElementInstancer("form", &default_instancers->form);
  198. RegisterElementInstancer("input", &default_instancers->input);
  199. RegisterElementInstancer("dataselect", &default_instancers->dataselect);
  200. RegisterElementInstancer("select", &default_instancers->select);
  201. RegisterElementInstancer("label", &default_instancers->element_label);
  202. RegisterElementInstancer("textarea", &default_instancers->textarea);
  203. RegisterElementInstancer("#selection", &default_instancers->selection);
  204. RegisterElementInstancer("tabset", &default_instancers->tabset);
  205. RegisterElementInstancer("progress", &default_instancers->progress);
  206. RegisterElementInstancer("progressbar", &default_instancers->progress);
  207. RegisterElementInstancer("datagrid", &default_instancers->datagrid);
  208. RegisterElementInstancer("datagridexpand", &default_instancers->datagrid_expand);
  209. RegisterElementInstancer("#rmlctl_datagridcell", &default_instancers->datagrid_cell);
  210. RegisterElementInstancer("#rmlctl_datagridrow", &default_instancers->datagrid_row);
  211. // Decorator instancers
  212. RegisterDecoratorInstancer("tiled-horizontal", &default_instancers->decorator_tiled_horizontal);
  213. RegisterDecoratorInstancer("tiled-vertical", &default_instancers->decorator_tiled_vertical);
  214. RegisterDecoratorInstancer("tiled-box", &default_instancers->decorator_tiled_box);
  215. RegisterDecoratorInstancer("image", &default_instancers->decorator_image);
  216. RegisterDecoratorInstancer("ninepatch", &default_instancers->decorator_ninepatch);
  217. RegisterDecoratorInstancer("gradient", &default_instancers->decorator_gradient);
  218. // Font effect instancers
  219. RegisterFontEffectInstancer("blur", &default_instancers->font_effect_blur);
  220. RegisterFontEffectInstancer("glow", &default_instancers->font_effect_glow);
  221. RegisterFontEffectInstancer("outline", &default_instancers->font_effect_outline);
  222. RegisterFontEffectInstancer("shadow", &default_instancers->font_effect_shadow);
  223. // Data binding views
  224. RegisterDataViewInstancer(&default_instancers->data_view_attribute, "attr", false);
  225. RegisterDataViewInstancer(&default_instancers->data_view_attribute_if, "attrif", false);
  226. RegisterDataViewInstancer(&default_instancers->data_view_class, "class", false);
  227. RegisterDataViewInstancer(&default_instancers->data_view_if, "if", false);
  228. RegisterDataViewInstancer(&default_instancers->data_view_visible, "visible", false);
  229. RegisterDataViewInstancer(&default_instancers->data_view_rml, "rml", false);
  230. RegisterDataViewInstancer(&default_instancers->data_view_style, "style", false);
  231. RegisterDataViewInstancer(&default_instancers->data_view_text, "text", false);
  232. RegisterDataViewInstancer(&default_instancers->data_view_value, "value", false);
  233. RegisterDataViewInstancer(&default_instancers->data_view_checked, "checked", false);
  234. RegisterDataViewInstancer(&default_instancers->structural_data_view_for, "for", true );
  235. // Data binding controllers
  236. RegisterDataControllerInstancer(&default_instancers->data_controller_value, "value");
  237. RegisterDataControllerInstancer(&default_instancers->data_controller_event, "event");
  238. RegisterDataControllerInstancer(&default_instancers->data_controller_checked, "checked");
  239. // XML node handlers
  240. XMLParser::RegisterNodeHandler("", MakeShared<XMLNodeHandlerDefault>());
  241. XMLParser::RegisterNodeHandler("body", MakeShared<XMLNodeHandlerBody>());
  242. XMLParser::RegisterNodeHandler("head", MakeShared<XMLNodeHandlerHead>());
  243. XMLParser::RegisterNodeHandler("template", MakeShared<XMLNodeHandlerTemplate>());
  244. // XML node handlers for control elements
  245. XMLParser::RegisterNodeHandler("datagrid", MakeShared<XMLNodeHandlerDataGrid>());
  246. XMLParser::RegisterNodeHandler("tabset", MakeShared<XMLNodeHandlerTabSet>());
  247. XMLParser::RegisterNodeHandler("textarea", MakeShared<XMLNodeHandlerTextArea>());
  248. XMLParser::RegisterNodeHandler("select", MakeShared<XMLNodeHandlerSelect>());
  249. return true;
  250. }
  251. void Factory::Shutdown()
  252. {
  253. element_instancers.clear();
  254. decorator_instancers.clear();
  255. font_effect_instancers.clear();
  256. data_controller_instancers.clear();
  257. data_view_instancers.clear();
  258. structural_data_view_instancers.clear();
  259. structural_data_view_attribute_names.clear();
  260. context_instancer = nullptr;
  261. event_listener_instancer = nullptr;
  262. event_instancer = nullptr;
  263. XMLParser::ReleaseHandlers();
  264. default_instancers.reset();
  265. }
  266. // Registers the instancer to use when instancing contexts.
  267. void Factory::RegisterContextInstancer(ContextInstancer* instancer)
  268. {
  269. context_instancer = instancer;
  270. }
  271. // Instances a new context.
  272. ContextPtr Factory::InstanceContext(const String& name)
  273. {
  274. ContextPtr new_context = context_instancer->InstanceContext(name);
  275. if (new_context)
  276. new_context->SetInstancer(context_instancer);
  277. return new_context;
  278. }
  279. void Factory::RegisterElementInstancer(const String& name, ElementInstancer* instancer)
  280. {
  281. element_instancers[StringUtilities::ToLower(name)] = instancer;
  282. }
  283. // Looks up the instancer for the given element
  284. ElementInstancer* Factory::GetElementInstancer(const String& tag)
  285. {
  286. ElementInstancerMap::iterator instancer_iterator = element_instancers.find(tag);
  287. if (instancer_iterator == element_instancers.end())
  288. {
  289. instancer_iterator = element_instancers.find("*");
  290. if (instancer_iterator == element_instancers.end())
  291. return nullptr;
  292. }
  293. return instancer_iterator->second;
  294. }
  295. // Instances a single element.
  296. ElementPtr Factory::InstanceElement(Element* parent, const String& instancer_name, const String& tag, const XMLAttributes& attributes)
  297. {
  298. ElementInstancer* instancer = GetElementInstancer(instancer_name);
  299. if (instancer)
  300. {
  301. ElementPtr element = instancer->InstanceElement(parent, tag, attributes);
  302. // Process the generic attributes and bind any events
  303. if (element)
  304. {
  305. element->SetInstancer(instancer);
  306. element->SetAttributes(attributes);
  307. ElementUtilities::BindEventAttributes(element.get());
  308. PluginRegistry::NotifyElementCreate(element.get());
  309. }
  310. return element;
  311. }
  312. return nullptr;
  313. }
  314. // Instances a single text element containing a string.
  315. bool Factory::InstanceElementText(Element* parent, const String& in_text)
  316. {
  317. RMLUI_ASSERT(parent);
  318. String text;
  319. if (SystemInterface* system_interface = GetSystemInterface())
  320. system_interface->TranslateString(text, in_text);
  321. // If this text node only contains white-space we don't want to construct it.
  322. const bool only_white_space = std::all_of(text.begin(), text.end(), &StringUtilities::IsWhitespace);
  323. if (only_white_space)
  324. return true;
  325. // See if we need to parse it as RML, and whether the text contains data expressions (curly brackets).
  326. bool parse_as_rml = false;
  327. bool has_data_expression = false;
  328. bool inside_brackets = false;
  329. bool inside_string = false;
  330. char previous = 0;
  331. for (const char c : text)
  332. {
  333. const char* error_str = XMLParseTools::ParseDataBrackets(inside_brackets, inside_string, c, previous);
  334. if (error_str)
  335. {
  336. Log::Message(Log::LT_WARNING, "Failed to instance text element '%s'. %s", text.c_str(), error_str);
  337. return false;
  338. }
  339. if (inside_brackets)
  340. has_data_expression = true;
  341. else if (c == '<')
  342. parse_as_rml = true;
  343. previous = c;
  344. }
  345. // If the text contains RML elements then run it through the XML parser again.
  346. if (parse_as_rml)
  347. {
  348. RMLUI_ZoneScopedNC("InstanceStream", 0xDC143C);
  349. auto stream = MakeUnique<StreamMemory>(text.size() + 32);
  350. Context* context = parent->GetContext();
  351. String tag = context ? context->GetDocumentsBaseTag() : "body";
  352. String open_tag = "<" + tag + ">";
  353. String close_tag = "</" + tag + ">";
  354. stream->Write(open_tag.c_str(), open_tag.size());
  355. stream->Write(text);
  356. stream->Write(close_tag.c_str(), close_tag.size());
  357. stream->Seek(0, SEEK_SET);
  358. InstanceElementStream(parent, stream.get());
  359. }
  360. else
  361. {
  362. RMLUI_ZoneScopedNC("InstanceText", 0x8FBC8F);
  363. // Attempt to instance the element.
  364. XMLAttributes attributes;
  365. // If we have curly brackets in the text, we tag the element so that the appropriate data view (DataViewText) is constructed.
  366. if (has_data_expression)
  367. attributes.emplace("data-text", Variant());
  368. ElementPtr element = Factory::InstanceElement(parent, "#text", "#text", attributes);
  369. if (!element)
  370. {
  371. Log::Message(Log::LT_ERROR, "Failed to instance text element '%s', instancer returned nullptr.", text.c_str());
  372. return false;
  373. }
  374. // Assign the element its text value.
  375. ElementText* text_element = rmlui_dynamic_cast< ElementText* >(element.get());
  376. if (!text_element)
  377. {
  378. Log::Message(Log::LT_ERROR, "Failed to instance text element '%s'. Found type '%s', was expecting a derivative of ElementText.", text.c_str(), rmlui_type_name(*element));
  379. return false;
  380. }
  381. text_element->SetText(text);
  382. // Add to active node.
  383. parent->AppendChild(std::move(element));
  384. }
  385. return true;
  386. }
  387. // Instances a element tree based on the stream
  388. bool Factory::InstanceElementStream(Element* parent, Stream* stream)
  389. {
  390. XMLParser parser(parent);
  391. parser.Parse(stream);
  392. return true;
  393. }
  394. // Instances a element tree based on the stream
  395. ElementPtr Factory::InstanceDocumentStream(Context* context, Stream* stream, const String& document_base_tag)
  396. {
  397. RMLUI_ZoneScoped;
  398. ElementPtr element = Factory::InstanceElement(nullptr, document_base_tag, document_base_tag, XMLAttributes());
  399. if (!element)
  400. {
  401. Log::Message(Log::LT_ERROR, "Failed to instance document, instancer returned nullptr.");
  402. return nullptr;
  403. }
  404. ElementDocument* document = rmlui_dynamic_cast< ElementDocument* >(element.get());
  405. if (!document)
  406. {
  407. Log::Message(Log::LT_ERROR, "Failed to instance document element. Found type '%s', was expecting derivative of ElementDocument.", rmlui_type_name(*element));
  408. return nullptr;
  409. }
  410. document->context = context;
  411. XMLParser parser(element.get());
  412. parser.Parse(stream);
  413. return element;
  414. }
  415. // Registers an instancer that will be used to instance decorators.
  416. void Factory::RegisterDecoratorInstancer(const String& name, DecoratorInstancer* instancer)
  417. {
  418. RMLUI_ASSERT(instancer);
  419. decorator_instancers[StringUtilities::ToLower(name)] = instancer;
  420. }
  421. // Retrieves a decorator instancer registered with the factory.
  422. DecoratorInstancer* Factory::GetDecoratorInstancer(const String& name)
  423. {
  424. auto iterator = decorator_instancers.find(name);
  425. if (iterator == decorator_instancers.end())
  426. return nullptr;
  427. return iterator->second;
  428. }
  429. // Registers an instancer that will be used to instance font effects.
  430. void Factory::RegisterFontEffectInstancer(const String& name, FontEffectInstancer* instancer)
  431. {
  432. RMLUI_ASSERT(instancer);
  433. font_effect_instancers[StringUtilities::ToLower(name)] = instancer;
  434. }
  435. FontEffectInstancer* Factory::GetFontEffectInstancer(const String& name)
  436. {
  437. auto iterator = font_effect_instancers.find(name);
  438. if (iterator == font_effect_instancers.end())
  439. return nullptr;
  440. return iterator->second;
  441. }
  442. // Creates a style sheet containing the passed in styles.
  443. SharedPtr<StyleSheetContainer> Factory::InstanceStyleSheetString(const String& string)
  444. {
  445. auto memory_stream = MakeUnique<StreamMemory>((const byte*) string.c_str(), string.size());
  446. return InstanceStyleSheetStream(memory_stream.get());
  447. }
  448. // Creates a style sheet from a file.
  449. SharedPtr<StyleSheetContainer> Factory::InstanceStyleSheetFile(const String& file_name)
  450. {
  451. auto file_stream = MakeUnique<StreamFile>();
  452. file_stream->Open(file_name);
  453. return InstanceStyleSheetStream(file_stream.get());
  454. }
  455. // Creates a style sheet from an Stream.
  456. SharedPtr<StyleSheetContainer> Factory::InstanceStyleSheetStream(Stream* stream)
  457. {
  458. SharedPtr<StyleSheetContainer> style_sheet_container = MakeShared<StyleSheetContainer>();
  459. if (style_sheet_container->LoadStyleSheetContainer(stream))
  460. {
  461. return style_sheet_container;
  462. }
  463. return nullptr;
  464. }
  465. // Clears the style sheet cache. This will force style sheets to be reloaded.
  466. void Factory::ClearStyleSheetCache()
  467. {
  468. StyleSheetFactory::ClearStyleSheetCache();
  469. }
  470. /// Clears the template cache. This will force templates to be reloaded.
  471. void Factory::ClearTemplateCache()
  472. {
  473. TemplateCache::Clear();
  474. }
  475. // Registers an instancer for all RmlEvents
  476. void Factory::RegisterEventInstancer(EventInstancer* instancer)
  477. {
  478. event_instancer = instancer;
  479. }
  480. // Instance an event object.
  481. EventPtr Factory::InstanceEvent(Element* target, EventId id, const String& type, const Dictionary& parameters, bool interruptible)
  482. {
  483. EventPtr event = event_instancer->InstanceEvent(target, id, type, parameters, interruptible);
  484. if (event)
  485. event->instancer = event_instancer;
  486. return event;
  487. }
  488. // Register an instancer for all event listeners
  489. void Factory::RegisterEventListenerInstancer(EventListenerInstancer* instancer)
  490. {
  491. event_listener_instancer = instancer;
  492. }
  493. // Instance an event listener with the given string
  494. EventListener* Factory::InstanceEventListener(const String& value, Element* element)
  495. {
  496. // If we have an event listener instancer, use it
  497. if (event_listener_instancer)
  498. return event_listener_instancer->InstanceEventListener(value, element);
  499. return nullptr;
  500. }
  501. void Factory::RegisterDataViewInstancer(DataViewInstancer* instancer, const String& name, bool is_structural_view)
  502. {
  503. bool inserted = false;
  504. if (is_structural_view)
  505. {
  506. inserted = structural_data_view_instancers.emplace(name, instancer).second;
  507. if (inserted)
  508. structural_data_view_attribute_names.push_back(String("data-") + name);
  509. }
  510. else
  511. {
  512. inserted = data_view_instancers.emplace(name, instancer).second;
  513. }
  514. if (!inserted)
  515. Log::Message(Log::LT_WARNING, "Could not register data view instancer '%s'. The given name is already registered.", name.c_str());
  516. }
  517. void Factory::RegisterDataControllerInstancer(DataControllerInstancer* instancer, const String& name)
  518. {
  519. bool inserted = data_controller_instancers.emplace(name, instancer).second;
  520. if (!inserted)
  521. Log::Message(Log::LT_WARNING, "Could not register data controller instancer '%s'. The given name is already registered.", name.c_str());
  522. }
  523. DataViewPtr Factory::InstanceDataView(const String& type_name, Element* element, bool is_structural_view)
  524. {
  525. RMLUI_ASSERT(element);
  526. if (is_structural_view)
  527. {
  528. auto it = structural_data_view_instancers.find(type_name);
  529. if (it != structural_data_view_instancers.end())
  530. return it->second->InstanceView(element);
  531. }
  532. else
  533. {
  534. auto it = data_view_instancers.find(type_name);
  535. if (it != data_view_instancers.end())
  536. return it->second->InstanceView(element);
  537. }
  538. return nullptr;
  539. }
  540. DataControllerPtr Factory::InstanceDataController(const String& type_name, Element* element)
  541. {
  542. auto it = data_controller_instancers.find(type_name);
  543. if (it != data_controller_instancers.end())
  544. return it->second->InstanceController(element);
  545. return DataControllerPtr();
  546. }
  547. bool Factory::IsStructuralDataView(const String& type_name)
  548. {
  549. return structural_data_view_instancers.find(type_name) != structural_data_view_instancers.end();
  550. }
  551. const StringList& Factory::GetStructuralDataViewAttributeNames()
  552. {
  553. return structural_data_view_attribute_names;
  554. }
  555. } // namespace Rml