Electron 문서1.4.1

Docs / API / nativeImage

nativeImage

PNG 또는 JPG 파일을 사용하여 트레이, 독, 애플리케이션 아이콘을 생성합니다.

Electron은 파일 경로 또는 NativeImage 인스턴스를 통해 이미지를 사용할 수 있는 API를 가지고 있습니다. null을 전달할 경우 빈 이미지가 생성됩니다.

예를 들어 트레이 메뉴를 만들거나 윈도우의 아이콘을 설정할 때 다음과 같이 파일 경로를 전달하여 이미지를 사용할 수 있습니다:

const appIcon = new Tray('/Users/somebody/images/icon.png')
let win = new BrowserWindow({icon: '/Users/somebody/images/window.png'})

이 예시는 클립보드로부터 가져온 nativeImage로 트레이 메뉴를 생성합니다:

const image = clipboard.readImage()
const appIcon = new Tray(image)

지원하는 포맷

현재 PNGJPEG 이미지 포맷을 지원하고 있습니다. 손실 없는 이미지 압축과 투명도 지원을 위해 PNG 사용을 권장합니다.

Windows에서는 파일 경로로부터 ICO 포맷도 사용할 수 있으며, 가장 좋은 시각적 효과를 얻기 위해 최소한 다음 사이즈를 포함하는 것을 권장합니다:

이 글Size requirements 섹션을 확인하세요.

고해상도 이미지

플랫폼이 Apple Retina 디스플레이와 같이 high-DPI를 지원하는 경우 @2x와 같이 이미지의 파일명 뒤에 접미사를 추가하는 것으로 고해상도 이미지를 지정할 수 있습니다.

예를 들어 icon.png 라는 기본 해상도의 이미지를 기준으로 크기를 두 배로 늘린 이미지를 icon@2x.png 처럼 지정하면 고해상도 이미지로 처리됩니다.

서로 다른 해상도(DPI)의 이미지를 같이 지원하고 싶다면 다중 해상도의 이미지를 접미사를 붙여 한 폴더에 같이 넣으면 됩니다. 이 이미지를 사용(로드)할 땐 따로 접미사를 붙이지 않습니다:

images/
├── icon.png
├── icon@2x.png
└── icon@3x.png
let appIcon = new Tray('/Users/somebody/images/icon.png')

지원하는 DPI 접미사는 다음과 같습니다:

템플릿 이미지

템플릿 이미지는 검은색과 명확한 색상(알파 채널)으로 이루어져 있습니다. 템플릿 이미지는 단독 이미지로 사용되지 않고 다른 콘텐츠와 혼합되어 최종 외관 만드는데 사용됩니다.

가장 일반적으로 템플릿 이미지는 밝고 어두운 테마 색상으로 변경할 수 있는 메뉴 바 아이콘 등에 사용되고 있습니다.

참고: 템플릿 이미지는 macOS 운영체제만 지원합니다.

템플릿 이미지를 지정하려면 다음 예시와 같이 파일명에 Template 문자열을 추가해야 합니다:

Methods

nativeImage 모듈은 다음과 같은 메서드를 가지고 있으며, 모든 메서드는 NativeImage 클래스의 인스턴스를 반환합니다.

nativeImage.createEmpty()

Returns NativeImage

NativeImage 인스턴스를 만듭니다.

nativeImage.createFromPath(path)

Returns NativeImage

path로부터 이미지를 로드하여 새로운 NativeImage 인스턴스를 만듭니다. path 가 존재하지 않거나, 읽을 수 없거나, 유효한 이미지가 아니면 빈 이미지를 반환합니다.

const nativeImage = require('electron').nativeImage
let image = nativeImage.createFromPath('/Users/somebody/images/icon.png')

nativeImage.createFromBuffer(buffer[, scaleFactor])

Returns NativeImage

buffer로부터 이미지를 로드하여 새로운 NativeImage 인스턴스를 만듭니다. scaleFactor의 기본값은 1.0 입니다.

nativeImage.createFromDataURL(dataURL)

dataURL로부터 이미지를 로드하여 새로운 NativeImage 인스턴스를 만듭니다.

Class: NativeImage

네이티브로 랩핑된 트레이, dock, 애플리케이션 아이콘을 위한 이미지입니다.

Instance Methods

NativeImage 클래스 인스턴스 객체에서 사용할 수 있는 메서드입니다.

image.toPNG()

Return Buffer - PNG 로 인코딩된 데이터가 있는 Buffer.

image.toJPEG(quality)

Return Buffer - JPEG 로 인코딩된 데이터가 있는 Buffer.

image.toBitmap()

Return Buffer - 이미지의 raw 비트맵 픽셀 데이터가 있는 Buffer의 복사본.

image.toDataURL()

Returns String - 이미지의 data URL.

image.getBitmap()

Returns Buffer - 이미지의 raw 비트맵 픽셀 데이터가 있는 Buffer.

getBitmap()toBitmap()의 차이는 getBitmap()은 비트맵 데이터를 복사하지 않습니다. 그래서 버퍼를 현재 이벤트 루프 틱에 바로 반환해야 할 경우 유용하게 사용할 수 있습니다. 그렇지 않은 경우 데이터가 변경되거나 소멸될 수 있습니다.

image.getNativeHandle() macOS

Returns Buffer - 이미지의 네이티브 핸들의 C 포인터를 담은 Buffer. macOS에선, NSImage 인스턴스의 포인터가 반환됩니다.

참고로 반환된 포인터는 복사본이 아닌 네이티브 이미지의 밑에 있는 약한 포인터이며, 따라서 반드시 관련된 nativeImage 인스턴스가 확실하게 유지되고 있는지를 인지해야 합니다.

image.isEmpty()

Returns Boolean - 이미지가 비었는지 여부.

image.getSize()

Returns Object:

image.setTemplateImage(option)

해당 이미지를 템플릿 이미지로 설정합니다.

image.isTemplateImage()

Returns Boolean - 이미지가 템플릿 이미지인지 여부.

image.crop(rect)

Returns NativeImage - 잘라낸 이미지.

image.resize(options)

Returns NativeImage - 크기 변경된 이미지.

height 또는 width 하나만 명시한다면 크기가 변경된 이미지에서도 종횡비가 유지될 것 입니다.

image.getAspectRatio()

Returns Float - 이미지의 종횡비.


고쳐야 할 것이 있습니까? 소스에서 변경을 제안할 수 있습니다.
다른 버전의 문서가 필요한가요? 이전 버전 또는 커뮤니티 번역을 보세요.
모든 문서를 한번에 검색하고 싶으신가요? 한 페이지 문서를 보세요.