fun registerClientInvertPostEffect(id: String = "katton:preset/invert", amount: Float = 1.0f, activate: Boolean = false): Boolean注册一个可配置的全屏反色效果。
| 参数 | 说明 |
|---|---|
amount | 0.0 保持原图，1.0 完全反色。 |
fun registerClientGrayscalePostEffect(id: String = "katton:preset/grayscale", amount: Float = 1.0f, activate: Boolean = false): Boolean注册一个可配置的灰度效果。
| 参数 | 说明 |
|---|---|
amount | 0.0 保留颜色，1.0 完全转为灰度。 |
fun registerClientSepiaPostEffect(id: String = "katton:preset/sepia", amount: Float = 1.0f, activate: Boolean = false): Boolean注册一个可配置的棕褐色效果。
| 参数 | 说明 |
|---|---|
amount | 0.0 保持原图，1.0 完全应用棕褐色调。 |
fun registerClientTintPostEffect(id: String = "katton:preset/tint", color: Int = 0x55AAFF, amount: Float = 0.5f, activate: Boolean = false): Boolean注册一个将屏幕亮度映射到 [color] 的染色效果。
| 参数 | 说明 |
|---|---|
color | RGB 或 ARGB 整数；Alpha 通道会被忽略。 |
amount | 0.0 保留原色，1.0 完全应用染色。 |
fun registerClientColorAdjustPostEffect(id: String = "katton:preset/color_adjust", brightness: Float = 0.0f, contrast: Float = 1.0f, saturation: Float = 1.0f, gamma: Float = 1.0f, activate: Boolean = false): Boolean注册一个基础颜色调整效果。
| 参数 | 说明 |
|---|---|
brightness | -1.0 变暗，0.0 不变，1.0 变亮。 |
contrast | 1.0 不变，较低值降低对比度，较高值增强对比度。 |
saturation | 1.0 不变，0.0 转为灰度，较高值提高饱和度。 |
gamma | 1.0 不变，较高值会提亮暗部。 |
fun registerClientVignettePostEffect(id: String = "katton:preset/vignette", amount: Float = 0.75f, radius: Float = 0.65f, softness: Float = 0.35f, color: Int = 0x000000, activate: Boolean = false): Boolean注册一个暗角效果。
| 参数 | 说明 |
|---|---|
amount | 边缘颜色强度。 |
radius | 从屏幕中心到暗角开始位置的距离。 |
softness | 衰减宽度。 |
color | RGB 或 ARGB 整数；Alpha 通道会被忽略。 |
fun registerClientChromaticAberrationPostEffect(id: String = "katton:preset/chromatic_aberration", offsetPixels: Float = 1.5f, amount: Float = 1.0f, activate: Boolean = false): Boolean注册一个色差效果。
| 参数 | 说明 |
|---|---|
offsetPixels | 红色和蓝色通道的屏幕像素偏移量。 |
amount | 原始颜色与偏移颜色之间的混合比例。 |
fun registerClientPixelatePostEffect(id: String = "katton:preset/pixelate", pixelSize: Float = 4.0f, activate: Boolean = false): Boolean注册一个像素化效果。
| 参数 | 说明 |
|---|---|
pixelSize | 像素块的屏幕像素大小。 |
fun registerClientPosterizePostEffect(id: String = "katton:preset/posterize", levels: Int = 5, amount: Float = 1.0f, activate: Boolean = false): Boolean注册一个色阶压缩效果。
| 参数 | 说明 |
|---|---|
levels | 每个颜色通道的色阶数量。 |
amount | 0.0 保留原色，1.0 完全应用色阶压缩。 |
fun registerClientScanlinePostEffect(id: String = "katton:preset/scanline", amount: Float = 0.18f, lines: Float = 240.0f, activate: Boolean = false): Boolean注册一个静态扫描线效果。
| 参数 | 说明 |
|---|---|
amount | 扫描线暗度。 |
lines | 屏幕高度方向上的近似扫描线数量。 |
fun registerClientBlurPostEffect(id: String = "katton:preset/blur", radius: Float = 4.0f, passes: Int = 1, activate: Boolean = false): Boolean注册一个基于 Minecraft 内置 box blur shader 的模糊效果。
| 参数 | 说明 |
|---|---|
radius | 模糊半径，单位为像素。 |
passes | 水平和垂直模糊轮数。 |