2026a

# brighten

增亮或加深颜色图

函数库: TyPlot

# 语法

brighten(s, beta)
brighten(s,map,beta)
newmap = brighten(beta)
newmap = brighten(map,beta)

# 说明

brighten(s, beta) 沿同一方向变换当前颜色图中所有颜色的强度。当 beta 介于 0 和 1 之间时，颜色变亮；当 beta 介于 -1 和 0 之间时，颜色变暗。变化的幅度与 beta 的幅值成正比。示例

brighten(s,map,beta) 变换指定为 map 的颜色图的强度。示例

newmap = brighten(beta) 返回调整后的颜色图。

newmap = brighten(map,beta) 指定颜色图。您也可以通过调用预定义的颜色图函数来创建矩阵。

# 示例

增亮当前颜色图

创建一个使用默认颜色图的曲面图。

using TyPlot
x, y, z = peaks()
s = surf(x, y, z)

增亮当前图窗的颜色图。

brighten(s, 0.8)

加深特定坐标区的颜色图

在分块图布局中显示使用 summer 颜色图的两个曲面图。

using TyPlot
ax1 = subplot(1, 2, 1; projection="3d")
ax2 = subplot(1, 2, 2; projection="3d")
x, y, z = peaks(49)
s1 = surf(ax1, x, y, z)
s2 = surf(ax2, x, y, z)
colormap(s1, "summer")

加深 summer 颜色图，并将其应用于第二个曲面。

newmap = brighten(summer(), -0.7)
colormap(s2, newmap)

# 输入参数

s — 目标对象

图形对象

目标对象，指定为图形对象。

beta — 亮度调整

数值标量值

亮度调整参数，指定为一个数值标量值。brighten 函数将颜色图中的每个值增大为 γ 的幂，其定义为：

数据类型： Float32 | Float64

map — 颜色图

由 RGB 三元组组成的三列矩阵

要绘制的颜色图，指定为由 RGB 三元组组成的三列矩阵。RGB 三元组是包含三个元素的行向量，其元素分别指定颜色的红、绿、蓝分量的强度。强度必须在 [0, 1] 范围内。例如，下面是包含五种颜色的颜色图：

map = [0.2 0.1 0.5
    0.1 0.5 0.8
    0.2 0.7 0.6
    0.8 0.7 0.3
    0.9 1 0];

下表列出了常见颜色的 RGB 三元组值。

颜色	RGB 三元组
黄色	[1 1 0]
品红色	[1 0 1]
青蓝色	[0 1 1]
红色	[1 0 0]
绿色	[0 1 0]
蓝色	[0 0 1]
白色	[1 1 1]
黑色	[0 0 0]

您也可以通过调用预定义的颜色图函数来创建矩阵。将该函数作为 brighten 函数的输入参数进行调用。例如，下面的命令绘制 parula 颜色图。

brighten(parula(), 0.8)

数据类型： Float32 | Float64

# 输出参数

newmap - 调整后的颜色图

由 RGB 三元组组成的三列矩阵

调整后的颜色图，返回为由 RGB 三元组组成的三列矩阵。

# 另请参阅

colormap | rgbplot