Crate caper

Minimalist game framework. Currently has systems for:

• Rendering (glium)
• Input (winit via volition)
• Physics (nphysics)
• Audio (rodio)

Example of a basis for a game:

Setup

Linux

Due to the crate alsa-sys being use for linux the following packages are required:

Debian/Ubuntu etc

apt install libasound2-dev pkg-config

Fedora/RHEL/CentOS

dnf install alsa-lib-devel

Usage

extern crate caper;

use caper::game::*;
use caper::imgui::Ui;
use caper::input::Key;
use caper::mesh::gen_cube;
use caper::types::{DefaultTag, RenderItemBuilder, TransformBuilder};
use caper::utils::handle_fp_inputs;

fn main() {
    // crate an instance of the game struct
    let (mut game, event_loop) = Game::<DefaultTag>::new();

    // define some items to be rendered
    game.add_render_item(
        RenderItemBuilder::default()
            .vertices(gen_cube())
            .instance_transforms(vec![TransformBuilder::default()
                .pos((-0.5, 0.0, -5.0))
                .build()
                .unwrap()])
            .build()
            .unwrap(),
    );

    // run the engine update
    start_loop(event_loop, move |events| {
        game.update(
            |_: &Ui| {},
            |g: &mut Game<DefaultTag>| -> UpdateStatus {
                // update the first person inputs
                handle_fp_inputs(&mut g.input, &mut g.cams[0]);

                // quit
                if g.input.keys_down.contains(&Key::Escape) {
                    return UpdateStatus::Finish;
                }

                UpdateStatus::Continue
            },
            events,
        )
    });
}

Re-exports

pub extern crate impose as audio;

pub extern crate glium;

pub extern crate image;

pub extern crate imgui;

pub extern crate volition as input;

pub use renderer::lighting;

pub use renderer::posteffect;

pub use renderer::shader;

pub use renderer::texture;

Modules

collision

Simple collision detection

game

Module represent another way of creating a game

mesh

Module for procedurally generated meshes

persist

Module for saving and loading data

renderer

A module for rendering items

types

All of the caper types

utils

Utility functions and macros

Macros

load_texture

Macro for including and loading a texture

load_texture_dynamic

Macro for dynamically loading a texture