guiAPI.cpp 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453
  1. 
  2. // zlib open source license
  3. //
  4. // Copyright (c) 2019 David Forsgren Piuva
  5. //
  6. // This software is provided 'as-is', without any express or implied
  7. // warranty. In no event will the authors be held liable for any damages
  8. // arising from the use of this software.
  9. //
  10. // Permission is granted to anyone to use this software for any purpose,
  11. // including commercial applications, and to alter it and redistribute it
  12. // freely, subject to the following restrictions:
  13. //
  14. // 1. The origin of this software must not be misrepresented; you must not
  15. // claim that you wrote the original software. If you use this software
  16. // in a product, an acknowledgment in the product documentation would be
  17. // appreciated but is not required.
  18. //
  19. // 2. Altered source versions must be plainly marked as such, and must not be
  20. // misrepresented as being the original software.
  21. //
  22. // 3. This notice may not be removed or altered from any source
  23. // distribution.
  24. #define DFPSR_INTERNAL_ACCESS
  25. #include "guiAPI.h"
  26. #include "timeAPI.h"
  27. #include "../gui/DsrWindow.h"
  28. #include "fileAPI.h"
  29. using namespace dsr;
  30. // To be implemented outside of the core framework
  31. std::shared_ptr<dsr::BackendWindow> createBackendWindow(const dsr::String& title, int width, int height);
  32. #define MUST_EXIST(OBJECT, METHOD) if (OBJECT.get() == nullptr) { throwError("The " #OBJECT " handle was null in " #METHOD "\n"); }
  33. Window dsr::window_create(const String& title, int32_t width, int32_t height) {
  34. if (width < 1) { width = 1; }
  35. if (height < 1) { height = 1; }
  36. std::shared_ptr<dsr::BackendWindow> backend = createBackendWindow(title, width, height);
  37. if (backend.get() != nullptr) {
  38. return std::make_shared<DsrWindow>(backend);
  39. } else {
  40. return std::shared_ptr<DsrWindow>();
  41. }
  42. }
  43. Window dsr::window_create_fullscreen(const String& title) {
  44. return std::make_shared<DsrWindow>(createBackendWindow(title, 0, 0));
  45. }
  46. bool dsr::window_exists(const Window& window) {
  47. return window.get() != nullptr;
  48. }
  49. bool dsr::component_exists(const Component& component) {
  50. return component.get() != nullptr;
  51. }
  52. void dsr::window_loadInterfaceFromString(const Window& window, const String& content, const ReadableString &fromPath) {
  53. MUST_EXIST(window, window_loadInterfaceFromString);
  54. window->loadInterfaceFromString(content, fromPath);
  55. }
  56. void dsr::window_loadInterfaceFromString(const Window& window, const String& content) {
  57. MUST_EXIST(window, window_loadInterfaceFromString);
  58. window->loadInterfaceFromString(content, file_getCurrentPath());
  59. }
  60. void dsr::window_loadInterfaceFromFile(const Window& window, const ReadableString& filename) {
  61. MUST_EXIST(window, window_loadInterfaceFromFile);
  62. window->loadInterfaceFromString(string_load(filename), file_getRelativeParentFolder(filename));
  63. }
  64. String dsr::window_saveInterfaceToString(const Window& window) {
  65. MUST_EXIST(window, window_saveInterfaceToString);
  66. return window->saveInterfaceToString();
  67. }
  68. Component dsr::window_getRoot(const Window& window) {
  69. MUST_EXIST(window, window_getRoot);
  70. return window->getRootComponent();
  71. }
  72. Component dsr::window_findComponentByName(const Window& window, const ReadableString& name, bool mustExist) {
  73. MUST_EXIST(window, window_findComponentByName);
  74. Component result = window->findComponentByName(name);
  75. if (mustExist && result.get() == nullptr) {
  76. throwError(U"window_findComponentByName: No child component named ", name, " found!");
  77. }
  78. return result;
  79. }
  80. Component dsr::window_findComponentByNameAndIndex(const Window& window, const ReadableString& name, int index, bool mustExist) {
  81. MUST_EXIST(window, window_findComponentByNameAndIndex);
  82. Component result = window->findComponentByNameAndIndex(name, index);
  83. if (mustExist && result.get() == nullptr) {
  84. throwError(U"window_findComponentByName: No child component named ", name, " with index ", index, " found!");
  85. }
  86. return result;
  87. }
  88. int dsr::component_getChildCount(const Component& parent) {
  89. if (parent.get()) {
  90. return parent->getChildCount();
  91. } else {
  92. return -1;
  93. }
  94. }
  95. Component dsr::component_getChild(const Component& parent, int childIndex) {
  96. if (parent.get()) {
  97. return std::dynamic_pointer_cast<VisualComponent>(parent->getChild(childIndex));
  98. } else {
  99. return std::shared_ptr<VisualComponent>(); // Null handle
  100. }
  101. }
  102. static void findAllComponentsByName(const Component& component, const ReadableString& name, std::function<void(Component, int)> callback) {
  103. if (component_exists(component)) {
  104. // Check if the current component matches
  105. if (string_match(component->getName(), name)) {
  106. callback(component, component->getIndex());
  107. }
  108. // Search among child components
  109. int childCount = component_getChildCount(component);
  110. for (int childIndex = childCount - 1; childIndex >= 0; childIndex--) {
  111. findAllComponentsByName(component_getChild(component, childIndex), name, callback);
  112. }
  113. }
  114. }
  115. void dsr::window_findAllComponentsByName(const Window& window, const ReadableString& name, std::function<void(Component, int)> callback) {
  116. MUST_EXIST(window, window_findAllComponentsByName);
  117. findAllComponentsByName(window->getRootComponent(), name, callback);
  118. }
  119. bool dsr::window_executeEvents(const Window& window) {
  120. MUST_EXIST(window, window_executeEvents);
  121. return window->executeEvents();
  122. }
  123. void dsr::window_drawComponents(const Window& window) {
  124. MUST_EXIST(window, window_drawComponents);
  125. window->drawComponents();
  126. }
  127. void dsr::window_showCanvas(const Window& window) {
  128. MUST_EXIST(window, window_showCanvas);
  129. window->showCanvas();
  130. }
  131. int dsr::window_getPixelScale(const Window& window) {
  132. MUST_EXIST(window, window_getPixelScale);
  133. return window->getPixelScale();
  134. }
  135. void dsr::window_setPixelScale(const Window& window, int scale) {
  136. MUST_EXIST(window, window_setPixelScale);
  137. window->setPixelScale(scale);
  138. }
  139. void dsr::window_setFullScreen(const Window& window, bool enabled) {
  140. MUST_EXIST(window, window_setFullScreen);
  141. window->setFullScreen(enabled);
  142. }
  143. bool dsr::window_isFullScreen(const Window& window) {
  144. MUST_EXIST(window, window_isFullScreen);
  145. return window->isFullScreen();
  146. }
  147. AlignedImageRgbaU8 dsr::window_getCanvas(const Window& window) {
  148. MUST_EXIST(window, window_getCanvas);
  149. return window->getCanvas();
  150. }
  151. AlignedImageF32 dsr::window_getDepthBuffer(const Window& window) {
  152. MUST_EXIST(window, window_getDepthBuffer);
  153. return window->getDepthBuffer();
  154. }
  155. int dsr::window_getCanvasWidth(const Window& window) {
  156. MUST_EXIST(window, window_getCanvasWidth);
  157. return window->getCanvasWidth();
  158. }
  159. int dsr::window_getCanvasHeight(const Window& window) {
  160. MUST_EXIST(window, window_getCanvasHeight);
  161. return window->getCanvasHeight();
  162. }
  163. int dsr::window_getInnerWidth(const Window& window) {
  164. MUST_EXIST(window, window_getInnerWidth);
  165. return window->getInnerWidth();
  166. }
  167. int dsr::window_getInnerHeight(const Window& window) {
  168. MUST_EXIST(window, window_getInnerHeight);
  169. return window->getInnerHeight();
  170. }
  171. void dsr::window_setMouseEvent(const Window& window, const MouseCallback& mouseEvent) {
  172. MUST_EXIST(window, window_setMouseEvent);
  173. window->windowMouseEvent() = mouseEvent;
  174. }
  175. void dsr::window_setKeyboardEvent(const Window& window, const KeyboardCallback& keyboardEvent) {
  176. MUST_EXIST(window, window_setKeyboardEvent);
  177. window->windowKeyboardEvent() = keyboardEvent;
  178. }
  179. void dsr::window_setCloseEvent(const Window& window, const EmptyCallback& closeEvent) {
  180. MUST_EXIST(window, window_setCloseEvent);
  181. window->windowCloseEvent() = closeEvent;
  182. }
  183. void dsr::component_setPressedEvent(const Component& component, const EmptyCallback& event) {
  184. MUST_EXIST(component, component_setPressedEvent);
  185. component->pressedEvent() = event;
  186. }
  187. void dsr::component_setMouseDownEvent(const Component& component, const MouseCallback& mouseEvent) {
  188. MUST_EXIST(component, component_setMouseDownEvent);
  189. component->mouseDownEvent() = mouseEvent;
  190. }
  191. void dsr::component_setMouseUpEvent(const Component& component, const MouseCallback& mouseEvent) {
  192. MUST_EXIST(component, component_setMouseUpEvent);
  193. component->mouseUpEvent() = mouseEvent;
  194. }
  195. void dsr::component_setMouseMoveEvent(const Component& component, const MouseCallback& mouseEvent) {
  196. MUST_EXIST(component, component_setMouseMoveEvent);
  197. component->mouseMoveEvent() = mouseEvent;
  198. }
  199. void dsr::component_setMouseScrollEvent(const Component& component, const MouseCallback& mouseEvent) {
  200. MUST_EXIST(component, component_setMouseScrollEvent);
  201. component->mouseScrollEvent() = mouseEvent;
  202. }
  203. void dsr::component_setKeyDownEvent(const Component& component, const KeyboardCallback& keyboardEvent) {
  204. MUST_EXIST(component, component_setKeyDownEvent);
  205. component->keyDownEvent() = keyboardEvent;
  206. }
  207. void dsr::component_setKeyUpEvent(const Component& component, const KeyboardCallback& keyboardEvent) {
  208. MUST_EXIST(component, component_setKeyUpEvent);
  209. component->keyUpEvent() = keyboardEvent;
  210. }
  211. void dsr::component_setKeyTypeEvent(const Component& component, const KeyboardCallback& keyboardEvent) {
  212. MUST_EXIST(component, component_setKeyTypeEvent);
  213. component->keyTypeEvent() = keyboardEvent;
  214. }
  215. void dsr::component_setSelectEvent(const Component& component, const IndexCallback& selectEvent) {
  216. MUST_EXIST(component, component_setKeyTypeEvent);
  217. component->selectEvent() = selectEvent;
  218. }
  219. bool dsr::component_hasProperty(const Component& component, const ReadableString& propertyName) {
  220. MUST_EXIST(component, component_hasProperty);
  221. Persistent* target = component->findAttribute(propertyName);
  222. return target != nullptr;
  223. }
  224. ReturnCode dsr::component_setProperty(const Component& component, const ReadableString& propertyName, const ReadableString& value, const ReadableString& fromPath, bool mustAssign) {
  225. MUST_EXIST(component, component_setProperty);
  226. Persistent* target = component->findAttribute(propertyName);
  227. if (target == nullptr) {
  228. if (mustAssign) {
  229. throwError("component_setProperty: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  230. }
  231. return ReturnCode::KeyNotFound;
  232. } else {
  233. if (target->assignValue(value, fromPath)) {
  234. component->changedAttribute(propertyName);
  235. return ReturnCode::Good;
  236. } else {
  237. if (mustAssign) {
  238. throwError("component_setProperty: The input ", value, " could not be assigned to property ", propertyName, " because of incorrect format.\n");
  239. }
  240. return ReturnCode::ParsingFailure;
  241. }
  242. }
  243. }
  244. ReturnCode dsr::component_setProperty(const Component& component, const ReadableString& propertyName, const ReadableString& value, bool mustAssign) {
  245. return component_setProperty(component, propertyName, value, file_getCurrentPath(), mustAssign);
  246. }
  247. String dsr::component_getProperty(const Component& component, const ReadableString& propertyName, bool mustExist) {
  248. MUST_EXIST(component, component_getProperty);
  249. Persistent* target = component->findAttribute(propertyName);
  250. if (target == nullptr) {
  251. if (mustExist) {
  252. throwError("component_getProperty: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  253. }
  254. return U"";
  255. } else {
  256. return target->toString();
  257. }
  258. }
  259. ReturnCode dsr::component_setProperty_string(const Component& component, const ReadableString& propertyName, const ReadableString& value, bool mustAssign) {
  260. MUST_EXIST(component, component_setProperty_string);
  261. Persistent* target = component->findAttribute(propertyName);
  262. PersistentString* stringTarget = dynamic_cast<PersistentString*>(target);
  263. if (target == nullptr) {
  264. if (mustAssign) {
  265. throwError("component_setProperty_string: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  266. }
  267. return ReturnCode::KeyNotFound;
  268. } else if (stringTarget == nullptr) {
  269. if (mustAssign) {
  270. throwError("component_setProperty_string: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of a string.\n");
  271. }
  272. return ReturnCode::KeyNotFound;
  273. } else {
  274. stringTarget->value = value;
  275. component->changedAttribute(propertyName);
  276. return ReturnCode::Good;
  277. }
  278. }
  279. String dsr::component_getProperty_string(const Component& component, const ReadableString& propertyName, bool mustExist) {
  280. MUST_EXIST(component, component_getProperty_string);
  281. Persistent* target = component->findAttribute(propertyName);
  282. PersistentString* stringTarget = dynamic_cast<PersistentString*>(target);
  283. if (target == nullptr) {
  284. if (mustExist) {
  285. throwError("component_getProperty_string: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  286. }
  287. return U"";
  288. } else if (stringTarget == nullptr) {
  289. if (mustExist) {
  290. throwError("component_getProperty_string: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of a string.\n");
  291. }
  292. return U"";
  293. } else {
  294. return stringTarget->value;
  295. }
  296. }
  297. ReturnCode dsr::component_setProperty_integer(const Component& component, const ReadableString& propertyName, int64_t value, bool mustAssign) {
  298. MUST_EXIST(component, component_setProperty_integer);
  299. Persistent* target = component->findAttribute(propertyName);
  300. if (target == nullptr) {
  301. if (mustAssign) {
  302. throwError("component_setProperty_integer: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  303. }
  304. return ReturnCode::KeyNotFound;
  305. } else {
  306. PersistentInteger* integerTarget = dynamic_cast<PersistentInteger*>(target);
  307. PersistentBoolean* booleanTarget = dynamic_cast<PersistentBoolean*>(target);
  308. if (integerTarget != nullptr) {
  309. integerTarget->value = value;
  310. component->changedAttribute(propertyName);
  311. return ReturnCode::Good;
  312. } else if (booleanTarget != nullptr) {
  313. booleanTarget->value = value ? 1 : 0;
  314. component->changedAttribute(propertyName);
  315. return ReturnCode::Good;
  316. } else {
  317. if (mustAssign) {
  318. throwError("component_setProperty_integer: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of an integer or boolean.\n");
  319. }
  320. return ReturnCode::KeyNotFound;
  321. }
  322. }
  323. }
  324. int64_t dsr::component_getProperty_integer(const Component& component, const ReadableString& propertyName, bool mustExist, int64_t defaultValue) {
  325. MUST_EXIST(component, component_getProperty_integer);
  326. Persistent* target = component->findAttribute(propertyName);
  327. if (target == nullptr) {
  328. if (mustExist) {
  329. throwError("component_getProperty_integer: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  330. }
  331. return defaultValue;
  332. } else {
  333. PersistentInteger* integerTarget = dynamic_cast<PersistentInteger*>(target);
  334. PersistentBoolean* booleanTarget = dynamic_cast<PersistentBoolean*>(target);
  335. if (integerTarget != nullptr) {
  336. return integerTarget->value;
  337. } else if (booleanTarget != nullptr) {
  338. return booleanTarget->value;
  339. } else {
  340. if (mustExist) {
  341. throwError("component_getProperty_integer: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of an integer or boolean.\n");
  342. }
  343. return defaultValue;
  344. }
  345. }
  346. }
  347. ReturnCode dsr::component_setProperty_image(const Component& component, const ReadableString& propertyName, const OrderedImageRgbaU8& value, bool mustAssign) {
  348. MUST_EXIST(component, component_setProperty_image);
  349. Persistent* target = component->findAttribute(propertyName);
  350. if (target == nullptr) {
  351. if (mustAssign) {
  352. throwError("component_setProperty_image: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  353. }
  354. return ReturnCode::KeyNotFound;
  355. } else {
  356. PersistentImage* imageTarget = dynamic_cast<PersistentImage*>(target);
  357. if (imageTarget != nullptr) {
  358. imageTarget->value = value;
  359. component->changedAttribute(propertyName);
  360. return ReturnCode::Good;
  361. } else {
  362. if (mustAssign) {
  363. throwError("component_setProperty_image: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of an image.\n");
  364. }
  365. return ReturnCode::KeyNotFound;
  366. }
  367. }
  368. }
  369. OrderedImageRgbaU8 dsr::component_getProperty_image(const Component& component, const ReadableString& propertyName, bool mustExist) {
  370. MUST_EXIST(component, component_getProperty_image);
  371. Persistent* target = component->findAttribute(propertyName);
  372. if (target == nullptr) {
  373. if (mustExist) {
  374. throwError("component_getProperty_image: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  375. }
  376. return OrderedImageRgbaU8();
  377. } else {
  378. PersistentImage* imageTarget = dynamic_cast<PersistentImage*>(target);
  379. if (imageTarget != nullptr) {
  380. return imageTarget->value;
  381. } else {
  382. if (mustExist) {
  383. throwError("component_getProperty_image: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of an image.\n");
  384. }
  385. return OrderedImageRgbaU8();
  386. }
  387. }
  388. }
  389. String dsr::component_call(const Component& component, const ReadableString& methodName, const ReadableString& arguments) {
  390. MUST_EXIST(component, component_call);
  391. return component->call(methodName, arguments);
  392. }
  393. String dsr::component_call(const Component& component, const ReadableString& methodName) {
  394. return component_call(component, methodName, U"");
  395. }
  396. void dsr::component_detachFromParent(const Component& component) {
  397. MUST_EXIST(component, component_detachFromParent);
  398. component->detachFromParent();
  399. }
  400. Component dsr::component_create(const Component& parent, const ReadableString& className, const ReadableString& identifierName, int index) {
  401. // Making sure that the default components exist before trying to create a component manually.
  402. gui_initialize();
  403. // Creating a component from the name
  404. Component child = std::dynamic_pointer_cast<VisualComponent>(createPersistentClass(className));
  405. if (child) {
  406. child->setName(identifierName);
  407. child->setIndex(index);
  408. // Attaching to a parent is optional, but convenient to do in the same call.
  409. if (parent) {
  410. parent->addChildComponent(child);
  411. }
  412. }
  413. return child;
  414. }
  415. void dsr::window_applyTheme(const Window& window, const VisualTheme& theme) {
  416. MUST_EXIST(window, window_applyTheme);
  417. MUST_EXIST(theme, window_applyTheme);
  418. window->applyTheme(theme);
  419. }