https://github.com/nosfty/cs-sdl3d
From Scratch C# SDL RENDERER
https://github.com/nosfty/cs-sdl3d
3d-graphics dotnet from-scratch math render sdl2 vector vectormath
Last synced: about 2 months ago
JSON representation
From Scratch C# SDL RENDERER
- Host: GitHub
- URL: https://github.com/nosfty/cs-sdl3d
- Owner: nosfty
- License: mit
- Created: 2025-04-29T20:53:30.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-30T14:40:48.000Z (about 1 year ago)
- Last Synced: 2025-05-04T08:58:50.116Z (about 1 year ago)
- Topics: 3d-graphics, dotnet, from-scratch, math, render, sdl2, vector, vectormath
- Language: C#
- Homepage:
- Size: 29.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# CS-SDL3D
## 3D Cube Renderer with SDL2
This is a simple program for rendering a 3D cube using the SDL2 library in C#. The project demonstrates the basics of 3D graphics, including coordinate transformations, projection, and camera control.
## Features
- Rendering of a rotating 3D cube using SDL2
- Simple movable camera
- Mathematics for 3D transformations (rotation, translation, projection)
- Vector math basics (Vec2, Vec3)
## Controls
- **W/S**: Move camera forward/backward (Z-axis)
- **A/D**: Move camera left/right (X-axis)
- **Q/E**: Move camera up/down (Y-axis)
- **Close window**: Quit the program
## API Overview
### Core Classes
1. **WindowManager** - manages SDL2 window and renderer
- `GetRenderer()` - gets the SDL renderer
- `ClearBackground()` - clears the screen
- `Present()` - displays rendered content
2. **Vec2/Vec3** - classes for 2D and 3D vector operations
- Basic operations (+, -, *, /)
- Normalization, dot product
- Rotation (Vec3 only)
3. **Camera** - simple 3D camera
- `WorldToViewSpace()` - transforms world coordinates to camera space
- Configurable FOV, near and far clipping planes
4. **Core** - utility functions
- `Vec3toVec2()` - projects 3D point to 2D screen
- `Rotate()` - rotates vector around axis
- `ScreenSpaceToSDLCoords()` - converts normalized coordinates to pixel coordinates
## Building and Running
1. Ensure you have .NET SDK installed (version 5.0 or higher)
2. Install SDL2 dependencies (via NuGet or manually)
3. Build the project: `dotnet build`
4. Run: `dotnet run`
## How to Contribute
All contributions are welcome! Here are some ideas:
1. **Graphics Improvements**:
- Add lighting
- Implement filled polygons instead of wireframe
- Add texturing
2. **New Features**:
- Load 3D models from files
- More advanced camera controls (free flight)
- Mouse camera control
3. **Optimizations**:
- Improve math operations
- Add backface culling
- More efficient rendering
### Contribution Process
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to your fork (`git push origin feature/amazing-feature`)
5. Open a Pull Request
### Gallery
## License
This project is licensed under the MIT License. See the LICENSE file for details.