godot_c.h 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569
  1. /*************************************************************************/
  2. /* godot_c.h */
  3. /*************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /*************************************************************************/
  8. /* Copyright (c) 2007-2020 Juan Linietsky, Ariel Manzur. */
  9. /* Copyright (c) 2014-2020 Godot Engine contributors (cf. AUTHORS.md). */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /*************************************************************************/
  30. #ifndef GODOT_C_H
  31. #define GODOT_C_H
  32. #ifdef __cplusplus
  33. extern "C" {
  34. #endif
  35. #if defined(GDAPI_BUILT_IN) || !defined(WINDOWS_ENABLED)
  36. #define GDAPI
  37. #elif defined(GDAPI_EXPORTS)
  38. #define GDAPI __declspec(dllexport)
  39. #else
  40. #define GDAPI __declspec(dllimport)
  41. #endif
  42. #define GODOT_API_VERSION 1
  43. typedef int godot_bool;
  44. #define GODOT_FALSE 0
  45. #define GODOT_TRUE 1
  46. ////// Image
  47. #define GODOT_IMAGE_FORMAT_GRAYSCALE 0
  48. #define GODOT_IMAGE_FORMAT_INTENSITY 1
  49. #define GODOT_IMAGE_FORMAT_GRAYSCALE_ALPHA 2
  50. #define GODOT_IMAGE_FORMAT_RGB 3
  51. #define GODOT_IMAGE_FORMAT_RGBA 4
  52. #define GODOT_IMAGE_FORMAT_INDEXED 5
  53. #define GODOT_IMAGE_FORMAT_INDEXED_ALPHA 6
  54. #define GODOT_IMAGE_FORMAT_YUV_422 7
  55. #define GODOT_IMAGE_FORMAT_YUV_444 8
  56. #define GODOT_IMAGE_FORMAT_BC1 9
  57. #define GODOT_IMAGE_FORMAT_BC2 10
  58. #define GODOT_IMAGE_FORMAT_BC3 11
  59. #define GODOT_IMAGE_FORMAT_BC4 12
  60. #define GODOT_IMAGE_FORMAT_BC5 13
  61. #define GODOT_IMAGE_FORMAT_PVRTC2 14
  62. #define GODOT_IMAGE_FORMAT_PVRTC2_ALPHA 15
  63. #define GODOT_IMAGE_FORMAT_PVRTC4 16
  64. #define GODOT_IMAGE_FORMAT_PVRTC4_ALPHA 17
  65. #define GODOT_IMAGE_FORMAT_ETC 18
  66. #define GODOT_IMAGE_FORMAT_ATC 19
  67. #define GODOT_IMAGE_FORMAT_ATC_ALPHA_EXPLICIT 20
  68. #define GODOT_IMAGE_FORMAT_ATC_ALPHA_INTERPOLATED 21
  69. typedef void *godot_image;
  70. godot_image GDAPI godot_image_create_empty();
  71. godot_image GDAPI godot_image_create(int p_width, int p_height, int p_format, int p_use_mipmaps);
  72. godot_image GDAPI godot_image_create_with_data(int p_width, int p_height, int p_format, int p_use_mipmaps, unsigned char *p_buffer);
  73. int GDAPI godot_image_get_width(godot_image p_image);
  74. int GDAPI godot_image_get_height(godot_image p_image);
  75. int GDAPI godot_image_get_format(godot_image p_image);
  76. int GDAPI godot_image_get_mipmap_count(godot_image p_image);
  77. godot_image GDAPI godot_image_copy(godot_image p_image);
  78. void GDAPI godot_image_free(godot_image p_image);
  79. ////// RID
  80. typedef void *godot_rid;
  81. godot_rid GDAPI godot_rid_create();
  82. godot_rid GDAPI godot_rid_copy(godot_rid p_rid);
  83. void GDAPI godot_rid_free(godot_rid p_rid);
  84. ////// Variant (forward declared)
  85. typedef void *godot_variant;
  86. ////// Dictionary
  87. typedef void *godot_dictionary;
  88. godot_dictionary GDAPI godot_dictionary_create();
  89. void GDAPI godot_dictionary_has(godot_dictionary p_dictionary, godot_variant p_key);
  90. godot_variant GDAPI godot_dictionary_get(godot_dictionary p_dictionary, godot_variant p_key);
  91. void GDAPI godot_dictionary_insert(godot_dictionary p_dictionary, godot_variant p_key, godot_variant p_value);
  92. void GDAPI godot_dictionary_remove(godot_dictionary p_dictionary, godot_variant p_key);
  93. void GDAPI godot_dictionary_clear(godot_dictionary p_dictionary);
  94. int GDAPI godot_dictionary_get_size(godot_dictionary p_dictionary);
  95. void GDAPI godot_dictionary_get_keys(godot_dictionary p_dictionary, godot_variant *p_keys);
  96. godot_dictionary GDAPI godot_dictionary_copy(godot_dictionary p_dictionary);
  97. void GDAPI godot_dictionary_free(godot_dictionary p_dictionary);
  98. ////// Array
  99. typedef void *godot_array;
  100. godot_array GDAPI godot_array_create();
  101. godot_variant GDAPI godot_array_get(godot_array p_array, int p_index);
  102. void GDAPI godot_array_set(godot_array p_array, int p_index, godot_variant p_value);
  103. void GDAPI godot_array_resize(godot_array p_array, int p_size);
  104. void GDAPI godot_array_insert(godot_array p_array, int p_position, godot_variant p_value);
  105. void GDAPI godot_array_remove(godot_array p_array, int p_position);
  106. void GDAPI godot_array_clear(godot_array p_array);
  107. int GDAPI godot_array_get_size(godot_array p_array);
  108. int GDAPI godot_array_find(godot_array p_array, godot_variant p_value, int p_from_pos = -1);
  109. godot_array GDAPI godot_array_copy(godot_array p_array);
  110. void GDAPI godot_array_free(godot_array p_array);
  111. ////// InputEvent
  112. #define INPUT_EVENT_BUTTON_LEFT 1
  113. #define INPUT_EVENT_BUTTON_RIGHT 2
  114. #define INPUT_EVENT_BUTTON_MIDDLE 3
  115. #define INPUT_EVENT_BUTTON_WHEEL_UP 4
  116. #define INPUT_EVENT_BUTTON_WHEEL_DOWN 5
  117. #define INPUT_EVENT_BUTTON_WHEEL_LEFT 6
  118. #define INPUT_EVENT_BUTTON_WHEEL_RIGHT 7
  119. #define INPUT_EVENT_BUTTON_MASK_LEFT (1 << (INPUT_EVENT_BUTTON_LEFT - 1))
  120. #define INPUT_EVENT_BUTTON_MASK_RIGHT (1 << (INPUT_EVENT_BUTTON_RIGHT - 1))
  121. #define INPUT_EVENT_BUTTON_MASK_MIDDLE (1 << (INPUT_EVENT_BUTTON_MIDDLE - 1))
  122. #define INPUT_EVENT_TYPE_NONE 0
  123. #define INPUT_EVENT_TYPE_KEY 1
  124. #define INPUT_EVENT_TYPE_MOUSE_MOTION 2
  125. #define INPUT_EVENT_TYPE_MOUSE_BUTTON 3
  126. #define INPUT_EVENT_TYPE_JOYSTICK_MOTION 4
  127. #define INPUT_EVENT_TYPE_JOYSTICK_BUTTON 5
  128. #define INPUT_EVENT_TYPE_SCREEN_TOUCH 6
  129. #define INPUT_EVENT_TYPE_SCREEN_DRAG 7
  130. #define INPUT_EVENT_TYPE_ACTION 8
  131. typedef void *godot_input_event;
  132. godot_input_event GDAPI godot_input_event_create();
  133. godot_input_event GDAPI godot_input_event_copy(godot_input_event p_input_event);
  134. void GDAPI godot_input_event_free(godot_input_event p_input_event);
  135. int GDAPI godot_input_event_get_type(godot_input_event p_event);
  136. int GDAPI godot_input_event_get_device(godot_input_event p_event);
  137. godot_bool GDAPI godot_input_event_mod_has_alt(godot_input_event p_event);
  138. godot_bool GDAPI godot_input_event_mod_has_ctrl(godot_input_event p_event);
  139. godot_bool GDAPI godot_input_event_mod_has_command(godot_input_event p_event);
  140. godot_bool GDAPI godot_input_event_mod_has_shift(godot_input_event p_event);
  141. godot_bool GDAPI godot_input_event_mod_has_meta(godot_input_event p_event);
  142. int GDAPI godot_input_event_key_get_scancode(godot_input_event p_event);
  143. int GDAPI godot_input_event_key_get_unicode(godot_input_event p_event);
  144. godot_bool GDAPI godot_input_event_key_is_pressed(godot_input_event p_event);
  145. godot_bool GDAPI godot_input_event_key_is_echo(godot_input_event p_event);
  146. int GDAPI godot_input_event_mouse_get_x(godot_input_event p_event);
  147. int GDAPI godot_input_event_mouse_get_y(godot_input_event p_event);
  148. int GDAPI godot_input_event_mouse_get_global_x(godot_input_event p_event);
  149. int GDAPI godot_input_event_mouse_get_global_y(godot_input_event p_event);
  150. int GDAPI godot_input_event_mouse_get_button_mask(godot_input_event p_event);
  151. int GDAPI godot_input_event_mouse_button_get_button_index(godot_input_event p_event);
  152. godot_bool GDAPI godot_input_event_mouse_button_is_pressed(godot_input_event p_event);
  153. godot_bool GDAPI godot_input_event_mouse_button_is_doubleclick(godot_input_event p_event);
  154. int GDAPI godot_input_event_mouse_motion_get_relative_x(godot_input_event p_event);
  155. int GDAPI godot_input_event_mouse_motion_get_relative_y(godot_input_event p_event);
  156. int GDAPI godot_input_event_mouse_motion_get_speed_x(godot_input_event p_event);
  157. int GDAPI godot_input_event_mouse_motion_get_speed_y(godot_input_event p_event);
  158. int GDAPI godot_input_event_joystick_motion_get_axis(godot_input_event p_event);
  159. float GDAPI godot_input_event_joystick_motion_get_axis_value(godot_input_event p_event);
  160. int GDAPI godot_input_event_joystick_button_get_button_index(godot_input_event p_event);
  161. godot_bool GDAPI godot_input_event_joystick_button_is_pressed(godot_input_event p_event);
  162. float GDAPI godot_input_event_joystick_button_get_pressure(godot_input_event p_event);
  163. int GDAPI godot_input_event_screen_touch_get_index(godot_input_event p_event);
  164. int GDAPI godot_input_event_screen_touch_get_x(godot_input_event p_event);
  165. int GDAPI godot_input_event_screen_touch_get_y(godot_input_event p_event);
  166. int GDAPI godot_input_event_screen_touch_is_pressed(godot_input_event p_event);
  167. int GDAPI godot_input_event_screen_drag_get_index(godot_input_event p_event);
  168. int GDAPI godot_input_event_screen_drag_get_x(godot_input_event p_event);
  169. int GDAPI godot_input_event_screen_drag_get_y(godot_input_event p_event);
  170. int GDAPI godot_input_event_screen_drag_get_relative_x(godot_input_event p_event);
  171. int GDAPI godot_input_event_screen_drag_get_relative_y(godot_input_event p_event);
  172. int GDAPI godot_input_event_screen_drag_get_speed_x(godot_input_event p_event);
  173. int GDAPI godot_input_event_screen_drag_get_speed_y(godot_input_event p_event);
  174. int GDAPI godot_input_event_is_action(godot_input_event p_event, char *p_action);
  175. int GDAPI godot_input_event_is_action_pressed(godot_input_event p_event, char *p_action);
  176. ////// ByteArray
  177. typedef void *godot_byte_array;
  178. godot_byte_array GDAPI godot_byte_array_create();
  179. godot_byte_array GDAPI godot_byte_array_copy(godot_byte_array p_byte_array);
  180. void GDAPI godot_byte_array_free(godot_byte_array p_byte_array);
  181. int GDAPI godot_byte_array_get_size(godot_byte_array p_byte_array);
  182. unsigned char GDAPI godot_byte_array_get(godot_byte_array p_byte_array, int p_index);
  183. void GDAPI godot_byte_array_set(godot_byte_array p_byte_array, int p_index, unsigned char p_value);
  184. void GDAPI godot_byte_array_remove(godot_byte_array p_byte_array, int p_index);
  185. void GDAPI godot_byte_array_clear(godot_byte_array p_byte_array);
  186. typedef void *godot_byte_array_lock;
  187. godot_byte_array_lock GDAPI godot_byte_array_get_lock(godot_byte_array p_byte_array);
  188. unsigned char GDAPI *godot_byte_array_lock_get_pointer(godot_byte_array_lock p_byte_array_lock);
  189. void GDAPI godot_byte_array_lock_free(godot_byte_array_lock p_byte_array_lock);
  190. godot_image GDAPI godot_image_create_with_array(int p_width, int p_height, int p_format, int p_use_mipmaps, godot_array p_array);
  191. godot_byte_array GDAPI godot_image_get_data(godot_image p_image);
  192. ////// IntArray
  193. typedef void *godot_int_array;
  194. godot_int_array GDAPI godot_int_array_create();
  195. godot_int_array GDAPI godot_int_array_copy(godot_int_array p_int_array);
  196. void GDAPI godot_int_array_free(godot_int_array p_int_array);
  197. int GDAPI godot_int_array_get_size(godot_int_array p_int_array);
  198. int GDAPI godot_int_array_get(godot_int_array p_int_array, int p_index);
  199. void GDAPI godot_int_array_set(godot_int_array p_int_array, int p_index, int p_value);
  200. void GDAPI godot_int_array_remove(godot_int_array p_int_array, int p_index);
  201. void GDAPI godot_int_array_clear(godot_int_array p_int_array);
  202. typedef void *godot_int_array_lock;
  203. godot_int_array_lock GDAPI godot_int_array_get_lock(godot_int_array p_int_array);
  204. int GDAPI *godot_int_array_lock_get_pointer(godot_int_array_lock p_int_array_lock);
  205. void GDAPI godot_int_array_lock_free(godot_int_array_lock p_int_array_lock);
  206. ////// RealArray
  207. typedef void *godot_real_array;
  208. godot_real_array GDAPI godot_real_array_create();
  209. godot_real_array GDAPI godot_real_array_copy(godot_real_array p_real_array);
  210. void GDAPI godot_real_array_free(godot_real_array p_real_array);
  211. int GDAPI godot_real_array_get_size(godot_real_array p_real_array);
  212. float GDAPI godot_real_array_get(godot_real_array p_real_array, int p_index);
  213. void GDAPI godot_real_array_set(godot_real_array p_real_array, int p_index, float p_value);
  214. void GDAPI godot_real_array_remove(godot_real_array p_real_array, int p_index);
  215. void GDAPI godot_real_array_clear(godot_real_array p_real_array);
  216. typedef void *godot_real_array_lock;
  217. godot_real_array_lock GDAPI godot_real_array_get_lock(godot_real_array p_real_array);
  218. float GDAPI *godot_real_array_lock_get_pointer(godot_real_array_lock p_real_array_lock);
  219. void GDAPI godot_real_array_lock_free(godot_real_array_lock p_real_array_lock);
  220. ////// StringArray
  221. typedef void *godot_string_array;
  222. godot_string_array GDAPI godot_string_array_create();
  223. godot_string_array GDAPI godot_string_array_copy(godot_string_array p_string_array);
  224. void GDAPI godot_string_array_free(godot_string_array p_string_array);
  225. int GDAPI godot_string_array_get_size(godot_string_array p_string_array);
  226. int GDAPI godot_string_array_get(godot_string_array p_string_array, int p_index, unsigned char *p_string, int p_max_len);
  227. void GDAPI godot_string_array_set(godot_string_array p_string_array, int p_index, unsigned char *p_string);
  228. void GDAPI godot_string_array_remove(godot_string_array p_string_array, int p_index);
  229. void GDAPI godot_string_array_clear(godot_string_array p_string_array);
  230. ////// Vector2Array
  231. typedef void *godot_vector2_array;
  232. godot_vector2_array GDAPI godot_vector2_array_create();
  233. godot_vector2_array GDAPI godot_vector2_array_copy(godot_vector2_array p_vector2_array);
  234. void GDAPI godot_vector2_array_free(godot_vector2_array p_vector2_array);
  235. int GDAPI godot_vector2_array_get_size(godot_vector2_array p_vector2_array);
  236. int GDAPI godot_vector2_array_get_stride(godot_vector2_array p_vector2_array);
  237. void GDAPI godot_vector2_array_get(godot_vector2_array p_vector2_array, int p_index, float *p_vector2);
  238. void GDAPI godot_vector2_array_set(godot_vector2_array p_vector2_array, int p_index, float *p_vector2);
  239. void GDAPI godot_vector2_array_remove(godot_vector2_array p_vector2_array, int p_index);
  240. void GDAPI godot_vector2_array_clear(godot_vector2_array p_vector2_array);
  241. typedef void *godot_vector2_array_lock;
  242. godot_vector2_array_lock GDAPI godot_vector2_array_get_lock(godot_vector2_array p_vector2_array);
  243. float GDAPI *godot_vector2_array_lock_get_pointer(godot_vector2_array_lock p_vector2_array_lock);
  244. void GDAPI godot_vector2_array_lock_free(godot_vector2_array_lock p_vector2_array_lock);
  245. ////// Vector3Array
  246. typedef void *godot_vector3_array;
  247. godot_vector3_array GDAPI godot_vector3_array_create();
  248. godot_vector3_array GDAPI godot_vector3_array_copy(godot_vector3_array p_vector3_array);
  249. void GDAPI godot_vector3_array_free(godot_vector3_array p_vector3_array);
  250. int GDAPI godot_vector3_array_get_size(godot_vector3_array p_vector3_array);
  251. int GDAPI godot_vector3_array_get_stride(godot_vector3_array p_vector3_array);
  252. void GDAPI godot_vector3_array_get(godot_vector3_array p_vector3_array, int p_index, float *p_vector3);
  253. void GDAPI godot_vector3_array_set(godot_vector3_array p_vector3_array, int p_index, float *p_vector3);
  254. void GDAPI godot_vector3_array_remove(godot_vector3_array p_vector3_array, int p_index);
  255. void GDAPI godot_vector3_array_clear(godot_vector3_array p_vector3_array);
  256. typedef void *godot_vector3_array_lock;
  257. godot_vector3_array_lock GDAPI godot_vector3_array_get_lock(godot_vector3_array p_vector3_array);
  258. float GDAPI *godot_vector3_array_lock_get_pointer(godot_vector3_array_lock p_vector3_array_lock);
  259. void GDAPI godot_vector3_array_lock_free(godot_vector3_array_lock p_vector3_array_lock);
  260. ////// ColorArray
  261. typedef void *godot_color_array;
  262. godot_color_array GDAPI godot_color_array_create();
  263. godot_color_array GDAPI godot_color_array_copy(godot_color_array p_color_array);
  264. void GDAPI godot_color_array_free(godot_color_array p_color_array);
  265. int GDAPI godot_color_array_get_size(godot_color_array p_color_array);
  266. int GDAPI godot_color_array_get_stride(godot_color_array p_color_array);
  267. void GDAPI godot_color_array_get(godot_color_array p_color_array, int p_index, float *p_color);
  268. void GDAPI godot_color_array_set(godot_color_array p_color_array, int p_index, float *p_color);
  269. void GDAPI godot_color_array_remove(godot_color_array p_color_array, int p_index);
  270. void GDAPI godot_color_array_clear(godot_color_array p_color_array);
  271. typedef void *godot_color_array_lock;
  272. godot_color_array_lock GDAPI godot_color_array_get_lock(godot_color_array p_color_array);
  273. float GDAPI *godot_color_array_lock_get_pointer(godot_color_array_lock p_color_array_lock);
  274. void GDAPI godot_color_array_lock_free(godot_color_array_lock p_color_array_lock);
  275. ////// Instance (forward declared)
  276. typedef void *godot_instance;
  277. ////// Variant
  278. #define GODOT_VARIANT_NIL 0
  279. #define GODOT_VARIANT_BOOL 1
  280. #define GODOT_VARIANT_INT 2
  281. #define GODOT_VARIANT_REAL 3
  282. #define GODOT_VARIANT_STRING 4
  283. #define GODOT_VARIANT_VECTOR2 5
  284. #define GODOT_VARIANT_RECT2 6
  285. #define GODOT_VARIANT_VECTOR3 7
  286. #define GODOT_VARIANT_MATRIX32 8
  287. #define GODOT_VARIANT_PLANE 9
  288. #define GODOT_VARIANT_QUAT 10
  289. #define GODOT_VARIANT_AABB 11
  290. #define GODOT_VARIANT_MATRIX3 12
  291. #define GODOT_VARIANT_TRANSFORM 13
  292. #define GODOT_VARIANT_COLOR 14
  293. #define GODOT_VARIANT_IMAGE 15
  294. #define GODOT_VARIANT_NODE_PATH 16
  295. #define GODOT_VARIANT_RID 17
  296. #define GODOT_VARIANT_OBJECT 18
  297. #define GODOT_VARIANT_INPUT_EVENT 19
  298. #define GODOT_VARIANT_DICTIONARY 20
  299. #define GODOT_VARIANT_ARRAY 21
  300. #define GODOT_VARIANT_BYTE_ARRAY 22
  301. #define GODOT_VARIANT_INT_ARRAY 23
  302. #define GODOT_VARIANT_REAL_ARRAY 24
  303. #define GODOT_VARIANT_STRING_ARRAY 25
  304. #define GODOT_VARIANT_VECTOR2_ARRAY 26
  305. #define GODOT_VARIANT_VECTOR3_ARRAY 27
  306. #define GODOT_VARIANT_COLOR_ARRAY 28
  307. #define GODOT_VARIANT_MAX 29
  308. godot_variant *godot_variant_new();
  309. int GDAPI godot_variant_get_type(godot_variant p_variant);
  310. void GDAPI godot_variant_set_null(godot_variant p_variant);
  311. void GDAPI godot_variant_set_bool(godot_variant p_variant, godot_bool p_bool);
  312. void GDAPI godot_variant_set_int(godot_variant p_variant, int p_int);
  313. void GDAPI godot_variant_set_float(godot_variant p_variant, int p_float);
  314. void GDAPI godot_variant_set_string(godot_variant p_variant, char *p_string);
  315. void GDAPI godot_variant_set_vector2(godot_variant p_variant, float *p_elems);
  316. void GDAPI godot_variant_set_rect2(godot_variant p_variant, float *p_elems);
  317. void GDAPI godot_variant_set_vector3(godot_variant p_variant, float *p_elems);
  318. void GDAPI godot_variant_set_matrix32(godot_variant p_variant, float *p_elems);
  319. void GDAPI godot_variant_set_plane(godot_variant p_variant, float *p_elems);
  320. void GDAPI godot_variant_set_aabb(godot_variant p_variant, float *p_elems);
  321. void GDAPI godot_variant_set_matrix3(godot_variant p_variant, float *p_elems);
  322. void GDAPI godot_variant_set_transform(godot_variant p_variant, float *p_elems);
  323. void GDAPI godot_variant_set_color(godot_variant p_variant, float *p_elems);
  324. void GDAPI godot_variant_set_image(godot_variant p_variant, godot_image *p_image);
  325. void GDAPI godot_variant_set_node_path(godot_variant p_variant, char *p_path);
  326. void GDAPI godot_variant_set_rid(godot_variant p_variant, char *p_path);
  327. void GDAPI godot_variant_set_instance(godot_variant p_variant, godot_instance p_instance);
  328. void GDAPI godot_variant_set_input_event(godot_variant p_variant, godot_input_event p_instance);
  329. void GDAPI godot_variant_set_dictionary(godot_variant p_variant, godot_dictionary p_dictionary);
  330. void GDAPI godot_variant_set_array(godot_variant p_variant, godot_array p_array);
  331. void GDAPI godot_variant_set_byte_array(godot_variant p_variant, godot_byte_array p_array);
  332. void GDAPI godot_variant_set_int_array(godot_variant p_variant, godot_byte_array p_array);
  333. void GDAPI godot_variant_set_string_array(godot_variant p_variant, godot_string_array p_array);
  334. void GDAPI godot_variant_set_vector2_array(godot_variant p_variant, godot_vector2_array p_array);
  335. void GDAPI godot_variant_set_vector3_array(godot_variant p_variant, godot_vector3_array p_array);
  336. void GDAPI godot_variant_set_color_array(godot_variant p_variant, godot_color_array p_array);
  337. godot_bool GDAPI godot_variant_get_bool(godot_variant p_variant);
  338. int GDAPI godot_variant_get_int(godot_variant p_variant);
  339. float GDAPI godot_variant_get_float(godot_variant p_variant);
  340. int GDAPI godot_variant_get_string(godot_variant p_variant, char *p_string, int p_bufsize);
  341. void GDAPI godot_variant_get_vector2(godot_variant p_variant, float *p_elems);
  342. void GDAPI godot_variant_get_rect2(godot_variant p_variant, float *p_elems);
  343. void GDAPI godot_variant_get_vector3(godot_variant p_variant, float *p_elems);
  344. void GDAPI godot_variant_get_matrix32(godot_variant p_variant, float *p_elems);
  345. void GDAPI godot_variant_get_plane(godot_variant p_variant, float *p_elems);
  346. void GDAPI godot_variant_get_aabb(godot_variant p_variant, float *p_elems);
  347. void GDAPI godot_variant_get_matrix3(godot_variant p_variant, float *p_elems);
  348. void GDAPI godot_variant_get_transform(godot_variant p_variant, float *p_elems);
  349. void GDAPI godot_variant_get_color(godot_variant p_variant, float *p_elems);
  350. godot_image GDAPI *godot_variant_get_image(godot_variant p_variant);
  351. int GDAPI godot_variant_get_node_path(godot_variant p_variant, char *p_path, int p_bufsize);
  352. godot_rid GDAPI godot_variant_get_rid(godot_variant p_variant);
  353. godot_instance GDAPI godot_variant_get_instance(godot_variant p_variant);
  354. void GDAPI godot_variant_get_input_event(godot_variant p_variant, godot_input_event);
  355. void GDAPI godot_variant_get_dictionary(godot_variant p_variant, godot_dictionary);
  356. godot_array GDAPI godot_variant_get_array(godot_variant p_variant);
  357. godot_byte_array GDAPI godot_variant_get_byte_array(godot_variant p_variant);
  358. godot_byte_array GDAPI godot_variant_get_int_array(godot_variant p_variant);
  359. godot_string_array GDAPI godot_variant_get_string_array(godot_variant p_variant);
  360. godot_vector2_array GDAPI godot_variant_get_vector2_array(godot_variant p_variant);
  361. godot_vector3_array GDAPI godot_variant_get_vector3_array(godot_variant p_variant);
  362. godot_color_array GDAPI godot_variant_get_color_array(godot_variant p_variant);
  363. void GDAPI godot_variant_delete(godot_variant p_variant);
  364. ////// Class
  365. ///
  366. char GDAPI **godot_class_get_list(); //get list of classes in array to array of strings, must be freed, use godot_list_free()
  367. int GDAPI godot_class_get_base(char *p_class, char *p_base, int p_max_len);
  368. int GDAPI godot_class_get_name(char *p_class, char *p_base, int p_max_len);
  369. char GDAPI **godot_class_get_method_list(char *p_class); //free with godot_list_free()
  370. int GDAPI godot_class_method_get_argument_count(char *p_class, char *p_method);
  371. int GDAPI godot_class_method_get_argument_type(char *p_class, char *p_method, int p_argument);
  372. godot_variant GDAPI godot_class_method_get_argument_default_value(char *p_class, char *p_method, int p_argument);
  373. char GDAPI **godot_class_get_constant_list(char *p_class); //free with godot_list_free()
  374. int GDAPI godot_class_constant_get_value(char *p_class, char *p_constant);
  375. ////// Instance
  376. typedef int godot_call_error;
  377. #define GODOT_CALL_OK
  378. #define GODOT_CALL_ERROR_WRONG_ARGUMENTS
  379. #define GODOT_CALL_ERROR_INVALID_INSTANCE
  380. godot_instance GDAPI godot_instance_new(char *p_class);
  381. int GDAPI godot_instance_get_class(godot_instance p_instance, char *p_class, int p_max_len);
  382. typedef struct {
  383. char *name;
  384. int hint;
  385. char *hint_string;
  386. int usage;
  387. } godot_property_info;
  388. godot_call_error GDAPI godot_instance_call(godot_instance p_instance, char *p_method, ...);
  389. godot_call_error GDAPI godot_instance_call_ret(godot_instance p_instance, godot_variant r_return, char *p_method, ...);
  390. godot_bool GDAPI godot_instance_set(godot_instance p_instance, char *p_prop, godot_variant p_value);
  391. godot_variant GDAPI godot_instance_get(godot_instance p_instance, char *p_prop);
  392. #define GODOT_PROPERTY_HINT_NONE 0 ///< no hint provided.
  393. #define GODOT_PROPERTY_HINT_RANGE 1 ///< hint_text = "min,max,step,slider; //slider is optional"
  394. #define GODOT_PROPERTY_HINT_EXP_RANGE 2 ///< hint_text = "min,max,step", exponential edit
  395. #define GODOT_PROPERTY_HINT_ENUM 3 ///< hint_text= "val1,val2,val3,etc"
  396. #define GODOT_PROPERTY_HINT_EXP_EASING 4 /// exponential easing funciton (Math::ease)
  397. #define GODOT_PROPERTY_HINT_LENGTH 5 ///< hint_text= "length" (as integer)
  398. #define GODOT_PROPERTY_HINT_SPRITE_FRAME 6
  399. #define GODOT_PROPERTY_HINT_KEY_ACCEL 7 ///< hint_text= "length" (as integer)
  400. #define GODOT_PROPERTY_HINT_FLAGS 8 ///< hint_text= "flag1,flag2,etc" (as bit flags)
  401. #define GODOT_PROPERTY_HINT_ALL_FLAGS 9
  402. #define GODOT_PROPERTY_HINT_FILE 10 ///< a file path must be passed, hint_text (optionally) is a filter "*.png,*.wav,*.doc,"
  403. #define GODOT_PROPERTY_HINT_DIR 11 ///< a directort path must be passed
  404. #define GODOT_PROPERTY_HINT_GLOBAL_FILE 12 ///< a file path must be passed, hint_text (optionally) is a filter "*.png,*.wav,*.doc,"
  405. #define GODOT_PROPERTY_HINT_GLOBAL_DIR 13 ///< a directort path must be passed
  406. #define GODOT_PROPERTY_HINT_RESOURCE_TYPE 14 ///< a resource object type
  407. #define GODOT_PROPERTY_HINT_MULTILINE_TEXT 15 ///< used for string properties that can contain multiple lines
  408. #define GODOT_PROPERTY_HINT_COLOR_NO_ALPHA 16 ///< used for ignoring alpha component when editing a color
  409. #define GODOT_PROPERTY_HINT_IMAGE_COMPRESS_LOSSY 17
  410. #define GODOT_PROPERTY_HINT_IMAGE_COMPRESS_LOSSLESS 18
  411. #define GODOT_PROPERTY_HINT_OBJECT_ID 19
  412. #define GODOT_PROPERTY_USAGE_STORAGE 1
  413. #define GODOT_PROPERTY_USAGE_EDITOR 2
  414. #define GODOT_PROPERTY_USAGE_NETWORK 4
  415. #define GODOT_PROPERTY_USAGE_EDITOR_HELPER 8
  416. #define GODOT_PROPERTY_USAGE_CHECKABLE 16 //used for editing global variables
  417. #define GODOT_PROPERTY_USAGE_CHECKED 32 //used for editing global variables
  418. #define GODOT_PROPERTY_USAGE_INTERNATIONALIZED 64 //hint for internationalized strings
  419. #define GODOT_PROPERTY_USAGE_BUNDLE 128 //used for optimized bundles
  420. #define GODOT_PROPERTY_USAGE_CATEGORY 256
  421. #define GODOT_PROPERTY_USAGE_STORE_IF_NONZERO 512 //only store if nonzero
  422. #define GODOT_PROPERTY_USAGE_STORE_IF_NONONE 1024 //only store if false
  423. #define GODOT_PROPERTY_USAGE_NO_INSTANCE_STATE 2048
  424. #define GODOT_PROPERTY_USAGE_RESTART_IF_CHANGED 4096
  425. #define GODOT_PROPERTY_USAGE_SCRIPT_VARIABLE 8192
  426. #define GODOT_PROPERTY_USAGE_STORE_IF_NULL 16384
  427. #define GODOT_PROPERTY_USAGE_ANIMATE_AS_TRIGGER 32768
  428. #define GODOT_PROPERTY_USAGE_DEFAULT GODOT_PROPERTY_USAGE_STORAGE | GODOT_PROPERTY_USAGE_EDITOR | GODOT_PROPERTY_USAGE_NETWORK
  429. #define GODOT_PROPERTY_USAGE_DEFAULT_INTL GODOT_PROPERTY_USAGE_STORAGE | GODOT_PROPERTY_USAGE_EDITOR | GODOT_PROPERTY_USAGE_NETWORK | GODOT_PROPERTY_USAGE_INTERNATIONALIZED
  430. #define GODOT_PROPERTY_USAGE_NOEDITOR GODOT_PROPERTY_USAGE_STORAGE | GODOT_PROPERTY_USAGE_NETWORK
  431. godot_property_info GDAPI **godot_instance_get_property_list(godot_instance p_instance);
  432. void GDAPI godot_instance_free_property_list(godot_instance p_instance, godot_property_info **p_list);
  433. void GDAPI godot_list_free(char **p_name); //helper to free all the class list
  434. ////// Script API
  435. typedef void *(godot_script_instance_func)(godot_instance); //passed an instance, return a pointer to your userdata
  436. typedef void(godot_script_free_func)(godot_instance, void *); //passed an instance, please free your userdata
  437. void GDAPI godot_script_register(char *p_base, char *p_name, godot_script_instance_func p_instance_func, godot_script_free_func p_free_func);
  438. void GDAPI godot_script_unregister(char *p_name);
  439. typedef GDAPI godot_variant(godot_script_func)(godot_instance, void *, godot_variant *, int); //instance,userdata,arguments,argument count. Return something or NULL. Arguments must not be freed.
  440. void GDAPI godot_script_add_function(char *p_name, char *p_function_name, godot_script_func p_func);
  441. void GDAPI godot_script_add_validated_function(char *p_name, char *p_function_name, godot_script_func p_func, int *p_arg_types, int p_arg_count, godot_variant *p_default_args, int p_default_arg_count);
  442. typedef void(godot_set_property_func)(godot_instance, void *, godot_variant); //instance,userdata,value. Value must not be freed.
  443. typedef godot_variant(godot_get_property_func)(godot_instance, void *); //instance,userdata. Return a value or NULL.
  444. void GDAPI godot_script_add_property(char *p_name, char *p_path, godot_set_property_func p_set_func, godot_get_property_func p_get_func);
  445. void GDAPI godot_script_add_listed_property(char *p_name, char *p_path, godot_set_property_func p_set_func, godot_get_property_func p_get_func, int p_type, int p_hint, char *p_hint_string, int p_usage);
  446. ////// System Functions
  447. //using these will help Godot track how much memory is in use in debug mode
  448. void GDAPI *godot_alloc(int p_bytes);
  449. void GDAPI *godot_realloc(void *p_ptr, int p_bytes);
  450. void GDAPI godot_free(void *p_ptr);
  451. #ifdef __cplusplus
  452. }
  453. #endif
  454. #endif // GODOT_C_H