image-provider 0.1.2

Axum-based image resizer
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

# Image Provider

Axum-based image resizer. (like [node/ipx](https://www.npmjs.com/package/ipx))

## Features
- Realtime Resizing
- Embeddable
- Caching

## Format
```
http://localhost:3000/path/to/image.jpg?dpr=2&w=100&h=100&output=webp
```
> Such as `wsrv.nl`

Output Format
`output: "webp", "jpeg", "png"`

Device Pixel Ratio
`dpr: 1 ~ 3`

Width
`w: Number`

Height
`h: Number`

## Usage
### Cli
Download binary from [releases](https://github.com/xiao-e-yun/image-provider/releases).
```bash
Usage: image-provider [OPTIONS] [PATH]

Arguments:
  [PATH]  [default: .]

Options:
  -p, --port <PORT>
          [default: 3000]
      --resize-images-filter-type <resize-images-filter-type>
          Filter type to use for resizing `lanczos3` `gaussian` `catmull-rom` `hamming` `mitchell` `bilinear` `box` [default: lanczos3]
      --resize-images-algorithm <resize-images-algorithm>
          Resize algorithm to use `super-sampling8x` `super-sampling4x` `super-sampling2x` `convolution` `interpolation` `nearest` (nearest will ignore filter_type) [default: interpolation]
      --resize-images-cache-size <resize-images-cache-size>
          Maximum cached images in memory [default: 200]
  -v, --verbose...
          Increase logging verbosity
  -q, --quiet...
          Decrease logging verbosity
  -h, --help
          Print help
```

### Programmatic API
Add `image_provider` to your `Cargo.toml`:
```bash
cargo add image_provider
```

Create image provider router:
```rust
use image_provider::{get_images_router, ResizeConfig};

// Create images_provider router
let config = ResizeConfig::builder().build();
let images_router: Router = get_images_router(path, config);
```

Then you can mount `images_router` to your main router.