# 调色与自动增强

> 调整图片的亮度、对比度、饱和度等色调，或一键自动增强画质。

## 自动增强

| 参数        | 含义                                    | 取值       |
| :-------- | ------------------------------------- | -------- |
| `enhance` | **自动画质增强**，值为强度。只写 `enhance` 不带值时为 50 | 0 \~ 100 |
| `redeye`  | **去红眼**                               | `1`      |

`enhance` 会分析画面后自动调整：校正黑白场，提亮偏暗的中间调，适度增加对比与自然饱和度。它会按画面明暗自适应：光线充足的照片改动很小，偏暗的照片改善更明显；高光区域受到保护，不会过曝。

<https://demo.bitiful.com/girl.jpeg?enhance=70>

也可使用 `auto` 写法组合多项：`auto=enhance,redeye`。其中 `auto=enhance` 等同于 `enhance=100`。

## 手动调色

| 参数           | 含义         |      取值     | 说明                |
| :----------- | ---------- | :---------: | ----------------- |
| `bri`        | **亮度**     | -100 \~ 100 | 整体变亮或变暗           |
| `con`        | **对比度**    | -100 \~ 100 | -100 为全灰          |
| `gam`        | **伽马**     | -100 \~ 100 | 正值提亮中间调，高光与暗部基本不变 |
| `exp`        | **曝光**     | -100 \~ 100 | 对应正负 2 档曝光        |
| `high`       | **高光**     |  -100 \~ 0  | 压暗高光，找回过亮区域的细节    |
| `shad`       | **阴影**     | -100 \~ 100 | 正值提亮暗部，负值压暗       |
| `sat`        | **饱和度**    | -100 \~ 100 | -100 为黑白          |
| `vib`        | **自然饱和度**  | -100 \~ 100 | 优先提升不饱和的颜色，保护肤色   |
| `hue`        | **色相**     | -360 \~ 360 | 旋转角度              |
| `sepia`      | **怀旧棕褐色调** |   0 \~ 100  | 值为强度              |
| `monochrome` | **单色调**    |    十六进制颜色   | 4 位或 8 位写法的首段为强度  |
| `invert`     | **反相**     |     `1`     | –                 |

所有参数默认为 0，即不调整。多个参数可以同时使用。

<https://demo.bitiful.com/girl.jpeg?exp=20&shad=30&vib=25>

锐化与马赛克分别见 [图像锐化](/coreix/features/sharp) 和 [图像模糊](/coreix/features/blur)。

## 使用说明

- **执行顺序**：自动增强在前，手动调色在后，即手动参数是在增强结果上微调。
- **宽色域**：Display P3、Adobe RGB 等宽色域图片按其原有色彩空间计算，色彩不会被压缩到 sRGB。
- **透明图片**：透明度保持不变。
- **动图**：支持，各帧使用同一组调整，不会出现帧间色调跳变。
- **HDR 图片**：调色只作用于 SDR 画面，HDR 高光信息保留。黑白、棕褐、单色调会同步去除 HDR 部分的色彩；`invert` 输出为 SDR。
- **视频**：不支持，输出视频时带这些参数会返回错误。
