imgscale 0.2.1

A library for generating various sizes of an image and the appropriate html <img> tag
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

# Imgscale


A cli / library for generating various sizes of an image and the appropriate html `<img>` tag.

## Features


- Supports a wide range of *input* formats:

  - Jpeg / Jpg
  - Png
  - Webp
  - Avif

- Supports a wide range of *output* formats:

  - Jpeg / Jpg
  - Png
  - Webp Lossless
  - Webp Lossy (only with `zenwebp-agpl` feature)
  - Avif

- Generates html `<img>` tags:

  - Can resolve the image web-path from a given root dir.

- Supports output caching.

- Handles one image on a single thread.

  - You must bring your own multi-image/multithreading

## License


### imgscale


**`imgscale`** is licensed at your choice under either **MIT** or **Apache-2.0**.

> [!IMPORTANT]  
> The `zenwebp-agpl` feature pulls in `zenwebp` which is licensed **AGPL-3.0-only**.  
> Enabling the optional `zenwebp-agpl` feature subjects any compiled binary or service using it to the terms of the AGPL-3.0.

### imgscale-cli


**`imgscale-cli`** is licensed **AGPL-3.0-only**, because it pulls in `zenwebp`.

## Cli


### Installation


Right now it is only available from source. I might publish binaries to GitHub Releases and add support for `cargo binstall` in the future.

Install from source (will install the `imgscale` binary):

```shell
cargo install imgscale-cli
```

### Usage


```shell
imgscale --widths 400,800,1200 input-img.jpg --output-dir some/dir
```

## Library


See examples and documentation at [docs.rs](https://docs.rs/imgscale).