使用PNG或JPG文件创建托盘，dock和应用程序图标。
进程: 主进程, 渲染进程
在 Electron 中, 对所有创建 images 的 api 来说, 你可以传递文件路径或 NativeImage 实例. 如果传递 null ,将创建一个空的image 对象.
例如, 当创建托盘图标或设置窗口图标时,你可以传递 String格式的文件路径 :
const {BrowserWindow, Tray} = require('electron')
const appIcon = new Tray('/Users/somebody/images/icon.png')
let win = new BrowserWindow({icon: '/Users/somebody/images/window.png'})
console.log(appIcon, win)
或者从返回 NativeImage的剪贴板中读图 :
const {clipboard, Tray} = require('electron')
const image = clipboard.readImage()
const appIcon = new Tray(image)
console.log(appIcon)
当前支持 PNG 和 JPEG 图片格式. 推荐 PNG ,因为它支持透明和无损压缩.
在 Windows, 你也可以使用 ICO 图标的格式.
在这里查看微软关于尺寸的详细说明
在具有高DPI支持的平台(如Apple Retina显示器)上，您可以在图像的基本文件名后面加上 @2x，以将其标记为高分辨率图像。
如果 icon.png是具有标准分辨率的正常图像， icon@2x.png则表示具有双DPI密度的高分辨率图像。
如果要同时支持具有不同DPI密度的显示，则可以将不同大小的图像放在同一文件夹中，并使用不带DPI后缀的文件名。例如：
还支持以下后缀DPI：
模板图像由黑色和透明色(或alpha 通道)组成.
模板图像并不用作独立图片,它通常与其他内容混合以创建期望的最终效果。
最常见的情况是当做菜单栏图标,因此它可以适应亮和暗色菜单栏。
注意: 仅在macOS上支持模板图像。
如果希望标记为模板图像,其文件名应以单词 Template结尾。例如:
nativeImage模块有以下方法，所有方法都返回 NativeImage类的一个实例：
nativeImage.createEmpty()
用途:创建一个空的 NativeImage 实例
nativeImage.createFromPath(path)
用途:从位于 path的文件创建一个新的 NativeImage实例
path String - path不存在,无法读取或不是有效图像,此方法将返回空图像。
示例:
nativeImage.createFromBuffer(buffer[, options])
用途:从 buffer中创建一个 NativeImage 实例
options Object (可选)
width Integer (可选) - 对于位图bitmap,缓冲区(buffers)是必需的。
height Integer (可选) - 对于位图bitmap,缓冲区(buffers)是必需的。
scaleFactor Double (可选) - 默认1.0.
nativeImage.createFromDataURL(dataURL)
用途:从 dataURL创建一个 NativeImage 实例( NativeImage)
image.toPNG([options])
用途:返回包含图片 PNG 编码数据( Buffer [Buffer][buffer])
scaleFactor Double (可选) - 默认 1.0.
image.toJPEG(quality)
用途:返回包含图片 JPEG 编码数据( Buffer [Buffer][buffer])
quality Integer (必须) - 质量可选 0 - 100.
image.toBitmap([options])
用途:返回包含图片 Bitmap 编码数据副本( Buffer [Buffer][buffer])
scaleFactor Double (可选) - 默认 1.0.
image.toDataURL([options])
用途:返回图片数据的 URL( String)
scaleFactor Double (可选) - 默认 1.0.
image.getBitmap([options])
用途:返回包含图片 Bitmap 编码数据( Buffer [Buffer][buffer])
scaleFactor Double (可选) - 默认 1.0.
getBitmap()和 toBitmap()之间的区别是, getBitmap() 不会复制位图数据,所以你必须在当前事件中立即使用返回的Buffer,否则数据可能会被改变,销毁。
image.getNativeHandle() macOS
用途:返回带有指向了图像底层本地句柄的C指针的 [Buffer][buffer]
在macOS上，返回的是指向 NSImage实例的指针。
注意，返回的指针是一个指向底层本地映像而不是副本的弱指针，所以你必须确保关联的nativeImage实例被保留。
image.isEmpty()
用途:判断图片是否为空( Boolean)
image.getSize()
用途:获得尺寸信息( Object)
image.setTemplateImage(option)
用途:将图片标识为模板图像
image.isTemplateImage()
用途:判断图片是否为模板图像( Boolean)
image.crop(rect)
用途:按区域裁剪并返回指定尺寸的图片( NativeImage)
image.resize(options)
用途:重新调整图片尺寸( NativeImage)
options Object
width Integer (可选)- 默认为图像宽度
height Integer (可选)- 默认为图像高度
quality String (可选) - 调整图像大小的所需质量,可能的值是 good, better 或者 best。默认值是 best
如果只指定 height或 width,那么图片将保持原始宽高比。
image.getAspectRatio()
用途:获取图像的宽高比例( Float)
image.addRepresentation(options)
用途:自定义图片缩放比例
options Object
scaleFactor Double - 默认1.0
width Integer(可选) - 默认为0.如果位图缓冲区指定为 buffer,则为必需。
height Integer(可选) - 默认为0.如果位图缓冲区指定为 buffer,则为必需。
buffer Buffer(可选) - 包含原始图像数据的缓冲区。
dataURL String(可选) - 数据URL，包含基本64编码的PNG或JPEG图像。
[buffer]: https://nodejs.org/api/buffer.html#buffer_class_buffer