Skip to content

Latest commit

 

History

History
68 lines (41 loc) · 3.91 KB

README.md

File metadata and controls

68 lines (41 loc) · 3.91 KB

Safe Rust bindings to the Skia Graphics Library.

This packages contains safe Rust wrappers for Skia and uses skia-bindings to build and interface with the Skia C++ library.

For information about the supported build targets and how to run the examples, please visit the github page of the rust-skia project.

Documentation

Function level documentation is not yet available. To get started, take a look at the Rust examples or the Skia documentation.

Bindings & Wrappers

Skia-safe wraps most parts of the public Skia C++ APIs:

  • Vector Geometry: Matrix, Rect, Point, Size, etc.
  • Most drawing related classes and functions: Surface, Canvas, Paint, Path.
  • Effects and Shaders.
  • Utility classes we think are useful.
  • PDF & SVG rendering
  • Skia Modules
  • GPU Backends
    • Vulkan
    • OpenGL
    • Metal

Wrappers for functions that take callbacks and virtual classes are not supported right now. While we think they should be wrapped, the use cases related seem to be rather special, so we postponed that for now.

Features

Skia-safe supports the following features that can be configured via cargo:

gl

Platform support for OpenGL or OpenGL ES can be enabled by adding the feature gl. Since version 0.25.0, rust-skia is configured by default to enable CPU rendering only. Before that, OpenGL support was included in every feature configuration. To render the examples with OpenGL, use

(cd skia-org && cargo run --features gl [OUTPUT_DIR] --driver opengl)

vulkan

Vulkan support can be enabled by adding the feature vulkan. To render the examples with Vulkan, use

(cd skia-org && cargo run --features vulkan [OUTPUT_DIR] --driver vulkan)

Note that Vulkan drivers need to be available. On Windows, they are most likely available already, on Linux this article on linuxconfig.org might get you started, and on macOS with Metal support, install the Vulkan SDK for Mac and configure MoltenVK by setting the DYLD_LIBRARY_PATH, VK_LAYER_PATH, and VK_ICD_FILENAMES environment variables as described in Documentation/getting_started_macos.html.

metal

Support for Metal on macOS and iOS targets can be enabled by adding the feature metal.

textlayout

The Cargo feature textlayout enables text shaping with Harfbuzz and ICU by providing bindings to the Skia modules skshaper and skparagraph.

The skshaper module can be accessed through skia_safe::Shaper and the Rust bindings for skparagraph are in the skia_safe::textlayout module.

On Windows, the file icudtl.dat must be available in your executable's directory. To provide the data file, either copy it from the build's output directory (shown when skia-bindings is compiled with cargo build -vv | grep "ninja: Entering directory"), or - if your executable directory is writable - invoke the function skia_safe::icu::init() before using the skia_safe::Shaper object or the skia_safe::textlayout module.

Simple examples of the skshaper and skparagraph module bindings can be found in the skia-org example command line application.