[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-5717":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":31,"readmeContent":32,"aiSummary":33,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":34,"discoverSource":35},5717,"vulkano","vulkano-rs\u002Fvulkano","vulkano-rs","Safe and rich Rust wrapper around the Vulkan API","",null,"Rust",5091,469,59,84,0,2,5,29,6,39.02,"Apache License 2.0",false,"master",[26,27,28,29,30],"graphics-programming","rust","spir-v","vulkan","vulkan-api","2026-06-12 02:01:14","\u003Cimg align=\"left\" alt=\"\" src=\"logo.png\" height=\"150\" \u002F>\n\n# [Vulkano](https:\u002F\u002Fvulkano.rs)\n\n[![Build Status](https:\u002F\u002Fgithub.com\u002Fvulkano-rs\u002Fvulkano\u002Fworkflows\u002FRust\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fvulkano-rs\u002Fvulkano\u002Factions?query=workflow%3ARust)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F937149253296476201?label=discord)](https:\u002F\u002Fdiscord.gg\u002FxjHzXQp8hw)\n[![Website\u002Fguide](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-website\u002Fguide-%23555.svg)](https:\u002F\u002Fvulkano.rs\u002F)\n\u003Cbr\u002F>\n[![vulkano crates.io](https:\u002F\u002Fimg.shields.io\u002Fcrates\u002Fv\u002Fvulkano?label=vulkano)](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fvulkano)\n[![vulkano-shaders crates.io](https:\u002F\u002Fimg.shields.io\u002Fcrates\u002Fv\u002Fvulkano-shaders?label=shaders)](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fvulkano-shaders)\n[![vulkano-taskgraph crates.io](https:\u002F\u002Fimg.shields.io\u002Fcrates\u002Fv\u002Fvulkano-taskgraph?label=taskgraph)](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fvulkano-taskgraph)\n[![vulkano-util crates.io](https:\u002F\u002Fimg.shields.io\u002Fcrates\u002Fv\u002Fvulkano-util?label=util)](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fvulkano-util)\n\u003Cbr\u002F>\n[![vulkano docs](https:\u002F\u002Fimg.shields.io\u002Fdocsrs\u002Fvulkano?label=vulkano%20docs)](https:\u002F\u002Fdocs.rs\u002Fvulkano)\n[![vulkano-shaders docs](https:\u002F\u002Fimg.shields.io\u002Fdocsrs\u002Fvulkano-shaders?label=shaders%20docs)](https:\u002F\u002Fdocs.rs\u002Fvulkano-shaders)\n[![vulkano-taskgraph docs](https:\u002F\u002Fimg.shields.io\u002Fdocsrs\u002Fvulkano-taskgraph?label=taskgraph%20docs)](https:\u002F\u002Fdocs.rs\u002Fvulkano-taskgraph)\n[![vulkano-util docs](https:\u002F\u002Fimg.shields.io\u002Fdocsrs\u002Fvulkano-util?label=util%20docs)](https:\u002F\u002Fdocs.rs\u002Fvulkano-util)\n\nVulkano is a Rust wrapper around [the Vulkan graphics API](https:\u002F\u002Fwww.khronos.org\u002Fvulkan\u002F).\nIt follows the Rust philosophy, which is that as long as you don't use unsafe code you shouldn't\nbe able to trigger any undefined behavior. In the case of Vulkan, this means that non-unsafe code\nshould always conform to valid API usage.\n\nWhat does vulkano do?\n\n- Provides a low-levelish API around Vulkan. It doesn't hide what it does but provides some\n  comfort types.\n- Plans to prevent all invalid API usages, even the most obscure ones. The purpose of Vulkano\n  is not to simply let you draw a teapot, but to cover all possible usages of Vulkan and detect all\n  the possible problems in order to write robust programs. Invalid API usage is prevented thanks to\n  both compile-time checks and runtime checks.\n- Can handle synchronization on the GPU side for you (unless you choose to do that yourself), as this\n  aspect of Vulkan is both annoying to handle and error-prone. Dependencies between submissions are\n  automatically detected, and semaphores are managed automatically. The behavior of the library can\n  be customized thanks to unsafe trait implementations.\n- Tries to be convenient to use. Nobody is going to use a library that requires you to browse\n  the documentation for hours for every single operation.\n\n### Comparison\n\nComparison to other well-known Graphics APIs in Rust ecosystem.\n\n| Name | Open-sourced Since | API Level | Notable Features |\n| ---- | ------------------ | --------- | ------------- |\n| Vulkano | March, 2016 | High-level Rust API wrapping Vulkan APIs. | Type-safe compile-time shaders. Transparent interoperability with glsl and spir-v shader code types in Rust code. Automatically generated types for shader's Layout. |\n| [Wgpu](https:\u002F\u002Fgithub.com\u002Fgfx-rs\u002Fwgpu) | May, 2019 | High-level Rust API with multiple backends. | Supports multiple backends: Vulkan, Metal, DirectX, WebGPU, and other. Follows WebGPU specification. With async\u002Fawait API. |\n| [Miniquad](https:\u002F\u002Fgithub.com\u002Fnot-fl3\u002Fminiquad) | March, 2020 | High-level minimalistic Rust API with multiple backends. | Relatively minimalistic API well suited for small to medium graphics projects. Supports multiple backends, including browser target. |\n| [Sierra](https:\u002F\u002Fgithub.com\u002Fzakarumych\u002Fsierra) | March, 2021 | High-level Rust API for Vulkan\u002FMetal APIs. | Layouts, Descriptors and shader Types construction in Rust code through the macro system. Built on top of [Erupt](https:\u002F\u002Fgitlab.com\u002FFriz64\u002Ferupt). Supports Ray Tracing Pipeline. |\n| [Glium](https:\u002F\u002Fgithub.com\u002Fglium\u002Fglium) | October, 2014 | High-level Rust API wrapping OpenGL | OpenGL only. |\n| [Ash](https:\u002F\u002Fgithub.com\u002FMaikKlein\u002Fash) | August, 2016 | Low-level API for Vulkan. | Unsafe Vulkan API bindings. |\n| [Erupt](https:\u002F\u002Fgitlab.com\u002FFriz64\u002Ferupt) | April, 2020 | Low-level API for Vulkan. | Unsafe Vulkan API bindings. |\n\nPlease note that by the current date none of the known projects in the ecosystem(including Vulkano)\nreached stable release versions and the final design goals, their APIs are changing from time\nto time in a breakable way too, and there could be bugs and unfinished features too.\n\nHowever, most of the projects mentioned above are already established definitive structures, all\nfeature breaking changes will likely be straightforward to fix in user code, and most of them\nare maintained. As such we can recommend using any of them in the 3rd party code.\nThe choice depends on the end project's goals and requirements, and we recommend examining\ntheir actual set of features and API capabilities beforehand.\n\n## Documentation and Resources\n\nTo get started you are encouraged to use the following resources:\n\n- The [examples](https:\u002F\u002Fgithub.com\u002Fvulkano-rs\u002Fvulkano\u002Ftree\u002Fmaster\u002Fexamples) folder in this repository.\n - [docs.rs](https:\u002F\u002Fdocs.rs\u002Fvulkano) - Full Vulkano API documentation\n - The guide on [vulkano.rs](https:\u002F\u002Fvulkano.rs\u002F01-introduction\u002F01-introduction.html) - Starts with trivial compute\n   examples (~50 lines of code) and then works up to rendering triangles and mandelbrots.\n   The guide is currently outdated a little. We are planning to update it in the future, but it's\n   a good place to start understanding the base building blocks of Vulkano API.\n - GitHub [Issues](https:\u002F\u002Fgithub.com\u002Fvulkano-rs\u002Fvulkano\u002Fissues) - Raise a topic, ask a question\n   or report a bug. The new topics there are watched regularly by maintainers and other\n   community users.\n - Gitter [Chat](https:\u002F\u002Fgitter.im\u002Fvulkano-rs\u002FLobby) - Another place to raise a question. However,\n   the chat is not maintained regularly at this moment. Better use GitHub Issues for this purpose.\n\n## Contributing\n\nContributions are very welcome! Feel free to submit pull requests, to open questions and topics\nin the [Issues](https:\u002F\u002Fgithub.com\u002Fvulkano-rs\u002Fvulkano\u002Fissues) section.\n\nThe project was initially developed by Pierre Krieger(Tomaka), who established Vulkano's base\ndesign goals, and the code structure. In the meantime, development is driven by Vulkano\ncommunity members.\n\nIf your change adds, removes or modifies a trait or a function, please\nspecify changelog entries **in the Pull Request description**(not in the changelog file directly).\nThey will be transferred to the changelog right after the PR merge.\n\nEvery PR must pass tests in order to be merged to `master`.\n\nMinor releases are usually happening between 1 to 3 months averagely depending on grow\nof unreleased and breaking changes in `master`\n\n### Repository Structure\n\nThis repository contains four libraries:\n\n- `vulkano` is the main one.\n- `vulkano-shaders` provides the `shader!` macro for compiling glsl shaders.\n- `vulkano-taskgraph` allows building a dependency graph of tasks, which are automatically\n  synchronized and are then executed on the Vulkan device.\n- `vulkano-util` provides a variety of utility functions to streamline certain common operations such as device and swapchain creation.\n  a window to render to.\n\nIn order to run tests, run `cargo test --all` at the root of the repository. Make sure your Vulkan\ndriver is up to date before doing so.\n\n### Hall of Fame\n\nWe would love to mention some members, who put significant contributions to this project:\n- Pierre Krieger. The initial developer. [Patreon page](https:\u002F\u002Fwww.patreon.com\u002Ftomaka).\n- Lucas Kent. Maintainer. [Patreon page](https:\u002F\u002Fwww.patreon.com\u002Frukai).\n- Austin Johnson. Maintainer. [Patreon page](https:\u002F\u002Fwww.patreon.com\u002Faustinj235).\n- Rua. An active developer, who put a lot of effort to improve Vulkano and constantly keeping it up to date.\n- **You!** Thanks to your help, contributions, improvements, bug reports and user experience\n  to make this project one of the major Rust graphics API library in Rust!\n\n## Setup and Troubleshooting\n\nVulkano uses [shaderc-rs](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fshaderc-rs) for shader compilation.  Refer to shaderc-rs documentation to provide a pre-built libshaderc for faster build times.\n\nNote that in general vulkano does **not** require you to install the official Vulkan SDK. This is\nnot something specific to vulkano (you don't need the SDK to write programs that use Vulkan, even\nwithout vulkano), but many people are unaware of that and install the SDK thinking that it is\nrequired. However, macOS, iOS and tvOS platforms do require a little more Vulkan setup since it is not\nnatively supported. See below for more details.\n\nUnless you provide libshaderc, in order to build libshaderc with the shaderc-sys crate, the following tools must be installed and available on `PATH`:\n- [CMake](https:\u002F\u002Fcmake.org\u002F)\n- [Ninja](https:\u002F\u002Fninja-build.org\u002F) Is optional except when building with MSVC.  It may speed up build time for libshaderc.\n- [Python](https:\u002F\u002Fwww.python.org\u002F) (works with both Python 2.x and 3.x, on windows the executable must be named `python.exe`)\n\nThese requirements can be either installed with your favourite package manager or with installers\nfrom the projects' websites. Below are some examples of ways to set up.\n\n### windows-msvc Specific Setup\n\n1. `rustup default stable-x86_64-pc-windows-msvc`\n2. Install [Build Tools for Visual Studio 2017](https:\u002F\u002Fvisualstudio.microsoft.com\u002Fdownloads\u002F#build-tools-for-visual-studio-2017). If you have already been using this toolchain then its probably already installed.\n3.  Install [msys2](https:\u002F\u002Fwww.msys2.org\u002F), following ALL of the instructions.\n4.  Then in the msys2 terminal run: `pacman --noconfirm -Syu mingw-w64-x86_64-cmake mingw-w64-x86_64-python2 mingw-w64-x86_64-ninja`\n5.  Add the msys2 mingw64 binary path to the PATH environment variable.\n\n### Windows-gnu Specific Setup\n\nwindows-gnu toolchain is not supported but you can instead cross-compile to windows-gnu from windows-msvc\n\nSteps 1 and 2 are to workaround https:\u002F\u002Fgithub.com\u002Frust-lang\u002Frust\u002Fissues\u002F49078 by using the same mingw that rust uses.\n\n1.  Download and extract https:\u002F\u002Fs3-us-west-1.amazonaws.com\u002Frust-lang-ci2\u002Frust-ci-mirror\u002Fx86_64-6.3.0-release-posix-seh-rt_v5-rev2.7z\n2.  Add the absolute path to mingw64\\bin to your PATH environment variable. (This path needs to be before the msys2 path)\n3.  Run the command: `rustup default stable-x86_64-pc-windows-msvc`\n4.  Run the command: `rustup target install x86_64-pc-windows-gnu`\n5.  Install [Build Tools for Visual Studio 2017](https:\u002F\u002Fvisualstudio.microsoft.com\u002Fdownloads\u002F#build-tools-for-visual-studio-2017). If you have already been using this toolchain then it's probably already installed.\n6.  Install [msys2](https:\u002F\u002Fwww.msys2.org\u002F), following ALL of the instructions.\n7.  Then in the msys2 terminal run: `pacman --noconfirm -Syu mingw64\u002Fmingw-w64-x86_64-pkg-config mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake mingw-w64-x86_64-make mingw-w64-x86_64-python2 mingw-w64-x86_64-ninja`\n8.  Add the msys2 mingw64 binary path to the PATH environment variable.\n9.  Any cargo command that builds the project needs to include `--target x86_64-pc-windows-gnu` e.g. to run: `cargo run --target x86_64-pc-windows-gnu`\n\n### Linux Specific Setup\n\nUse your package manager to install the required dev-tools and Vulkan drivers\n\nFor example on ubuntu:\n```\nsudo apt-get install build-essential git python cmake libvulkan-dev vulkan-tools\n```\nOn arch based system\n```\nsudo pacman -Sy base-devel git python cmake vulkan-devel --noconfirm\n```\n\n### macOS, iOS and tvOS Specific Setup\n\nVulkan is not natively supported by macOS, iOS and tvOS. However, there exists [MoltenVK](https:\u002F\u002Fgithub.com\u002FKhronosGroup\u002FMoltenVK)\nan open-source Vulkan implementation on top of Apple's Metal API. This allows vulkano to build and run on macOS, iOS and tvOS platforms.\n\nThe easiest way to get vulkano up and running with MoltenVK is to install the\n[Vulkan SDK for macOS](https:\u002F\u002Fvulkan.lunarg.com\u002Fsdk\u002Fhome). There are [installation instructions](https:\u002F\u002Fvulkan.lunarg.com\u002Fdoc\u002Fsdk\u002Flatest\u002Fmac\u002Fgetting_started.html) on the LunarG website.\n\nOn iOS and tvOS, vulkano links directly to the MoltenVK framework. There is nothing else to do besides\ninstalling it. Note that the Vulkan SDK for macOS also comes with the framework for iOS and tvOS.\n\n## License\n\nLicensed under either of\n\n- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or\n  https:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0)\n- MIT license ([LICENSE-MIT](LICENSE-MIT) or https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n\nat your option.\n\n### Contribution\n\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in the work by you shall be dual licensed as above, without any\nadditional terms or conditions.\n","Vulkano 是一个围绕 Vulkan 图形 API 的 Rust 包装库，旨在提供安全且丰富的编程接口。其核心功能包括通过类型安全机制预防所有非法的 API 调用，并在编译时和运行时进行检查；自动处理 GPU 上的同步问题，如依赖关系检测和信号量管理，从而减少开发者的负担。此外，Vulkano 还提供了较为便捷的使用体验，使得开发者无需花费大量时间查阅文档即可完成操作。此项目适用于需要高性能图形渲染的应用场景，特别是在游戏开发、科学可视化等领域，能够帮助开发者充分利用 Vulkan 的强大性能同时避免常见的错误。","2026-06-11 03:04:52","top_language"]