blinc_platform_desktop 0.1.13

Blinc desktop platform - macOS, Windows, Linux windowing and input
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

# blinc_platform_desktop

> **Part of the [Blinc UI Framework](https://project-blinc.github.io/Blinc)**
>
> This crate is a component of Blinc, a GPU-accelerated UI framework for Rust.
> For full documentation and guides, visit the [Blinc documentation](https://project-blinc.github.io/Blinc).

Desktop platform implementation for Blinc UI.

## Overview

`blinc_platform_desktop` provides windowing, input handling, and event loop implementation for desktop platforms (macOS, Windows, Linux) using [winit](https://github.com/rust-windowing/winit).

## Supported Platforms

- **macOS**: 11.0+ (Big Sur and later)
- **Windows**: 10+
- **Linux**: X11 and Wayland

## Features

- **Native Windowing**: Platform-native window management
- **Full Input Support**: Mouse, keyboard, trackpad, touch
- **High DPI**: Automatic scale factor handling
- **Multiple Windows**: Create and manage multiple windows
- **Platform Integration**: Native look and feel

## Quick Start

```rust
use blinc_platform_desktop::DesktopPlatform;
use blinc_platform::{Platform, WindowConfig};

fn main() {
    let platform = DesktopPlatform::new();

    let window = platform.create_window(WindowConfig {
        title: "My App".to_string(),
        width: 800,
        height: 600,
        ..Default::default()
    });

    platform.run(|event| {
        match event {
            Event::RedrawRequested(_) => {
                // Render your UI
            }
            Event::WindowEvent { event, .. } => {
                // Handle window events
            }
            _ => {}
        }
        ControlFlow::Poll
    });
}
```

## Platform-Specific Features

### macOS

```rust
#[cfg(target_os = "macos")]
{
    // Native title bar integration
    window.set_titlebar_transparent(true);

    // Vibrancy effects
    window.set_background_appearance(NSVisualEffectMaterial::Sidebar);

    // Full screen support
    window.set_fullscreen(Some(Fullscreen::Borderless));
}
```

### Windows

```rust
#[cfg(target_os = "windows")]
{
    // DWM composition
    window.enable_blur_behind();

    // Taskbar integration
    window.set_taskbar_progress(0.5);
}
```

### Linux

```rust
#[cfg(target_os = "linux")]
{
    // Wayland-specific
    window.set_app_id("com.example.myapp");

    // X11-specific
    window.set_wm_class("MyApp", "myapp");
}
```

## Event Handling

```rust
platform.run(|event| {
    match event {
        // Window lifecycle
        Event::WindowEvent { event: WindowEvent::CloseRequested, .. } => {
            return ControlFlow::Exit;
        }

        // Input
        Event::WindowEvent { event: WindowEvent::KeyboardInput { input, .. }, .. } => {
            handle_key(input);
        }

        Event::WindowEvent { event: WindowEvent::CursorMoved { position, .. }, .. } => {
            handle_mouse_move(position.x, position.y);
        }

        // Redraw
        Event::RedrawRequested(_) => {
            render();
        }

        _ => {}
    }
    ControlFlow::Poll
});
```

## Requirements

### macOS
- Xcode Command Line Tools

### Windows
- Visual Studio Build Tools 2019+

### Linux
- X11: `libxkbcommon-dev`, `libwayland-dev`, `libxrandr-dev`
- Wayland: `libwayland-dev`, `libxkbcommon-dev`

## License

MIT OR Apache-2.0