logo
Tutorials Examples naver map js api v3 네이버 지도 API CanvasTile

Class: naver.maps.CanvasTile

naver.maps. CanvasTile

CanvasTile 클래스는 한 장의 HTML5 캔버스 타일을 정의합니다.

new naver.maps.CanvasTile(canvasTileOptions)

Parameters
Name Type Argument Description
canvasTileOptions CanvasTileOptions <optional>

캔버스 타일의 옵션

Extends

Methods

appendTo(parentNode)

지정한 parentNode에 타일 HTML 요소를 추가합니다.

Parameters
Name Type Description
parentNode HTMLElement

타일이 추가될 HTML 요소

Inherited From

cancelFadeIn()

진행 중인 페이드 인(타일이 서서히 나타나는) 효과를 즉시 중지하고, 본래의 불투명도를 설정합니다.

Inherited From

destroy()

캔버스 타일 객체를 완전히 삭제합니다.

Overrides

fadeIn(callback, startOpacity)

페이드 인(타일이 서서히 나타나는) 효과를 실행합니다.

Parameters
Name Type Argument Default Description
callback function

페이드 인 효과가 완료되었을 때 실행할 콜백 함수입니다.

startOpacity number <optional>
0

페이드 인 효과의 시작 불투명도입니다.

Inherited From

getDuration()

타일의 fadeIn 효과 지속시간을 반환합니다.

Inherited From
Returns
Type Description
number

타일의 fadeIn animation duration

getElement()

타일의 HTML 요소를 반환합니다.

Inherited From
Returns
Type Description
HTMLElement

타일의 HTML 요소

getOffset()

타일의 오프셋(위치)을 반환합니다.

Inherited From
Returns
Type Description
naver.maps.Point

타일의 오프셋

getOpacity()

타일의 불투명도를 반환합니다.
불투명도값의 범위는 0~1이며, 기본값은 1입니다.

Inherited From
Returns
Type Description
number

0~1 사이의 실수.

getSize()

타일의 크기를 반환합니다.

Inherited From
Returns
Type Description
naver.maps.Size

타일의 크기

getTileIndex()

타일 인덱스를 반환합니다.

Inherited From
Returns
Type Description
TileIndex

타일 인덱스

getZIndex()

타일의 쌓임 순서를 반환합니다.

Inherited From
Returns
Type Description
number

타일의 쌓임 순서

hide()

타일을 숨깁니다.

Inherited From

load(canvasTileOptions)

캔버스 타일을 불러옵니다.

Parameters
Name Type Argument Description
canvasTileOptions CanvasTileOptions <optional>

캔버스 타일의 옵션

Overrides

remove()

캔버스 타일의 HTML Canvas 요소를 지도에서 삭제합니다.

Overrides

reset(mapType, zoom, canvasTileOptions)

지정한 mapType에 맞게 타일을 재설정합니다.

Parameters
Name Type Argument Description
mapType naver.maps.CanvasMapType

재설정할 캔버스 지도 유형

zoom number

타일 재설정 시 적용할 지도의 줌 레벨

canvasTileOptions CanvasTileOptions <optional>

이미지 타일의 옵션

Overrides

setBlank()

캔버스 타일의 이미지 데이터를 모두 지우고 투명한 공백 타일로 설정합니다.

Overrides

setDuration(duration)

타일의 fadeIn 효과 지속시간을 설정합니다.
단위는 밀리초 (millisecond), 기본값은 300~600ms 입니다.

Parameters
Name Type Description
duration number

타일의 fadeIn animation duration

Inherited From

setOffset(offset)

타일이 표시될 오프셋(위치)을 지정합니다.

Parameters
Name Type Description
offset naver.maps.Point

타일의 오프셋

Inherited From
Overrides

setOpacity(opacity)

타일의 불투명도를 지정합니다.
불투명도값의 범위는 0~1이며, 기본값은 1입니다.

Parameters
Name Type Description
opacity number

불투명도 0~1 사이의 실수.

Inherited From

setSize(size)

타일의 크기를 설정합니다.

Parameters
Name Type Description
size naver.maps.Size

타일의 크기

Inherited From

setTileIndex(tileIndex)

타일 인덱스를 설정합니다.

Parameters
Name Type Description
tileIndex TileIndex

타일 인덱스

Inherited From

setZIndex(zIndex)

타일의 쌓임 순서를 설정합니다.

Parameters
Name Type Description
zIndex number

타일의 쌓임 순서

Inherited From

show()

타일을 보이게 합니다.

Inherited From

Type Definitions


CanvasTileOptions

CanvasTileOptions 객체는 naver.maps.CanvasTile을 정의하는 데 필요한 옵션을 나타냅니다.

Type:
Properties
Name Type Argument Default Description
imageData ImageData <optional>

캔버스 타일에 렌더링할 이미지 데이터

opacity number <optional>
1

타일의 불투명도

transition boolean <optional>
true

타일 로드 시 fadeIn 효과의 사용 여부입니다.

duration number <optional>

타일의 fadeIn 효과 지속 시간입니다. (밀리초 단위)

offset naver.maps.Point <optional>

타일의 오프셋입니다.

zIndex number <optional>
0

타일의 쌓임 순서입니다.

size naver.maps.Size <optional>

타일의 크기입니다.

pane HTMLElement <optional>

타일이 추가될 HTML 요소입니다.

Events

imageData_changed

캔버스 타일의 이미지 데이터가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
imageData ImageData

캔버스 타일의 이미지 데이터

loaded

타일의 로드가 완료되면 이벤트가 발생합니다.

Parameters
Name Type Description
tile naver.maps.Tile

로드가 완료된 타일 객체

Inherited From

offset_changed

타일의 오프셋(위치)이 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
offset naver.maps.Point

타일의 오프셋

Inherited From

opacity_changed

타일의 불투명도가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
opacity number

타일의 불투명도

Inherited From

pane_changed

타일이 추가된 HTML 요소가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
paneElement HTMLElement

타일이 추가된 HTML 요소

Inherited From

size_changed

타일의 크기가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
size naver.maps.Size

타일의 크기

Inherited From

tileIndex_changed

타일의 인덱스가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
tileIndex TileIndex

타일의 인덱스

Inherited From

zIndex_changed

타일의 쌓임 순서가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
zIndex number

타일의 쌓임 순서

Inherited From