helpless/changelog.txt

## v0.01.003 - Stuff
	- Os layer
		- Implemented setting of mouse pointers, either to system standard pointers or a custom image
		- Ignore SETCURSOR events unless window resize
		- Store SYSTEM_INFO in init
		- os_get_number_of_logical_processors()
	
	- Renderer
		- Fix bad uv sampling bug when uneven window dimensions
	
	- Memory
		- Made program_memory act more like an arena (see os_reserve_next_memory_pages() & os_unlock_program_memory_pages())
		- In debug, default program memory to PAGE_NOACCESS which needs to be unlocked with os_unlock_program_memory_pages() (better crashes if we touch that memory)
		- os_lock_program_memory_pages
		- Heap locks pages when completely free
	
	- Misc
		- Deprecate Rangef stuff
		- peek_random()
		- Update #Contributions
		- Clean up memory barriers in concurrency.c and use volatile instead
		- Output d3d11 debug messages before crash on hr fail
		- Configurable temporary storage size for new threads
		- Cleanup temporary storage after thread destroy


## v0.01.002 - Flexible build options, Hotloading, growing array
    - Build system
        - We can now compile with:
            OOGABOOGA_HEADLESS: No window, graphics or audio
            OOGABOOGA_BUILD_SHARED_LIBRARY: Build oogabooga as a shared library (dll)
            OOGABOOGA_LINK_EXTERNAL_INSTANCE: Link to an external oogabooga global state instance
        - See oogabooga/examples/hotload for an example on how we can set up a project with hotloaded code
    
    - Misc
        - Better examples in custom_shader.c, & outlined circle
        - Z-Sorting in the renderer is now stable
        - Growing array
            - oogabooga/examples/growing_array_example.c
        

## v0.01.001 - Spacial audio, custom shading, scissor boxing
	- Audio
		- Implemented spacial audio playback
			Simply set player->position (it's in ndc space (-1 to 1), see audio_test.c)
			Save some computation with player->disable_spacialization = true
		- Added position overloads for play_one_clip
			play_one_audio_clip_source_at_position(source, pos)
			play_one_audio_clip_at_position(path, pos)
		- Implemented volume control with player->volume
	- Renderer
		- Implemented custom shading
			- Recompile shader with your extension to the pixel stage with
				shader_recompile_with_extension(source, cbuffer_size)
			- pass a buffer to the shader constant buffer at b0 with
				draw_frame.cbuffer = &my_cbuffer_data
			- pass userdata in the form of Vector4's
				define VERTEX_2D_USER_DATA_COUNT for the amount of Vertex4 userdata's to be part of each vertex.
				You can set the userdata in Draw_Quad->userdata which is a Vector4[VERTEX_2D_USER_DATA_COUNT].
				See custom_shading.c example.
		- Added window scissor boxing (screen space)
			push_window_scissor(min, max);
			pop_window_scissor();
		- Added draw_circle() and draw_circle_xform in drawing.c
		- Made an example for custom shading (oogabooga/examples/custom_shading.c)
		- Embed default shader into codebase & always compile
		- Added draw_line(p0, p1, width, color)
		- Implemented culling of quads out of view
		- Fixed culling bug where big rectangles that overlapped the screen but had all corners outside the screen would get culled.
	- Misc
		- Improved text measure and added a better explanation for it in font.c.
		- Added some useful Vector procedures:
			vx_length()
			vx_normalize()
			vx_average()
			vx_dot()
			vx_abs()
			vx_cross()
		- added os_get_file_size_from_Path()
		- Some simple restructuring of existing code
	   - Made heap corruption detection more robust

## v0.01.000 - AUDIO!
	- Added audio sources
		- File stream sources & Fully decoded sources
		- 16-bit int & 32-bit float support
		- WAV & OGG support (in-house wav decoder, stb_vorbis for ogg)
		- Usage:
			bool audio_open_source_stream(*src, path, allocator)
			bool audio_open_source_load(*src, path, allocator)
			void audio_source_destroy(*src)
	- Added audio playback
		- The simple way:
			play_one_audio_clip_source(source);
			play_one_audio_clip(path);
		- With Audio_Player:
			audio_player_get_one();
			audio_player_release(*player);
			audio_player_set_state(*player, state);
			audio_player_set_time_stamp(*player, time_in_seconds);
			audio_player_set_progression_factor(*player, factor);
			audio_player_get_time_stamp(*player);
			audio_player_get_current_progression_factor(*player);
			audio_player_set_source(*player, src, bool retain_progression_factor);
			audio_player_clear_source(*player);
			audio_player_set_looping(*player, bool looping);
	- Added some basic features in the audio system
		- Conversion & resampling between audio formats
		- Automatically detects new default device
		- Small fade in pause/play for less noise from sudden changes in playback buffer
	- Added a audio_test.c example
	- More OS procuedres
		- os_file_set_pos(file, pos)
		- os_file_get_pos(file)
		- os_file_get_size(file)
		- os_get_stack_trace(allocator)
	- Misc
		- Win32 audio impl
		- Link to more win32 junk
		- Make default logger thread safe
		- Rename tm_scope_cycles & tm_scope_cycles_xxx -> tm_scope & tm_scope_xxx
		- Minor cleanups
		- Fix Vector types align woopsies
		- Fix bug in heap allocator which caused internal heap corruption
		- Maybe fixed spinlocks with memory barriers?
		- Bunch of more asserts & better detection for heap allocation issues
		- lerpf, lerpi, smerpf, smerpi
		- Failed asserts now prints the stack trace.
		

## v0.00.005 - Z layers

Renderer:
	- Added optional Z-sorting
		- Either set quad->z or call push_z_layer(s64) (and pop_z_layer())
		- Enable with draw_frame.enable_z_sorting = true
	- Refactored the quad buffering to just be a growing quad buffer rather than a linked list of quad blocks. Your CPU will be thankful.
	- Fixed crashing when D3D11 DEBUG flag fails in ID3D11CreateDevice, and instead log a descriptive error then continue as usual
	
Misc:
	- removed gfx_impl_legacy_opengl.c
	- Sorting procedures
		- merge_sort()
		- radix_sort()
	- sorting tests

## v0.00.004 - Custom logging, more concurrency & bugfixing

Concurrency:
	- Refactored spinlock out of OS api (deprecated old procs)
	- Concurrency utilites:
		void spinlock_init(Spinlock *l);
		void spinlock_acquire_or_wait(Spinlock* l);
		bool spinlock_acquire_or_wait_timeout(Spinlock* l, f64 timeout_seconds);
		void spinlock_release(Spinlock* l);
		void mutex_init(Mutex *m);
		void mutex_destroy(Mutex *m);
		void mutex_acquire_or_wait(Mutex *m);
		void mutex_release(Mutex *m);
		void binary_semaphore_init(Binary_Semaphore *sem, bool initial_state);
		void binary_semaphore_destroy(Binary_Semaphore *sem);
		void binary_semaphore_wait(Binary_Semaphore *sem);
		void binary_semaphore_signal(Binary_Semaphore *sem);
		Macro MEMORY_BARRIER
	- Concurrency tests
	
Docs:
	- custom_logger.c example to show how one can make a custom logger and have logs displayed in-game

Utility:
	- draw_text_and_measure() which is just an overload of draw_text but it also does a measure and returns it

Misc:
	- Added u64 thread_id to global context. This is set in main() for main thread and in thread startup when you dispatch a Thread
	- Fixed a bug where plain rects would be drawn with the incorrect color
	- Fixed a bug where quads from earlier frames would be drawn

## v0.00.003 - Fixes

Random:
	- get_random_float64()
	- get_random_float32_in_range()
	- get_random_float64_in_range()
	- get_random_int_in_range()

Third party:
	- Added 3 minimal libraries for audio decoding
		- dr_mp3.h: MP3 decoding
		- dr_wav.h: WAV decoding
		- stb_vorbis.c: OGG decoding
	- Made a global thread_local "third_party_allocator" which is set when third party libraries are used so all memory still goes through our *program_memory
	- Stripped all third party libraries of external dependencies (C headers) & noise

Memory:
	- Improved assert messages to be more clear about what might be happening if they fail
	- Added more checks in debug to detect heap corruption and what not
	- Fixed a bug where the program would crash because a heap block was perfectly full

Misc:
	- Fixed typos in examples/text_rendering.c
	- Fixed Y placement of window when changing the window rect
	- Fixed window sizing when setting scaled_width or scaled_height
	- Updated readme
	- Portable DEPRECATED macro
	- Deprecate os_compare_and_swap and replace with more portable compare_and_swap
	- Fixed a bug where the wrong image would be drawn

	

## v0.00.003 - Fixes

Random:
	- get_random_float64()
	- get_random_float32_in_range()
	- get_random_float64_in_range()
	- get_random_int_in_range()

Third party:
	- Added 3 minimal libraries for audio decoding
		- dr_mp3.h: MP3 decoding
		- dr_wav.h: WAV decoding
		- stb_vorbis.c: OGG decoding
	- Made a global thread_local "third_party_allocator" which is set when third party libraries are used so all memory still goes through our *program_memory
	- Stripped all third party libraries of external dependencies (C headers) & noise

Memory:
	- Improved assert messages to be more clear about what might be happening if they fail
	- Added more checks in debug to detect heap corruption and what not
	- Fixed a bug where the program would crash because a heap block was perfectly full

Misc:
	- Fixed typos in examples/text_rendering.c
	- Fixed Y placement of window when changing the window rect
	- Fixed window sizing when setting scaled_width or scaled_height
	- Updated readme
	- Portable DEPRECATED macro
	- Deprecate os_compare_and_swap and replace with more portable compare_and_swap
	- Fixed a bug where the wrong image would be drawn

	

## v0.00.002 - Text rendering, image manipulation, hash tables

Renderer:
	- Pass 8-bit integers "type" and "sampler_index" to shader
		- Sample texture differently depending on "type" (text or regular quad)
		- Sample with nearest/linear min/mag depending on sampler_index
		- Set min/mag filtering in Draw_Quad
		- Images are now created and deleted directly with gfx calls rather than deferring it for gfx_update.
		- We can now set image sub data with gfx_set_image_data()
		- Images are no longer hard coded to 4 channels
		
Text/Fonts:
	- Added font loading with lazy initialization/rasterization when it's needed
		- Load & rasterize any fonts with load_font_from_disk()
		- Fonts automatically rasterize glyphs into atlases and generate metrics on the fly
		- Measure text for very_useful metrics with measure_text()
		- Walk over glyphs and their metrics with walk_glyphs()
	- Implemented simple but powerful text rendering
		- Draw text with draw_text() or draw_text_xform()
	- See oogabooga/examples/text_rendering.c for more
			
Other:
	- Added 3 simple hash functions:
		- 64-bit xx_hash(): Very fast hash for 64-bit values
		- 64-bit city_hash(): Very fast hash for short strings
		- 64-bit djb2_hash(): Fast hash for strings longer than 32 bytes
		- Made a generic get_hash() macro to detect the type you are trying to hash and call the approriate procedure
	- Introduced a simple (kinda slow) hash table with following procedures:
		- hash_table_add
		- hash_table_find
		- hash_table_contains
		- hash_table_set
		See hash_table.c for more information.
	- Utf8 utility:
		- utf8_to_utf32(): convert utf8 bytes to a single u32 codepoint
		- next_utf8(): Convert first utf8 character in a string to a u32 codepoint and advance the passed string to the next unicode
	- Renamed m4_multiply -> m4_mul for consistency
	- Refactored os window to be DPI aware
		- Window now has scaled_width, scaled_height which is the DPI-scaled size. Previous window.width & window.height are now aliased as window.pixel_height and window.pixel_width for clarity
	- in minimal example, renamed hammer_xform -> rect_xform