b3-core

Crates.iob3-core
lib.rsb3-core
version0.4.0
sourcesrc
created_at2024-05-31 14:57:17.311794
updated_at2024-06-06 05:05:02.322356
descriptionA cross-platform framework that provides access and management of the main elements of a graphical application.
homepagehttps://github.com/Klein-Stein/b3-core
repositoryhttps://github.com/Klein-Stein/b3-core
max_upload_size
id1258085
size101,491
Denis Sologub (ghostman2013)

documentation

https://docs.rs/crate/b3-core/latest

README

B3. Core

Crates.io Version docs.rs GitHub License GitHub Actions Workflow Status

⚠️WARNING The project is under active development. The current codebase may be unstable and incomplete, and the API may be significantly changed in future versions. At this stage, it is highly discouraged to use this crate in the release build.

Preview

B3. Core is a cross-platform framework that provides access and management of the main elements of a graphical application:

  • events including mouse, keyboard and touchpad events,
  • menus: application, context and etc.,
  • windows,
  • notifications,
  • tray.

The framework was heavily inspired by winit crate.

Repository

If you want to make a Pull Request or open a new Issue, please, make sure that you are on GitHub.com, and not project's mirrors.

Main:

Mirror:

Roadmap

  • macOS: Application menu support
  • macOS: Support of system events
  • macOS: Support of windows
  • macOS: Support of modal windows
  • macOS: Support of notifications

Features

Feature Description
dh Provide raw display and window pointers
notifications Enable a support of user notifications

Examples

The project contains few examples in the examples folder.

Example Description
hello-app Minimally viable application with a trivial application menu. This example will only be visible on OS that supports the main application menu.
hello-window Example of application with multiple windows, notifications and the main application menu.
hello-vulkan Example of Vulkan initialization. It requires an additional configuration (see below).

To launch the hello-vulkan example it's required to specify environment variables that point to installed Vulkan libraries. To do this, create .env file in project's root directory:

# Replace <...> by actual paths
cat <<EOT >> .env
VULKAN_SDK=<VULKAN_SDK_DIR>/<TARGET_PLATFORM_DIR>
PATH=<VULKAN_SDK_DIR>/<TARGET_PLATFORM_DIR>/bin:$PATH
DYLD_LIBRARY_PATH=<VULKAN_SDK_DIR>/<TARGET_PLATFORM_DIR>/lib:$DYLD_LIBRARY_PATH
VK_ICD_FILENAMES=<VULKAN_SDK_DIR>/<TARGET_PLATFORM_DIR>/share/vulkan/icd.d/MoltenVK_icd.json
VK_LAYER_PATH=<VULKAN_SDK_DIR>/<TARGET_PLATFORM_DIR>/share/vulkan/explicit_layer.d
EOT

License

This project is distributed under the MIT license.

Commit count: 53

cargo fmt