koharu-diffusion 0.62.0-alpha.1

Safe Rust bindings for stable-diffusion.cpp with runtime dynamic loading.
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

use std::{ffi::NulError, path::PathBuf};

/// A result returned by the safe stable-diffusion.cpp wrapper.
pub type Result<T> = std::result::Result<T, Error>;

/// Errors reported while validating arguments or invoking stable-diffusion.cpp.
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum Error {
    #[error("{field} contains an interior NUL byte")]
    InteriorNul {
        field: &'static str,
        #[source]
        source: NulError,
    },
    #[error("{field} is not valid Unicode: {path}", path = path.display())]
    NonUnicodePath { field: &'static str, path: PathBuf },
    #[error("image dimensions overflow the addressable buffer size")]
    ImageDimensionsOverflow,
    #[error("image width, height, and channel count must all be non-zero")]
    ZeroImageDimension,
    #[error("native image has {actual} channels; expected {expected}")]
    UnexpectedNativeImageChannelCount { expected: u32, actual: u32 },
    #[error(
        "invalid audio buffer: {sample_count} samples across {channels} channels requires {expected} values, got {actual}"
    )]
    InvalidAudioBuffer {
        sample_count: u64,
        channels: u32,
        expected: usize,
        actual: usize,
    },
    #[error("audio dimensions overflow the addressable buffer size")]
    AudioDimensionsOverflow,
    #[error("{field} has {len} entries, which exceeds the native API limit")]
    CountOverflow { field: &'static str, len: usize },
    #[error("invalid parameter {name}: {reason}")]
    InvalidParameter {
        name: &'static str,
        reason: &'static str,
    },
    #[error("stable-diffusion.cpp failed to create a model context")]
    ContextCreationFailed,
    #[error("stable-diffusion.cpp failed to generate images")]
    ImageGenerationFailed,
    #[error("stable-diffusion.cpp failed to generate video")]
    VideoGenerationFailed,
    #[error("stable-diffusion.cpp returned an invalid {kind} output")]
    InvalidNativeOutput { kind: &'static str },
    #[error("stable-diffusion.cpp failed to create an upscaler context")]
    UpscalerCreationFailed,
    #[error("stable-diffusion.cpp failed to upscale the image")]
    UpscaleFailed,
    #[error("stable-diffusion.cpp failed to convert the model")]
    ConversionFailed,
    #[error("stable-diffusion.cpp failed to preprocess the image")]
    PreprocessFailed,
    #[error("stable-diffusion.cpp failed to load the importance matrix")]
    ImatrixLoadFailed,
    #[error("a native callback cannot be reconfigured from inside a native call or callback")]
    ReentrantCallbackConfiguration,
    #[error("preview interval must be greater than zero")]
    InvalidPreviewInterval,
    #[error("an importance-matrix collection is already active")]
    ImatrixCollectionAlreadyActive,
    #[error("invalid {kind} value returned by stable-diffusion.cpp: {value}")]
    InvalidEnum { kind: &'static str, value: i32 },
    #[error("unknown {kind} name: {value}")]
    UnknownEnumName { kind: &'static str, value: String },
}