教程菜单 本页目录

tint

tint(tint) ⇒ Sharp

使用提供的颜色为图像着色。可能存在 alpha 通道,但操作不会改变该通道。

Throws:

  • 错误 参数无效
参数类型描述
tintstring | Object由颜色模块解析。

示例

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

greyscale

greyscale([greyscale]) ⇒ Sharp

转换为 8 位灰度;256 种灰度。这是一个线性操作。如果输入图像处于非线性颜色空间(如 sRGB),请将 gamma() 与 greyscale() 结合使用以获得最佳效果。默认情况下,输出图像将是适合 Web 的 sRGB 并包含三个(相同)颜色通道。这可能会被其他锐化操作(如 toColourspace('b-w'))覆盖,这将生成包含一个颜色通道的输出图像。可能存在 alpha 通道,并且不会因操作而发生变化。

参数类型默认
[greyscale]Booleantrue

示例

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

grayscale

grayscale([grayscale]) ⇒ Sharp

灰度的替代拼写。

参数类型默认
[grayscale]Booleantrue

pipelineColourspace

pipelineColourspace([colourspace]) ⇒ Sharp

设置管道色彩空间。

输入图像将在管道开始时转换为提供的色彩空间。所有操作都将在转换为输出色彩空间之前使用此色彩空间,如 toColourspace 所定义。

Throws:

  • 错误 参数无效

: 0.29.0

参数类型描述
[colourspace]string管道色彩空间,例如  rgb16, scrgb, lab, grey16 ...

示例

// Run pipeline in 16 bits per channel RGB while converting final result to 8 bits per channel sRGB.
await sharp(input)
 .pipelineColourspace('rgb16')
 .toColourspace('srgb')
 .toFile('16bpc-pipeline-to-8bpc-output.png')

pipelineColorspace

pipelineColorspace([colorspace]) ⇒ Sharp

管道色彩空间的替代拼写。

Throws:

  • 错误 参数无效
参数类型描述
[colorspace]string管道色彩空间。

toColourspace

toColourspace([colourspace]) ⇒ Sharp

设置输出色彩空间。默认情况下,输出图像将是适合网络的 sRGB,其他通道将解释为 alpha 通道。

Throws:

  • 错误 参数无效
参数类型描述
[colourspace]string输出色彩空间,例如 srgb, rgb, cmyk, lab, b-w ...

示例

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

toColorspace

toColorspace([colorspace]) ⇒ Sharp

toColourspace 的替代拼写。

Throws:

  • 错误 参数无效
参数类型描述
[colorspace]string输出色彩空间。
本页目录