Linebender Resource Handle

Shared handle for immutable blobs with dynamic lifetime

Linebender Resource Handle provides functionality for storing blobs of data and an associated ID. This primitive is adapted in Peniko to store images, but the FontData type lives in this crate. This crate is designed to allow making semver incompatible releases of Parley and Vello, whilst allowing them to be cross-compatible.

This crate is not intended for long-term use, and we expect our resource handling story to change. That's the reason that this crate has the organisation name ("Linebender") in its crate name; we avoid squatting a more general name after we discontinue it.

Features

The following crate feature flags are available:

• std (enabled by default): Enable future features which require the standard library. This feature is provided for forwards compatibility only, and current behaviour is the same whether or not it is enabled.
• serde: Implement [serde::Serialize] and [serde::Deserialize] for the types in the crate.
• stable_deref_trait_v1: Implements the StableDeref trait for Blob, which can be used with crates like yoke to enable zero-copy deserialization of data stored in the Blob.

Minimum supported Rust Version (MSRV)

This version of Linebender Resource Handle has been verified to compile with Rust 1.70 and later.

Future versions of Linebender Resource Handle might increase the Rust version requirement. It will not be treated as a breaking change and as such can even happen with small patch releases.

Community

Discussion of Linebender Resource Handle development happens in the Linebender Zulip, specifically in #rust ui > Linebender Resource Handle. All public content can be read without logging in

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Contributions are welcome by pull request. The Rust code of conduct applies. Please feel free to add your name to the AUTHORS file in any substantive pull request.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.