oxidize-html-gpui 0.1.2

GPUI rendering backend for oxidize-html. Translates DrawCommands into GPUI elements.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

# oxidize-html-gpui
[![Tests](https://img.shields.io/github/actions/workflow/status/ghostvox/oxidize-html/render.yml?branch=master&label=oxidize-html-render&logo=rust)](https://github.com/ghostvox/oxidize-html/actions/workflows/render.yml)



GPUI rendering backend for `oxidize-html-engine`. Translates `DrawCommand`s into GPUI elements.

## Usage

Add to your `Cargo.toml`:

```toml
[dependencies]
oxidize-html = {"0.1.0" }
oxidize-render = { path = "../oxidize-render", features = ["gpui"] }
gpui = {2.2.0 }
```

Then in your GPUI component:

```rust
use oxidize_html::HtmlRenderer;
use oxidize_html_gpui::gpui_renderer::{command_element, content_extent};
use gpui::{div, px};

let mut renderer = HtmlRenderer::default();
let commands = renderer.render_html(&html, width);
let (doc_width, doc_height) = content_extent(&commands);

let mut document = div()
    .relative()
    .w(px(doc_width))
    .h(px(doc_height));

for command in &commands {
    document = document.child(command_element(command));
}
```

## Public API

### `command_element(command: &DrawCommand) -> gpui::Div`
Converts a single `DrawCommand` into a GPUI `Div` element positioned absolutely within a document canvas.

### `content_extent(commands: &[DrawCommand]) -> (f32, f32)`
Computes the total `(width, height)` of the rendered document from its draw commands. Use this to size the canvas container.

### `to_bounds_with_offset(rect: Rect, ox: f32, oy: f32) -> Bounds<Pixels>`
Converts an engine `Rect` to a GPUI `Bounds<Pixels>` with a scroll or origin offset applied. Useful for hit testing links and interactive elements.
Example:

```rust
use oxidize_html::DrawCommand;
use oxidize_html_gpui::gpui_renderer::to_bounds_with_offset;
use gpui::Bounds;

// inside Element::paint, where `bounds: Bounds` is available:
let ox = f32::from(bounds.origin.x);
let oy = f32::from(bounds.origin.y);
for command in &commands {
if let DrawCommand::Link { rect, href } = command {
let link_bounds = to_bounds_with_offset(*rect, ox, oy);
// use link_bounds for mouse hit testing
}
}
```

## Features

| Feature | Description |
|---------|-------------|
| `gpui` | Enables the GPUI rendering backend (required) |