色彩处理

tint 着色

在保留图像亮度的同时，使用提供的色度对图像进行染色。可能存在一个Alpha通道，该通道将保持不变。

参数

• rgb （string|Object）由色彩模块解析以提取色度值。

例子

const output = await sharp(input)
  .tint({ r: 255, g: 240, b: 16 })
  .toBuffer();

• 无效参数将引发错误

返回sharp实例对象

greyscale 灰度

转换为8位灰度；256种灰色阴影。这是线性操作。如果输入图像位于诸如sRGB之类的非线性色彩空间中，请使用gamma() 伴随greyscale()以获得最佳效果。默认情况下，输出图像将是Web友好的sRGB，并包含三个（相同）颜色通道。可能会被其他sharp的操作（例如toColourspace('b-w')）覆盖，这将产生包含一个颜色通道的输出图像。可能存在一个Alpha通道，并且该操作将保持其不变。

参数

• greyscale boolean （可选，默认true）

例子

const output = await sharp(input).greyscale().toBuffer();

返回sharp实例对象

grayscale 灰阶

greyscale的替代拼写。

参数

• grayscale boolean （可选，默认true）

返回sharp实例对象

pipelineColourspace 管道色彩空间

设置管道配色空间。

参数

• colourspace string ？输出色彩空间例如rgb16，scrgb，lab，grey16 …

例子

await sharp(input)
 .pipelineColourspace('rgb16')
 .toColourspace('srgb')
 .toFile('16bpc-pipeline-to-8bpc-output.png')

• 无效参数将引发错误

返回sharp实例对象

pipelineColorspace

Pipelinecoolourspace 的可选拼写。

参数

• colorspace string ？输出色彩空间例如rgb16，scrgb，lab，grey16 …
• 无效参数将引发错误

返回sharp实例对象

toColourspace

设置输出色彩空间。默认情况下，输出图像将是Web友好的sRGB，附加通道被解释为alpha通道。

参数

• colourspace string ？输出色彩空间例如srgb，rgb，cmyk，lab，b-w …

例子

// Output 16 bits per pixel RGB
await sharp(input)
 .toColourspace('rgb16')
 .toFile('16-bpp.png')

• 无效参数将引发错误

返回sharp实例对象

toColorspace

toColourspace的替代拼写。

参数

• colorspace string ？输出色彩空间。
• 无效参数将引发错误

返回sharp实例对象