caesura 0.31.0

An all-in-one command line tool to transcode FLAC audio files and upload to gazelle based indexers/trackers
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

use crate::testing_prelude::*;
use image::{Rgb, RgbImage};

/// Builder for generating sample PNG images with a gradient pattern.
///
/// # Example
/// ```ignore
/// ImageGenerator::new()
///     .with_filename("cover.png")
///     .with_size(100, 100)
///     .generate(&output_dir)?;
/// ```
#[derive(Debug, Clone)]
pub struct ImageGenerator {
    width: u32,
    height: u32,
    filename: String,
}

impl Default for ImageGenerator {
    fn default() -> Self {
        Self {
            width: 100,
            height: 100,
            filename: "image.png".to_owned(),
        }
    }
}

impl ImageGenerator {
    /// Create a new image generator with default parameters.
    ///
    /// Defaults:
    /// - Size: 100x100
    /// - Filename: "image.png"
    #[must_use]
    pub fn new() -> Self {
        Self::default()
    }

    /// Set the image dimensions (default: 100x100).
    #[must_use]
    pub fn with_size(mut self, width: u32, height: u32) -> Self {
        self.width = width;
        self.height = height;
        self
    }

    /// Set the output filename (default: "image.png").
    #[must_use]
    pub fn with_filename(mut self, filename: impl Into<String>) -> Self {
        self.filename = filename.into();
        self
    }

    /// Generate the image in the specified output directory.
    ///
    /// Returns the full path to the generated file.
    pub fn generate(&self, output_dir: &Path) -> Result<PathBuf, Failure<SampleAction>> {
        let path = output_dir.join(&self.filename);
        let mut img = RgbImage::new(self.width, self.height);
        #[allow(
            clippy::as_conversions,
            clippy::cast_possible_truncation,
            clippy::integer_division
        )]
        for y in 0..self.height {
            for x in 0..self.width {
                // Red decreases left-to-right, blue increases top-to-bottom
                let r = (255 - (x * 255 / self.width.max(1))) as u8;
                let b = (y * 255 / self.height.max(1)) as u8;
                img.put_pixel(x, y, Rgb([r, 0, b]));
            }
        }
        img.save(&path)
            .map_err(Failure::wrap(SampleAction::SaveImage))?;
        Ok(path)
    }
}