DimScreen

1. Overview

지도 전체를 가릴 수 있는 스크린 레이어입니다. 지도 전체를 특정 색깔로 가릴 수 있고, DimScreenLayer 에 Polygon 을 추가하여 특정 부분을 강조해서 표시 할 수 있습니다.

아래는 DimScreenLayer 을 활용한 다양한 예제 그림입니다.

지도 전체 반투명하게 가릴 때	Polygon 을 추가할 때 1	Polygon 을 추가할 때 2

2. DimScreenLayer 표시하기

DimScreenLayer 는 새롭게 추가하거나 삭제할 수 없고, DimScreenManager 를 통해 아래와 같이 가져와서 이용 할 수 있습니다.

DimScreenLayer dimScreenLayer = kakaoMap.getDimScreenManager().getDimScreenLayer();
dimScreenLayer.setVisible(true);

// 원하는 색깔로 DimScreenLayer 의 색상 변경
dimScreenLayer.setColor(Color.GREEN);

3. DimScreenLayer 에 Polygon 추가하기

원하는 디자인의 폴리곤 옵션을 생성해서 DimScreenLayer 에 추가하면 됩니다. 다양한 Polygon 의 생성 방법은 Polygon 문서를 참조해 주세요.

// 1. 원하는 디자인의 폴리곤 옵션을 생성
PolygonOptions options = PolygonOptions.from(DotPoints.fromCircle(LatLng.from(37.394660,127.111182), 200))
    .setStyles(Color.TRANSPARENT);
 
// 2. dimScreenLayer 폴리곤 옵션 추가
dimScreenLayer.addPolygon(options);