karl2d.odin 48 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935
  1. #+vet explicit-allocators
  2. package karl2d
  3. import "base:runtime"
  4. import "core:mem"
  5. import "core:log"
  6. import "core:math"
  7. import "core:math/linalg"
  8. import "core:slice"
  9. import "core:strings"
  10. import "core:reflect"
  11. import "core:os"
  12. import fs "vendor:fontstash"
  13. import "core:image"
  14. import "core:image/jpeg"
  15. import "core:image/bmp"
  16. import "core:image/png"
  17. import "core:image/tga"
  18. import hm "handle_map"
  19. //-----------------------------------------------//
  20. // SETUP, WINDOW MANAGEMENT AND FRAME MANAGEMENT //
  21. //-----------------------------------------------//
  22. // Opens a window and initializes some internal state. The internal state will use `allocator` for
  23. // all dynamically allocated memory. The return value can be ignored unless you need to later call
  24. // `set_internal_state`.
  25. init :: proc(window_width: int, window_height: int, window_title: string,
  26. window_creation_flags := Window_Flags {},
  27. allocator := context.allocator, loc := #caller_location) -> ^State {
  28. assert(s == nil, "Don't call 'init' twice.")
  29. context.allocator = allocator
  30. s = new(State, allocator, loc)
  31. // This is the same type of arena as the default temp allocator. This arena is for allocations
  32. // that have a lifetime of "one frame". They are valid until you call `present()`, at which
  33. // point the frame allocator is cleared.
  34. s.frame_allocator = runtime.arena_allocator(&s.frame_arena)
  35. frame_allocator = s.frame_allocator
  36. s.allocator = allocator
  37. s.win = WINDOW_INTERFACE
  38. win = s.win
  39. // We alloc memory for the windowing backend and pass the blob of memory to it.
  40. window_state_alloc_error: runtime.Allocator_Error
  41. s.window_state, window_state_alloc_error = mem.alloc(win.state_size(), allocator = allocator)
  42. log.assertf(window_state_alloc_error == nil, "Failed allocating memory for window state: %v", window_state_alloc_error)
  43. win.init(s.window_state, window_width, window_height, window_title, window_creation_flags, allocator)
  44. // This is a OS-independent handle that we can pass to any rendering backend.
  45. s.window = win.window_handle()
  46. // See `config.odin` for how this is picked.
  47. s.rb = RENDER_BACKEND
  48. // Depending on backend the depth is counted in one of two ways. It can be counted from `1` and
  49. // to lower numbers. Or from `-1` and to higher numbers.
  50. s.depth_start = DEPTH_START
  51. s.depth_increment = DEPTH_INCREMENT
  52. if s.rb.flip_z() {
  53. s.depth_start = -DEPTH_START
  54. s.depth_increment = -DEPTH_INCREMENT
  55. }
  56. s.depth = s.depth_start
  57. rb = s.rb
  58. rb_alloc_error: runtime.Allocator_Error
  59. s.rb_state, rb_alloc_error = mem.alloc(rb.state_size(), allocator = allocator)
  60. log.assertf(rb_alloc_error == nil, "Failed allocating memory for rendering backend: %v", rb_alloc_error)
  61. s.proj_matrix = make_default_projection(win.get_width(), win.get_height())
  62. s.view_matrix = 1
  63. // Boot up the render backend. It will render into our previously created window.
  64. rb.init(s.rb_state, s.window, win.get_width(), win.get_height(), allocator)
  65. // The vertex buffer is created in a render backend-independent way. It is passed to the
  66. // render backend each frame as part of `draw_current_batch()`
  67. s.vertex_buffer_cpu = make([]u8, VERTEX_BUFFER_MAX, allocator, loc)
  68. // The shapes drawing texture is sampled when any shape is drawn. This way we can use the same
  69. // shader for textured drawing and shape drawing. It's just a white box.
  70. white_rect: [16*16*4]u8
  71. slice.fill(white_rect[:], 255)
  72. s.shape_drawing_texture = rb.load_texture(white_rect[:], 16, 16, .RGBA_8_Norm)
  73. // The default shader will arrive in a different format depending on backend. GLSL for GL,
  74. // HLSL for d3d etc.
  75. s.default_shader = load_shader_from_memory(rb.default_shader_vertex_source(), rb.default_shader_fragment_source())
  76. s.batch_shader = s.default_shader
  77. // FontStash enables us to bake fonts from TTF files on-the-fly.
  78. fs.Init(&s.fs, FONT_DEFAULT_ATLAS_SIZE, FONT_DEFAULT_ATLAS_SIZE, .TOPLEFT)
  79. DEFAULT_FONT_DATA :: #load("roboto.ttf")
  80. // Dummy element so font with index 0 means 'no font'.
  81. append_nothing(&s.fonts)
  82. s.default_font = load_font_from_bytes(DEFAULT_FONT_DATA)
  83. set_font(s.default_font)
  84. return s
  85. }
  86. // Returns true if the program wants to shut down. This happens when for example pressing the close
  87. // button on the window. The application can decide if it wants to shut down or if it wants to show
  88. // some kind of confirmation dialogue and shut down later.
  89. //
  90. // Commonly used for creating the "main loop" of a game.
  91. shutdown_wanted :: proc() -> bool {
  92. return s.shutdown_wanted
  93. }
  94. // Closes the window and cleans up the internal state.
  95. shutdown :: proc() {
  96. assert(s != nil, "You've called 'shutdown' without calling 'init' first")
  97. context.allocator = s.allocator
  98. destroy_font(s.default_font)
  99. rb.destroy_texture(s.shape_drawing_texture)
  100. destroy_shader(s.default_shader)
  101. rb.shutdown()
  102. delete(s.vertex_buffer_cpu, s.allocator)
  103. win.shutdown()
  104. fs.Destroy(&s.fs)
  105. delete(s.fonts)
  106. a := s.allocator
  107. free(s.window_state, a)
  108. free(s.rb_state, a)
  109. free(s, a)
  110. s = nil
  111. }
  112. // Clear the backbuffer with supplied color.
  113. clear :: proc(color: Color) {
  114. draw_current_batch()
  115. rb.clear(s.batch_render_target, color)
  116. s.depth = s.depth_start
  117. }
  118. // Present the backbuffer. Call at end of frame to make everything you've drawn appear on the
  119. // screen. Also clears the frame_allocator that Karl2D uses for allocations that have the lifetime
  120. // of a single frame.
  121. present :: proc() {
  122. draw_current_batch()
  123. rb.present()
  124. free_all(s.frame_allocator)
  125. }
  126. // Call at start or end of frame to process all events that have arrived to the window. This
  127. // includes keyboard, mouse, gamepad and window events.
  128. //
  129. // WARNING: Not calling this will make your program impossible to interact with.
  130. process_events :: proc() {
  131. s.key_went_up = {}
  132. s.key_went_down = {}
  133. s.mouse_button_went_up = {}
  134. s.mouse_button_went_down = {}
  135. s.gamepad_button_went_up = {}
  136. s.gamepad_button_went_down = {}
  137. s.mouse_delta = {}
  138. s.mouse_wheel_delta = 0
  139. win.process_events()
  140. events := win.get_events()
  141. for &event in events {
  142. switch &e in event {
  143. case Window_Event_Close_Wanted:
  144. s.shutdown_wanted = true
  145. case Window_Event_Key_Went_Down:
  146. s.key_went_down[e.key] = true
  147. s.key_is_held[e.key] = true
  148. case Window_Event_Key_Went_Up:
  149. s.key_went_up[e.key] = true
  150. s.key_is_held[e.key] = false
  151. case Window_Event_Mouse_Button_Went_Down:
  152. s.mouse_button_went_down[e.button] = true
  153. s.mouse_button_is_held[e.button] = true
  154. case Window_Event_Mouse_Button_Went_Up:
  155. s.mouse_button_went_up[e.button] = true
  156. s.mouse_button_is_held[e.button] = false
  157. case Window_Event_Mouse_Move:
  158. prev_pos := s.mouse_position
  159. s.mouse_position = e.position
  160. s.mouse_delta = s.mouse_position - prev_pos
  161. case Window_Event_Mouse_Wheel:
  162. s.mouse_wheel_delta = e.delta
  163. case Window_Event_Gamepad_Button_Went_Down:
  164. if e.gamepad < MAX_GAMEPADS {
  165. s.gamepad_button_went_down[e.gamepad][e.button] = true
  166. s.gamepad_button_is_held[e.gamepad][e.button] = true
  167. }
  168. case Window_Event_Gamepad_Button_Went_Up:
  169. if e.gamepad < MAX_GAMEPADS {
  170. s.gamepad_button_went_up[e.gamepad][e.button] = true
  171. s.gamepad_button_is_held[e.gamepad][e.button] = false
  172. }
  173. case Window_Event_Resize:
  174. rb.resize_swapchain(e.width, e.height)
  175. s.proj_matrix = make_default_projection(e.width, e.height)
  176. }
  177. }
  178. win.clear_events()
  179. }
  180. get_screen_width :: proc() -> int {
  181. return win.get_width()
  182. }
  183. get_screen_height :: proc() -> int {
  184. return win.get_height()
  185. }
  186. set_window_position :: proc(x: int, y: int) {
  187. win.set_position(x, y)
  188. }
  189. set_window_size :: proc(width: int, height: int) {
  190. // TODO not sure if we should resize swapchain here. On windows the WM_SIZE event fires and
  191. // it all works out. But perhaps not on all platforms?
  192. win.set_size(width, height)
  193. }
  194. // Fetch the scale of the window. This usually comes from some DPI scaling setting in the OS.
  195. // 1 means 100% scale, 1.5 means 150% etc.
  196. get_window_scale :: proc() -> f32 {
  197. return win.get_window_scale()
  198. }
  199. set_window_flags :: proc(flags: Window_Flags) {
  200. win.set_flags(flags)
  201. }
  202. // Flushes the current batch. This sends off everything to the GPU that has been queued in the
  203. // current batch. Normally, you do not need to do this manually. It is done automatically when these
  204. // procedures run:
  205. //
  206. // - present
  207. // - set_camera
  208. // - set_shader
  209. // - set_shader_constant
  210. // - set_scissor_rect
  211. // - draw_texture_* IF previous draw did not use the same texture (1)
  212. // - draw_rect_*, draw_circle_*, draw_line IF previous draw did not use the shapes drawing texture (2)
  213. //
  214. // (1) When drawing textures, the current texture is fed into the active shader. Everything within
  215. // the same batch must use the same texture. So drawing with a new texture will draw the current
  216. // batch. You can combine several textures into an atlas to get bigger batches.
  217. //
  218. // (2) In order to use the same shader for shapes drawing and textured drawing, the shapes drawing
  219. // uses a blank, white texture. For the same reasons as (1), drawing something else than shapes
  220. // before drawing a shape will break up the batches. TODO: Add possibility to customize shape
  221. // drawing texture so that you can put it into an atlas.
  222. //
  223. // The batch has maximum size of VERTEX_BUFFER_MAX bytes. The shader dictates how big a vertex is
  224. // so the maximum number of vertices that can be drawn in each batch is
  225. // VERTEX_BUFFER_MAX / shader.vertex_size
  226. draw_current_batch :: proc() {
  227. update_font(s.batch_font)
  228. if s.vertex_buffer_cpu_used == 0 {
  229. return
  230. }
  231. shader := s.batch_shader
  232. mvp := s.proj_matrix * s.view_matrix
  233. for mloc, builtin in shader.constant_builtin_locations {
  234. constant, constant_ok := mloc.?
  235. if !constant_ok {
  236. continue
  237. }
  238. switch builtin {
  239. case .MVP:
  240. if constant.size == size_of(mvp) {
  241. dst := (^matrix[4,4]f32)(&shader.constants_data[constant.offset])
  242. dst^ = mvp
  243. }
  244. }
  245. }
  246. if def_tex_idx, has_def_tex_idx := shader.default_texture_index.?; has_def_tex_idx {
  247. shader.texture_bindpoints[def_tex_idx] = s.batch_texture
  248. }
  249. rb.draw(shader, s.batch_render_target, shader.texture_bindpoints, s.batch_scissor, s.batch_blend_mode, s.vertex_buffer_cpu[:s.vertex_buffer_cpu_used])
  250. s.vertex_buffer_cpu_used = 0
  251. }
  252. //-------//
  253. // INPUT //
  254. //-------//
  255. // Returns true if a keyboard key went down between the current and the previous frame. Set when
  256. // 'process_events' runs (probably once per frame).
  257. key_went_down :: proc(key: Keyboard_Key) -> bool {
  258. return s.key_went_down[key]
  259. }
  260. // Returns true if a keyboard key went up (was released) between the current and the previous frame.
  261. // Set when 'process_events' runs (probably once per frame).
  262. key_went_up :: proc(key: Keyboard_Key) -> bool {
  263. return s.key_went_up[key]
  264. }
  265. // Returns true if a keyboard is currently being held down. Set when 'process_events' runs (probably
  266. // once per frame).
  267. key_is_held :: proc(key: Keyboard_Key) -> bool {
  268. return s.key_is_held[key]
  269. }
  270. mouse_button_went_down :: proc(button: Mouse_Button) -> bool {
  271. return s.mouse_button_went_down[button]
  272. }
  273. mouse_button_went_up :: proc(button: Mouse_Button) -> bool {
  274. return s.mouse_button_went_up[button]
  275. }
  276. mouse_button_is_held :: proc(button: Mouse_Button) -> bool {
  277. return s.mouse_button_is_held[button]
  278. }
  279. get_mouse_wheel_delta :: proc() -> f32 {
  280. return s.mouse_wheel_delta
  281. }
  282. get_mouse_position :: proc() -> Vec2 {
  283. return s.mouse_position
  284. }
  285. get_mouse_delta :: proc() -> Vec2 {
  286. return s.mouse_delta
  287. }
  288. is_gamepad_active :: proc(gamepad: Gamepad_Index) -> bool {
  289. return win.is_gamepad_active(gamepad)
  290. }
  291. gamepad_button_went_down :: proc(gamepad: Gamepad_Index, button: Gamepad_Button) -> bool {
  292. if gamepad < 0 || gamepad >= MAX_GAMEPADS {
  293. return false
  294. }
  295. return s.gamepad_button_went_down[gamepad][button]
  296. }
  297. gamepad_button_went_up :: proc(gamepad: Gamepad_Index, button: Gamepad_Button) -> bool {
  298. if gamepad < 0 || gamepad >= MAX_GAMEPADS {
  299. return false
  300. }
  301. return s.gamepad_button_went_up[gamepad][button]
  302. }
  303. gamepad_button_is_held :: proc(gamepad: Gamepad_Index, button: Gamepad_Button) -> bool {
  304. if gamepad < 0 || gamepad >= MAX_GAMEPADS {
  305. return false
  306. }
  307. return s.gamepad_button_is_held[gamepad][button]
  308. }
  309. get_gamepad_axis :: proc(gamepad: Gamepad_Index, axis: Gamepad_Axis) -> f32 {
  310. return win.get_gamepad_axis(gamepad, axis)
  311. }
  312. // Set the left and right vibration motor speed. The range of left and right is 0 to 1. Note that on
  313. // most gamepads, the left motor is "low frequency" and the right motor is "high frequency". They do
  314. // not vibrate with the same speed.
  315. set_gamepad_vibration :: proc(gamepad: Gamepad_Index, left: f32, right: f32) {
  316. win.set_gamepad_vibration(gamepad, left, right)
  317. }
  318. //---------//
  319. // DRAWING //
  320. //---------//
  321. draw_rect :: proc(r: Rect, c: Color) {
  322. if s.vertex_buffer_cpu_used + s.batch_shader.vertex_size * 6 > len(s.vertex_buffer_cpu) {
  323. draw_current_batch()
  324. }
  325. if s.batch_texture != s.shape_drawing_texture {
  326. draw_current_batch()
  327. }
  328. s.batch_texture = s.shape_drawing_texture
  329. z := get_next_depth()
  330. batch_vertex({r.x, r.y, z}, {0, 0}, c)
  331. batch_vertex({r.x + r.w, r.y, z}, {1, 0}, c)
  332. batch_vertex({r.x + r.w, r.y + r.h, z}, {1, 1}, c)
  333. batch_vertex({r.x, r.y, z}, {0, 0}, c)
  334. batch_vertex({r.x + r.w, r.y + r.h, z}, {1, 1}, c)
  335. batch_vertex({r.x, r.y + r.h, z}, {0, 1}, c)
  336. }
  337. draw_rect_vec :: proc(pos: Vec2, size: Vec2, c: Color) {
  338. draw_rect({pos.x, pos.y, size.x, size.y}, c)
  339. }
  340. draw_rect_ex :: proc(r: Rect, origin: Vec2, rot: f32, c: Color) {
  341. if s.vertex_buffer_cpu_used + s.batch_shader.vertex_size * 6 > len(s.vertex_buffer_cpu) {
  342. draw_current_batch()
  343. }
  344. if s.batch_texture != s.shape_drawing_texture {
  345. draw_current_batch()
  346. }
  347. s.batch_texture = s.shape_drawing_texture
  348. tl, tr, bl, br: Vec2
  349. // Rotation adapted from Raylib's "DrawTexturePro"
  350. if rot == 0 {
  351. x := r.x - origin.x
  352. y := r.y - origin.y
  353. tl = { x, y }
  354. tr = { x + r.w, y }
  355. bl = { x, y + r.h }
  356. br = { x + r.w, y + r.h }
  357. } else {
  358. sin_rot := math.sin(rot * math.RAD_PER_DEG)
  359. cos_rot := math.cos(rot * math.RAD_PER_DEG)
  360. x := r.x
  361. y := r.y
  362. dx := -origin.x
  363. dy := -origin.y
  364. tl = {
  365. x + dx * cos_rot - dy * sin_rot,
  366. y + dx * sin_rot + dy * cos_rot,
  367. }
  368. tr = {
  369. x + (dx + r.w) * cos_rot - dy * sin_rot,
  370. y + (dx + r.w) * sin_rot + dy * cos_rot,
  371. }
  372. bl = {
  373. x + dx * cos_rot - (dy + r.h) * sin_rot,
  374. y + dx * sin_rot + (dy + r.h) * cos_rot,
  375. }
  376. br = {
  377. x + (dx + r.w) * cos_rot - (dy + r.h) * sin_rot,
  378. y + (dx + r.w) * sin_rot + (dy + r.h) * cos_rot,
  379. }
  380. }
  381. z := get_next_depth()
  382. batch_vertex(vec3(tl, z), {0, 0}, c)
  383. batch_vertex(vec3(tr, z), {1, 0}, c)
  384. batch_vertex(vec3(br, z), {1, 1}, c)
  385. batch_vertex(vec3(tl, z), {0, 0}, c)
  386. batch_vertex(vec3(br, z), {1, 1}, c)
  387. batch_vertex(vec3(bl, z), {0, 1}, c)
  388. }
  389. draw_rect_outline :: proc(r: Rect, thickness: f32, color: Color) {
  390. t := thickness
  391. // Based on DrawRectangleLinesEx from Raylib
  392. top := Rect {
  393. r.x,
  394. r.y,
  395. r.w,
  396. t,
  397. }
  398. bottom := Rect {
  399. r.x,
  400. r.y + r.h - t,
  401. r.w,
  402. t,
  403. }
  404. left := Rect {
  405. r.x,
  406. r.y + t,
  407. t,
  408. r.h - t * 2,
  409. }
  410. right := Rect {
  411. r.x + r.w - t,
  412. r.y + t,
  413. t,
  414. r.h - t * 2,
  415. }
  416. draw_rect(top, color)
  417. draw_rect(bottom, color)
  418. draw_rect(left, color)
  419. draw_rect(right, color)
  420. }
  421. draw_circle :: proc(center: Vec2, radius: f32, color: Color, segments := 16) {
  422. if s.vertex_buffer_cpu_used + s.batch_shader.vertex_size * 3 * segments > len(s.vertex_buffer_cpu) {
  423. draw_current_batch()
  424. }
  425. if s.batch_texture != s.shape_drawing_texture {
  426. draw_current_batch()
  427. }
  428. s.batch_texture = s.shape_drawing_texture
  429. z := get_next_depth()
  430. prev := center + {radius, 0}
  431. for s in 1..=segments {
  432. sr := (f32(s)/f32(segments)) * 2*math.PI
  433. rot := linalg.matrix2_rotate(sr)
  434. p := center + rot * Vec2{radius, 0}
  435. batch_vertex(vec3(prev, z), {0, 0}, color)
  436. batch_vertex(vec3(p, z), {1, 0}, color)
  437. batch_vertex(vec3(center, z), {1, 1}, color)
  438. prev = p
  439. }
  440. }
  441. draw_circle_outline :: proc(center: Vec2, radius: f32, thickness: f32, color: Color, segments := 16) {
  442. prev := center + {radius, 0}
  443. for s in 1..=segments {
  444. sr := (f32(s)/f32(segments)) * 2*math.PI
  445. rot := linalg.matrix2_rotate(sr)
  446. p := center + rot * Vec2{radius, 0}
  447. draw_line(prev, p, thickness, color)
  448. prev = p
  449. }
  450. }
  451. draw_line :: proc(start: Vec2, end: Vec2, thickness: f32, color: Color) {
  452. p := Vec2{start.x, start.y + thickness*0.5}
  453. s := Vec2{linalg.length(end - start), thickness}
  454. origin := Vec2 {0, thickness*0.5}
  455. r := Rect {p.x, p.y, s.x, s.y}
  456. rot := math.atan2(end.y - start.y, end.x - start.x)
  457. draw_rect_ex(r, origin, rot * math.DEG_PER_RAD, color)
  458. }
  459. draw_texture :: proc(tex: Texture, pos: Vec2, tint := WHITE) {
  460. draw_texture_ex(
  461. tex,
  462. {0, 0, f32(tex.width), f32(tex.height)},
  463. {pos.x, pos.y, f32(tex.width), f32(tex.height)},
  464. {},
  465. 0,
  466. tint,
  467. )
  468. }
  469. draw_texture_rect :: proc(tex: Texture, rect: Rect, pos: Vec2, tint := WHITE) {
  470. draw_texture_ex(
  471. tex,
  472. rect,
  473. {pos.x, pos.y, rect.w, rect.h},
  474. {},
  475. 0,
  476. tint,
  477. )
  478. }
  479. draw_texture_ex :: proc(tex: Texture, src: Rect, dst: Rect, origin: Vec2, rotation: f32, tint := WHITE) {
  480. if tex.width == 0 || tex.height == 0 {
  481. return
  482. }
  483. if s.vertex_buffer_cpu_used + s.batch_shader.vertex_size * 6 > len(s.vertex_buffer_cpu) {
  484. draw_current_batch()
  485. }
  486. if s.batch_texture != tex.handle {
  487. draw_current_batch()
  488. }
  489. s.batch_texture = tex.handle
  490. flip_x, flip_y: bool
  491. src := src
  492. dst := dst
  493. if src.w < 0 {
  494. flip_x = true
  495. src.w = -src.w
  496. }
  497. if src.h < 0 {
  498. flip_y = true
  499. src.h = -src.h
  500. }
  501. if dst.w < 0 {
  502. dst.w *= -1
  503. }
  504. if dst.h < 0 {
  505. dst.h *= -1
  506. }
  507. tl, tr, bl, br: Vec2
  508. // Rotation adapted from Raylib's "DrawTexturePro"
  509. if rotation == 0 {
  510. x := dst.x - origin.x
  511. y := dst.y - origin.y
  512. tl = { x, y }
  513. tr = { x + dst.w, y }
  514. bl = { x, y + dst.h }
  515. br = { x + dst.w, y + dst.h }
  516. } else {
  517. sin_rot := math.sin(rotation * math.RAD_PER_DEG)
  518. cos_rot := math.cos(rotation * math.RAD_PER_DEG)
  519. x := dst.x
  520. y := dst.y
  521. dx := -origin.x
  522. dy := -origin.y
  523. tl = {
  524. x + dx * cos_rot - dy * sin_rot,
  525. y + dx * sin_rot + dy * cos_rot,
  526. }
  527. tr = {
  528. x + (dx + dst.w) * cos_rot - dy * sin_rot,
  529. y + (dx + dst.w) * sin_rot + dy * cos_rot,
  530. }
  531. bl = {
  532. x + dx * cos_rot - (dy + dst.h) * sin_rot,
  533. y + dx * sin_rot + (dy + dst.h) * cos_rot,
  534. }
  535. br = {
  536. x + (dx + dst.w) * cos_rot - (dy + dst.h) * sin_rot,
  537. y + (dx + dst.w) * sin_rot + (dy + dst.h) * cos_rot,
  538. }
  539. }
  540. ts := Vec2{f32(tex.width), f32(tex.height)}
  541. up := Vec2{src.x, src.y} / ts
  542. us := Vec2{src.w, src.h} / ts
  543. c := tint
  544. uv0 := up
  545. uv1 := up + {us.x, 0}
  546. uv2 := up + us
  547. uv3 := up
  548. uv4 := up + us
  549. uv5 := up + {0, us.y}
  550. if flip_x {
  551. uv0.x += us.x
  552. uv1.x -= us.x
  553. uv2.x -= us.x
  554. uv3.x += us.x
  555. uv4.x -= us.x
  556. uv5.x += us.x
  557. }
  558. if flip_y {
  559. uv0.y += us.y
  560. uv1.y += us.y
  561. uv2.y -= us.y
  562. uv3.y += us.y
  563. uv4.y -= us.y
  564. uv5.y -= us.y
  565. }
  566. z := get_next_depth()
  567. batch_vertex(vec3(tl, z), uv0, c)
  568. batch_vertex(vec3(tr, z), uv1, c)
  569. batch_vertex(vec3(br, z), uv2, c)
  570. batch_vertex(vec3(tl, z), uv3, c)
  571. batch_vertex(vec3(br, z), uv4, c)
  572. batch_vertex(vec3(bl, z), uv5, c)
  573. }
  574. measure_text :: proc(text: string, font_size: f32) -> Vec2 {
  575. fs.SetSize(&s.fs, font_size)
  576. b: [4]f32
  577. fs.TextBounds(&s.fs, text, bounds = &b)
  578. return {b[2] - b[0], b[3] - b[1]}
  579. }
  580. draw_text :: proc(text: string, pos: Vec2, font_size: f32, color: Color) {
  581. draw_text_ex(s.default_font, text, pos, font_size, color)
  582. }
  583. draw_text_ex :: proc(font: Font_Handle, text: string, pos: Vec2, font_size: f32, color: Color) {
  584. if int(font) >= len(s.fonts) {
  585. return
  586. }
  587. set_font(font)
  588. font := &s.fonts[font]
  589. fs.SetSize(&s.fs, font_size)
  590. iter := fs.TextIterInit(&s.fs, pos.x, pos.y+font_size/2, text)
  591. q: fs.Quad
  592. for fs.TextIterNext(&s.fs, &iter, &q) {
  593. src := Rect {
  594. q.s0, q.t0,
  595. q.s1 - q.s0, q.t1 - q.t0,
  596. }
  597. w := f32(FONT_DEFAULT_ATLAS_SIZE)
  598. h := f32(FONT_DEFAULT_ATLAS_SIZE)
  599. src.x *= w
  600. src.y *= h
  601. src.w *= w
  602. src.h *= h
  603. dst := Rect {
  604. q.x0, q.y0,
  605. q.x1 - q.x0, q.y1 - q.y0,
  606. }
  607. draw_texture_ex(font.atlas, src, dst, {}, 0, color)
  608. }
  609. }
  610. //--------------------//
  611. // TEXTURE MANAGEMENT //
  612. //--------------------//
  613. create_texture :: proc(width: int, height: int, format: Pixel_Format) -> Texture {
  614. h := rb.create_texture(width, height, format)
  615. return {
  616. handle = h,
  617. width = width,
  618. height = height,
  619. }
  620. }
  621. // Load a texture from disk and upload it to the GPU so you can draw it to the screen.
  622. // Supports PNG, BMP, TGA and baseline PNG. Note that progressive PNG files are not supported!
  623. //
  624. // The `options` parameter can be used to specify things things such as premultiplication of alpha.
  625. load_texture_from_file :: proc(filename: string, options: Load_Texture_Options = {}) -> Texture {
  626. when FILESYSTEM_SUPPORTED {
  627. load_options := image.Options {
  628. .alpha_add_if_missing,
  629. }
  630. if .Premultiply_Alpha in options {
  631. load_options += { .alpha_premultiply }
  632. }
  633. img, img_err := image.load_from_file(filename, options = load_options, allocator = s.frame_allocator)
  634. if img_err != nil {
  635. log.errorf("Error loading texture %v: %v", filename, img_err)
  636. return {}
  637. }
  638. return load_texture_from_bytes_raw(img.pixels.buf[:], img.width, img.height, .RGBA_8_Norm)
  639. } else {
  640. log.errorf("load_texture_from_file failed: OS %v has no filesystem support!", ODIN_OS)
  641. return {}
  642. }
  643. }
  644. // TODO should we have an error here or rely on check the handle of the texture?
  645. load_texture_from_bytes :: proc(bytes: []u8, options: Load_Texture_Options = {}) -> Texture {
  646. load_options := image.Options {
  647. .alpha_add_if_missing,
  648. }
  649. if .Premultiply_Alpha in options {
  650. load_options += { .alpha_premultiply }
  651. }
  652. img, img_err := image.load_from_bytes(bytes, options = load_options, allocator = s.frame_allocator)
  653. if img_err != nil {
  654. log.errorf("Error loading texture: %v", img_err)
  655. return {}
  656. }
  657. return load_texture_from_bytes_raw(img.pixels.buf[:], img.width, img.height, .RGBA_8_Norm)
  658. }
  659. // TODO should we have an error here or rely on check the handle of the texture?
  660. load_texture_from_bytes_raw :: proc(bytes: []u8, width: int, height: int, format: Pixel_Format) -> Texture {
  661. backend_tex := rb.load_texture(bytes[:], width, height, format)
  662. if backend_tex == TEXTURE_NONE {
  663. return {}
  664. }
  665. return {
  666. handle = backend_tex,
  667. width = width,
  668. height = height,
  669. }
  670. }
  671. // Get a rectangle that spans the whole texture. Coordinates will be (x, y) = (0, 0) and size
  672. // (w, h) = (texture_width, texture_height)
  673. get_texture_rect :: proc(t: Texture) -> Rect {
  674. return {
  675. 0, 0,
  676. f32(t.width), f32(t.height),
  677. }
  678. }
  679. // Update a texture with new pixels. `bytes` is the new pixel data. `rect` is the rectangle in
  680. // `tex` where the new pixels should end up.
  681. update_texture :: proc(tex: Texture, bytes: []u8, rect: Rect) -> bool {
  682. return rb.update_texture(tex.handle, bytes, rect)
  683. }
  684. destroy_texture :: proc(tex: Texture) {
  685. rb.destroy_texture(tex.handle)
  686. }
  687. // Controls how a texture should be filtered. You can choose "point" or "linear" filtering. Which
  688. // means "pixly" or "smooth". This filter will be used for up and down-scaling as well as for
  689. // mipmap sampling. Use `set_texture_filter_ex` if you need to control these settings separately.
  690. set_texture_filter :: proc(t: Texture, filter: Texture_Filter) {
  691. set_texture_filter_ex(t, filter, filter, filter)
  692. }
  693. // Controls how a texture should be filtered. `scale_down_filter` and `scale_up_filter` controls how
  694. // the texture is filtered when we render the texture at a smaller or larger size.
  695. // `mip_filter` controls how the texture is filtered when it is sampled using _mipmapping_.
  696. //
  697. // TODO: Add mipmapping generation controls for texture and refer to it from here.
  698. set_texture_filter_ex :: proc(
  699. t: Texture,
  700. scale_down_filter: Texture_Filter,
  701. scale_up_filter: Texture_Filter,
  702. mip_filter: Texture_Filter,
  703. ) {
  704. rb.set_texture_filter(t.handle, scale_down_filter, scale_up_filter, mip_filter)
  705. }
  706. //-----------------//
  707. // RENDER TEXTURES //
  708. //-----------------//
  709. // Create a texture that you can render into. Meaning that you can draw into it instead of drawing
  710. // onto the screen. Set the texture using `set_render_texture`.
  711. create_render_texture :: proc(width: int, height: int) -> Render_Texture {
  712. texture, render_target := rb.create_render_texture(width, height)
  713. return {
  714. texture = {
  715. handle = texture,
  716. width = width,
  717. height = height,
  718. },
  719. render_target = render_target,
  720. }
  721. }
  722. // Destroy a Render_Texture previously created using `create_render_texture`.
  723. destroy_render_texture :: proc(render_texture: Render_Texture) {
  724. rb.destroy_texture(render_texture.texture.handle)
  725. rb.destroy_render_target(render_texture.render_target)
  726. }
  727. // Make all rendering go into a texture instead of onto the screen. Create the render texture using
  728. // `create_render_texture`. Pass `nil` to resume drawing onto the screen.
  729. set_render_texture :: proc(render_texture: Maybe(Render_Texture)) {
  730. if rt, rt_ok := render_texture.?; rt_ok {
  731. if s.batch_render_target == rt.render_target {
  732. return
  733. }
  734. draw_current_batch()
  735. s.batch_render_target = rt.render_target
  736. } else {
  737. if s.batch_render_target == RENDER_TARGET_NONE {
  738. return
  739. }
  740. draw_current_batch()
  741. s.batch_render_target = RENDER_TARGET_NONE
  742. }
  743. }
  744. //-------//
  745. // FONTS //
  746. //-------//
  747. load_font_from_file :: proc(filename: string) -> Font_Handle {
  748. if data, data_ok := os.read_entire_file(filename, frame_allocator); data_ok {
  749. return load_font_from_bytes(data)
  750. }
  751. return FONT_NONE
  752. }
  753. load_font_from_bytes :: proc(data: []u8) -> Font_Handle {
  754. font := fs.AddFontMem(&s.fs, "", data, false)
  755. h := Font_Handle(len(s.fonts))
  756. append(&s.fonts, Font {
  757. fontstash_handle = font,
  758. atlas = {
  759. handle = rb.create_texture(FONT_DEFAULT_ATLAS_SIZE, FONT_DEFAULT_ATLAS_SIZE, .RGBA_8_Norm),
  760. width = FONT_DEFAULT_ATLAS_SIZE,
  761. height = FONT_DEFAULT_ATLAS_SIZE,
  762. },
  763. })
  764. return h
  765. }
  766. destroy_font :: proc(font: Font_Handle) {
  767. if int(font) >= len(s.fonts) {
  768. return
  769. }
  770. f := &s.fonts[font]
  771. rb.destroy_texture(f.atlas.handle)
  772. // TODO fontstash has no "destroy font" proc... I should make my own version of fontstash
  773. delete(s.fs.fonts[f.fontstash_handle].glyphs)
  774. s.fs.fonts[f.fontstash_handle].glyphs = {}
  775. }
  776. get_default_font :: proc() -> Font_Handle {
  777. return s.default_font
  778. }
  779. //---------//
  780. // SHADERS //
  781. //---------//
  782. load_shader_from_file :: proc(
  783. vertex_filename: string,
  784. fragment_filename: string,
  785. layout_formats: []Pixel_Format = {}
  786. ) -> Shader {
  787. vertex_source, vertex_source_ok := os.read_entire_file(vertex_filename, frame_allocator)
  788. if !vertex_source_ok {
  789. log.errorf("Failed loading shader %s", vertex_filename)
  790. return {}
  791. }
  792. fragment_source: []byte
  793. if fragment_filename == vertex_filename {
  794. fragment_source = vertex_source
  795. } else {
  796. fragment_source_ok: bool
  797. fragment_source, fragment_source_ok = os.read_entire_file(fragment_filename, frame_allocator)
  798. if !fragment_source_ok {
  799. log.errorf("Failed loading shader %s", fragment_filename)
  800. return {}
  801. }
  802. }
  803. return load_shader_from_memory(vertex_source, fragment_source, layout_formats)
  804. }
  805. load_shader_from_memory :: proc(
  806. vertex_shader_bytes: []byte,
  807. fragment_shader_bytes: []byte,
  808. layout_formats: []Pixel_Format = {},
  809. ) -> Shader {
  810. handle, desc := rb.load_shader(
  811. vertex_shader_bytes,
  812. fragment_shader_bytes,
  813. s.frame_allocator,
  814. layout_formats,
  815. )
  816. if handle == SHADER_NONE {
  817. log.error("Failed loading shader")
  818. return {}
  819. }
  820. constants_size: int
  821. for c in desc.constants {
  822. constants_size += c.size
  823. }
  824. shd := Shader {
  825. handle = handle,
  826. constants_data = make([]u8, constants_size, s.allocator),
  827. constants = make([]Shader_Constant_Location, len(desc.constants), s.allocator),
  828. constant_lookup = make(map[string]Shader_Constant_Location, s.allocator),
  829. inputs = slice.clone(desc.inputs, s.allocator),
  830. input_overrides = make([]Shader_Input_Value_Override, len(desc.inputs), s.allocator),
  831. texture_bindpoints = make([]Texture_Handle, len(desc.texture_bindpoints), s.allocator),
  832. texture_lookup = make(map[string]int, s.allocator),
  833. }
  834. for &input in shd.inputs {
  835. input.name = strings.clone(input.name, s.allocator)
  836. }
  837. constant_offset: int
  838. for cidx in 0..<len(desc.constants) {
  839. constant_desc := &desc.constants[cidx]
  840. loc := Shader_Constant_Location {
  841. offset = constant_offset,
  842. size = constant_desc.size,
  843. }
  844. shd.constants[cidx] = loc
  845. constant_offset += constant_desc.size
  846. if constant_desc.name != "" {
  847. shd.constant_lookup[strings.clone(constant_desc.name, s.allocator)] = loc
  848. switch constant_desc.name {
  849. case "mvp":
  850. shd.constant_builtin_locations[.MVP] = loc
  851. }
  852. }
  853. }
  854. for tbp, tbp_idx in desc.texture_bindpoints {
  855. shd.texture_lookup[tbp.name] = tbp_idx
  856. if tbp.name == "tex" {
  857. shd.default_texture_index = tbp_idx
  858. }
  859. }
  860. for &d in shd.default_input_offsets {
  861. d = -1
  862. }
  863. input_offset: int
  864. for &input in shd.inputs {
  865. default_format := get_shader_input_default_type(input.name, input.type)
  866. if default_format != .Unknown {
  867. shd.default_input_offsets[default_format] = input_offset
  868. }
  869. input_offset += pixel_format_size(input.format)
  870. }
  871. shd.vertex_size = input_offset
  872. return shd
  873. }
  874. destroy_shader :: proc(shader: Shader) {
  875. rb.destroy_shader(shader.handle)
  876. a := s.allocator
  877. delete(shader.constants_data, a)
  878. delete(shader.constants, a)
  879. delete(shader.texture_lookup)
  880. delete(shader.texture_bindpoints, a)
  881. for k, _ in shader.constant_lookup {
  882. delete(k, a)
  883. }
  884. delete(shader.constant_lookup)
  885. for i in shader.inputs {
  886. delete(i.name, a)
  887. }
  888. delete(shader.inputs, a)
  889. delete(shader.input_overrides, a)
  890. }
  891. get_default_shader :: proc() -> Shader {
  892. return s.default_shader
  893. }
  894. set_shader :: proc(shader: Maybe(Shader)) {
  895. if shd, shd_ok := shader.?; shd_ok {
  896. if shd.handle == s.batch_shader.handle {
  897. return
  898. }
  899. } else {
  900. if s.batch_shader.handle == s.default_shader.handle {
  901. return
  902. }
  903. }
  904. draw_current_batch()
  905. s.batch_shader = shader.? or_else s.default_shader
  906. }
  907. set_shader_constant :: proc(shd: Shader, loc: Shader_Constant_Location, val: any) {
  908. if shd.handle == SHADER_NONE {
  909. log.error("Invalid shader")
  910. return
  911. }
  912. if loc.size == 0 {
  913. log.error("Could not find shader constant")
  914. return
  915. }
  916. draw_current_batch()
  917. if loc.offset + loc.size > len(shd.constants_data) {
  918. log.errorf("Constant with offset %v and size %v is out of bounds. Buffer ends at %v", loc.offset, loc.size, len(shd.constants_data))
  919. return
  920. }
  921. sz := reflect.size_of_typeid(val.id)
  922. if sz != loc.size {
  923. log.errorf("Trying to set constant of type %v, but it is not of correct size %v", val.id, loc.size)
  924. return
  925. }
  926. mem.copy(&shd.constants_data[loc.offset], val.data, sz)
  927. }
  928. override_shader_input :: proc(shader: Shader, input: int, val: any) {
  929. sz := reflect.size_of_typeid(val.id)
  930. assert(sz < SHADER_INPUT_VALUE_MAX_SIZE)
  931. if input >= len(shader.input_overrides) {
  932. log.errorf("Input override out of range. Wanted to override input %v, but shader only has %v inputs", input, len(shader.input_overrides))
  933. return
  934. }
  935. o := &shader.input_overrides[input]
  936. o.val = {}
  937. if sz > 0 {
  938. mem.copy(raw_data(&o.val), val.data, sz)
  939. }
  940. o.used = sz
  941. }
  942. pixel_format_size :: proc(f: Pixel_Format) -> int {
  943. switch f {
  944. case .Unknown: return 0
  945. case .RGBA_32_Float: return 32
  946. case .RGB_32_Float: return 12
  947. case .RG_32_Float: return 8
  948. case .R_32_Float: return 4
  949. case .RGBA_8_Norm: return 4
  950. case .RG_8_Norm: return 2
  951. case .R_8_Norm: return 1
  952. case .R_8_UInt: return 1
  953. }
  954. return 0
  955. }
  956. //-------------------------------//
  957. // CAMERA AND COORDINATE SYSTEMS //
  958. //-------------------------------//
  959. set_camera :: proc(camera: Maybe(Camera)) {
  960. if camera == s.batch_camera {
  961. return
  962. }
  963. draw_current_batch()
  964. s.batch_camera = camera
  965. s.proj_matrix = make_default_projection(win.get_width(), win.get_height())
  966. if c, c_ok := camera.?; c_ok {
  967. s.view_matrix = get_camera_view_matrix(c)
  968. } else {
  969. s.view_matrix = 1
  970. }
  971. }
  972. screen_to_world :: proc(pos: Vec2, camera: Camera) -> Vec2 {
  973. return (get_camera_world_matrix(camera) * Vec4 { pos.x, pos.y, 0, 1 }).xy
  974. }
  975. world_to_screen :: proc(pos: Vec2, camera: Camera) -> Vec2 {
  976. return (get_camera_view_matrix(camera) * Vec4 { pos.x, pos.y, 0, 1 }).xy
  977. }
  978. get_camera_view_matrix :: proc(c: Camera) -> Mat4 {
  979. inv_target_translate := linalg.matrix4_translate(vec3_from_vec2(-c.target))
  980. inv_rot := linalg.matrix4_rotate_f32(c.rotation * math.RAD_PER_DEG, {0, 0, 1})
  981. inv_scale := linalg.matrix4_scale(Vec3{c.zoom, c.zoom, 1})
  982. inv_offset_translate := linalg.matrix4_translate(vec3_from_vec2(c.offset))
  983. // A view matrix is essentially the world transform matrix of the camera, but inverted. We
  984. // bring everything in the world "in front of the camera".
  985. //
  986. // Instead of constructing the camera matrix and doing a matrix inverse, here we just do the
  987. // maths in "backwards order". I.e. a camera transform matrix would be:
  988. //
  989. // target_translate * rot * scale * offset_translate
  990. return inv_offset_translate * inv_scale * inv_rot * inv_target_translate
  991. }
  992. get_camera_world_matrix :: proc(c: Camera) -> Mat4 {
  993. offset_translate := linalg.matrix4_translate(vec3_from_vec2(-c.offset))
  994. rot := linalg.matrix4_rotate_f32(-c.rotation * math.RAD_PER_DEG, {0, 0, 1})
  995. scale := linalg.matrix4_scale(Vec3{1/c.zoom, 1/c.zoom, 1})
  996. target_translate := linalg.matrix4_translate(vec3_from_vec2(c.target))
  997. return target_translate * rot * scale * offset_translate
  998. }
  999. //------//
  1000. // MISC //
  1001. //------//
  1002. // Choose how the alpha channel is used when mixing half-transparent color with what is already
  1003. // drawn. The default is the .Alpha mode, but you also have the option of using .Premultiply_Alpha.
  1004. set_blend_mode :: proc(mode: Blend_Mode) {
  1005. if s.batch_blend_mode == mode {
  1006. return
  1007. }
  1008. draw_current_batch()
  1009. s.batch_blend_mode = mode
  1010. }
  1011. set_scissor_rect :: proc(scissor_rect: Maybe(Rect)) {
  1012. draw_current_batch()
  1013. s.batch_scissor = scissor_rect
  1014. }
  1015. // Restore the internal state using the pointer returned by `init`. Useful after reloading the
  1016. // library (for example, when doing code hot reload).
  1017. set_internal_state :: proc(state: ^State) {
  1018. s = state
  1019. rb = s.rb
  1020. win = s.win
  1021. rb.set_internal_state(s.rb_state)
  1022. win.set_internal_state(s.window_state)
  1023. }
  1024. //---------------------//
  1025. // TYPES AND CONSTANTS //
  1026. //---------------------//
  1027. Vec2 :: [2]f32
  1028. Vec3 :: [3]f32
  1029. Vec4 :: [4]f32
  1030. Mat4 :: matrix[4,4]f32
  1031. // A two dimensional vector of integer numeric type.
  1032. Vec2i :: [2]int
  1033. // A rectangle that sits at position (x, y) and has size (w, h).
  1034. Rect :: struct {
  1035. x, y: f32,
  1036. w, h: f32,
  1037. }
  1038. // An RGBA (Red, Green, Blue, Alpha) color. Each channel can have a value between 0 and 255.
  1039. Color :: [4]u8
  1040. WHITE :: Color { 255, 255, 255, 255 }
  1041. BLACK :: Color { 0, 0, 0, 255 }
  1042. GRAY :: Color { 127, 127, 127, 255 }
  1043. RED :: Color { 198, 40, 90, 255 }
  1044. GREEN :: Color { 30, 240, 30, 255 }
  1045. BLANK :: Color { 0, 0, 0, 0 }
  1046. BLUE :: Color { 30, 116, 240, 255 }
  1047. // These are from Raylib. They are here so you can easily port a Raylib program to Karl2D.
  1048. RL_LIGHTGRAY :: Color { 200, 200, 200, 255 }
  1049. RL_GRAY :: Color { 130, 130, 130, 255 }
  1050. RL_DARKGRAY :: Color { 80, 80, 80, 255 }
  1051. RL_YELLOW :: Color { 253, 249, 0, 255 }
  1052. RL_GOLD :: Color { 255, 203, 0, 255 }
  1053. RL_ORANGE :: Color { 255, 161, 0, 255 }
  1054. RL_PINK :: Color { 255, 109, 194, 255 }
  1055. RL_RED :: Color { 230, 41, 55, 255 }
  1056. RL_MAROON :: Color { 190, 33, 55, 255 }
  1057. RL_GREEN :: Color { 0, 228, 48, 255 }
  1058. RL_LIME :: Color { 0, 158, 47, 255 }
  1059. RL_DARKGREEN :: Color { 0, 117, 44, 255 }
  1060. RL_SKYBLUE :: Color { 102, 191, 255, 255 }
  1061. RL_BLUE :: Color { 0, 121, 241, 255 }
  1062. RL_DARKBLUE :: Color { 0, 82, 172, 255 }
  1063. RL_PURPLE :: Color { 200, 122, 255, 255 }
  1064. RL_VIOLET :: Color { 135, 60, 190, 255 }
  1065. RL_DARKPURPLE :: Color { 112, 31, 126, 255 }
  1066. RL_BEIGE :: Color { 211, 176, 131, 255 }
  1067. RL_BROWN :: Color { 127, 106, 79, 255 }
  1068. RL_DARKBROWN :: Color { 76, 63, 47, 255 }
  1069. RL_WHITE :: WHITE
  1070. RL_BLACK :: BLACK
  1071. RL_BLANK :: BLANK
  1072. RL_MAGENTA :: Color { 255, 0, 255, 255 }
  1073. RL_RAYWHITE :: Color { 245, 245, 245, 255 }
  1074. Texture :: struct {
  1075. handle: Texture_Handle,
  1076. width: int,
  1077. height: int,
  1078. }
  1079. Load_Texture_Option :: enum {
  1080. Premultiply_Alpha,
  1081. }
  1082. Load_Texture_Options :: bit_set[Load_Texture_Option]
  1083. Blend_Mode :: enum {
  1084. Alpha,
  1085. Premultiplied_Alpha, // Requires the alpha-channel to be multiplied into texture RGB channels.
  1086. }
  1087. Render_Texture :: struct {
  1088. texture: Texture,
  1089. render_target: Render_Target_Handle,
  1090. }
  1091. Texture_Filter :: enum {
  1092. Point, // Similar to "nearest neighbor". Pixly texture scaling.
  1093. Linear, // Smoothed texture scaling.
  1094. }
  1095. Camera :: struct {
  1096. target: Vec2,
  1097. offset: Vec2,
  1098. rotation: f32,
  1099. zoom: f32,
  1100. }
  1101. Window_Flag :: enum {
  1102. Resizable,
  1103. }
  1104. Window_Flags :: bit_set[Window_Flag]
  1105. Shader_Handle :: distinct Handle
  1106. SHADER_NONE :: Shader_Handle {}
  1107. Shader_Constant_Location :: struct {
  1108. offset: int,
  1109. size: int,
  1110. }
  1111. Shader :: struct {
  1112. handle: Shader_Handle,
  1113. // We store the CPU-side value of all constants in a single buffer to have less allocations.
  1114. // The 'constants' array says where in this buffer each constant is, and 'constant_lookup'
  1115. // maps a name to a constant location.
  1116. constants_data: []u8,
  1117. constants: []Shader_Constant_Location,
  1118. constant_lookup: map[string]Shader_Constant_Location,
  1119. // Maps built in constant types such as "model view projection matrix" to a location.
  1120. constant_builtin_locations: [Shader_Builtin_Constant]Maybe(Shader_Constant_Location),
  1121. texture_bindpoints: []Texture_Handle,
  1122. texture_lookup: map[string]int,
  1123. default_texture_index: Maybe(int),
  1124. inputs: []Shader_Input,
  1125. input_overrides: []Shader_Input_Value_Override,
  1126. default_input_offsets: [Shader_Default_Inputs]int,
  1127. vertex_size: int,
  1128. }
  1129. SHADER_INPUT_VALUE_MAX_SIZE :: 256
  1130. Shader_Input_Value_Override :: struct {
  1131. val: [SHADER_INPUT_VALUE_MAX_SIZE]u8,
  1132. used: int,
  1133. }
  1134. Shader_Input_Type :: enum {
  1135. F32,
  1136. Vec2,
  1137. Vec3,
  1138. Vec4,
  1139. }
  1140. Shader_Builtin_Constant :: enum {
  1141. MVP,
  1142. }
  1143. Shader_Default_Inputs :: enum {
  1144. Unknown,
  1145. Position,
  1146. UV,
  1147. Color,
  1148. }
  1149. Shader_Input :: struct {
  1150. name: string,
  1151. register: int,
  1152. type: Shader_Input_Type,
  1153. format: Pixel_Format,
  1154. }
  1155. Pixel_Format :: enum {
  1156. Unknown,
  1157. RGBA_32_Float,
  1158. RGB_32_Float,
  1159. RG_32_Float,
  1160. R_32_Float,
  1161. RGBA_8_Norm,
  1162. RG_8_Norm,
  1163. R_8_Norm,
  1164. R_8_UInt,
  1165. }
  1166. Font :: struct {
  1167. atlas: Texture,
  1168. // internal
  1169. fontstash_handle: int,
  1170. }
  1171. Handle :: hm.Handle
  1172. Texture_Handle :: distinct Handle
  1173. Render_Target_Handle :: distinct Handle
  1174. Font_Handle :: distinct int
  1175. FONT_NONE :: Font_Handle {}
  1176. TEXTURE_NONE :: Texture_Handle {}
  1177. RENDER_TARGET_NONE :: Render_Target_Handle {}
  1178. // This keeps track of the internal state of the library. Usually, you do not need to poke at it.
  1179. // It is created and kept as a global variable when 'init' is called. However, 'init' also returns
  1180. // the pointer to it, so you can later use 'set_internal_state' to restore it (after for example hot
  1181. // reload).
  1182. State :: struct {
  1183. allocator: runtime.Allocator,
  1184. frame_arena: runtime.Arena,
  1185. frame_allocator: runtime.Allocator,
  1186. win: Window_Interface,
  1187. window_state: rawptr,
  1188. rb: Render_Backend_Interface,
  1189. rb_state: rawptr,
  1190. fs: fs.FontContext,
  1191. shutdown_wanted: bool,
  1192. mouse_position: Vec2,
  1193. mouse_delta: Vec2,
  1194. mouse_wheel_delta: f32,
  1195. key_went_down: #sparse [Keyboard_Key]bool,
  1196. key_went_up: #sparse [Keyboard_Key]bool,
  1197. key_is_held: #sparse [Keyboard_Key]bool,
  1198. mouse_button_went_down: #sparse [Mouse_Button]bool,
  1199. mouse_button_went_up: #sparse [Mouse_Button]bool,
  1200. mouse_button_is_held: #sparse [Mouse_Button]bool,
  1201. gamepad_button_went_down: [MAX_GAMEPADS]#sparse [Gamepad_Button]bool,
  1202. gamepad_button_went_up: [MAX_GAMEPADS]#sparse [Gamepad_Button]bool,
  1203. gamepad_button_is_held: [MAX_GAMEPADS]#sparse [Gamepad_Button]bool,
  1204. window: Window_Handle,
  1205. default_font: Font_Handle,
  1206. fonts: [dynamic]Font,
  1207. shape_drawing_texture: Texture_Handle,
  1208. batch_font: Font_Handle,
  1209. batch_camera: Maybe(Camera),
  1210. batch_shader: Shader,
  1211. batch_scissor: Maybe(Rect),
  1212. batch_texture: Texture_Handle,
  1213. batch_render_target: Render_Target_Handle,
  1214. batch_blend_mode: Blend_Mode,
  1215. view_matrix: Mat4,
  1216. proj_matrix: Mat4,
  1217. depth: f32,
  1218. depth_start: f32,
  1219. depth_increment: f32,
  1220. vertex_buffer_cpu: []u8,
  1221. vertex_buffer_cpu_used: int,
  1222. default_shader: Shader,
  1223. }
  1224. // Support for up to 255 mouse buttons. Cast an int to type `Mouse_Button` to use things outside the
  1225. // options presented here.
  1226. Mouse_Button :: enum {
  1227. Left,
  1228. Right,
  1229. Middle,
  1230. Max = 255,
  1231. }
  1232. // Based on Raylib / GLFW
  1233. Keyboard_Key :: enum {
  1234. None = 0,
  1235. // Numeric keys (top row)
  1236. N0 = 48,
  1237. N1 = 49,
  1238. N2 = 50,
  1239. N3 = 51,
  1240. N4 = 52,
  1241. N5 = 53,
  1242. N6 = 54,
  1243. N7 = 55,
  1244. N8 = 56,
  1245. N9 = 57,
  1246. // Letter keys
  1247. A = 65,
  1248. B = 66,
  1249. C = 67,
  1250. D = 68,
  1251. E = 69,
  1252. F = 70,
  1253. G = 71,
  1254. H = 72,
  1255. I = 73,
  1256. J = 74,
  1257. K = 75,
  1258. L = 76,
  1259. M = 77,
  1260. N = 78,
  1261. O = 79,
  1262. P = 80,
  1263. Q = 81,
  1264. R = 82,
  1265. S = 83,
  1266. T = 84,
  1267. U = 85,
  1268. V = 86,
  1269. W = 87,
  1270. X = 88,
  1271. Y = 89,
  1272. Z = 90,
  1273. // Special characters
  1274. Apostrophe = 39,
  1275. Comma = 44,
  1276. Minus = 45,
  1277. Period = 46,
  1278. Slash = 47,
  1279. Semicolon = 59,
  1280. Equal = 61,
  1281. Left_Bracket = 91,
  1282. Backslash = 92,
  1283. Right_Bracket = 93,
  1284. Grave_Accent = 96,
  1285. // Function keys, modifiers, caret control etc
  1286. Space = 32,
  1287. Escape = 256,
  1288. Enter = 257,
  1289. Tab = 258,
  1290. Backspace = 259,
  1291. Insert = 260,
  1292. Delete = 261,
  1293. Right = 262,
  1294. Left = 263,
  1295. Down = 264,
  1296. Up = 265,
  1297. Page_Up = 266,
  1298. Page_Down = 267,
  1299. Home = 268,
  1300. End = 269,
  1301. Caps_Lock = 280,
  1302. Scroll_Lock = 281,
  1303. Num_Lock = 282,
  1304. Print_Screen = 283,
  1305. Pause = 284,
  1306. F1 = 290,
  1307. F2 = 291,
  1308. F3 = 292,
  1309. F4 = 293,
  1310. F5 = 294,
  1311. F6 = 295,
  1312. F7 = 296,
  1313. F8 = 297,
  1314. F9 = 298,
  1315. F10 = 299,
  1316. F11 = 300,
  1317. F12 = 301,
  1318. Left_Shift = 340,
  1319. Left_Control = 341,
  1320. Left_Alt = 342,
  1321. Left_Super = 343,
  1322. Right_Shift = 344,
  1323. Right_Control = 345,
  1324. Right_Alt = 346,
  1325. Right_Super = 347,
  1326. Menu = 348,
  1327. // Numpad keys
  1328. NP_0 = 320,
  1329. NP_1 = 321,
  1330. NP_2 = 322,
  1331. NP_3 = 323,
  1332. NP_4 = 324,
  1333. NP_5 = 325,
  1334. NP_6 = 326,
  1335. NP_7 = 327,
  1336. NP_8 = 328,
  1337. NP_9 = 329,
  1338. NP_Decimal = 330,
  1339. NP_Divide = 331,
  1340. NP_Multiply = 332,
  1341. NP_Subtract = 333,
  1342. NP_Add = 334,
  1343. NP_Enter = 335,
  1344. NP_Equal = 336,
  1345. }
  1346. MAX_GAMEPADS :: 4
  1347. // A value between 0 and MAX_GAMEPADS - 1
  1348. Gamepad_Index :: int
  1349. Gamepad_Axis :: enum {
  1350. Left_Stick_X,
  1351. Left_Stick_Y,
  1352. Right_Stick_X,
  1353. Right_Stick_Y,
  1354. Left_Trigger,
  1355. Right_Trigger,
  1356. }
  1357. Gamepad_Button :: enum {
  1358. // DPAD buttons
  1359. Left_Face_Up,
  1360. Left_Face_Down,
  1361. Left_Face_Left,
  1362. Left_Face_Right,
  1363. Right_Face_Up, // XBOX: Y, PS: Triangle
  1364. Right_Face_Down, // XBOX: A, PS: X
  1365. Right_Face_Left, // XBOX: X, PS: Square
  1366. Right_Face_Right, // XBOX: B, PS: Circle
  1367. Left_Shoulder,
  1368. Left_Trigger,
  1369. Right_Shoulder,
  1370. Right_Trigger,
  1371. Left_Stick_Press, // Clicking the left analogue stick
  1372. Right_Stick_Press, // Clicking the right analogue stick
  1373. Middle_Face_Left, // Select / back / options button
  1374. Middle_Face_Middle, // PS button (not available on XBox)
  1375. Middle_Face_Right, // Start
  1376. }
  1377. // Used by API builder. Everything after this constant will not be in karl2d.doc.odin
  1378. API_END :: true
  1379. batch_vertex :: proc(v: Vec3, uv: Vec2, color: Color) {
  1380. v := v
  1381. if s.vertex_buffer_cpu_used == len(s.vertex_buffer_cpu) {
  1382. draw_current_batch()
  1383. }
  1384. shd := s.batch_shader
  1385. base_offset := s.vertex_buffer_cpu_used
  1386. pos_offset := shd.default_input_offsets[.Position]
  1387. uv_offset := shd.default_input_offsets[.UV]
  1388. color_offset := shd.default_input_offsets[.Color]
  1389. mem.set(&s.vertex_buffer_cpu[base_offset], 0, shd.vertex_size)
  1390. if pos_offset != -1 {
  1391. (^Vec3)(&s.vertex_buffer_cpu[base_offset + pos_offset])^ = v
  1392. }
  1393. if uv_offset != -1 {
  1394. (^Vec2)(&s.vertex_buffer_cpu[base_offset + uv_offset])^ = uv
  1395. }
  1396. if color_offset != -1 {
  1397. (^Color)(&s.vertex_buffer_cpu[base_offset + color_offset])^ = color
  1398. }
  1399. override_offset: int
  1400. for &o, idx in shd.input_overrides {
  1401. input := &shd.inputs[idx]
  1402. sz := pixel_format_size(input.format)
  1403. if o.used != 0 {
  1404. mem.copy(&s.vertex_buffer_cpu[base_offset + override_offset], raw_data(&o.val), o.used)
  1405. }
  1406. override_offset += sz
  1407. }
  1408. s.vertex_buffer_cpu_used += shd.vertex_size
  1409. }
  1410. VERTEX_BUFFER_MAX :: 1000000
  1411. @(private="file")
  1412. s: ^State
  1413. // These globals are here for access from other files. The state struct above is private to make
  1414. // sure global state sharing doesn't become too messy.
  1415. frame_allocator: runtime.Allocator
  1416. win: Window_Interface
  1417. rb: Render_Backend_Interface
  1418. get_shader_input_default_type :: proc(name: string, type: Shader_Input_Type) -> Shader_Default_Inputs {
  1419. if name == "position" && type == .Vec3 {
  1420. return .Position
  1421. } else if name == "texcoord" && type == .Vec2 {
  1422. return .UV
  1423. } else if name == "color" && type == .Vec4 {
  1424. return .Color
  1425. }
  1426. return .Unknown
  1427. }
  1428. get_shader_format_num_components :: proc(format: Pixel_Format) -> int {
  1429. switch format {
  1430. case .Unknown: return 0
  1431. case .RGBA_32_Float: return 4
  1432. case .RGB_32_Float: return 3
  1433. case .RG_32_Float: return 2
  1434. case .R_32_Float: return 1
  1435. case .RGBA_8_Norm: return 4
  1436. case .RG_8_Norm: return 2
  1437. case .R_8_Norm: return 1
  1438. case .R_8_UInt: return 1
  1439. }
  1440. return 0
  1441. }
  1442. get_shader_input_format :: proc(name: string, type: Shader_Input_Type) -> Pixel_Format {
  1443. default_type := get_shader_input_default_type(name, type)
  1444. if default_type != .Unknown {
  1445. switch default_type {
  1446. case .Position: return .RGB_32_Float
  1447. case .UV: return .RG_32_Float
  1448. case .Color: return .RGBA_8_Norm
  1449. case .Unknown: unreachable()
  1450. }
  1451. }
  1452. switch type {
  1453. case .F32: return .R_32_Float
  1454. case .Vec2: return .RG_32_Float
  1455. case .Vec3: return .RGB_32_Float
  1456. case .Vec4: return .RGBA_32_Float
  1457. }
  1458. return .Unknown
  1459. }
  1460. vec3_from_vec2 :: proc(v: Vec2) -> Vec3 {
  1461. return {
  1462. v.x, v.y, 0,
  1463. }
  1464. }
  1465. frame_cstring :: proc(str: string, loc := #caller_location) -> cstring {
  1466. return strings.clone_to_cstring(str, s.frame_allocator, loc)
  1467. }
  1468. @(require_results)
  1469. matrix_ortho3d_f32 :: proc "contextless" (left, right, bottom, top, near, far: f32) -> Mat4 #no_bounds_check {
  1470. m: Mat4
  1471. m[0, 0] = +2 / (right - left)
  1472. m[1, 1] = +2 / (top - bottom)
  1473. m[2, 2] = +1
  1474. m[0, 3] = -(right + left) / (right - left)
  1475. m[1, 3] = -(top + bottom) / (top - bottom)
  1476. m[2, 3] = 0
  1477. m[3, 3] = 1
  1478. return m
  1479. }
  1480. make_default_projection :: proc(w, h: int) -> matrix[4,4]f32 {
  1481. return matrix_ortho3d_f32(0, f32(w), f32(h), 0, 0.001, 2)
  1482. }
  1483. FONT_DEFAULT_ATLAS_SIZE :: 1024
  1484. update_font :: proc(fh: Font_Handle) {
  1485. font := &s.fonts[fh]
  1486. font_dirty_rect: [4]f32
  1487. tw := FONT_DEFAULT_ATLAS_SIZE
  1488. if fs.ValidateTexture(&s.fs, &font_dirty_rect) {
  1489. fdr := font_dirty_rect
  1490. r := Rect {
  1491. fdr[0],
  1492. fdr[1],
  1493. fdr[2] - fdr[0],
  1494. fdr[3] - fdr[1],
  1495. }
  1496. x := int(r.x)
  1497. y := int(r.y)
  1498. w := int(fdr[2]) - int(fdr[0])
  1499. h := int(fdr[3]) - int(fdr[1])
  1500. expanded_pixels := make([]Color, w * h, frame_allocator)
  1501. start := x + tw * y
  1502. for i in 0..<w*h {
  1503. px := i%w
  1504. py := i/w
  1505. dst_pixel_idx := (px) + (py * w)
  1506. src_pixel_idx := start + (px) + (py * tw)
  1507. src := s.fs.textureData[src_pixel_idx]
  1508. expanded_pixels[dst_pixel_idx] = {255,255,255, src}
  1509. }
  1510. rb.update_texture(font.atlas.handle, slice.reinterpret([]u8, expanded_pixels), r)
  1511. }
  1512. }
  1513. set_font :: proc(fh: Font_Handle) {
  1514. fh := fh
  1515. if s.batch_font == fh {
  1516. return
  1517. }
  1518. s.batch_font = fh
  1519. if s.batch_font != FONT_NONE {
  1520. update_font(s.batch_font)
  1521. }
  1522. if fh == 0 {
  1523. fh = s.default_font
  1524. }
  1525. font := &s.fonts[fh]
  1526. fs.SetFont(&s.fs, font.fontstash_handle)
  1527. }
  1528. DEPTH_START :: -1 + DEPTH_INCREMENT
  1529. DEPTH_INCREMENT :: (1.0/10000000.0)
  1530. _ :: jpeg
  1531. _ :: bmp
  1532. _ :: png
  1533. _ :: tga
  1534. Color_F32 :: [4]f32
  1535. f32_color_from_color :: proc(color: Color) -> Color_F32 {
  1536. return {
  1537. f32(color.r) / 255,
  1538. f32(color.g) / 255,
  1539. f32(color.b) / 255,
  1540. f32(color.a) / 255,
  1541. }
  1542. }
  1543. vec3 :: proc(v2: Vec2, z: f32) -> Vec3 {
  1544. return {
  1545. v2.x, v2.y, z,
  1546. }
  1547. }
  1548. get_next_depth :: proc() -> f32 {
  1549. d := s.depth
  1550. s.depth += s.depth_increment
  1551. return d
  1552. }
  1553. FILESYSTEM_SUPPORTED :: ODIN_OS != .JS && ODIN_OS != .Freestanding