ray4laz_r3d/README.md at main · GuvaCode/ray4laz_r3d · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
# R3D - 3D Rendering Library for raylib (free pascal binding)

<img align="left" src="https://github.com/Bigfoot71/r3d/blob/master/logo.png" width="100" hspace="20">
<br>
R3D is a modern 3D rendering library for <a href="https://www.raylib.com/">raylib</a> that provides advanced lighting, shadows, materials, and post-processing effects without the complexity of building a full engine from scratch.
<br clear="left">


## Key Features

- **Hybrid Renderer**: Deferred pipeline with forward rendering for transparency.
- **Advanced Materials**: Complete PBR material system (Burley/SchlickGGX)
- **Custom Shaders**: Support for surface shaders (materials/decals) and screen shaders.
- **Dynamic Lighting**: Directional, spot, and omni lights with soft shadows
- **Image-Based Lighting**: Supports environment IBL and reflection probes.
- **Post-Processing**: SSAO, SSR, DoF, bloom, fog, tonemapping, and more
- **Kinematics Support**: Basic kinematic system with capsule and mesh-based colliders.
- **Mesh Utilities**: Mesh generation, manipulation, and helper utilities.
- **Model Loading**: Assimp integration with animations and mesh generation
- **Performance**: Built-in frustum culling, instanced rendering, and more

## Installation

```
Open and complile package/ray4laz_r3d.lpk
```

**Requirements package**: ray4laz

## Quick Start

```pascal
program r3dexample;

{$mode objfpc}{$H+}

uses
  SysUtils, raylib, r3d, raymath;

const
  SCREEN_WIDTH = 800;
  SCREEN_HEIGHT = 600;

var
  mesh: TR3D_Mesh;
  material: TR3D_Material;
  light: TR3D_Light;
  camera: TCamera3D;

begin
  // Initialize window
  InitWindow(SCREEN_WIDTH, SCREEN_HEIGHT, 'R3D Example');
  SetTargetFPS(60);

  // Initialize R3D
  R3D_Init(SCREEN_WIDTH, SCREEN_HEIGHT);

  try
    // Create scene objects
    mesh := R3D_GenMeshSphere(1.0, 16, 32);
    material := R3D_GetDefaultMaterial();

    // Setup lighting
    light := R3D_CreateLight(R3D_LIGHT_DIR);
    R3D_SetLightDirection(light, Vector3Create(-1, -1, -1));
    R3D_SetLightActive(light, True);

    // Camera setup
    camera.position := Vector3Create(3, 3, 3);
    camera.target := Vector3Create(0, 0, 0);
    camera.up := Vector3Create(0, 1, 0);
    camera.fovy := 60.0;
    camera.projection := CAMERA_PERSPECTIVE;

    // Main loop
    while not WindowShouldClose() do
    begin
      UpdateCamera(@camera, CAMERA_ORBITAL);

      BeginDrawing();
        ClearBackground(BLACK);

        R3D_Begin(camera);
          R3D_DrawMesh(mesh, material, Vector3Zero(), 1.0);
        R3D_End();

        // Draw FPS
        DrawFPS(10, 10);
      EndDrawing();
    end;

  finally
    // Cleanup
    R3D_UnloadMesh(mesh);
    R3D_Close();
    CloseWindow();
  end;
end.
```

## License

Licensed under the **MIT License** - see [LICENSE](LICENSE) for details.

## Screenshots

<table>
  <tr>
    <td><img src="screenshots/screenshot0.png"></td>
    <td><img src="screenshots/screenshot1.png"></td>
  </tr>
  <tr>
    <td><img src="screenshots/screenshot2.png"></td>
    <td><img src="screenshots/screenshot3.png"></td>
  </tr>
</table>