# 查找表([name])

表示色彩映射的查找表。它用于从一系列数据值中确定颜色值。

## 引入

[name] 是一个附加组件，必须显式导入。请参阅 [link:#manual/introduction/Installation Installation / Addons]。

`import { Lut } from 'three/addons/math/Lut.js';`

## 代码示例

`const lut = new Lut( 'rainbow', 512 ); const color = lut.getColor( 0.5 );`

## 构造函数

### [name]( [param:String colormap], [param:Number count] )

colormap - 设置预定义色彩映射中的一个。可用的色彩映射有：`rainbow`, `cooltowarm`, `blackbody`, `grayscale`。 默认为 `rainbow`。
count - 设置用于表示数据数组的颜色数量。默认为 `32`。

## 属性

### [property:Array lut]

所选颜色映射的查找表，表示为 [page:Color] 数组。

### [property:Array map]

当前选择的颜色映射。默认是 `rainbow`。

### [property:Number minV]

用查找表表示的最小值。默认值为 *0*。

### [property:Number maxV]

用查找表表示的最大值。默认值为 *1*。

### [property:Number n]

当前所选颜色映射的颜色数。默认为 `32`。

## 方法

### [method:this copy]( [param:Lut lut] ) [param:Lut this]

color — Lut 复制。

复制给定的 lut。

### [method:this addColorMap]( [param:String name], [param:Array arrayOfColors] )

name — 颜色映射的名称。
arrayOfColors — 颜色值数组。每个值都是一个数组，其中包含阈值和十六进制数形式的实际颜色值。

将一个颜色映射添加到此 [name] 实例。

### [method:HTMLCanvasElement createCanvas]()

创建一个画布以将查找表可视化为纹理。

### [method:Color getColor]( [param:Number alpha] )

value -- 要显示为颜色的数据值。

返回给定数据值的 [page:Color] 实例。

### [method:this setColorMap]( [param:String colormap], [param:Number count] )

colormap — 颜色映射的名称。
count — 颜色的数量。默认为 `32`。

为给定的颜色映射和颜色数量配置查找表。

### [method:this setMin]( [param:Number minV] )

minV — 用查找表表示的最小值

设置此 [name] 的表示最小值。

### [method:this setMax]( [param:Number maxV] )

maxV — 用查找表表示的最大值。

设置此 [name] 的表示最大值。

### [method:HTMLCanvasElement updateCanvas]( [param:HTMLCanvasElement canvas] )

使用 [name] 的数据更新画布。

## 源代码

[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/math/Lut.js examples/jsm/math/Lut.js]