Electron官方文档(v1.6.1)中文翻译

3. nativeImage

2017-03-21  本文已影响304人  Shmily落墨

原文：https://github.com/electron/electron/blob/master/docs/api/native-image.md
译者：Lin

使用PNG或JPG文件创建托盘图标，dock图标和应用图标。

进程：进程：主进程，渲染进程

Electron中，对于需要图像的接口，你可以传入文件的路径或者NativeImage实例。当传入null时将使用一个空的图像。

例如，当创建一个托盘活着设置一个窗口的图标，你可以传入一个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图标。为了最好的可视化效果，建议至少包含以下尺寸：

点击this article中的Size requirements部分。

高分辨率图像

有支持高DPI的平台上，例如苹果Retina显示屏，你可以在图像的基本文件名的后面添加@2x来标记这个事一个高分辨率的图像。

例如，如果icon.png是一个标准分辨率的正常图像，那么icon@2x.png将被处理为一个有两倍DPI密度的高分辨率图像。

如果你想同时支持不同DPI密度显示屏，你可以将不同尺寸的图像放在同一个文件夹下，并且使用不包含DPI后缀的文件名。例如：

images/
├── icon.png
├── icon@2x.png
└── icon@3x.png

const {Tray} = require('electron')
let appIcon = new Tray('/Users/somebody/images/icon.png')
console.log(appIcon)

支持以下DPI的后缀名：

模版图像

模版图像包括黑色和无颜色（和一个透明通道）。模版图像是不打算被作为单独的图像而使用的，并且通常和其他内容混合创建一个理想的最终形态。

最常见的情况是在菜单栏图标上使用模版图像，所以它可以适应浅色和暗色的菜单栏。

注意：只有MacOS支持模版图像。

为了使用一个模版图像，它的文件名字必须以Template单词结尾。例如：

方法

nativeImage模块又以下方法，所有的方法斗返回一个NativeImage类的实例：

nativeImage.createEmpty()

返回值为NativeImage类型

创建一个空的NativeImage实例。

nativeImage.createFromPath(path)

返回值为NativeImage类型

使用本地文件地址创建一个新的NativeImage实例。如果path不存在，或者不能被读取，或者不是一个图像，那么这个方法返回一个空的图像。

const nativeImage = require('electron').nativeImage

let image = nativeImage.createFromPath('/Users/somebody/images/icon.png')
console.log(image)

nativeImage.createFromBuffer(buffer[, options])

返回值为NativeImage类型

通过buffer创建一个新的NativeImage实例。

nativeImage.createFromDataURL(dataURL)

通过dataURL创建一个新的NativeImage实例。

类: NativeImage

使用PNG或JPG文件创建托盘图标，dock图标和应用图标。

进程：主进程，渲染进程

实例的方法

NativeImage类的实例有以下方法：

image.toPNG([options])

返回值为Buffer类型 - 一个包含图像的PNG编码数据的Buffer。

image.toJPEG(quality)

返回值为Buffer类型 - 一个包含图像的JPEG编码数据的Buffer。

image.toBitmap([options])

返回值为Buffer类型 - 一个包含图像的原始位图的数据副本的Buffer。

image.toDataURL([options])

返回值为String类型 - 图片的数据地址。

image.getBitmap([options])

返回值为Buffer类型 - 一个包含图像的原始位图的数据的Buffer。

getBitmap()和toBitmap()的区别是，getBitmap()不会复制位图数据，所以你必须在当前事件循环标记中直接使用返回的Buffer，否则数据将会被改变或者被销毁。

image.getNativeHandle() MacOS

返回值为Buffer类型 - 一个存储底层处理本地图像的C指针的Buffer。MacOS中，将返回一个指向NSImage实例的指针。

请注意，返回的指针是一个指向底层的本地土图像来代替一个副本的弱指针，所以你必须确保对应的nativeImage实例一直存在。

image.isEmpty()

返回值为Boolean类型 - 图像是否是空。

image.getSize()

返回值为Object类型：

image.setTemplateImage(option)

将图像转为一个模版图像。

image.isTemplateImage()

返回值为Boolean类型 - 图像是否是一个模版图像。

image.crop(rect)

返回值为NativeImage类型 - 被修剪的图像。

image.resize(options)

返回值为NativeImage - 重设大小的图像。

如果只指定了height或者width，那么将使用当前的纵横比来重设图像。

image.getAspectRatio()

返回值为Float类型 - 图像的纵横比。

image.addRepresentation(options)

添加一个指定的缩放因数的图像表现。这个可以被用来明确的添加不同缩放因素表现到一个图像上。这个方法可以在空图像上调用。

上一篇下一篇

猜你喜欢

热点阅读