PlayDate API

Mostly high-level rusty API for the Playdate handheld gaming system.

Usage with cargo-playdate is strongly recommended.

What's inside

Covered parts of API:

• controls
• display
• file system
• graphics (with color)
• sound
• sprite
• system (with menu)
• sys - base, low-level cffi bindings

Plus some extensions to make it all more rust-ish.

Not yet covered parts:

• scoreboards
• json
• lua

How to start

Look at the examples.

Examples

Here is available examples. You car run it with following command:

```bash

Simulator:

cargo playdate run -p=playdate --example=hello-world --features=entry-point

Device:

cargo playdate run -p=playdate --example=video --features=entry-point --device ```

More information how to use cargo-playdate in help: cargo playdate --help.

Prerequisites

Follow the instructions for: 1. SDK 1. cargo-playdate 1. playdate-sys (prerequisites only)

Hello World

There is multiple ways to learn and start.

Following two is just a quick introduction. In details it all will be explained soon in the wiki.

Short Way

1. Install cargo-playdate.
2. cd where/your/project/will/be
3. cargo playdate init --lib --full-metadata --deps="playdate" (more about it)
4. cargo playdate run

Done. Now take a look at long way below for details what's happen.

Alternative Way

Just run cargo new <your options> and add do following: 1. Add [playdate crate][playdate-crate] as dependency to your project 1. #![no_std] for library, or #![no_std] #![no_main] for executable binary 1. Look at existing example for api-parts like that 1. Add minimally required metadata to build package: - package.metadata.playdate.bundle-id = "com.yourcompany.game" - Read about playdate metadata format if needed 1. Install cargo-playdate to build your project 1. Run cargo playdate run 1. Help this project somehow.

Made with ❤️‍🔥 by me.

This software is not sponsored or supported by Panic.