electron/docs-translations/ko-KR/api/native-image.md

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);

지원하는 포맷

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

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

• 16x16
• 32x32
• 64x64
• 256x256

고해상도 이미지

플랫폼이 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 접미사는 다음과 같습니다:

• @1x
• @1.25x
• @1.33x
• @1.4x
• @1.5x
• @1.8x
• @2x
• @2.5x
• @3x
• @4x
• @5x

템플릿 이미지

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

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

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

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

• xxxTemplate.png
• xxxTemplate@2x.png

Methods

nativeImage 클래스는 다음과 같은 메서드를 가지고 있습니다:

nativeImage.createEmpty()

빈 nativeImage 인스턴스를 만듭니다.

nativeImage.createFromPath(path)

• path String

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

nativeImage.createFromBuffer(buffer[, scaleFactor])

• buffer Buffer
• scaleFactor Double (optional)

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

nativeImage.createFromDataURL(dataURL)

• dataURL String

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

Instance Methods

nativeImage 인스턴스 객체에서 사용할 수 있는 메서드 입니다:

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

image.toPng()

PNG 이미지를 인코딩한 데이터를 Buffer로 반환합니다.

image.toJpeg(quality)

• quality Integer (required) 0 - 100 사이의 값

JPEG 이미지를 인코딩한 데이터를 Buffer로 반환합니다.

image.toDataURL()

이미지를 data URL로 반환합니다.

image.getNativeHandle() OS X

이미지의 네이티브 핸들 밑에 있는 C 포인터를 담은 Buffer을 반환합니다. OS X에선, NSImage 인스턴스가 반환됩니다.

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

image.isEmpty()

이미지가 비었는지 확인합니다.

image.getSize()

이미지의 사이즈를 반환합니다.

image.setTemplateImage(option)

• option Boolean

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

image.isTemplateImage()

이미지가 템플릿 이미지인지 확인합니다.