libmx2

Project Overview

libmx2 is a comprehensive, modern multimedia framework written in C++20 that provides developers with powerful tools for creating cross-platform applications with advanced graphics, audio, and interactive capabilities. The framework encompasses everything from basic SDL2 wrappers to sophisticated OpenGL rendering engines, complete with WebAssembly deployment support and an advanced command-line console system.

Framework Architecture

The libmx2 framework is built with a modular architecture that separates concerns and provides clean interfaces for different multimedia subsystems.

Core Features

Example Applications

The framework includes over 50 complete example applications demonstrating various aspects of multimedia development.

2D Game Examples

3D OpenGL Examples

Graphics Technology Demos

Console Skeleton - Interactive Terminal

The Console Skeleton represents the pinnacle of the libmx2 framework's capabilities, combining advanced OpenGL graphics with a fully-featured interactive terminal and scripting system.

MXCMD Language Features

# Example MXCMD Script
define init_graphics()
begin
    let width = 1280
    let height = 720
    
    # Load external SDL module
    extern "sdl-mod" "sdl_init" "sdl_init"
    extern "sdl-mod" "sdl_create_window" "sdl_window"
    
    # Initialize graphics
    sdl_init
    sdl_window "My Application" width height
    
    printf "Graphics initialized: %dx%d\n" width height
    return 0
end

# Execute initialization
init_graphics

WebAssembly Deployment

One of libmx2's most powerful features is its comprehensive WebAssembly support, allowing native C++ applications to run seamlessly in web browsers with near-native performance.

Available WebAssembly Demos

Technical Specifications

Platform Support Matrix

Getting Started

Begin your journey with libmx2 by exploring the comprehensive example collection and following the build instructions for your target platform.

# install SDL2, SDL2_ttf, SDL2_mixer, GLM, zlib, libpng
# Clone the repository
git clone https://github.com/lostjared/libmx2.git
cd libmx2/libmx

# Build for desktop (Linux/macOS/Windows)
mkdir build && cd build
cmake .. -DDEBUG_MODE=ON -DEXAMPLES=ON
cmake --build .
sudo cmake --install
# Run examples from build directories
./gl_pong -p ../../gl_pong/v4
./space -p ../../space
./cmd-console

# compile libmx2 for WebAssembly
cd libmx2/libmx/libmx
make -f Makefile.em -j8 install 
make -f Makefile.em clean

# WebAssembly build
cd MX2_Project
make -f Makefile.em