How itfrombit/osx_handmade works
Main Components
a) Platform Layer (macOS Specific)
• Core Platform Services
• Audio System (osx_handmade_audio.cpp)
• File System (osx_handmade_file.cpp)
• Input Handling (osx_handmade_hid.cpp)
• Memory Management (osx_handmade_memory.cpp)
• Threading (osx_handmade_thread.cpp)
b) Rendering System
• OpenGL Implementation (osx_handmade_opengl.cpp/mm)
• Renderer Interface (osx_handmade_renderer.h)
c) Game Layer
• Core Game Logic (osx_handmade_game.cpp)
• Asset Management (osx_asset_builder.cpp)
d) Development Tools
• Debug System (osx_handmade_debug.cpp)
• Hot Reload System (osx_handmade_dylib.cpp)
┌─────────────────────────────────────────┐
• Application Layer │
• (Main Game Loop, Asset Management) │
• ┤
• Platform Services Layer │
• (Audio, Input, File System, Memory) │
• ┤
• Rendering Layer │
• (OpenGL Implementation, Renderer) │
• ┤
• macOS System │
• (Cocoa, CoreText, System Services) │
• ┘
Key Relationships to Highlight
• Blue: Core game systems
• Green: Platform-specific implementations
• Orange: Development/Debug tools
• Gray: External system dependencies
Implementation Details
[Game Core (libhandmade.dylib)] ←→ [Platform Layer]
• ↓ ↓
• [Asset System] ←→ [File System] → [macOS APIs]
• ↓ ↓
[Renderer (libhandmade_opengl.dylib)] → [OpenGL]
Additional Elements
• A development tools section showing:
• HandmadeTabView
• HandmadeRendererTest
• Font generation tools
• Debug utilities
Notes
• Use standardized symbols for components
• Version information
• Notes about platform-specific implementations
• Document hot reload paths
• Asset pipeline flow