pixelbomber 1.2.4

Insanely fast pixelflut client for images and animations
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

use crate::client::Client;
use crate::image_handler::BinaryFormat;
use std::io::Result;

/// Detected feature set of a pixelflut server.
pub struct Features {
    /// Canvas width
    pub width: u32,
    /// Canvas height
    pub height: u32,
    /// If the `OFFSET` command is supported. NOTE: this is derived from the HELP command
    pub offset: bool,
    /// If the `PX x y gg` command is supported. NOTE: this is derived from the HELP command
    pub px_gray: bool,
    /// If and what binary format the server uses
    pub binary: Option<BinaryFormat>,
}

/// Detect the features supported by a server
/// NOTE: command detection is based on the `HELP` command, and might not work
/// If you do notice that a server has a certain feature, but this is not reflected in the result,
/// feel free to open an issue
pub fn feature_detection(client: &mut Client) -> Result<Features> {
    let (width, height) = client.read_screen_size()?;
    let mut features = Features {
        width,
        height,
        offset: false,
        px_gray: false,
        binary: None,
    };
    let help_text = client.read_help()?;
    for line in help_text.split('\n') {
        let lowered = line.to_lowercase();
        let trimmed = lowered.trim_start();
        // breakwater format
        if trimmed.starts_with("offset") {
            features.offset = true
        // breakwater format and Wellenbrecher format
        } else if trimmed.starts_with("px x y gg") || trimmed.starts_with("grayscale") {
            features.px_gray = true
        // pixelpwner-server and breakwater format
        } else if trimmed.contains("pbxyrgba") || trimmed.contains("pbxxyyrgba") {
            features.binary = Some(BinaryFormat::CoordLERGBA)
        }
    }
    Ok(features)
}