mirror of
https://gitee.com/openharmony/third_party_vulkan-loader
synced 2024-11-23 15:20:52 +00:00
61688e09fe
Update the loader documentation in the following ways:
1. Move documentation to new "docs" folder"
2. Split LoaderAndLayerInterface.md into multiple docs to focus
on target audience:
- Top-Level LoaderInterfaceArchitecture.md
- Applications LoaderApplicationInterface.md
- Layers LoaderLayerInterface.md
- ICDs LoaderImplementationInterface.md
3. Upload newer images and their corresponding original Inkscape files.
4. Cleanup and update sections on Linux directory search
5. Add new sections to detail items missing
- VkConfig
- Handling undef Fuchsia
6. Language cleanup
Thanks to @charles-lunarg and @smcv for feedback and various section language
corrections.
63 lines
2.7 KiB
Markdown
63 lines
2.7 KiB
Markdown
# Vulkan Ecosystem Components
|
|
|
|
This project provides the Khronos official Vulkan ICD desktop loader for Windows, Linux, and MacOS.
|
|
|
|
## CI Build Status
|
|
|
|
[](https://github.com/KhronosGroup/Vulkan-Loader/actions)
|
|
|
|
## Introduction
|
|
|
|
Vulkan is an explicit API, enabling direct control over how GPUs actually work.
|
|
As such, Vulkan supports systems that have multiple GPUs, each running with a different driver, or ICD (Installable Client Driver).
|
|
Vulkan also supports multiple global contexts (instances, in Vulkan terminology).
|
|
The ICD loader is a library that is placed between a Vulkan application and any number of Vulkan drivers, in order to support multiple drivers and the instance-level functionality that works across these drivers.
|
|
Additionally, the loader manages inserting Vulkan layer libraries, such as validation layers, between an application and the drivers.
|
|
|
|
This repository contains the Vulkan loader that is used for Linux, Windows, MacOS, and iOS.
|
|
There is also a separate loader, maintained by Google, which is used on Android.
|
|
|
|
The following components are available in this repository:
|
|
|
|
- [ICD Loader](loader/)
|
|
- [Loader Documentation](docs/LoaderInterfaceArchitecture.md)
|
|
- [Tests](tests/)
|
|
|
|
## Contact Information
|
|
|
|
- [Charles Giessen](mailto:charles@lunarg.com)
|
|
- [Mark Young](mailto:marky@lunarg.com)
|
|
|
|
## Information for Developing or Contributing
|
|
|
|
Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file in this repository for more details.
|
|
Please see the [GOVERNANCE.md](GOVERNANCE.md) file in this repository for repository
|
|
management details.
|
|
|
|
## How to Build and Run
|
|
|
|
[BUILD.md](BUILD.md)
|
|
Includes directions for building all components.
|
|
|
|
Architecture and interface information for the loader is in
|
|
[docs/LoaderInterfaceArchitecture.md](docs/LoaderInterfaceArchitecture.md).
|
|
|
|
## Version Tagging Scheme
|
|
|
|
Updates to the `Vulkan-Loader` repository which correspond to a new Vulkan specification release are tagged using the following format: `v<`_`version`_`>` (e.g., `v1.1.96`).
|
|
|
|
**Note**: Marked version releases have undergone thorough testing but do not imply the same quality level as SDK tags. SDK tags follow the `sdk-<`_`version`_`>.<`_`patch`_`>` format (e.g., `sdk-1.1.92.0`).
|
|
|
|
This scheme was adopted following the 1.1.96 Vulkan specification release.
|
|
|
|
## License
|
|
|
|
This work is released as open source under a Apache-style license from Khronos
|
|
including a Khronos copyright.
|
|
|
|
## Acknowledgements
|
|
|
|
While this project has been developed primarily by LunarG, Inc., there are many other
|
|
companies and individuals making this possible: Valve Corporation, funding
|
|
project development; Khronos providing oversight and hosting of the project.
|