Aloe XEmbed

Aloe XEmbed is a Rust crate designed specifically for embedding foreign X11 widgets on Linux and other Unix-like operating systems. It provides functionality to integrate widgets from toolkits such as GTK+ and QT, adhering to the XEmbed protocol as outlined in the freedesktop.org specification.

Overview

Aloe XEmbed supports both client-initiated and host-initiated XEmbed protocols:

• Client Initiated Protocol: The client creates a window, passing it to the hosting environment.
• Host Initiated Protocol: The host creates a window, allowing the client to reparent its widget.

This crate is compatible with GTK+ using gtk_plug_new and QT with QX11EmbedWidget. Additionally, it supports embedding of raw X11 widgets by following the standard X11 embed protocol.

Features

• Wide Compatibility: Supports GTK+, QT, and other X11 toolkits.
• Dual Protocol Support: Seamless handling of both client-initiated and host-initiated XEmbed protocols.
• Flexible Focus Management: Customize keyboard focus handling and window resizing behavior.

Requirements

• Operating System: Compatible with Linux, FreeBSD, OpenBSD, and NetBSD.
• Rust Edition: 2024

Usage

To use the crate, first ensure that your build environment is configured to target one of the supported operating systems. Then, you can include the crate in your Cargo.toml:

[dependencies]
aloe-xembed = "0.1.0"

After adding the dependency, you can embed a X11 widget as follows:

let xembed_component = aloe_xembed::XEmbedComponent::new(None, None);
// Additional logic and integration...

For client-initiated integration:

let window_id = /* obtain window id from GTK+ or QT */;
let xembed_component = aloe_xembed::XEmbedComponent::new(window_id, true, false);

Contributing

Aloe XEmbed is open-source and maintained by klebs. Contributions in the form of bug reports and pull requests are greatly appreciated.

Disclaimer

This README.md was generated by an AI model and may not be 100% accurate, however it should be pretty good.

This crate is a translation of the JUCE module.

JUCE is a c++ software framework for developing high performance audio applications.

Usage falls under the GPLv3 as well as the JUCE commercial license.

See github.com/juce-framework/JUCE and the JUCE license page for details.

This crate is in the process of being translated from c++ to rust. For progress updates, please see the workspacer rust project. designed specifically for rust projects.