新增英文
This commit is contained in:
parent
be88621c9e
commit
cd1641365e
79
readme_en.md
79
readme_en.md
@ -0,0 +1,79 @@
|
||||
# img2webp-cli
|
||||
|
||||
A command-line tool for converting all images in the current directory to WebP format, featuring recursive subdirectory processing and quality selection options, using WASM for processing.
|
||||
|
||||
[English](./readme_en.md)
|
||||
[中文](./readme.md)
|
||||
|
||||
## Installation
|
||||
|
||||
npm:
|
||||
```bash
|
||||
npm install -g img2webp-cli
|
||||
```
|
||||
|
||||
yarn:
|
||||
```bash
|
||||
yarn global add img2webp-cli
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
* Quick use:
|
||||
|
||||
Execute in the image directory:
|
||||
|
||||
```bash
|
||||
cp2webp
|
||||
```
|
||||
|
||||
* Custom use:
|
||||
|
||||
```bash
|
||||
cp2webp -i <input_directory> -o <output_directory> -q <quality> -r <recursive> -a <alpha>
|
||||
```
|
||||
|
||||
### Command Line Options
|
||||
|
||||
- `-i, --input <path>`: Specify input directory, defaults to current directory `./`
|
||||
- `-o, --output <path>`: Specify output directory, defaults to `./output`
|
||||
- `-q, --quality <number>`: Specify compression quality, range 1-100, defaults to 60
|
||||
- `-r, --recursive <number>`: Whether to process subdirectories recursively, defaults to 0 (no recursion)
|
||||
- `-a, --alpha <number>`: Whether to preserve alpha channel, 1 to preserve, 0 to discard, defaults to 1
|
||||
- `-h, --help`: Display help information
|
||||
|
||||
## Example
|
||||
|
||||
To convert images in `/path/to/input` directory to WebP format and output to `/path/to/output` directory:
|
||||
1. Navigate to the image directory
|
||||
```bash
|
||||
cd /path/to/input
|
||||
```
|
||||
2. Execute command
|
||||
```bash
|
||||
cp2webp
|
||||
```
|
||||
or
|
||||
|
||||
Execute from any directory
|
||||
```bash
|
||||
cp2webp -i /path/to/input -o /path/to/output -q 60 -r 1 -a 1
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- Supported image formats include JPG, PNG, TGA, BMP, PSD, GIF, HDR, PIC, and other common formats (for specific supported formats, please check [stb_image](https://github.com/nothings/stb))
|
||||
- By default, the output directory will create a subdirectory named `output` under the specified output path
|
||||
- Maximum recursive processing depth is limited to 5 levels to avoid excessive recursion and unexpected issues
|
||||
|
||||
## Acknowledgments
|
||||
|
||||
- [stb_image](https://github.com/nothings/stb)
|
||||
- [libwebp](https://chromium.googlesource.com/webm/libwebp)
|
||||
WASM packages include [stb_image](https://github.com/nothings/stb) and [libwebp](https://chromium.googlesource.com/webm/libwebp). Thanks to the authors and teams.
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
|
||||
Translated by Claude-3.5-sonnet-20241220
|
Loading…
Reference in New Issue
Block a user