2个版本

0.1.1	2020年12月31日
0.1.0	2020年12月9日

#669 in 图形API

被miniquad-fork-x使用

MIT/Apache

1.5MB
43K SLoC

Miniquad

在这样一个世界中，我们不需要复杂的依赖树和数千行代码就能用计算机绘制事物，Miniquad就是这个梦想的实现。

Miniquad旨在提供一种在任何具有GPU的平台上都以尽可能轻量级方式工作的图形抽象，同时尽可能覆盖更多的机器。

支持的平台

Windows，OpenGL 3，OpenGL 2.2；
Linux，OpenGL 2.2，OpenGL 3，GLES 2，GLES 3；
macOS，OpenGL 3，Metal；
iOS，GLES 2，GLES 3，Metal；
WASM，WebGL 1 - 已在iOS Safari，Firefox，Chrome上进行测试；
Android，GLES 2，GLES 3。

示例

Imgur

examples/quad.rs: 网络演示
 examples/offscreen.rs: 网络演示

PonasKovas/miniquad-mandelbrot: 网络演示

构建示例

Linux

cargo run --example quad

在NixOS Linux上，您可以使用shell.nix启动一个开发环境，在其中的Miniquad可以构建和运行。

Windows

# both MSVC and GNU target is supported:
rustup target add x86_64-pc-windows-msvc
# or
rustup target add x86_64-pc-windows-gnu

cargo run --example quad

WASM

rustup target add wasm32-unknown-unknown
cargo build --example quad --target wasm32-unknown-unknown

然后使用以下.html文件加载.wasm

index.html

<html lang="en">

<head>
    <meta charset="utf-8">
    <title>TITLE</title>
    <style>
        html,
        body,
        canvas {
            margin: 0px;
            padding: 0px;
            width: 100%;
            height: 100%;
            overflow: hidden;
            position: absolute;
            background: black;
            z-index: 0;
        }
    </style>
</head>

<body>
    <canvas id="glcanvas" tabindex='1'></canvas>
    <!-- Minified and statically hosted version of https://github.com/not-fl3/miniquad/blob/master/native/sapp-wasm/js/gl.js -->
    <script src="https://not-fl3.github.io/miniquad-samples/gl.js"></script>
    <script>load("quad.wasm");</script> <!-- Your compiled wasm file -->
</body>

</html>

提供静态.wasm和.html的几种方法之一

cargo install basic-http-server
basic-http-server .

Android

为Android构建的推荐方法是使用Docker。
Miniquad使用稍微修改过的cargo-apk版本。

docker run --rm -v $(pwd)":/root/src" -w /root/src notfl3/cargo-apk cargo quad-apk build --example quad

APK 文件将位于 target/android-artifacts/(debug|release)/apk

启用 "log-impl" 后，所有日志调用都将转发到 adb 控制台。Android 不需要代码修改，一切应该正常工作。

iOS

在模拟器上运行

mkdir MyGame.app
cargo build --target x86_64-apple-ios --release
cp target/release/mygame MyGame.app
# only if the game have any assets
cp -r assets MyGame.app
cat > MyGame.app/Info.plist << EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>CFBundleExecutable</key>
<string>mygame</string>
<key>CFBundleIdentifier</key>
<string>com.mygame</string>
<key>CFBundleName</key>
<string>mygame</string>
<key>CFBundleVersion</key>
<string>1</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
</dict>
</plist>
EOF

xcrun simctl install booted MyGame.app/
xcrun simctl launch booted com.mygame

有关为真 iPhone 配置的详细信息和方法，请参阅 https://macroquad.rs/articles/ios/

交叉编译


# windows target from linux host:
# this is how windows builds are tested from linux machine:
rustup target add x86_64-pc-windows-gnu
cargo run --example quad --target x86_64-pc-windows-gnu

目标

快速编译时间。目前，从 "cargo clean" 开始，桌面和 Web 都需要约 5 秒。
跨平台。平台特定用户代码的量应尽可能少。
支持低端设备。
可修改性。在制作自己的游戏时，高度可能遇到一些硬件不兼容的问题。解决这类问题应该很简单，实现细节不应被隐藏在抽象层之下。
可分支。每个平台实现通常是单个纯 Rust 文件。这个文件非常易于复制粘贴 - 它不使用任何 miniquad 特定的抽象。只需复制 miniquad 平台实现的一部分，就可以独立使用。

非目标

终极类型安全性。库应该完全符合 Rust 的安全定义 - 没有UB或内存不安全性。但正确的 GPU 状态没有类型保证。请在用户代码中自由提供安全性抽象！
高端 API，如 Vulkan/DirectX 12。请参阅 gfx-rs 或 vulkano。

金牌赞助商

Miniquad 由以下公司支持

SourceGear

sapp-kms