https://github.com/avem-labs/ol3d

A tiny portable 3D graphics lib for micro controllers
https://github.com/avem-labs/ol3d

3d-graphics arduino esp32 esp32-arduino graphics microcontroller

Last synced: 3 months ago
JSON representation

A tiny portable 3D graphics lib for micro controllers

• Host: GitHub
• URL: https://github.com/avem-labs/ol3d
• Owner: avem-labs
• Created: 2018-01-21T09:20:57.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2018-10-26T04:45:50.000Z (over 6 years ago)
• Last Synced: 2024-07-02T08:19:54.010Z (7 months ago)
• Topics: 3d-graphics, arduino, esp32, esp32-arduino, graphics, microcontroller
• Language: C
• Homepage:
• Size: 2.96 MB
• Stars: 145
• Watchers: 7
• Forks: 17
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# ol3d

A tiny portable 3D graphics lib for micro controllers.

![49797676-c0ff-4ffa-8ffd-491a022d48d1](https://user-images.githubusercontent.com/7625588/39510593-c9a2bba6-4e1c-11e8-8fa5-9975348b2e33.jpeg)

![4c8069e8-ebb0-4954-86dc-0561095fcf95](https://user-images.githubusercontent.com/7625588/39510596-ca71d27e-4e1c-11e8-897e-f52c012fcd68.jpeg)

## Example

Render a low poly wolf

```c

#include 

#include 

#include  // .obj data

void OLED_init();

void OLED_fill(unsigned char *buf);

// Declare display buffer, see ol3d_render.h

uint8_t buffer[128*128*3] = {};

float roll, yaw;

void setup () {

    SPI.begin();

    SPI.setClockDivider(SPI_CLOCK_DIV2);

    OLED_init(); // initialize your screen

    yaw = 0;

}

void loop () {

// MVP matrix

    ol3d_matrix_t p;

    ol3d_matrix_setPerspective(p, 60, 1, 1, 1000);

    ol3d_matrix_t v;

    ol3d_matrix_setTranslate(v, 0, 0, -700);

    ol3d_matrix_t vp;

    ol3d_matrix_multiply(v, p, vp);

    ol3d_matrix_t mvp;

// Render process

    for(;;) {

        // Model matrix of current frame

        ol3d_matrix_t m = MATRIX_UNIT;

        ol3d_matrix_translate(m, 0, -80, 0);    // Translate to center

        ol3d_matrix_rotate(m, (float)yaw, M_AXIS_Y);    // Rotate

        yaw += 8;

        ol3d_matrix_multiply(m, vp, mvp);

        ol3d_clean_buffer(buffer);

        ol3d_draw_Element(buffer, mesh_f, mesh_v, mesh_v, 100, mvp);

        OLED_fill(buffer);

    }

}

```

### OBJ model headerfile style

Simply modify an obj file

```c

double mesh_v[] = {

    -0.500000, -0.500000, 0.500000,

    0.500000, -0.500000, 0.500000,

    -0.500000, 0.500000, 0.500000,

    0.500000, 0.500000, 0.500000,

    -0.500000, 0.500000, -0.500000,

    0.500000, 0.500000, -0.500000,

    -0.500000, -0.500000, -0.500000,

    0.500000, -0.500000, -0.500000,

    -0.500000, -0.500000, 0.500000,

    0.500000, -0.500000, 0.500000,

    -0.500000, 0.500000, 0.500000,

    0.500000, 0.500000, 0.500000,

    -0.500000, 0.500000, -0.500000,

    0.500000, 0.500000, -0.500000,

    -0.500000, -0.500000, -0.500000,

    0.500000, -0.500000, -0.500000

};

long mesh_f[] = {

    1, 2, 3,

    3, 2, 4,

    3, 4, 5,

    5, 4, 6,

    5, 6, 7,

    7, 6, 8,

    7, 8, 1,

    1, 8, 2,

    2, 8, 4,

    4, 8, 6,

    7, 1, 5,

    5, 1, 3,

    9, 10, 11,

    11, 10, 12,

    11, 12, 13,

    13, 12, 14,

    13, 14, 15,

    15, 14, 16,

    15, 16, 9,

    9, 16, 10,

    10, 16, 12,

    12, 16, 14,

    15, 9, 13,

    13, 9, 11

};

```