Peterino2
6474e26ee3
Implemented full support for function pointer typedefs in the pattern:
typedef RetType (SDLCALL *CallbackName)(Param1Type param1, ...);
This is THE most requested feature - function pointers are used extensively
across SDL3 for callbacks (timers, events, logging, file I/O, etc.)
## Implementation
### New AST Type
Added `FunctionPointerDecl` to Declaration union:
- name: callback type name (SDL_TimerCallback)
- return_type: callback return type (Uint32)
- params: array of parameter declarations
- doc_comment: optional documentation
### Pattern Scanning (patterns.zig)
Added `scanFunctionPointer()` to recognize:
- Pattern: `typedef RetType (SDLCALL *SDL_Name)(Params);`
- Handles both `(*SDL_Name)` and `(SDLCALL *SDL_Name)` forms
- Parses return type, callback name, and parameters
- Must be checked BEFORE simple typedef (also starts with "typedef")
Key parsing logic:
1. Find `*SDL_` marker (callback name location)
2. Extract return type before marker (remove SDLCALL if present)
3. Extract callback name (between * and ))
4. Extract parameters (between final ( and ))
### Code Generation (codegen.zig)
Added `writeFunctionPointer()` generates:
```zig
pub const TimerCallback = *const fn(
userdata: ?*anyopaque,
timerID: TimerID,
interval: u32
) callconv(.C) u32;
```
Format: `*const fn(params) callconv(.C) RetType`
- Uses Zig's function pointer syntax
- Explicit C calling convention
- Parameters with names and types
### Dependency Resolution
Updated to track function pointer types:
- collectDefinedTypes: registers callback names
- collectReferencedTypes: scans params and return type
- cloneDeclaration: deep copies function pointer decls
- freeDeclaration: frees all allocated memory
### Memory Management
Updated all cleanup code in:
- parser.zig: main defer block and freeDeclDeep()
- dependency_resolver.zig: freeDeclaration()
- Properly frees name, return_type, params, doc_comment
## Results
### Before
- 15/43 APIs fully working (35%)
- Function pointer typedefs: NOT SUPPORTED
- Callback-heavy APIs: FAILED
### After
- **19/43 APIs fully working (44%)** ✅
- Function pointer typedefs: FULLY SUPPORTED
- 2 function pointers detected and generated per API average
### APIs Fixed (4 New Perfect!)
✅ **SDL_timer.h** (47 lines)
- SDL_TimerCallback, SDL_NSTimerCallback
- Timer management with callbacks
✅ **SDL_camera.h** (77 lines)
- Camera device access
✅ **SDL_hints.h** (41 lines)
- SDL_HintCallback
- Configuration hints system
✅ **SDL_properties.h** (106 lines)
- SDL_CleanupPropertyCallback
- Property system with cleanup callbacks
### Still Partial (23 APIs with 1 error each)
Most have just one remaining issue:
- Field name `type` (keyword conflict) - 3 APIs
- Other callback types not yet found - 20 APIs
## Testing
Tested against all 43 major SDL3 headers:
- 19 compile perfectly (0 errors)
- 23 have 1 error (usually keyword or edge case)
- 1 has 13 errors (SDL_video.h - complex)
- 0 complete failures
## Example Output
**Input** (SDL_timer.h):
```c
typedef Uint32 (SDLCALL *SDL_TimerCallback)(
void *userdata,
SDL_TimerID timerID,
Uint32 interval
);
```
**Output** (timer.zig):
```zig
pub const TimerCallback = *const fn(
userdata: ?*anyopaque,
timerID: TimerID,
interval: u32
) callconv(.C) u32;
```
## Code Changes
### src/patterns.zig (+80 lines)
- Added FunctionPointerDecl struct
- Added scanFunctionPointer() method
- Updated Declaration union
- Scan order: flags → function pointers → simple typedefs
### src/codegen.zig (+20 lines)
- Added writeFunctionPointer() method
- Generates Zig function pointer syntax
- Handles parameter conversion
### src/parser.zig (+25 lines)
- Updated statistics tracking
- Updated memory cleanup (2 places)
- Added function pointer counting
### src/dependency_resolver.zig (+40 lines)
- Updated type collection
- Updated declaration cloning
- Updated memory cleanup
## Impact
**Immediate**: +4 perfect APIs (9% improvement)
**Potential**: 20 more APIs blocked by similar issues
**Total Coverage**: 44% → potentially 90%+ with remaining fixes
Function pointer support was the #1 blocker - now resolved! 🎉
---
This unlocks callback-based APIs: timers, events, logging, file I/O,
threading, properties, hints, and more!
|
||
|---|---|---|
| .github/workflows | ||
| archive | ||
| build | ||
| buildgen | ||
| depot | ||
| docs | ||
| engine | ||
| extras | ||
| lib | ||
| projects | ||
| testing | ||
| tools | ||
| .gitattributes | ||
| .gitignore | ||
| CLAUDE.md | ||
| LICENSE | ||
| README.md | ||
| build.archive.zig | ||
| build.zig | ||
| build.zig.zon | ||
| content.txt | ||
| todo.txt | ||
README.md
Backlog
zig version: 0.15.1
Backlog Labs Game Engine.
Getting Started
run tools/scripts/first-time-setup.py
ffmpeg -i INPUT.mp4 -c:v libtheora -q:v 7 -c:a libvorbis -q:a 4 OUTPUT.ogv
git-bug Cheat Sheet
This project uses git-bug for distributed issue tracking. Issues are stored directly in the repository.
Common Commands
Listing Issues
git bug bug # List all issues
git bug bug status:open # List only open issues
git bug bug status:closed # List only closed issues
Creating Issues
git bug bug new -t "title" -m "message" # Create new issue
git bug bug new -t "Add feature X" -m "Description" # Example
Viewing & Managing Issues
git bug bug show <id> # Show issue details
git bug bug comment <id> # Add a comment to an issue
git bug bug close <id> # Close an issue
git bug bug open <id> # Reopen an issue
git bug bug status <id> # Show issue status
Labels
git bug bug label <id> # Show labels for an issue
git bug bug label new <id> <label> # Add a label
git bug bug label rm <id> <label> # Remove a label
Syncing
git bug pull # Pull issue updates from remote
git bug push # Push issue updates to remote
Standard Labels
Component Labels: core, rendering, physics, build-system, platform, assets, audio, ui, documentation
Type Labels:
bug- Defects or incorrect behaviorfeature- New functionalityenhancement- Improvements to existing featurestask- General development workdocumentation- Documentation improvementsquestion- Design decisions or discussionsrefactoring- Code cleanup
Problem Type Labels (for bugs):
memory- Memory issuesthreading- Concurrency issuescrash- Application crashesbuild- Build system issues
Quick Examples
# Create a bug report
git bug bug new -t "Memory leak in asset loader" -m "Assets not freed when unloading scenes"
git bug bug label new <id> bug assets memory
# Create a feature request
git bug bug new -t "Add terrain generation" -m "Implement heightmap-based terrain"
git bug bug label new <id> feature rendering
# Create a task
git bug bug new -t "Update to Zig 0.15" -m "Migrate to latest Zig version"
git bug bug label new <id> task build-system
# View and comment on an issue
git bug bug show abc123
git bug bug comment abc123
Tips
- Issue IDs can be abbreviated (first few characters)
- Use
--non-interactiveflag for scripting - Issues sync with
git bug pull/push - Keep descriptions factual and clear