Crate texture_synthesis

texture-synthesis is a light API for Multiresolution Stochastic Texture Synthesis, a non-parametric example-based algorithm for image generation.

First, you build a Session via a SessionBuilder, which follows the builder pattern. Calling build on the SessionBuilder loads all of the input images and checks for various errors.

Session has a run() method that takes all of the parameters and inputs added in the session builder to generated an image, which is returned as a GeneratedImage.

You can save, stream, or inspect the image from GeneratedImage.

Features

1. Single example generation
2. Multi example generation
3. Guided synthesis
4. Style transfer
5. Inpainting
6. Tiling textures

Please, refer to the examples folder in the repository for the features usage examples.

Usage

Session follows a "builder pattern" for defining parameters, meaning you chain functions together.

// Create a new session with default parameters
let session = texture_synthesis::Session::builder()
    // Set some parameters
    .seed(10)
    .nearest_neighbors(20)
    // Specify example images
    .add_example(&"imgs/1.jpg")
    // Build the session
    .build().expect("failed to build session");

// Generate a new image
let generated_img = session.run(None);

// Save the generated image to disk
generated_img.save("my_generated_img.jpg").expect("failed to save generated image");

Re-exports

pub use image;

Structs

CoordinateTransform	A buffer of transforms that were used to generate an image from a set of examples, which can be applied to a different set of input images to get a different output image.
Dims	Simple dimensions struct
Example	An example to be used in texture generation
ExampleBuilder	A builder for an Example
GeneratedImage	An image generated by a Session::run()
ProgressStat	Helper struct for passing progress information to external callers
ProgressUpdate	The current state of the image generator
Session	Texture synthesis session.
SessionBuilder	Builds a session by setting parameters and adding input images, calling build will check all of the provided inputs to verify that texture synthesis will provide valid output

Enums

ChannelMask	Helper type used to mask ImageSource's channels
Error
GenericSampleMethod	Method used for sampling an example image.
ImageSource	Helper type used to define the source of ImageSource's data

Traits

GeneratorProgress

Allows the generator to update external callers with the current progress of the image synthesis

Functions

load_dynamic_image

Type Definitions

SampleMethod
SamplingMethod