WEBAPI

settings_applicationsWindowOrWorkerGlobalScope

WEBAPI

Editing
  • account_tree
  • bug_report

PromiseimageBitmapcreateImageBitmap(Variousimage[, Dictionaryoptions] | Variousimage, Numbersx, Numbersy, NumbersWidth, NumbersHeight[, Dictionaryoptions])

주어진 이미지 리소스에서 비트맵을 생성하여 선택적으로 비트맵의 일부만 사용할 수 있게 한다.

설명

다양한 이미지 형식을 리소스로 사용할 수 있다.

구문

createImageBitmap(image, sx, sy, sWidth, sHeight);

매개 변수

Use of parameters type 1
Variousimage필수

생성할 이미지 객체를 지정한다. <img>, SVG <image>, <video>, <canvas>, HTMLImageElement, SVGImageElement, HTMLVideoElement, HTMLCanvasElement, Blob, ImageData, ImageBitmap, OffscreenCanvas 타입을 지정할 수 있다.

Dictionaryoptions선택

이미지 추출 옵션을 다음과 같이 지정할 수 있다.

  • imageOrientation : 이미지를 그대로 표시할지 세로로 뒤집을지를 설정한다. none이 기본값이다.
  • premultiplyAlpha : 비트맵의 색상 채널에 알파 채널을 미리 곱해야 할지에 대한 여부를 지정한다.
  • colorSpaceConversion :  색상 공간 변환을 사용하여 이미지를 디코딩해야 하는지의 여부를 지정한다.
  • resizeWidth :  표시할 너비를 지정한다.
  • resizeHeight : 표시할 높이를 지정한다.
  • resizeQuality : 출력 크기와 일치하도록 입력 크기를 조정하는데 사용할 알고리즘을 지정한다.
Use of parameters type 2
Variousimage필수
Numbersx필수

ImageBitmap이 추출될 사각형 참조점의 x 좌표를 지정한다.

Numbersy필수

ImageBitmap이 추출될 사각형 참조점의 y 좌표를 지정한다.

NumbersWidth필수

ImageBitmap이 추출될 사각형 너비를 지정한다. 음수값을 가질 수 있다.

NumbersHeight필수

ImageBitmap이 추출될 사각형 높이를 지정한다. 음수값을 가질 수 있다.

Dictionaryoptions선택

반환

PromiseimageBitmap

비동기 처리를 위한 Promise 객체를 반환한다. 따라서 than() 메소드로 생성된 ImageBitmap 객체를 처리해야 한다.

예제

지원 웹브라우저