guiAPI.cpp 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449
  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. String dsr::component_getProperty(const Component& component, const ReadableString& propertyName, bool mustExist) {
  245. MUST_EXIST(component, component_getProperty);
  246. Persistent* target = component->findAttribute(propertyName);
  247. if (target == nullptr) {
  248. if (mustExist) {
  249. throwError("component_getProperty: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  250. }
  251. return U"";
  252. } else {
  253. return target->toString();
  254. }
  255. }
  256. ReturnCode dsr::component_setProperty_string(const Component& component, const ReadableString& propertyName, const ReadableString& value, bool mustAssign) {
  257. MUST_EXIST(component, component_setProperty_string);
  258. Persistent* target = component->findAttribute(propertyName);
  259. PersistentString* stringTarget = dynamic_cast<PersistentString*>(target);
  260. if (target == nullptr) {
  261. if (mustAssign) {
  262. throwError("component_setProperty_string: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  263. }
  264. return ReturnCode::KeyNotFound;
  265. } else if (stringTarget == nullptr) {
  266. if (mustAssign) {
  267. throwError("component_setProperty_string: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of a string.\n");
  268. }
  269. return ReturnCode::KeyNotFound;
  270. } else {
  271. stringTarget->value = value;
  272. component->changedAttribute(propertyName);
  273. return ReturnCode::Good;
  274. }
  275. }
  276. String dsr::component_getProperty_string(const Component& component, const ReadableString& propertyName, bool mustExist) {
  277. MUST_EXIST(component, component_getProperty_string);
  278. Persistent* target = component->findAttribute(propertyName);
  279. PersistentString* stringTarget = dynamic_cast<PersistentString*>(target);
  280. if (target == nullptr) {
  281. if (mustExist) {
  282. throwError("component_getProperty_string: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  283. }
  284. return U"";
  285. } else if (stringTarget == nullptr) {
  286. if (mustExist) {
  287. throwError("component_getProperty_string: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of a string.\n");
  288. }
  289. return U"";
  290. } else {
  291. return stringTarget->value;
  292. }
  293. }
  294. ReturnCode dsr::component_setProperty_integer(const Component& component, const ReadableString& propertyName, int64_t value, bool mustAssign) {
  295. MUST_EXIST(component, component_setProperty_integer);
  296. Persistent* target = component->findAttribute(propertyName);
  297. if (target == nullptr) {
  298. if (mustAssign) {
  299. throwError("component_setProperty_integer: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  300. }
  301. return ReturnCode::KeyNotFound;
  302. } else {
  303. PersistentInteger* integerTarget = dynamic_cast<PersistentInteger*>(target);
  304. PersistentBoolean* booleanTarget = dynamic_cast<PersistentBoolean*>(target);
  305. if (integerTarget != nullptr) {
  306. integerTarget->value = value;
  307. component->changedAttribute(propertyName);
  308. return ReturnCode::Good;
  309. } else if (booleanTarget != nullptr) {
  310. booleanTarget->value = value ? 1 : 0;
  311. component->changedAttribute(propertyName);
  312. return ReturnCode::Good;
  313. } else {
  314. if (mustAssign) {
  315. throwError("component_setProperty_integer: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of an integer or boolean.\n");
  316. }
  317. return ReturnCode::KeyNotFound;
  318. }
  319. }
  320. }
  321. int64_t dsr::component_getProperty_integer(const Component& component, const ReadableString& propertyName, bool mustExist, int64_t defaultValue) {
  322. MUST_EXIST(component, component_getProperty_integer);
  323. Persistent* target = component->findAttribute(propertyName);
  324. if (target == nullptr) {
  325. if (mustExist) {
  326. throwError("component_getProperty_integer: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  327. }
  328. return defaultValue;
  329. } else {
  330. PersistentInteger* integerTarget = dynamic_cast<PersistentInteger*>(target);
  331. PersistentBoolean* booleanTarget = dynamic_cast<PersistentBoolean*>(target);
  332. if (integerTarget != nullptr) {
  333. return integerTarget->value;
  334. } else if (booleanTarget != nullptr) {
  335. return booleanTarget->value;
  336. } else {
  337. if (mustExist) {
  338. throwError("component_getProperty_integer: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of an integer or boolean.\n");
  339. }
  340. return defaultValue;
  341. }
  342. }
  343. }
  344. ReturnCode dsr::component_setProperty_image(const Component& component, const ReadableString& propertyName, const OrderedImageRgbaU8& value, bool mustAssign) {
  345. MUST_EXIST(component, component_setProperty_image);
  346. Persistent* target = component->findAttribute(propertyName);
  347. if (target == nullptr) {
  348. if (mustAssign) {
  349. throwError("component_setProperty_image: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  350. }
  351. return ReturnCode::KeyNotFound;
  352. } else {
  353. PersistentImage* imageTarget = dynamic_cast<PersistentImage*>(target);
  354. if (imageTarget != nullptr) {
  355. imageTarget->value = value;
  356. component->changedAttribute(propertyName);
  357. return ReturnCode::Good;
  358. } else {
  359. if (mustAssign) {
  360. throwError("component_setProperty_image: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of an image.\n");
  361. }
  362. return ReturnCode::KeyNotFound;
  363. }
  364. }
  365. }
  366. OrderedImageRgbaU8 dsr::component_getProperty_image(const Component& component, const ReadableString& propertyName, bool mustExist) {
  367. MUST_EXIST(component, component_getProperty_image);
  368. Persistent* target = component->findAttribute(propertyName);
  369. if (target == nullptr) {
  370. if (mustExist) {
  371. throwError("component_getProperty_image: ", propertyName, " in ", component->getClassName(), " could not be found.\n");
  372. }
  373. return OrderedImageRgbaU8();
  374. } else {
  375. PersistentImage* imageTarget = dynamic_cast<PersistentImage*>(target);
  376. if (imageTarget != nullptr) {
  377. return imageTarget->value;
  378. } else {
  379. if (mustExist) {
  380. throwError("component_getProperty_image: ", propertyName, " in ", component->getClassName(), " was a ", target->getClassName(), " instead of an image.\n");
  381. }
  382. return OrderedImageRgbaU8();
  383. }
  384. }
  385. }
  386. String dsr::component_call(const Component& component, const ReadableString& methodName, const ReadableString& arguments) {
  387. MUST_EXIST(component, component_call);
  388. return component->call(methodName, arguments);
  389. }
  390. String dsr::component_call(const Component& component, const ReadableString& methodName) {
  391. return component_call(component, methodName, U"");
  392. }
  393. void dsr::component_detachFromParent(const Component& component) {
  394. MUST_EXIST(component, component_detachFromParent);
  395. component->detachFromParent();
  396. }
  397. Component dsr::component_create(const Component& parent, const ReadableString& className, const ReadableString& identifierName, int index) {
  398. // Making sure that the default components exist before trying to create a component manually.
  399. gui_initialize();
  400. // Creating a component from the name
  401. Component child = std::dynamic_pointer_cast<VisualComponent>(createPersistentClass(className));
  402. if (child) {
  403. child->setName(identifierName);
  404. child->setIndex(index);
  405. // Attaching to a parent is optional, but convenient to do in the same call.
  406. if (parent) {
  407. parent->addChildComponent(child);
  408. }
  409. }
  410. return child;
  411. }
  412. void dsr::window_applyTheme(const Window& window, const VisualTheme& theme) {
  413. MUST_EXIST(window, window_applyTheme);
  414. MUST_EXIST(theme, window_applyTheme);
  415. window->applyTheme(theme);
  416. }