Class: U3dFlowPipe

Members

BASIC_TYPEstring

흐름 타입을 지정하지 않았거나 지원하지 않는 값을 넣었을 때 대신 쓰는 기본 타입(COLOR_BAND)입니다.

EVENTU3dFlowPipeEMI

이 도형이 발생시키는 이벤트의 이름 모음입니다.
addEventListener(U3dFlowPipe.EVENT.FLOW_END, handler)처럼 리스너를 등록할 때 사용합니다. 각 이벤트가 언제 발생하고 data에 무엇이 담기는지는 U3dFlowPipeEMI에 있습니다.

FlowTypeObject

사용할 수 있는 흐름 타입 이름 모음입니다.
생성 옵션의 flowType이나 changeFlowType에 문자열을 직접 적는 대신 U3dFlowPipe.FlowType.ARROW처럼 사용합니다. COLOR_BAND는 색 띠가 경로를 지나가고, COLOR_FILL은 한쪽 끝부터 색이 차오르며, ARROW는 화살표가 흘러갑니다.

animation

그리기 루프가 매 프레임 호출하는 애니메이션 함수를 돌려줍니다.
경과 시간(초)을 인자로 받아 셰이더 유니폼을 갱신하는 함수이며, initAnimation이 이 함수를 컨트롤러에 넘겨 씁니다. 직접 호출할 일은 거의 없고, 애니메이션 연결 상태를 확인할 때 사용합니다.

flowType

지금 적용되어 있는 흐름 표현 방식을 알려줍니다.
changeFlowType으로 바꾼 결과가 반영되며, 값에 따른 모습은 U3dFlowPipe.FlowType에 있습니다.

isFlowPipe

이 객체가 흐름 파이프인지 알려줍니다.
여러 종류의 도형이 섞인 목록에서 흐름 파이프만 골라낼 때 사용합니다. 생성 시 항상 true로 정해집니다.

sectionHighlight

setSectionHighlightByLength로 구간 강조를 켠 적이 있는지 알려줍니다.
길이 기준 강조에서만 켜지므로, setSectionHighlightNormalized로 강조를 켠 경우에는 강조가 보이고 있어도 false입니다.

totalLength

좌표를 따라 만들어진 파이프의 전체 길이를 알려줍니다. (미터)
좌표가 반영되어 파이프 형상이 만들어질 때 갱신되므로, 좌표를 넣기 전에는 0입니다. setSectionHighlightByLength에 넣을 구간 값을 정할 때 기준으로 사용합니다.

Methods

addPosition(x, y, z)

파이프가 지나갈 경로 끝에 위경도 좌표를 하나 덧붙입니다.
마우스로 경로를 그려 나갈 때처럼 좌표를 하나씩 쌓을 때 사용하며, 좌표가 두 개 이상 모여야 파이프가 만들어집니다. 그리는 중 띄워 둔 미리보기 파이프가 있으면 함께 정리합니다.

여기서 받는 좌표는 위경도(EPSG:4326)입니다. 월드 좌표(EPSG:3857)로 넣으려면 setVertex를 사용합니다.

Name	Type	Description
x	Vector3 | number	위경도 좌표를 담은 Vector3, 또는 경도 값
y	number	optional 위도. 첫 번째 인자에 숫자를 넣었을 때만 사용합니다
z	number	optional 지면 기준 높이 (미터). 첫 번째 인자에 숫자를 넣었을 때만 사용합니다

changeFlowType(type)

흐름을 보여주는 방식을 다른 타입으로 바꿉니다.
타입마다 셰이더가 달라 재질을 새로 만들며, 색·투명도·띠 크기 같은 현재 값은 새 재질로 그대로 옮겨집니다.

Name	Type	Description
type	string	바꿀 흐름 타입. COLOR_BAND·COLOR_FILL·ARROW 중 하나이며 U3dFlowPipe.FlowType으로 지정할 수 있습니다

clearSectionHighlight()

켜 두었던 구간 강조를 끄고 파이프를 원래 색으로 되돌립니다.
구간 값과 sectionHighlight 표시도 함께 0과 false로 되돌립니다. 강조를 켠 적이 없는 상태에서 호출하면 값이 그대로 유지됩니다.

endPreviewPipe()

띄워 둔 미리보기 파이프를 감춥니다.
경로를 그리다가 좌표를 확정하거나 그리기를 그만둘 때 사용합니다. 미리보기 좌표를 비우고 감추기만 하며 객체는 남겨 두므로 다음 previewPipe 호출에서 다시 사용됩니다.

flowPause()

흐름을 지금 자리에서 잠시 멈춥니다.
진행 상태를 유지하므로 flowResume으로 이어 재생할 수 있습니다. initAnimation으로 그리기 루프와 연결한 뒤부터 동작합니다.

flowResume()

flowPause나 hide로 멈춰 둔 흐름을 멈춘 자리에서 이어 재생합니다.
initAnimation으로 그리기 루프와 연결한 뒤부터 동작합니다.

flowStart()

흐름 애니메이션을 처음부터 재생합니다.
멈춰 있든 일시정지 상태든 경과 시간을 0으로 되돌리고 다시 흐르기 시작하며, 이미 흐르는 중이면 상태를 그대로 둡니다. 일시정지한 자리에서 이어 갈 때는 flowResume을 사용합니다.

initAnimation으로 그리기 루프와 연결한 뒤부터 동작합니다.

See:

• initAnimation

flowStop(isInit)

흐름 애니메이션을 멈춥니다.
어느 쪽으로 멈추든 다시 flowStart를 부르면 처음부터 흐릅니다. 멈춘 자리에서 이어 갈 때는 flowStop 대신 flowPause를 사용합니다.

initAnimation으로 그리기 루프와 연결한 뒤부터 동작합니다.

Name	Type	Default	Description
isInit	boolean	false	optional true면 멈추면서 경과 시간을 0으로 되돌리고 그리기 루프 등록도 정리합니다. false면 진행만 멈춥니다

getLength()number|undefined

좌표를 이어 만든 곡선 경로의 길이를 돌려줍니다. (미터)
곡선을 따라 잰 길이라 좌표 사이를 직선으로 이은 거리의 합보다 길 수 있습니다.

Returns:

Type	Description
number | undefined	경로 길이 (미터). 좌표가 아직 반영되지 않아 곡선이 없으면 undefined

getName()string

도형 이름을 돌려줍니다.
생성 옵션의 name으로 정한 값이며, 레이어에서 도형을 찾을 때 쓰는 식별자입니다.

Returns:

Type	Description
string	도형 이름. 생성 시 지정하지 않았으면 빈 문자열

getParam()U3dFlowPipeParam

흐름 파이프의 현재 속성을 한 객체에 담아 돌려줍니다.
흐름 설정(타입·속도·스타일)과 파이프 형상(반지름·장력·단면 분할), 경로 좌표가 함께 담깁니다. 각 항목의 의미는 U3dFlowPipeParam에 있습니다.

호출할 때마다 바깥 객체는 새로 만들어 돌려주지만, 그 안의 flowStyle과 style.color는 이 파이프가 실제로 쓰고 있는 객체이므로 그 안을 직접 고치면 파이프에도 반영됩니다.

Returns:

Type	Description
U3dFlowPipeParam	흐름 설정·파이프 형상·경로 좌표를 담은 현재 속성 객체

getPipeRadius()number

파이프 단면의 반지름을 돌려줍니다. (미터)
생성 옵션의 piperadius로 정한 값이며, 파이프가 얼마나 굵게 보이는지를 결정합니다.

Returns:

Type	Description
number	파이프 반지름 (미터)

getProgressByWorldPoint(worldPos)number|undefined

지정한 지점이 파이프 경로의 어디쯤인지를 0~1 비율로 알려줍니다.
파이프를 클릭한 자리가 전체의 몇 %인지 계산하거나, 그 값을 구간 강조의 시작·끝으로 넘길 때 사용합니다. 경로를 200등분한 지점 중 넘긴 좌표에 가장 가까운 곳을 찾아 재므로, 값에는 그만큼의 오차가 있습니다.

파이프에서 멀리 떨어진 지점도 가장 가까운 지점의 비율로 계산됩니다. 지점이 파이프 위에 있는지는 호출한 쪽에서 판단합니다.

Name	Type	Description
worldPos	WorldPositionVector3	조회할 지점의 월드 좌표 (EPSG:3857)

Returns:

Type	Description
number | undefined	파이프 시작점을 0, 끝점을 1로 본 진행률. 좌표가 두 개 미만이거나 경로가 아직 만들어지지 않았으면 undefined

hide()

파이프를 화면에서 감추고 흐름을 그 자리에서 멈춥니다.
진행 상태를 유지하므로 show로 다시 보이게 하면 멈춘 지점부터 이어집니다. 객체가 지워지지는 않습니다.

initAnimation(drawArg)

흐름 애니메이션을 그리기 루프와 연결합니다.
이 호출로 애니메이션 컨트롤러가 만들어지고, 그때부터 flowStart·flowStop·flowPause·flowResume이 동작합니다. 흐름 파이프를 만든 뒤 한 번 호출하면 되고, 다시 호출하면 컨트롤러가 새로 만들어집니다.

Name	Type	Description
drawArg	UDrawArg	렌더링과 카메라 정보를 담은 객체. 애니메이션을 그리기 루프에 태우는 데 사용하며, 앱이 들고 있는 _drawArg 값을 넘깁니다

previewPipe(x, y, z)

경로의 마지막 좌표에서 지정한 지점까지 이어지는 미리보기 파이프를 띄웁니다.
마우스를 따라 다음 구간이 어떻게 놓일지 미리 보여줄 때 사용하며, 본체 파이프의 반지름·장력·색·불투명도를 그대로 씁니다. 경로에 좌표가 하나도 없으면 이을 구간이 없어 미리보기가 그려지지 않습니다.

이 도형이 레이어에 올라간 뒤부터 동작합니다. 미리보기를 지울 때는 endPreviewPipe를 사용합니다.

Name	Type	Description
x	number	미리보기가 끝날 지점의 월드 X좌표 (EPSG:3857)
y	number	미리보기가 끝날 지점의 월드 Y좌표 (EPSG:3857)
z	number	미리보기가 끝날 지점의 높이 (미터)

setBaseColor(color, opacity)

파이프 몸통(흐름이 지나가는 바탕)의 색과 불투명도를 바꿉니다.
흐르는 부분의 색은 그대로 두므로, 흐름까지 바꾸려면 setFlowColor를 함께 사용합니다. 불투명도는 0~1로 잘라서 적용하고, 숫자로 바꿀 수 없는 값은 적용하지 않아 색만 바뀝니다.

Name	Type	Description
color	ColorRepresentation	파이프 몸통 색상. 16진수 숫자(0xff0000), CSS 색 문자열('#ff0000') 또는 THREE.Color를 넣습니다
opacity	number	optional 파이프 몸통의 불투명도 (0~1). 0으로 두면 몸통이 감춰져 흐르는 부분만 보입니다

setFlowColor(color, opacity)

파이프 위를 흐르는 부분(색 띠·채움·화살표)의 색과 불투명도를 바꿉니다.
파이프 몸통 색은 그대로 두므로, 몸통까지 바꾸려면 setBaseColor를 함께 사용합니다. 흐름 타입에 관계없이 동작하며, 재질이 만들어진 뒤부터 반영됩니다.

Name	Type	Description
color	ColorRepresentation	흐르는 부분의 색상. 16진수 숫자(0xffcc00), CSS 색 문자열('#ffcc00') 또는 THREE.Color를 넣습니다
opacity	number	optional 흐르는 부분의 불투명도 (0~1). 생략하면 지금 값을 유지합니다

setFlowOpacity(opacity)

파이프 위를 흐르는 부분의 불투명도만 바꿉니다.
범위를 벗어난 값은 0~1로 잘라서 적용하고, 숫자로 바꿀 수 없는 값은 적용하지 않고 콘솔에 기록을 남깁니다.

Name	Type	Description
opacity	number	흐르는 부분의 불투명도 (0~1). 0이면 흐름이 보이지 않고 1이면 불투명합니다

setLoop(isLoop)

흐름이 한 바퀴를 끝낸 뒤 처음부터 다시 흐를지를 정합니다.
기본 onComplete 동작과 셰이더의 반복 처리에 함께 쓰이며, 애니메이션이 도는 중에 바꿔도 됩니다. 생성 옵션에서 onComplete를 직접 지정했다면 반복 재생은 그 콜백이 담당하므로 이 값이 재생을 다시 시작하지는 않습니다.

Name	Type	Description
isLoop	boolean	true면 끝난 뒤 처음부터 다시 흐르고, false면 한 바퀴만 흐르고 멈춥니다

setOnUpdate(func)

흐름이 한 프레임 진행될 때마다 호출할 콜백을 등록합니다.
생성 옵션의 onUpdate 대신 나중에 지정하거나 바꿀 때 사용하며, 앞서 등록한 콜백은 교체됩니다. 함수가 아닌 값은 등록하지 않고 기존 콜백을 유지하며, 콘솔에 기록을 남깁니다.

Name	Type	Description
func	OnFlowUpdate	매 프레임 호출할 콜백. 경과 시간(초)과 0~1 진행률을 인자로 받습니다

setSectionHighlightByLength(startMeter, endMeter, color, opacity)

파이프의 한 구간을 실제 길이(미터)로 지정해 강조합니다.
넘긴 값을 파이프 전체 길이로 나눠 비율로 바꾼 뒤 setSectionHighlightNormalized와 같은 방식으로 처리하므로, 값을 자르고 맞바꾸는 규칙과 발생하는 이벤트도 같습니다.

좌표를 넣어 파이프 형상이 만들어지고 totalLength가 0보다 커진 뒤부터 동작합니다.

Name	Type	Description
startMeter	number	파이프 시작점에서 잰 구간 시작 위치 (미터)
endMeter	number	파이프 시작점에서 잰 구간 끝 위치 (미터)
color	ColorRepresentation	optional 구간을 덧칠할 색상. 생략하면 직전 값을 유지합니다
opacity	number	optional 덧칠의 불투명도 (0~1). 생략하면 직전 값을 유지합니다

setSectionHighlightNormalized(start, end, color, opacity)

파이프의 한 구간을 다른 색으로 덧칠해 강조합니다.
구간은 파이프 전체 길이를 0~1로 본 비율로 지정합니다. 예를 들어 0.25, 0.5는 앞에서 1/4 지점부터 절반 지점까지입니다. 흐름이 이 구간에 들어오고 나갈 때 ENTER·EXIT 이벤트가 발생합니다.

범위를 벗어난 값은 0~1로 자르고, start가 end보다 크면 두 값을 맞바꿔 처리합니다. 시작과 끝이 같으면 강조가 꺼집니다. 이 함수로 켠 강조는 sectionHighlight 게터에 반영되지 않습니다.

Name	Type	Description
start	number	구간이 시작하는 위치. 파이프 전체 길이를 1로 본 비율 (0~1)
end	number	구간이 끝나는 위치. 파이프 전체 길이를 1로 본 비율 (0~1)
color	ColorRepresentation	optional 구간을 덧칠할 색상. 생략하면 직전 값(처음에는 흰색)을 유지합니다
opacity	number	optional 덧칠의 불투명도 (0~1). 생략하면 직전 값(처음에는 1)을 유지합니다

show()

파이프를 화면에 다시 보이게 하고 멈춰 있던 흐름을 이어 재생합니다.
hide와 짝을 이룹니다. initAnimation으로 연결하기 전에는 표시만 되고 흐름은 움직이지 않습니다.

updatePreviewPipe(opt)

띄워 둔 미리보기 파이프의 색과 불투명도를 바꿉니다.
그리는 중인 구간이 유효한지 아닌지를 색으로 구분해 보여줄 때 사용합니다. previewPipe로 미리보기 파이프를 띄운 뒤부터 동작합니다.

Name	Type	Default	Description
opt	object	{}	optional 바꿀 속성만 담은 객체. 넣지 않은 항목은 그대로 둡니다 Name Type Description color ColorRepresentation optional 미리보기 파이프의 색상. 16진수 숫자, CSS 색 문자열 또는 THREE.Color를 넣습니다 opacity number optional 미리보기 파이프의 불투명도 (0~1). 0은 적용되지 않으며, 완전히 감출 때는 endPreviewPipe를 사용합니다

static isValidFlowType(type)boolean

넘긴 문자열이 이 클래스가 다룰 수 있는 흐름 타입인지 확인합니다.
생성 옵션이나 changeFlowType에 넣기 전에 사용자 입력을 걸러낼 때 사용합니다.

Name	Type	Description
type	string | undefined	확인할 문자열. undefined를 넣으면 false를 돌려줍니다

Returns:

Type	Description
boolean	COLOR_BAND·COLOR_FILL·ARROW 중 하나이면 true

Type Definitions

FlowShaderobject

흐름 표현에 쓰는 셰이더 한 벌을 담은 객체입니다.
흐름 타입마다 준비된 셰이더 모듈의 모양이며, 이 값으로 실제 ShaderMaterial을 만듭니다.

Properties:

Name	Type	Description
name	string	셰이더를 구분하는 이름
vertexShader	string	정점 셰이더 GLSL 소스 문자열
fragmentShader	string	프래그먼트 셰이더 GLSL 소스 문자열
uniforms	Record.<string, IUniform>	셰이더에 넘길 유니폼의 초기값 모음. 재질을 만들 때 복제해서 사용하므로 원본은 바뀌지 않습니다

FlowStyleobject

U3dFlowPipe가 실제로 사용하는 흐름 스타일 값입니다.
생성 옵션으로 받은 FlowStyleInput의 빈 항목을 기본값으로 채워 만든 확정본이며, getParam의 flowStyle로 그대로 돌려줍니다. 항목마다 효과가 나타나는 흐름 타입이 다릅니다.

Properties:

Name	Type	Description
color	Color	흐르는 부분(띠·채움·화살표)의 색상. 바탕이 되는 파이프 몸통 색은 생성 옵션의 color로 따로 정합니다
opacity	number	흐르는 부분의 불투명도 (0~1). 0이면 흐름이 보이지 않고 1이면 불투명합니다
bandLength	number	COLOR_BAND/ARROW에서 띠 하나의 길이 (미터). 파이프 전체 길이로 나눠 비율로 환산해 셰이더에 넘깁니다
bandNum	number	COLOR_BAND/ARROW에서 동시에 흐르는 띠의 개수
bandGap	number	COLOR_BAND/ARROW에서 띠와 띠 사이의 빈 간격 (미터)
softness	number	띠의 머리와 꼬리를 흐리게 번지도록 하는 정도. 값이 클수록 띠 사이 간격과 애니메이션 한 주기가 함께 길어집니다
autoNum	boolean	COLOR_BAND/ARROW에서 띠 개수를 진행에 따라 늘릴지 여부. 켜면 흐름이 앞으로 갈수록 띠가 계속 이어져 나옵니다
isWave	boolean	COLOR_FILL에서만 쓰이며, 채워지는 표면에 물결 모양 일렁임을 넣을지 여부입니다. 다른 흐름 타입에서는 효과가 없습니다
arrowWidth	number	ARROW에서 화살표 하나의 너비 (미터). 파이프 반지름과 같은 단위이며, 둘레 대비 비율로 환산됩니다
aroundRepeat	number	ARROW에서 파이프 둘레를 몇 칸으로 나눠 화살표를 늘어놓을지의 수. 1이면 둘레에 화살표가 하나만 놓입니다

FlowStyleInputobject

U3dFlowPipe 생성 옵션의 flowStyle에 넣는 흐름 스타일입니다.
모든 항목이 선택이며, 넣지 않은 항목은 아래 기본값으로 채워집니다. 각 항목의 자세한 의미는 FlowStyle에 있습니다.

Properties:

Name	Type	Argument	Default	Description
color	ColorRepresentation	<optional>	'#ffcc00'	흐르는 부분의 색상. 16진수 숫자(0xffcc00), CSS 색 문자열('#ffcc00') 또는 THREE.Color를 넣습니다
opacity	number	<optional>	1	흐르는 부분의 불투명도 (0~1)
bandLength	number	<optional>	30	COLOR_BAND/ARROW에서 띠 하나의 길이 (미터)
bandNum	number	<optional>	10	COLOR_BAND/ARROW에서 동시에 흐르는 띠의 개수
bandGap	number	<optional>	10	COLOR_BAND/ARROW에서 띠 사이의 빈 간격 (미터)
softness	number	<optional>	0.5	띠의 머리와 꼬리를 흐리게 번지도록 하는 정도
autoNum	boolean	<optional>	false	COLOR_BAND/ARROW에서 띠 개수를 진행에 따라 늘릴지 여부
isWave	boolean	<optional>	true	COLOR_FILL에서 표면에 물결 일렁임을 넣을지 여부
arrowWidth	number	<optional>	3	ARROW에서 화살표 하나의 너비 (미터)
aroundRepeat	number	<optional>	1	ARROW에서 파이프 둘레를 몇 칸으로 나눠 화살표를 늘어놓을지의 수

FlowUniformsRecord.<string, IUniform>

흐름 셰이더의 유니폼 값 모음입니다.
uTime, uFlowColor, isWave처럼 셰이더가 선언한 유니폼 이름을 키로 두고, 각 항목의 value에 셰이더로 넘길 실제 값이 들어 있습니다. 값의 종류는 유니폼마다 달라 색(Color), 숫자, 참/거짓이 섞여 있습니다.

OnFlowComplete()

흐름 애니메이션이 한 바퀴를 끝냈을 때 호출되는 콜백입니다.
생성 옵션의 onComplete로 등록하며, 넣지 않으면 흐름을 멈췄다가 loop가 켜져 있으면 다시 시작하는 기본 동작이 쓰입니다. 인자는 OnFlowUpdate와 같고, 종료 시점이므로 progress는 항상 1로 전달됩니다.

OnFlowUpdate()

흐름 애니메이션이 한 프레임 진행될 때마다 호출되는 콜백입니다.
setOnUpdate 또는 생성 옵션의 onUpdate로 등록합니다. 첫 번째 인자는 애니메이션이 시작한 뒤 흐른 시간(초)으로, 일시정지한 동안은 늘지 않습니다. 두 번째 인자는 흐름이 파이프를 얼마나 지났는지를 0~1로 나타낸 진행률입니다.

U3dFlowPipeCOobject

~extends U3dPipe~U3dPipeCO
U3dFlowPipe 생성자 옵션

Properties:

Name	Type	Argument	Default	Description
name	string	<optional>		도형 이름. 레이어에서 도형을 찾을 때 쓰는 식별자이며, 넣지 않으면 빈 문자열입니다
flowType	string	<optional>	'COLOR_BAND'	흐름을 어떤 모양으로 보여줄지 정합니다. COLOR_BAND는 색 띠가 지나가고, COLOR_FILL은 한쪽 끝부터 색이 차오르며, ARROW는 화살표가 흘러갑니다. 지원 범위 밖의 값은 COLOR_BAND로 만들고 콘솔에 기록을 남깁니다
flowStyle	U3dFlowPipe.types~FlowStyleInput	<optional>		흐르는 부분의 색·투명도·띠 크기 등 세부 스타일. 넣지 않은 항목은 기본값으로 채워집니다
loop	boolean	<optional>	true	흐름이 한 바퀴를 끝낸 뒤 처음부터 다시 반복할지 여부. 셰이더의 반복 처리와 기본 onComplete 동작에 함께 쓰이며, 만든 뒤에는 setLoop으로 바꿉니다
flowSpeed	number	<optional>	100	흐름이 경로를 따라 나아가는 속도 (m/s). 파이프 전체 길이로 나눠 비율 속도로 환산됩니다
onComplete	U3dFlowPipe.types~OnFlowComplete	<optional>		흐름이 한 바퀴를 끝냈을 때 호출할 콜백. 넣으면 반복 재생을 처리하는 기본 동작을 대신하므로, 반복이 필요하면 직접 flowStart를 불러야 합니다
onUpdate	U3dFlowPipe.types~OnFlowUpdate	<optional>		흐름이 한 프레임 진행될 때마다 호출할 콜백
color	ColorRepresentation	<optional>	0xff0000	파이프 몸통(바탕)의 색상. 흐르는 부분의 색은 flowStyle.color로 따로 정합니다
opacity	number	<optional>	0.7	파이프 몸통의 불투명도 (0~1). 0으로 두면 몸통이 감춰져 흐르는 부분만 보입니다
piperadius	number	<optional>	2	파이프의 반지름 (미터)
tension	number	<optional>	0.5	경로를 잇는 곡선의 장력 (0~1). 0이면 좌표를 직선으로 잇고, 클수록 좌표를 팽팽하게 지나는 곡선이 됩니다
radiusSegments	number	<optional>	16	파이프 단면(원둘레)을 나누는 면의 수. 클수록 단면이 원에 가까워지고 정점 수가 늘어납니다
closed	boolean	<optional>	false	경로의 시작점과 끝점을 이어 고리 모양으로 닫을지 여부
vertices	Array.<WorldPositionVector3>	<optional>		파이프가 지나갈 월드 좌표 배열 (EPSG:3857). 좌표 두 개 이상이어야 파이프가 만들어지며, 넣는 즉시 형상에 반영됩니다
coordinates	Array.<GeoPositionVector3>	<optional>		파이프가 지나갈 위경도 좌표 배열 (EPSG:4326). 도형이 속한 레이어가 월드 좌표로 바꿔 넣는 시점에 형상에 반영됩니다

U3dFlowPipeEMIobject

~extends U3dPipe~U3dPipeEMI
U3dFlowPipe가 발생시키는 이벤트의 이름 모음입니다.
flowPipe.addEventListener(U3dFlowPipe.EVENT.FLOW_END, handler)처럼 리스너를 등록할 때 사용합니다. 다만 FLOW_HIT·ENTER·EXIT는 상수 값과 실제 발생하는 이벤트 이름이 서로 달라, 이 세 이벤트는 'flowHit'·'enter'·'exit' 문자열을 직접 넘겨 등록합니다.

Properties:

Name	Type	Description
LOW_UPDATE	string	흐름이 한 프레임 진행될 때마다 발생합니다. data에 경과 시간(timeSec)과 진행률(progress)이 담깁니다
FLOW_END	string	흐름이 한 바퀴를 끝낸 뒤 매 프레임 발생합니다. 기본 onComplete는 이때 흐름을 멈추므로 보통 한 번만 발생하지만, onComplete를 직접 지정해 흐름을 멈추지 않으면 계속 발생합니다. data에 경과 시간과 진행률 1이 담깁니다
FLOW_HIT	string	흐름의 선두가 경로 끝에 닿은 뒤 매 프레임 발생합니다. data에 경과 시간(timeSec)과 bandIndex가 담깁니다
ENTER	string	강조 구간을 설정해 둔 상태에서 흐름이 그 구간에 들어섰을 때 한 번 발생합니다. data에 경과 시간(timeSec)과 진행률(progress), 구간의 시작·끝 비율(section)이 담깁니다
EXIT	string	흐름이 강조 구간을 완전히 빠져나갔을 때 한 번 발생합니다. data 구성은 ENTER와 같습니다

U3dFlowPipeParamobject

getParam 함수가 반환하는 흐름 파이프의 현재 속성 객체입니다.
흐름 고유 속성과 파이프 형상, 경로 좌표를 함께 담습니다.

Properties:

Name	Type	Description
name	string	도형 이름. 생성 시 지정하지 않았으면 빈 문자열입니다
flowSpeed	number	흐름 애니메이션 속도 (m/s)
flowStyle	U3dFlowPipe.types~FlowStyle	기본값까지 채워진 현재 흐름 스타일
flowType	string	현재 흐름 표현 방식 (COLOR_BAND/COLOR_FILL/ARROW)
piperadius	number	파이프 반지름 (미터)
tension	number	경로를 잇는 곡선의 장력 (0~1). 0이면 좌표를 직선으로 잇고, 클수록 좌표를 팽팽하게 지나는 곡선이 됩니다
radiusSegments	number	파이프 단면(원둘레)을 나누는 면의 수. 클수록 단면이 원에 가까워집니다
positions	Array.<GeoPositionVector3>	파이프 경로의 위경도 좌표 배열 (EPSG:4326)
vertices	Array.<WorldPositionVector3>	파이프 경로의 월드 좌표 배열 (EPSG:3857)
style	Object	파이프 몸통의 불투명도(opcity)와 색상(color)