Class: U3dCircle

Members

radiusnumber

원의 반지름입니다. (미터)
위경도 좌표를 지정한 원은 화면에 그릴 때 그 위도의 보정 배율(1 / cos(위도))이 곱해집니다.

segmentsnumber

원둘레를 나누는 삼각형 조각의 수입니다.
클수록 테두리가 매끄러운 원에 가까워지고 정점 수가 늘어납니다. 3이면 삼각형, 4면 사각형처럼 각진 다각형이 되며, 3보다 작은 값은 three.js가 3으로 올려 잡습니다.

Methods

getParam()U3dCircleParam

원(Circle)의 현재 속성을 반환합니다. (setParam과 짝을 이룹니다)
원 고유 속성과 함께 색상·투명도 같은 도형 공통 속성도 담기므로, 반환값을 다른 원의 setParam에 그대로 넘기면 같은 형태로 맞출 수 있습니다. 호출할 때마다 새 객체를 만들어 돌려주므로 반환된 객체에 값을 다시 넣어도 원은 바뀌지 않습니다. 다만 color처럼 객체로 된 값은 원이 실제로 쓰고 있는 것을 그대로 담으므로, 그 안을 직접 고치면 원의 색도 함께 바뀝니다.

Returns:

Type	Description
U3dCircleParam	반지름·조각 수 등 현재 속성 객체

getUid()number|string

이 원(Circle)을 가리키는 고유 식별자(UID)를 반환합니다.
userData.id에 식별자를 넣어 두었으면 그 값을, 없으면 three.js가 객체마다 자동으로 매기는 정수 id를 돌려줍니다. 클릭한 도형을 목록에서 찾거나 여러 도형을 구별할 때 사용합니다.

Returns:

Type	Description
number | string	userData.id에 넣어 둔 식별자 또는 three.js가 매긴 객체 id

setParam(param)

원(Circle)의 속성(색상·투명도·반지름·조각 수 등)을 한 번에 변경합니다.
전달한 값만 반영되고 나머지는 기존 값이 유지되며, 호출할 때마다 지오메트리가 다시 만들어집니다.

생성 옵션 중 렌더링 스타일(style), 좌표(vertices·coordinates), 이름(name), showLabel과 properties는 이 함수로 바뀌지 않습니다. 좌표는 setVertex나 setPositions로 바꾸고, 렌더링 스타일을 바꾸려면 원을 새로 만듭니다.

Name	Type	Description
param	U3dCircleCO	optional 변경할 속성 객체 (색상·투명도·와이어프레임·반지름·조각 수)

Type Definitions

U3dCircleCOobject

~extends U3dGeometry~U3dGeometryCO
U3dCircle 생성자 옵션

Properties:

Name	Type	Argument	Default	Description
name	string	<optional>		도형 이름. 레이어에서 도형을 찾을 때 쓰는 식별자이며, 넣지 않으면 무작위 UUID 문자열이 자동으로 만들어집니다
color	ColorRepresentation	<optional>	'#ff0000'	원판 표면 색상. 16진수 숫자(0xff0000), CSS 색 문자열('#ff0000') 또는 THREE.Color를 넣습니다. 검정은 0x000000이 아니라 '#000000' 문자열로 넣습니다
opacity	number	<optional>	0.7	불투명도 (0~1). 0이면 완전히 투명하고 1이면 불투명하며, 1보다 작으면 투명 처리가 켜집니다. 넣지 않으면 0.7이라 기본 원은 반투명하게 그려집니다
radius	number	<optional>	5	원의 반지름 (미터). 위경도 좌표를 지정한 원은 화면에 그릴 때 그 위도의 보정 배율(1 / cos(위도))이 곱해집니다
segments	number	<optional>	32	원둘레를 나누는 삼각형 조각의 수. 클수록 테두리가 매끄러운 원에 가까워지고 정점 수가 늘어납니다. 3이면 삼각형, 4면 사각형처럼 각진 다각형이 되며, 3보다 작은 값은 three.js가 3으로 올려 잡습니다
style	U3dCircle.types~U3dCircleStyle	<optional>		원이 지형이나 다른 도형에 가려질 때의 그리기 방식을 정하는 렌더링 스타일. 생성 시에만 적용되며 setParam으로는 바꿀 수 없습니다
wireframe	boolean	<optional>	false	면을 채우지 않고 삼각형 모서리만 선으로 그릴지 여부. 형태와 분할 상태를 확인할 때 사용합니다
showLabel	boolean	<optional>	true	도형에 붙은 라벨(화면에 함께 띄우는 글자)을 표시할지 여부
vertices	Array.<WorldPositionVector3>	<optional>		원을 놓을 월드 좌표 배열 (EPSG:3857). 첫 번째 좌표에 원의 중심이 놓이고 나머지 좌표는 사용하지 않습니다
coordinates	Array.<GeoPositionVector3>	<optional>		원을 놓을 위경도 좌표 배열 (EPSG:4326). 첫 번째 좌표에 원의 중심이 놓이며, 그 위도로 크기 보정 배율을 계산합니다
properties	KeyValue	<optional>		도형과 함께 보관할 사용자 정의 속성. 화면 표현에는 쓰이지 않으며 클릭한 도형의 부가 정보를 담을 때 사용합니다

U3dCircleParamobject

getParam 함수가 반환하는 원(Circle) 속성 객체입니다.
이 객체를 다른 원의 setParam에 그대로 넘기면 같은 형태로 맞출 수 있습니다.

Properties:

Name	Type	Description
radius	number	원의 반지름 (미터)
segments	number	원둘레를 나누는 삼각형 조각의 수

U3dCircleStyleobject

U3dCircle 생성 옵션의 style에 넣는 렌더링 스타일 옵션입니다.
원이 지형이나 다른 도형에 가려지거나 겹쳐서 깜빡일 때, 가림 판정과 그리는 순서를 조절합니다. 생성 시에만 적용되며 setParam으로는 바꿀 수 없습니다.

Properties:

Name	Type	Argument	Default	Description
depthTest	boolean	<optional>	true	앞을 가로막은 물체가 있는지 검사할지 여부. false로 두면 가려져도 원이 항상 그려져 지형 위에 겹쳐 보입니다
depthWrite	boolean	<optional>	true	이 원이 차지한 깊이를 기록해 뒤쪽 물체를 가릴지 여부. 반투명한 원을 여러 장 겹칠 때 false로 두면 뒤 물체가 비쳐 보입니다
renderOrder	number	<optional>		그리는 순서. 값이 클수록 나중에 그려져 같은 자리에 겹친 도형 위로 올라옵니다. 넣지 않으면 three.js 기본값인 0을 씁니다