CmdFX

A lightweight game engine for your terminal.

---

cmdfx is a lightweight game engine for your terminal. It is designed to be simple and easy to use, while still providing a powerful set of features.

It is written in C and is available cross-platform. It is licensed under the MIT license.

🍎 Features

• Cross-platform: cmdfx is available on Windows, macOS, and Linux.
• Lightweight: cmdfx is designed to be lightweight and fast.
• Easy to use: cmdfx is simple to use and easy to learn.
• Powerful: cmdfx provides a powerful set of features for creating terminal-based games.

📋 Full List

• Events API
  • Handle window events such as key presses and window resizing.
  • Get the current state of the keyboard.
• Canvas API
  • Draw characters and shapes on the terminal.
  • Set foreground and background colors.
  • Clear the screen.
  • Get the size of the terminal.
  • Sprites API
    • Load and draw sprites on the terminal.
    • Set the color of a sprite.
• Cross-Platform Exposure
  • Expose platform-specific features and utilities such as setting the title of the terminal.

📦 Installation

You can download the latest release of cmdfx from the releases page.

🚀 Example

#include <cmdfx.h>

int main() {
    // Set character at position (4, 4) to 'X'
    Canvas_setChar(4, 4, 'X');

    // Draw Circle with '#' at position (10, 10) with radius 5
    Canvas_fillCircle(10, 10, 5, '#');

    // Set Foreground to Red, then draw a line from (0, 0) to (10, 0)
    Canvas_setForeground(0xFF0000);
    Canvas_hLine(0, 0, 10);
}

📝 Contributing

If you would like to contribute to cmdfx, please see the contributing guidelines. All contributions are welcome!