https://github.com/scriptlinestudios/waphics.c

A web browser video game library for C.
https://github.com/scriptlinestudios/waphics.c

c game-development webassembly

Last synced: about 1 month ago
JSON representation

A web browser video game library for C.

• Host: GitHub
• URL: https://github.com/scriptlinestudios/waphics.c
• Owner: ScriptLineStudios
• License: mit
• Created: 2023-02-05T17:25:38.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-31T09:17:43.000Z (2 months ago)
• Last Synced: 2024-10-31T10:21:07.588Z (2 months ago)
• Topics: c, game-development, webassembly
• Language: C
• Homepage: https://waphicsc.readthedocs.io/en/latest/index.html
• Size: 669 KB
• Stars: 3
• Watchers: 2
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# waphics.c - WebAssembly Graphics

## A web browser based video game library for C.

Waphics allows you to easily create video games in C and export them to the web browser. Waphics provides a Javascript runtime enviroment for your C code which allows for:



  
Keyboard input (mouse input to come)

  
Playing sounds

  
Rendering primitimes (circles, rectangles, triangles)

  
Image rendering (with scaling using uv coordinates)

  
Alpha blending



```C

#define WAPHICS_IMPLEMENTATION

#include "src/waphics.c"

#define WIDTH 1000

#define HEIGHT 600

uint32_t pixels[WIDTH * HEIGHT];

Surface display;

void init(void) {

    display = SCREEN(pixels, WIDTH, HEIGHT);

}

static int x;

uint32_t *run(void) {

    //fill the display with black

    waphics_fill_display(display, RGB(0, 0, 0));

    //draw a red rectangle

    waphics_draw_rect(display, RECT(0, 0, 50, 50), RGB(255, 0, 0));

    //draw a blue circle

    waphics_draw_circle(display, CIRCLE(100, 100, 50), RGB(0, 100, 100));

    if (get_key(KEY_D)) x+=10;

    if (get_key(KEY_A)) x-=10;

    return display.pixels;

}

```

# Examples

![Peek 2023-02-12 11-56](https://user-images.githubusercontent.com/85095943/218304377-a63e7635-d910-407b-86c9-5a90035aadac.gif)

Triangle with mouse input.

![Peek 2023-02-12 12-07](https://user-images.githubusercontent.com/85095943/218304809-1dea99ef-9ea0-415a-ad4b-c9cf9d3096ff.gif)

Image loading with alpha.

# Using the Library

## Building from source

```bash

 1. git clone https://github.com/ScriptLineStudios/waphics.c

 2. cd waphics.c

 3. sudo make DESTDIR=/usr/bin/ install

```

# Getting started

Waphics is simple to use. Once installed simply create a new C file and add an init and run method as follows:

```C

#define WAPHICS_IMPLEMENTATION

#include "waphics.c"

#define WIDTH 1000

#define HEIGHT 600

uint32_t pixels[WIDTH * HEIGHT];

Surface display;

void init(void) {

    display = SCREEN(pixels, WIDTH, HEIGHT);

}

uint32_t *run(void) {

  // your code will go here...

  

  return display.pixels;

}

```

From there you are free to use waphics functionaltiy on the web! Once you are ready to compile to the web. Simpliy run:

```bash

waphics .c  

```

This will generate the following:

```

index.html

output.wasm

javascript.js

```

Simpliy run index.html using a web server of your choice, and you will be greeted by your window!

# Keyboard Inputs

```C

if get_key(KEY_A) {

  // the code here will only run when A is pressed

}

```