GeOnDT for JS API

Class: U2dPoint

U2dPoint

~extends U2dGeometry
2D 지도 위의 한 지점을 원형 마커로 표시하는 클래스입니다.
반지름과 채우기·테두리 색을 지정해 지도상의 특정 지점을 나타냅니다.

원의 크기와 선 두께는 픽셀로 다루므로 지도를 확대·축소해도 화면에서 보이는 크기는 그대로입니다. 좌표는 지도 좌표계(EPSG:3857)로 보관하며, 만들 때는 좌표가 비어 있으므로 생성한 뒤 setPosition으로 좌표를 넣어야 점이 나타납니다.

2D 점 도형을 생성합니다.
지정한 반지름과 색으로 원형 스타일을 만들고 OpenLayers Feature를 함께 준비하며, 좌표는 비어 있는 상태로 시작합니다. 만든 뒤 setPosition으로 좌표를 넣어야 화면에 점이 나타납니다.

Name	Type	Default	Description
`opt`	U2dPointCO	{}	optional 이름·반지름·채우기 색·테두리 색·테두리 두께·검색 제외·편집 잠금 등 생성 옵션

radiusnumber

점을 그리는 원의 반지름입니다. (픽셀)
생성 옵션의 radius로 정해지며, setRadius로 화면의 원을 키우거나 줄여도 이 값은 그대로 남습니다. 색상·두께·스타일을 바꾸는 함수들이 원을 다시 그릴 때 이 값을 기준으로 삼습니다.

setFillColor(color)

원 내부를 채우는 색상을 바꿉니다.
편집이 잠겨 있으면(nonChanged) 색을 바꾸지 않고 넘어갑니다.

Name	Type	Description
`color`	string	적용할 채우기 색상. CSS 색 문자열로 적으며 `rgba()`로 투명도를 함께 지정할 수 있습니다

setPosition(position, srs)

점을 지정한 좌표로 옮깁니다.
넘긴 좌표를 srs가 가리키는 좌표계에서 지도 좌표계(EPSG:3857)로 바꾼 뒤 반영합니다. 이미 지도 좌표로 가지고 있다면 srs에 'EPSG:3857'을 넣어 변환 없이 그대로 쓸 수 있습니다.

Name	Type	Default	Description
`position`	Array.<number>		점을 놓을 좌표 `[x, y]`. 기본 좌표계에서는 `[경도, 위도]`입니다
`srs`	string	'EPSG:4326'	optional 넘긴 좌표가 어떤 좌표계인지 나타내는 코드

setRadius(radius)

화면에 그리는 원의 반지름을 바꿉니다.
radius 프로퍼티는 그대로 두고 원만 다시 그리므로, 이후 색상·두께·스타일을 바꾸면 radius 프로퍼티 값으로 되돌아갑니다. 바꾼 크기를 계속 유지하려면 radius 프로퍼티도 함께 지정합니다.

Name	Type	Description
`radius`	number	새로 그릴 원의 반지름 (픽셀)

setStrokeColor(color)

원 테두리 선의 색상을 바꿉니다.
편집이 잠겨 있으면(nonChanged) 색을 바꾸지 않고 넘어갑니다.

Name	Type	Description
`color`	string	적용할 테두리 색상. CSS 색 문자열로 적습니다

setStrokeWidth(width)

원 테두리 선의 두께를 바꿉니다.
편집이 잠겨 있으면(nonChanged) 두께를 바꾸지 않고 넘어갑니다.

Name	Type	Description
`width`	number	적용할 테두리 두께 (픽셀)

setStyle(style)

채우기·테두리를 담은 스타일을 통째로 바꾸고 원을 다시 그립니다.
넘긴 스타일의 색과 두께가 fillColor·strokeColor·strokeWidth에도 함께 반영됩니다. 편집이 잠겨 있으면(nonChanged) 화면에는 적용하지 않습니다.

Name	Type	Description
`style`	OLStyle	적용할 OpenLayers 스타일 객체

OlCircleStyleobject

점을 원으로 그릴 때 쓰는 OpenLayers 원형 스타일 객체입니다.
U2dPoint가 생성자에서 하나 만들어 두고, 반지름과 색을 바꿀 때마다 이 객체를 고쳐 다시 그립니다.

Name	Type	Description
`setRadius`	function	원의 반지름을 픽셀 단위로 바꾸는 함수

U2dPointCOobject

~extends U2dGeometry~U2dGeometryCO
U2dPoint 생성자에 넘기는 옵션입니다.
점의 좌표는 여기에 넣지 않고, 만든 뒤 setPosition으로 넣습니다.

Name	Type	Argument	Default	Description
`radius`	number	<optional>	5	점을 그리는 원의 반지름 (픽셀). 지도를 확대·축소해도 화면에서 보이는 크기는 그대로입니다
`name`	string	<optional>		도형을 구분하는 이름. 레이어에서 도형을 찾을 때 쓰며, 넣지 않거나 빈 문자열이면 무작위 GUID 문자열이 자동으로 만들어집니다
`fillColor`	string	<optional>	'rgba(255,255,255,0.4)'	원 내부를 채우는 색상. CSS 색 문자열로 적으며 `rgba()`로 투명도를 함께 지정할 수 있습니다
`strokeColor`	string	<optional>	'#3399CC'	원 테두리 선의 색상. CSS 색 문자열로 적습니다
`strokeWidth`	number	<optional>	1.25	원 테두리 선의 두께 (픽셀)
`excludeSearch`	boolean	<optional>	false	지도에서 도형을 찾을 때 이 점을 검색 대상에서 뺄지 여부
`nonChanged`	boolean	<optional>	false	점을 편집하지 못하게 잠글지 여부. 켜면 스타일과 색상·두께를 바꾸는 함수가 값을 바꾸지 않고 그대로 넘어갑니다