3个版本

0.1.2	2020年12月31日
0.1.1	2020年10月5日
0.1.0	2020年7月27日

#80 in 渲染

1,428 每月下载量
在 11 个crate中（通过 miniquad-fork-x）使用

MIT/Apache

96KB
2.5K 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: web演示
 examples/offscreen.rs: web演示

PonasKovas/miniquad-mandelbrot: web演示

构建示例

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”开始，桌面和网页版本均为约5秒。
跨平台。平台特定用户代码的量应尽可能少。
支持低端设备。
可破解性。在你自己的游戏开发中，很可能会遇到一些硬件兼容性问题。解决这个问题应该很容易，实现细节不应被隐藏在抽象层之下。
可分支性。每个平台的实现通常只是一个纯Rust文件。这个文件非常易于复制粘贴——它不使用任何miniquad特定的抽象。只需复制miniquad平台实现的一部分，就可以独立使用它。

非目标

终极类型安全。库应该完全符合Rust对安全的定义——没有未定义行为或内存不安全。但正确的GPU状态并不能保证类型安全。那么，请随意在用户代码中提供安全性抽象！
高级API，如Vulkan/DirectX 12。请查看gfx-rs或vulkano！

金牌赞助商

Miniquad由以下组织支持

SourceGear

无运行时依赖

~180KB