GeOnDT for JS API

Class: U3dPipe

U3dPipe

~extends U3dGeometry
여러 좌표를 부드러운 곡선으로 잇는 관(파이프) 형태의 3D 도형 클래스입니다.
경로 좌표를 Catmull-Rom 곡선으로 보간해 원형 단면의 튜브를 만들며, 반지름·곡률·세분화 정도 등을 옵션으로 조절할 수 있습니다.

여러 좌표를 부드러운 곡선으로 잇는 파이프 도형을 생성합니다.
좌표는 생성 후 setVertex(월드) 또는 setPositions(위경도)로 지정하면, Catmull-Rom 곡선으로 보간된 튜브가 만들어집니다.

Name	Type	Default	Description
`opt`	U3dPipeCO	{}	optional 생성 옵션 (색상·반지름·곡률·세분화 등)
`isInit`	boolean	true	optional true면 생성 시 즉시 초기화(재질·지오메트리 생성). 상속 클래스에서 초기화를 미룰 때만 false 사용

파이프에서 발생하는 이벤트 이름 모음 (도형 공통 이벤트와 동일하며 추가 이벤트는 없습니다)

closedboolean

경로의 시작점과 끝점을 이어 닫을지 여부 (기본값 false).
true면 고리 형태의 닫힌 파이프가 됩니다. 변경은 setParam으로 합니다.

pathSegmentsnumber

경로 방향 분할 수 (기본값 64).
좌표를 이은 곡선을 이 수만큼 나누어 튜브를 만들므로, 값이 클수록 곡선이 매끄러워지고 정점 수가 늘어납니다. 생성 옵션 이름은 pathsegments이며, 변경은 setParam으로 합니다.

radiusSegmentsnumber

단면(원둘레) 분할 수 (기본값 16).
값이 클수록 단면이 원에 가까워지고 정점 수가 늘어납니다. 생성 옵션 이름은 radiussegments(별칭 radiusSegments)이며, 변경은 setParam으로 합니다.

tensionnumber

곡선 장력 (0~1, 기본값 0.5).
값이 클수록 좌표를 팽팽하게 지나고, 작을수록 완만하게 휩니다. 변경은 setParam으로 합니다.

tubeRadiusnumber

파이프 반지름 (미터, 기본값 2).
지오메트리에는 위도에 따른 좌표 보정이 곱해져 적용됩니다. 생성 옵션 이름은 piperadius이며, 변경은 setParam으로 합니다.

파이프의 현재 속성을 반환합니다. (setParam에 다시 넘길 수 있습니다)

Type	Description
U3dPipeParam \| U3dFlowPipeParam	반지름·세분화·닫힘·장력 등 현재 속성 객체. 흐름 파이프(`U3dFlowPipe`)는 자체 속성 객체를 반환합니다

setParam(param)

파이프의 속성(색상·투명도·반지름·세분화·닫힘·장력)을 한 번에 변경합니다.
전달한 값만 반영되고 나머지는 기존 값이 유지되며, 형태 관련 값을 바꾸면 튜브가 즉시 다시 만들어집니다.

Name	Type	Description
`param`	U3dPipeCO	optional 변경할 속성 객체. 생략한 속성은 현재 값을 유지합니다

U3dPipeCOobject

~extends U3dGeometry~U3dGeometryCO
U3dPipe(파이프 도형) 생성자 옵션

Name	Type	Argument	Default	Description
`color`	ColorRepresentation	<optional>	0xff0000	파이프 색상
`pathsegments`	number	<optional>	64	경로 방향 세분화 정도 (클수록 곡선이 매끄러움)
`piperadius`	number	<optional>	2	파이프 반지름
`radiussegments`	number	<optional>	16	원둘레 세분화 정도 (클수록 단면이 원에 가까움)
`radiusSegments`	number	<optional>	16	원둘레 세분화 정도 (radiussegments의 camelCase 별칭, 둘 중 하나만 지정)
`closed`	boolean	<optional>	false	튜브 양끝을 이어 닫을지 여부
`tension`	number	<optional>	0.5	곡선 장력 (0~1, 클수록 좌표를 팽팽하게 지남)
`name`	string	<optional>		도형 이름
`opacity`	number	<optional>		투명도 (0~1, 1이면 불투명)
`type`	string	<optional>		도형 타입 식별자
`wireframe`	boolean	<optional>		와이어프레임(뼈대)으로 표시할지 여부
`showLabel`	boolean	<optional>		라벨 표시 여부
`vertices`	Array.<Vector3>	<optional>		파이프 경로를 이루는 정점 배열
`coordinates`	Array.<Vector3>	<optional>		원본 좌표 배열
`properties`	KeyValue	<optional>		사용자 정의 속성 (key-value)

~extends U3dGeometry~U3dGeometryEMI
U3dPipe 이벤트 인터페이스 (U3dGeometry와 동일, 추가 이벤트 없음)

U3dPipeParamobject

getParam 함수가 반환하는 파이프(Pipe) 속성 객체