GeOnDT for JS API

new U3dComponentPosition(opt)

컴포넌트를 생성합니다. 옵션별 의미는 U3dComponentPositionCO를 참고하세요.
제약 사항: opt.componentlayer(정상 레이어)와 opt.position이 없으면 생성이 중단되고 isDisposed()가 true인 빈 객체가 됩니다.

Name	Type	Description
`opt`	U3dComponentPositionCO	생성 옵션. `componentlayer`, `position`은 필수

See:

GeOnDT.model.U3dMultipleComponentLayer

Example

let component = new U3dComponentPosition({
     name: '가로등1',
     type: 'component',
     loadedModel: "street_lamp",
     position: {x: 14133794.559901267, y: 4506973.292712285, z: 85.26596813065227, isVector3: true},
     scale: {x: 3, y: 3, z:3, isVector3: true},
     rotation: {_x: 0, _y: -90, _z: 0, _order: 'XYZ', isEuler: true}
 });

Members

LODMode

현재 LOD(카메라 거리 기반 자동 조정) 모드. setLODMode 참고.

animationControllers

등록된 주행 애니메이션 컨트롤러 목록. 키는 makeAnimationController가 만든 애니메이션 ID입니다.

childrenArray.<(U3dComponentPosition|ExtendedObject3D)>

setChild로 등록한 하위 컴포넌트·오브젝트 목록. 부모의 위치·회전·크기·가시화가 함께 반영됩니다.

colorColorRepresentation undefined

setColor로 지정한 현재 색상. 지정 전에는 undefined이며 모델 원본 색상이 쓰입니다.

componentLayerU3dMultipleComponentLayer

컴포넌트가 속한 컴포넌트 레이어. 생성 옵션 componentlayer로 지정됩니다.

cumulativeInfo

Deprecated

누적 이력은 더 이상 U3dComponentPosition 내부에 저장하지 않습니다. 클라이언트/서비스 단 이력을 사용하세요.

cumulativePath

화면에 그려진 이동 궤적(누적 경로) 객체. drawCumulativePath가 true인 상태로 이동해야 생성됩니다.

cumulativeProperty

누적 경로(궤적) 기록과 통과 콜백을 관리하는 상태. 마지막 통과 index, 통과 콜백, 이동 기준 거리 등을 담습니다.

distancenumber

현재 주행 경로의 총 길이 (m).

drawArgUDrawArg

앱·씬·카메라에 접근하기 위한 렌더 컨텍스트. 레이어에서 전달됩니다.

drawCumulativePath

주행 중 이동한 궤적(누적 경로)을 화면에 그릴지 여부.

drawPathboolean

주행 경로 라인을 화면에 표시할지 여부.

drawRealPathboolean

실제 이동 경로 메시를 표시할지 여부.

durationnumber

주행 목표 시간 (ms). 0이면 speed 기준 등속으로 주행합니다.

idstring

컴포넌트 고유 ID. 생략 시 GUID가 생성됩니다.

imagestring undefined

경로 텍스처 이미지 URL.

instanceIdnumber string undefined

instanced 컴포넌트일 때 인스턴스 index. 일반 컴포넌트는 undefined입니다.

isComponentboolean

컴포넌트 객체임을 나타내는 표식 (항상 true). 레이어가 객체 종류를 판별할 때 사용합니다.

isTraceboolean

카메라 추적 여부. true면 카메라가 컴포넌트를 따라가고(setCameraTrace), false면 일반 지도 모드입니다.

lookAtVector3 undefined

주행 중 바라보는 목표 위치 (월드 좌표). 주행 중이 아니면 undefined입니다.

matrixMatrix4

위치·회전·크기를 합친 변환 행렬. 부모가 있으면 부모 기준 상대 행렬입니다.

matrixWorldMatrix4

부모 계층까지 반영한 월드 변환 행렬. getMatrixWorld가 반환합니다.

mixersArray.<AnimationMixer>

모델 자체 애니메이션(클립)을 재생하는 믹서 목록. setMixers로 교체합니다.

movePointListArray.<GooglePositionWithCallback>

addMovePoint로 등록한 이동 지점 목록 (위경도 좌표, 통과 콜백 포함).

name

컴포넌트 이름. 생략 시 loadedModel 이름 또는 GUID가 쓰이며 editName으로 변경합니다.

needToChangeboolean

주행 중 속도 변경이 예약되었는지 여부.

newSpeednumber

setSpeed로 예약된 다음 속도 (km/h). 주행 중 변경하면 다음 프레임에 speed로 반영됩니다.

opacitynumber undefined

setOpacity로 지정한 현재 투명도 (0~1). 지정 전에는 undefined입니다.

overlayArray.<OverlayObject>

setOverlay로 붙인 오버레이 목록. 컴포넌트가 이동하면 함께 이동합니다.

parentU3dComponentPosition undefined

setParent로 지정한 상위 컴포넌트. 없으면 undefined입니다.

pathColorColor

경로 라인 색상. setPathColor로 변경합니다.

pathGeometry

주행 경로 라인의 지오메트리. 생성 옵션 drawpath/drawRealPath가 true일 때만 만들어지며 그 외에는 undefined입니다.

pathMaterial

주행 경로 라인에 쓰이는 재질. 생성 옵션 drawpath/drawRealPath가 true일 때만 만들어지며 그 외에는 undefined입니다.

pathOpacitynumber

경로 라인 투명도 (0~1). setPathOpacity로 변경합니다.

pitchYawRollListArray.<Vector3> undefined

addMovePoint로 지정한 지점별 방향각 목록. 지정하지 않으면 undefined입니다.

poiPoiLike undefined

컴포넌트 라벨 POI. setLabel로 생성되며 없으면 undefined입니다.

positionVector3

컴포넌트 위치 (월드 좌표 EPSG:3857, m). 직접 수정하지 말고 setPosition을 사용하세요.

properties

사용자 정의 속성 정보. getProperties/setProperties/addProperties로 다룹니다.

quaternionQuaternion

rotation과 동기화되는 회전 쿼터니언. 변환 행렬 계산에 사용됩니다.

repeatboolean

주행 애니메이션을 끝난 뒤 반복할지 여부.

rotationEuler

컴포넌트 회전 (라디안 Euler, XYZ 순). setRotation·setRotationX/Y/Z로 변경합니다.

scaleVector3

축별 크기 배율. 1이 원본 크기이며 setScale로 변경합니다.

scene

컴포넌트가 그려지는 씬. 기본값은 레이어의 씬입니다.

speednumber

주행 애니메이션 이동 속도 (m/s, 기본값 700). setSpeed로 변경합니다.

splineObjectunknown

typestring

컴포넌트 종류. 'component'(일반 모델) 또는 'crowd'(폴리곤 안을 돌아다니는 군중).

typePathstring

경로 표시 타입. 현재 'cube'만 지원합니다.

updateAnglenumber

주행 중 방향 갱신을 판단하는 기준 각도 (°).

updateDistancenumber

주행 중 updateAnimationFunc 콜백을 호출하는 이동 간격 (m).

useOriginRoute

입력 경로를 상대 좌표로 보정하지 않고 원본 좌표 그대로 사용하는지 여부. 생성 옵션 useOriginRoute로만 정해지며 이후 변경할 수 없습니다.

userDataKeyValue

외부에서 자유롭게 붙이는 사용자 데이터. verticalObjects(Object3D 배열)가 있으면 LOD 가시화 변경 시 함께 켜지고 꺼집니다.

usetruthpathboolean

입력 좌표를 곡선 보정 없이 그대로 경로로 사용할지 여부.

waypointHistoryArray.<WorldPositionVector3>

moveSmoothly로 도착한 최근 100개 지점의 복사본입니다. 오래된 지점부터 정렬됩니다.
시작점·대기 목표점·프레임 보간점은 포함하지 않습니다. 이동 중지나 컨트롤러 교체 시 유지하고 dispose 시 비웁니다.

Methods

addMovePoint(movePointList, pitchYawRollList, animateNow, smoothCorner)

컴포넌트가 이동할 Move Point를 추가하는 메서드입니다.
애니메이션 동작 시 Move Point를 따라 이동합니다.

Name	Type	Default	Description
`movePointList`	Array.<GooglePositionWithCallback>		이동할 Move Point 배열
`pitchYawRollList`	Array.<Vector3>		optional 컴포넌트 방향각 옵션
`animateNow`	boolean	true	optional `true`면 경로 설정 즉시 애니메이션을 시작합니다.
`smoothCorner`		true	optional `true`면 경로 생성 시 코너를 부드럽게 보정합니다.

addPathGeometry(pathGeometry, animateNow, hovering)

컴포넌트가 주행할 경로 (U3dPathGeometry)를 설정하는 메서드입니다.
입력한 U3dPathGeometry 경로를 따라 컴포넌트가 주행합니다.

Name Type Default Description

Name	Type	Default	Description
`pathGeometry`	PathGeometryLike		주행할 경로 (U3dPathGeometry)
`animateNow`	boolean	true	optional `true`이면 경로 설정 즉시 애니메이션을 시작합니다.
`hovering`	boolean	true	optional 호버링 사용 여부 호버링 : 드론이 수직으로 상승 또는 하강하는 비행 동작. `true`면 지면에서 `U3dPathGeometry` 경로를까지 수직으로 상승/하강하는 경로가 추가됩니다. `false`면 처음부터 경로 시작점에 컴포넌트가 배치되고, 경로를 따라 이동합니다.

pathGeometry

PathGeometryLike

주행할 경로 (U3dPathGeometry)

animateNow

boolean

true

optional

true이면 경로 설정 즉시 애니메이션을 시작합니다.

hovering

boolean

true

optional

호버링 사용 여부
호버링 : 드론이 수직으로 상승 또는 하강하는 비행 동작.

true면 지면에서 U3dPathGeometry 경로를까지 수직으로 상승/하강하는 경로가 추가됩니다.
false면 처음부터 경로 시작점에 컴포넌트가 배치되고, 경로를 따라 이동합니다.

addProperties(key, value)

컴포넌트 속성 정보를 추가하는 함수

Name	Type	Description
`key`	string	속성 정보 식별키
`value`	unknown	속성 정보 값

changeProperties(key, value)

컴포넌트 속성정보를 변경하는 함수

Name	Type	Description
`key`	string	변경할 속성 정보 식별키
`value`	unknown	속성 정보 값

checkIshaveLight(lightList)boolean

해당 목록에서 컴포넌트가 광원을 가지고 있는지 확인하는 함수

Name	Type	Description
`lightList`	Array.<LightLike>	전체 광원 목록

Returns:

Type	Description
boolean	광원 존재 여부

dispose()

컴포넌트를 씬에서 제거하고 모델·경로·라벨·오버레이·애니메이션 리소스를 해제하는 함수.
주의 사항: 호출 후 이 객체는 다시 사용할 수 없으며 isDisposed()가 true가 됩니다.

disposeAnimationControllers()

등록된 주행 애니메이션 컨트롤러를 모두 제거하고 현재·시작 애니메이션 ID를 초기화합니다.
주의 사항: 진행 중인 주행이 즉시 멈추며, 다시 주행하려면 경로를 새로 등록해야 합니다.

editName(newName)

컴포넌트 name을 편집하는 메서드입니다.

Name	Type	Description
`newName`	string	컴포넌트의 새 이름

exceptTexture(isExcept)boolean

컴포넌트가 출력하고 있는 모델의 텍스쳐 출력을 끄거나 켭니다.

Name	Type	Default	Description
`isExcept`	boolean	false	optional true이면 텍스처를 숨기고 단색으로 그리며, false이면 텍스처를 다시 표시합니다

Returns:

Type	Description
boolean	적용되면 true, 모델이 없거나 적용에 실패하면 false

getAnimationById(animationId)UAnimationController|undefined

애니메이션 ID로 애니메이션 컨트롤러를 반환하는 함수.

Name	Type	Description
`animationId`	string	애니메이션 ID

Returns:

Type	Description
UAnimationController \| undefined	UAnimationController 애니메이션 컨트롤러

getAnimationClips()Record.<string, AnimationAction>|undefined

모델 자체 애니메이션 클립(액션) 목록을 조회합니다. 키를 startAction/stopAction에 넘겨 재생을 제어합니다.

Returns:

Type	Description
Record.<string, AnimationAction> \| undefined	클립 이름을 키로 한 액션 객체. 믹서가 없으면 undefined

getAnimationInfo(animationId)U3dComponentAnimationInfo|undefined

현재 애니메이션 또는 지정한 애니메이션의 상태 정보를 반환하는 함수.

Name	Type	Description
`animationId`	string	optional 조회할 애니메이션 ID. 생략 시 현재 동작 중인 애니메이션 조회

Returns:

Type	Description
U3dComponentAnimationInfo \| undefined

getAnimationList()Record.<string, AnimationAction>|undefined

모델 자체 애니메이션 클립(액션) 목록을 반환합니다. getAnimationClips와 같은 값을 돌려줍니다.

Returns:

Type	Description
Record.<string, AnimationAction> \| undefined	클립 이름을 키로 한 액션 객체. 믹서가 없으면 undefined

getAnimationNow()UAnimationController|undefined

현재 동작 중인 주행 애니메이션 컨트롤러를 반환하는 함수.

Returns:

Type	Description
UAnimationController \| undefined	현재 애니메이션 컨트롤러. 주행 중이 아니면 undefined

getAnimations()Map.<string, UAnimationController>

컴포넌트 주행 애니메이션 목록을 반환하는 함수.

Returns:

Type	Description
Map.<string, UAnimationController>	animationControllers 애니메이션 목록

getBoundBoxObject()Box3WithCenter

원래 모델의 geometry bounding box를 반환 ( 위치, 회전, 크기가 반영되지 않은 초기 상태)

Returns:

Type	Description
Box3WithCenter	모델의 bounding box

getBoundingBox()Box3

컴포넌트의 경계영역(BoundingBox)을 반환하는 함수

Returns:

Type	Description
Box3	컴포넌트의 경계영역

getBrightness()number

이 컴포넌트에 설정한 밝기 배율을 반환합니다.

Returns:

Type	Description
number	밝기 배율. 기본값은 1입니다.

getChildren()Array.<(U3dComponentPosition|ExtendedObject3D)>

setChild로 등록한 하위 계층 목록을 반환하는 함수

Returns:

Type	Description
Array.<(U3dComponentPosition\|ExtendedObject3D)>	하위 컴포넌트·오브젝트 배열 (내부 배열을 직접 반환)

getColor()ColorRepresentation

컴포넌트가 출력하고있는 모델의 색상을 리턴합니다.

Returns:

Type	Description
ColorRepresentation	색상값, 색상값을 찾을 수 없다면 '' 빈문자열을 리턴합니다.

getContrast()number

이 컴포넌트에 설정한 대비 배율을 반환합니다.

Returns:

Type	Description
number	대비 배율. 기본값은 1입니다.

async getCumulativeInfo()Promise.<Array.<CumulativeInfo>>

전체 누적 정보 기록을 가져오는 함수

Deprecated

누적 이력은 더 이상 U3dComponentPosition 내부에 저장하지 않습니다. 클라이언트/서비스 단 이력을 사용하세요.

Returns:

Type	Description
Promise.<Array.<CumulativeInfo>>	빈 배열

async getCumulativeInfoByPoint(geo, world)Promise.<Map.<number, CumulativeInfo>>

Name	Type	Description
`geo`	GeoPositionVector3 \| undefined	위경도 좌표
`world`	WorldPositionVector3 \| undefined	월드 좌표

Deprecated

누적 이력은 더 이상 U3dComponentPosition 내부에 저장하지 않습니다. 클라이언트/서비스 단 이력을 사용하세요.

Returns:

Type	Description
Promise.<Map.<number, CumulativeInfo>>

getCumulativePath()U3dCumulativePath|undefined

컴포넌트 누적 경로를 반환하는 메서드입니다.

Returns:

Type	Description
U3dCumulativePath \| undefined	누적 경로가 없으면 undefined

getDepth()boolean

모델 재질의 깊이 버퍼 쓰기(depthWrite) 여부를 반환합니다. 첫 번째 재질 값을 대표로 사용합니다.

Returns:

Type	Description
boolean	depthWrite 값. 모델이나 재질이 없으면 true

getDistanceTraveled()number

애니메이션 동작시 컴포넌트가 현재까지 이동한 거리를 반환하는 함수

Returns:

Type	Description
number	현재까지 이동한 거리 (m). 주행 중이 아니면 0

getGeographicPosition()GeoPositionVector3

컴포넌트의 위경도 좌표를 반환하는 메서드입니다.

Returns:

Type	Description
GeoPositionVector3	위경도 좌표

getGeographicPositionByWorld(world)GeoPositionVector3

컴포넌트의 3D 월드 좌표(EPSG:3857)를 위경도 좌표(EPSG:4326)로 변환하는 메서드입니다.

Name	Type	Description
`world`	WorldPositionVector3	3D 월드 좌표

Returns:

Type	Description
GeoPositionVector3	위경도 좌표

getId()string|number

컴포넌트의 ID를 반환하는 함수

Returns:

Type	Description
string \| number	컴포넌트 ID

getInstanced()boolean

컴포넌트가 instanced 메시(같은 모델을 한 번의 드로우로 여러 개 그리는 방식)로 생성되었는지 반환하는 함수

Returns:

Type	Description
boolean	instanced 메시면 true

getLODMode()string

현재 LOD(카메라 거리 기반 자동 조정) 모드를 반환하는 함수

Returns:

Type	Description
string	`'none'` \| `'auto'` \| `'custom'`

getLayerName()string

컴포넌트가 속한 레이어의 이름을 반환하는 함수

Returns:

Type	Description
string	레이어 이름

getLookAtFromPitchRollYaw(distanceRate, pathPosition)Vector3|undefined

경로 진행률에 해당하는 시선 방향 목표 지점을 계산하는 함수 (경로 주행 중 카메라·모델이 바라볼 곳)

Name	Type	Description
`distanceRate`	number	경로 진행률 (0 시작점 ~ 1 끝점)
`pathPosition`	Vector3	경로상 현재 위치 (월드 좌표)

Returns:

Type	Description
Vector3 \| undefined	바라볼 위치 (월드 좌표). 경로가 없으면 undefined

getMatrix()Matrix4

컴포넌트의 변환 행렬(matrix)을 반환합니다. 부모가 있으면 부모 기준 상대 행렬입니다.

Returns:

Type	Description
Matrix4	변환 행렬

getMatrixWorld()Matrix4|undefined

모델의 월드 행렬을 반환하는 함수

Returns:

Type	Description
Matrix4 \| undefined	모델의 월드 행렬

getMaxVisibleDistance()number

'auto' LOD에서 컴포넌트가 표시되는 카메라 최대 거리를 반환하는 함수

Returns:

Type	Description
number	최대 가시화 거리 (m)

getMixerController()UComponentMixerController

모델 클립 믹서를 관리하는 컨트롤러를 반환합니다. 클립 목록 조회·재생·FPS 조절은 이 객체를 통해 이루어집니다.

Returns:

Type	Description
UComponentMixerController	믹서 컨트롤러

getModel()Object3D|undefined

컴포넌트 원본 모델 객체를 찾는 함수

Returns:

Type	Description
Object3D \| undefined	원본 모델 그룹

getModelName()string

생성시 참고한 model의 이름을 반환

Returns:

Type	Description
string

getName()string

컴포넌트의 이름을 반환하는 함수

Returns:

Type	Description
string	컴포넌트 이름

getObject()Object3D|undefined

컴포넌트의 모델 리소스를 반환하는 함수

Returns:

Type	Description
Object3D \| undefined	모델 데이터 리소스

getOpacity()number

컴포넌트가 출력하고있는 모델의 투명도를 리턴합니다.

Returns:

Type	Description
number	투명도값, 투명도값을 찾을 수 없다면 NaN 을 리턴합니다.

getOverlay()Array.<OverlayObject>

컴포넌트에 붙어 있는 오버레이 목록을 반환하는 메서드입니다.

Returns:

Type	Description
Array.<OverlayObject>	오버레이 배열 (내부 배열을 직접 반환)

getParam()ComponentParam

컴포넌트의 생성 파라미터값을 반환하는 함수

Returns:

Type	Description
ComponentParam	컴포넌트의 생성 파라미터값

getParent()U3dComponentPosition|undefined

setParent로 지정한 상위 컴포넌트를 반환합니다.

Returns:

Type	Description
U3dComponentPosition \| undefined	상위 컴포넌트. 없으면 undefined

async getPassedCumulativeInfo()Promise.<Array.<CumulativeInfo>>

Deprecated

누적 이력은 더 이상 U3dComponentPosition 내부에 저장하지 않습니다. 클라이언트/서비스 단 이력을 사용하세요.

Returns:

Type	Description
Promise.<Array.<CumulativeInfo>>	빈 배열

getPathOpacity()number

컴포넌트의 이동 경로 라인 투명도를 반환하는 함수

Returns:

Type	Description
number	투명도 (0~1)

getPitchYaw(lookAt, position)Euler

컴포넌트가 position에서 lookAt을 바라볼 때의 회전(pitch·yaw)을 계산하는 함수

Name	Type	Description
`lookAt`	WorldPositionVector3	바라보는 위치 좌표 (월드 좌표, EPSG:3857)
`position`	WorldPositionVector3	위치 좌표 (월드 좌표, EPSG:3857)

Returns:

Type	Description
Euler	회전 값 (라디안). 내부 공용 객체를 반환하므로 보관하려면 복사하세요

getPoiZOffset()number|undefined

POI의 Z(높이) 오프셋 값을 반환하는 메서드입니다.

Returns:

Type	Description
number \| undefined	라벨이 모델 위로 떠 있는 높이 (m). 라벨이 없으면 undefined

getPosition()GeoPositionVector3

컴포넌트 위경도 좌표를 반환하는 함수

Returns:

Type	Description
GeoPositionVector3	컴포넌트 위경도 좌표

getProperties()KeyValue

컴포넌트 속성 정보를 조회하는 함수

Returns:

Type	Description
KeyValue	속성 성보

Example

return {
    "관할구" : "서울특별시 구로구",
    "사용승인일" : "2022년 11월",
    "건축물 용도" : "아파트",
    "세대수" : "2500"
}

getRectangle()Object|undefined

현재 위치·회전·크기를 반영한 경계 상자(육면체)의 8개 꼭짓점을 월드 좌표로 반환합니다.
이름의 Down/Up은 z(높이) 최소/최대, Left/Right는 x 최소/최대, Top/Bottom은 y 최소/최대를 뜻합니다. 부수적으로 _bbox 캐시를 갱신합니다.

Returns:

Type	Description
Object \| undefined	꼭짓점 8개. 모델이나 회전 정보가 없으면 undefined

getRenderOrder()number|undefined

모델의 렌더 순서를 반환합니다.

Returns:

Type	Description
number \| undefined	렌더 순서. 모델이 없으면 undefined

getRotation()Euler

컴포넌트의 회전값을 반환하는 함수

Returns:

Type	Description
Euler	rotation 회전값 (radian)

getScale()Vector3

컴포넌트의 크기를 반환하는 함수

Returns:

Type	Description
Vector3	크기 {x,y,z} 값

getSpeed()number

애니메이션 시 컴포넌트의 이동속도를 반환하는 함수

Returns:

Type	Description
number	이동 속도 (km/h)

getStartAnimation()UAnimationController|undefined

startAnimationId에 해당하는 StartAnimation 대상을 반환합니다.

Returns:

Type	Description
UAnimationController \| undefined	대상 UAnimationController

getUpdateFunc()LOD_UpdateFunc|undefined

setUpdateFunc로 설정한 custom LOD 콜백을 반환하는 함수

Returns:

Type	Description
LOD_UpdateFunc \| undefined	설정된 콜백. 없으면 undefined

getVectorPosition()WorldPositionVector3

Deprecated

getWorldPosition() 메서드를 사용하세요 컴포넌트 3D 월드 좌표를 반환하는 함수

Returns:

Type	Description
WorldPositionVector3	컴포넌트 3D 월드 좌표

getWorldPosition()WorldPositionVector3

컴포넌트 3D 월드 좌표를 반환하는 함수

Returns:

Type	Description
WorldPositionVector3	컴포넌트 3D 월드 좌표

hasMixers()boolean

모델에 재생 가능한 애니메이션 클립(믹서)이 하나 이상 있는지 확인합니다.

Returns:

Type	Description
boolean	믹서가 있으면 true

hasOverlay(overlay)boolean

컴포넌트가 오버레이를 가지고 있는지 확인하는 메서드입니다.
파라미터로 overlay를 넣으면 해당 overlay가 있는지 검사합니다.

Name	Type	Description
`overlay`	OverlayObject	optional 검색할 대상 overlay. 없으면 아무 오버레이나 가지고 있는지 검사합니다.

Returns:

Type	Description
boolean	가지고 있으면 true, 없으면 false

hide()DeferredObject.<unknown>|undefined

컴포넌트 비가시화(hide) 함수

Returns:

Type	Description
DeferredObject.<unknown> \| undefined	표시 상태를 숨긴 경우 true로 resolve하며 이미 숨김 상태면 undefined

hideCumulativeRoute()

누적 경로(궤적)를 끄는(hide) 함수

hideLabel()

컴포넌트 라벨 POI을 화면에서 감추는(Hide) 메서드입니다.

isDisposed()boolean

컴포넌트가 해제되었거나 생성에 실패했는지 여부를 반환합니다. true인 객체는 다른 메서드를 호출해도 동작하지 않습니다.

Returns:

Type	Description
boolean	해제·생성 실패 상태면 true

isVisible()boolean

컴포넌트 가시화 상태를 반환하는 함수
가시화 상태면 true, 아니면 false

Returns:

Type	Description
boolean

isVisibleLabel()boolean

컴포넌트 라벨 POI의 가시화 여부를 반환하는 메서드입니다.
라벨 POI가 가시화 된 경우 true, 안된 경우 false를 반환한다.

Returns:

Type	Description
boolean	가시화 여부

movePause()

컴포넌트 주행/비행 애니메이션을 일시정지(Pause)하는 메서드입니다.

moveResume()

컴포넌트 주행/비행 애니메이션을 재개(Resume)하는 메서드입니다.

async moveSmoothly(opt, complete)Promise.<void>

현재 위치에서 목표 위경도 좌표까지 직선 구간을 매 프레임 보간하여 부드럽게 이동합니다.
이동 중 다시 호출되면 새 목표를 대기열에 추가하고, 앞선 목표에 도착한 뒤 순서대로 이동합니다. (웨이포인트 도착 보장) drawCumulativePath가 true이면 보간된 이동 위치를 누적 경로(궤적)로 기록합니다.

Name	Type	Default	Description
`opt`	MoveSmoothlyOpt	{}	optional moveSmoothly 옵션
`complete`	PassCallback		optional 각 목표 위치 도착 후 호출할 콜백. 이후 호출에서 새 콜백을 지정하기 전까지 같은 콜백을 사용합니다.

Returns:

Type	Description
Promise.<void>	이동 시작 또는 대기열 등록 처리가 끝나면 완료되는 Promise. 목표 위치 도착 완료를 의미하지 않습니다.

Example

목표 위치까지 1초 동안 보간 이동을 예약합니다.
const completedCallback = function ({name, key, distance, time}) {
    const message = `[${name}] ${key}번 목표 도착 · 누적 거리 ${distance.toFixed(2)}m · 경과 시간 ${(time / 1000).toFixed(2)}초`;
    console.info(message);
};

await component.moveSmoothly({
    position: {x: lon, y: lat, z: height},
    rotation: {x: 0, y: 0, z: 90},
    axis: 'relative',
    durationMs: 1000
}, completedCallback);

moveStart()

컴포넌트 주행/비행 애니메이션을 시작(Start)하는 메서드입니다.

moveStop(isInit)

컴포넌트 주행/비행 애니메이션을 종료(Stop)하는 메서드입니다.

Name	Type	Default	Description
`isInit`	boolean	false	optional 애니메이션 초기화 여부. true면 애니메이션을 종류 후 초기화합니다.

multiplyScale(num)

컴포넌트의 현재 크기에 배율을 곱하는 함수 (2면 두 배)

Name	Type	Description
`num`	number \| string	곱할 배율. 문자열은 숫자로 변환

offSelectHelperMesh()

onSelectHelperMesh로 표시한 궤적 강조 helper 메시를 숨깁니다.

onSelectHelperMesh()

누적 경로(궤적)의 선택 강조용 helper 메시를 표시합니다. 궤적 표시가 꺼져 있거나 궤적이 없으면 아무 동작도 하지 않습니다.

pickMaterial(intersect, color, opacity)boolean

컴포넌트를 선택했을 때 모델 전체를 지정 색상·투명도로 강조(highlight)하는 함수. restoreMaterial로 원래 재질을 복원합니다.

Name	Type	Description
`intersect`	unknown	픽킹 결과(교차 정보). 현재 구현에서는 사용하지 않으며 모델 전체가 강조됩니다
`color`	ColorRepresentation	optional 강조 색상 (기본 '#fe5f55')
`opacity`	number	optional 강조 투명도 (0~1, 기본 0.6)

Returns:

Type	Description
boolean	강조가 적용되면 true

predictFuturePositions(count)Array.<PredictedPosition>|undefined

최근 count개 도착 지점의 선형 추세로 1~count단계 뒤의 예측점과 예상 도착 시간을 배열로 반환합니다.
월드 좌표(EPSG:3857, m)에서 지점 순번에 대한 최소제곱 직선의 기울기를 구하고, 마지막 도착점부터 같은 변위로 단계마다 연장합니다. 한 단계는 과거 웨이포인트 한 구간에 대응하며 곡률·가감속·대기 중인 목표점은 반영하지 않습니다.
도착 시간은 최근 count개 도착의 평균 속도(총 이동 거리 ÷ 총 경과 시간)로 마지막 도착점에서 각 예측점까지의 거리를 나눠 구합니다. 각 원소의 time은 호출 시점부터 해당 지점 도착까지의 예상 경과 시간(ms, 반올림)이며, 이미 지난 것으로 계산되면 0, 평균 속도가 0이어서 도달 시각을 구할 수 없으면 Infinity입니다.
이력이 count개 미만이면 undefined를 반환합니다. 조회는 이력과 실제 이동 상태를 변경하지 않습니다. count가 숫자가 아니면 TypeError, 2~100 사이의 정수가 아니면 RangeError가 발생합니다.

Name	Type	Description
`count`	number	분석할 과거 지점 수이자 미래로 연장할 단계 수 (2~100 정수)

Returns:

Type	Description
Array.<PredictedPosition> \| undefined	1단계부터 count단계까지 순서대로 담은 `{point, time}` 배열. 이력이 부족하면 undefined

Example

const predicted = component.predictFuturePositions(10);
if (predicted) {
    const farthest = predicted[predicted.length - 1];
    const geographic = component.getGeographicPositionByWorld(farthest.point);
    console.log(`${farthest.time}ms 후 도착 예상`);
}

recordCumulativePathFrame(position, dist, time, speed, moveDistance)

현재 위치를 누적 경로에 기록한다. moveSmoothly, addMovePoint, setPosition 등 위치 변경 진입점에서 공통으로 사용한다.

Name	Type	Description
`position`	WorldPositionVector3	기록할 월드 좌표
`dist`	number	optional 애니메이션 컨트롤러 기준 누적 거리
`time`	number	optional 애니메이션 컨트롤러 기준 누적 시간(ms)
`speed`	number	optional 현재 속도(m/s)
`moveDistance`	number	optional 이번 프레임 이동 거리U

relocationObjects(relocationOffset, isCopy)

출력 모델을 구성하는 Mesh의 센터점으로 부터의 상대적 위치를 설정하는 메서드입니다.(센터점은 변경되지 않습니다.)

Name	Type	Default	Description
`relocationOffset`	Vector3		이동량 백터
`isCopy`	boolean	false	optional true면 relocationOffset 값으로 위치를 덮어쓰고, false면 현재 위치에 더합니다

Example

componentPosition.relocationObjects({x:0,y:0,z:1}, false); //센터점에서 Mesh들이 z축으로 1만큼 추가 이동
componentPosition.relocationObjects({x:0,y:0,z:1}, true); //센터점에서 Mesh들이 z축 1 죄표로 정렬

removeChild(child)

지정된 하위 계층 대상 제거하는 함수

Name	Type	Description
`child`	U3dComponentPosition	하위 계층 대상

removeCumulativeRoute()

누적 경로(궤적)를 제거하는 함수

removeLabel()

컴포넌트 라벨 POI를 제거하는 메서드입니다.

removeOverlay(overlay)

컴포넌트에 등록된 오버레이를 목록에서 제거하는 메서드입니다.

Name	Type	Description
`overlay`	OverlayObject	제거할 오버레이 객체 (`setOverlay`로 붙인 것)

removeParent()

지정된 상위 계층을 제거하는 함수

removeProperties(key)

컴포넌트 속성 정보를 제거하는 함수

Name	Type	Description
`key`	string	속성 정보 식별키

restart()

컴포넌트 주행/비행 애니메이션을 재시작(Restart)하는 메서드입니다.

restoreMaterial()

pickMaterial을 호출하여 강조한 색상을 복원합니다.

rotateByAngle(degree)

컴포넌트를 수직축(z축) 기준으로 지정 각도로 회전시키는 함수. 누적이 아니라 절대 각도로 설정됩니다.

Name	Type	Description
`degree`	Degree	회전 각도 (°, -360 ~ 360). 범위를 벗어나면 예외가 발생합니다

saveObjectSetting()

현재의 상태를 초기 상태로 저장합니다.

setBrightness(brightness)

모델의 밝기를 절대값으로 설정합니다. 반복 호출해도 기존 색상에 누적되지 않습니다. 1은 원래 밝기, 0은 검정이며 1보다 크면 밝아집니다. 대비보다 먼저 적용합니다. 일반·인스턴스 컴포넌트의 표준 Three.js 재질을 지원하며 사용자 ShaderMaterial은 제외합니다. 선택 강조 중에도 설정값은 보존되며, 선택을 해제하면 다시 적용됩니다. 숫자가 아니면 TypeError, 음수·비유한 값·Float32 표현 범위 초과이면 RangeError를 발생시킵니다.

Name	Type	Default	Description
`brightness`	number	1	optional 밝기 배율. 생략하면 기본값으로 복원합니다.

setCameraTrace(bool, view, offset, targetOffset)

컴포넌트로 카메라 추적 시점을 설정하는 메서드입니다.

Name	Type	Description
`bool`	boolean	카메라 추적 활성 여부. `true`면 카메라가 컴포넌트를 지정한 시점으로 실시간 추적하고, `false`면 추적을 중지합니다.
`view`	string	optional 카메라 시점 종류. `FrontView` : 대상의 정면에서 바라보는 시점 `TopView` : 대상의 위에서 내려다보는 시점 `ThirdPersonFront` : 3인칭 시점 (컴포넌트 앞면) `ThirdPersonRight` : 3인칭 시점 (컴포넌트 우측면) `ThirdPersonLeft` : 3인칭 시점 (컴포넌트 좌측면) `ThirdPersonBack` : 3인칭 시점 (컴포넌트 뒷면) `ThirdPersonRound` : 3인칭 시점 (컴포넌트를 기준으로 회전)
`offset`	Vector3Like	optional 카메라 위치 보정값 (x, y, z). 입력한 값만큼 카메라 위치를 이동시킵니다. 예: `{ x: 0, y: 0, z: 10 }` → 대상보다 10m에서 카메라가 따라감
`targetOffset`	Vector3Like	optional 카메라가 바라보는 지점의 보정값 (x, y, z). 생략 가능. 입력한 값만큼 카메라의 시선 방향을 이동시킵니다. 예: `{ x: 0, y: 0, z: 2 }` → 대상의 2m 위 지점을 바라봄

setChild(child)

하위 계층 대상을 설정하는 함수

Name	Type	Description
`child`	U3dComponentPosition \| ExtendedObject3D	하위 계층 대상 (컴포넌트 또는 확장 3D 오브젝트)

setCollisionDistance(distance)

주행 중 충돌로 판정할 거리를 설정하는 함수

Name	Type	Description
`distance`	number	충돌 감지 거리 (m, 기본 10)

setCollisionFunction(func)

주행 중 다른 객체가 충돌 감지 거리 안에 들어왔을 때 호출할 콜백을 지정하는 함수.

Name	Type	Description
`func`	function	`(component) => void` 형태의 콜백. 충돌한 컴포넌트가 전달됩니다

setColor(color)boolean

컴포넌트가 출력하고있는 모델의 색상을 설정 합니다.

Name	Type	Default	Description
`color`	ColorRepresentation	#ffffff	설정할 색상값

Returns:

Type	Description
boolean	색상이 적용되면 true, 모델이 없거나 적용에 실패하면 false

setContrast(contrast)

모델의 대비를 절대값으로 설정합니다. 1은 원래 대비이며 0은 중간 회색입니다. 밝기 적용 뒤 RGB의 0.5를 기준으로 조절하며 투명도는 변경하지 않습니다. 지원 재질·선택 강조·오류 처리는 setBrightness와 같습니다.

Name	Type	Default	Description
`contrast`	number	1	optional 대비 배율. 생략하면 기본값으로 복원합니다.

setCumulativePathStyle(opt)

누적 경로(궤적)의 스타일을 변경하는 함수

Name	Type	Description
`opt`	U3dCumulativePath_StyleOpt	변경 옵션

setDepth(depthWrite)boolean

모델의 모든 재질에 깊이 버퍼 쓰기(depthWrite)를 설정합니다. false로 두면 이 모델이 다른 객체의 깊이 판정에 영향을 주지 않아 반투명 객체가 겹칠 때 뒤쪽이 사라지는 현상을 줄일 수 있습니다. 첫 호출 시 원본 재질이 복원용으로 보관됩니다.

Name	Type	Default	Description
`depthWrite`	boolean	true	optional 깊이 버퍼 쓰기 여부

Returns:

Type	Description
boolean	항상 true

setEndAnimationFunc(func)

애니메이션 종료 시 호출할 사용자 함수 설정 메서드입니다.

Name	Type	Description
`func`	function	사용사 함수 (호출시 입력되는 파라메터: fnc( U3dComponentPosition ) )

setEndFnc()

Deprecated

2.2.1.10.180.d 부터 setEndAnimationFunc 으로 변경되었습니다.

setForceMoveTween(rate)

컴포넌트의 경로 이동 애니메이션 실행 중 강제로 위치를 이동 시키는 함수

Name	Type	Description
`rate`	number	이동 목표 비율. 0(시작점) ~ 1(종료점)

setHeight(height)

경로 주행 시 유지할 고도를 설정합니다. 설정하면 경로 좌표의 높이 대신 이 값이 z에 적용됩니다.

Name	Type	Description
`height`	number \| string \| undefined	유지할 높이 (월드 z, m). undefined면 경로 높이를 그대로 사용

setInitPathPositions(positions)

누적 경로(궤적)의 초기 좌표 값(이전 히스토리)을 설정하는 함수.

Name	Type	Description
`positions`	Array.<GeoPositionVector3>	위경도 좌표 배열

setLODMode(mode)

카메라 거리에 따른 자동 조정(LOD) 방식을 설정하는 함수. 매 프레임 update가 호출될 때 적용됩니다.

Name	Type	Description
`mode`	'none' \| 'auto' \| 'custom' \| string	`'none'` 조정 없음, `'auto'` 최대 가시화 거리 밖이면 숨김, `'custom'` `setUpdateFunc` 콜백 결과(가시화·색상·투명도 등) 적용. 그 외 값은 `'none'`으로 처리

setLabel(opt)

컴포넌트에 라벨 POI를 지정하는 메서드입니다.

Name Type Description

opt

object

POI 생성 옵션

Name	Type	Description
`position`	WorldPositionVector3	optional POI 포지션 (EPSG:3857)
`image`	string	optional POI 이미지 URL
`label`	string	optional POI 라벨

Example

component.setLabel({
    position: {x: 14130641.7349, y: 4511699.005533, z: 20.8},
    image: '이미지경로/이미지.jpg',
    label: '컴포넌트1'
});

setMaxVisibleDistance(dist)

LOD 모드가 'auto'일 때 컴포넌트를 표시할 카메라 최대 거리를 설정하는 함수. 카메라가 이보다 멀어지면 자동으로 숨겨집니다.

Name	Type	Description
`dist`	number	최대 가시화 거리 (m). NaN이면 기본값 1000으로 되돌립니다

setMixerFPS(fps)

모델 자체 애니메이션(클립)의 갱신 빈도를 설정하는 함수. 낮추면 먼 컴포넌트의 연산 부담이 줄어듭니다.

Name	Type	Description
`fps`	number	초당 갱신 횟수

setMixers(mixers)

모델 자체 애니메이션(클립)을 재생할 믹서 목록을 교체합니다. 이후 mixers·getAnimationClips는 새 목록을 기준으로 동작합니다.

Name	Type	Default	Description
`mixers`	Array.<AnimationMixer>	[]	optional 새 믹서 목록. 빈 배열이면 클립 재생이 없는 상태가 됩니다

setOpacity(opacity)boolean

컴포넌트가 출력하고있는 모델의 투명도를 설정 합니다.

Name	Type	Default	Description
`opacity`	number	1	optional 설정할 투명도 (0 투명 ~ 1 불투명)

Returns:

Type	Description
boolean	투명도가 적용되면 true, 모델이 없거나 적용에 실패하면 false

setOverlay(overlay)

컴포넌트에 오버레이(HTML 등 화면 요소)를 붙이는 메서드입니다. 붙인 오버레이는 컴포넌트가 이동할 때 함께 이동합니다.

Name	Type	Description
`overlay`	OverlayObject	붙일 오버레이 객체

setParent(parent)

상위 계층을 설정하는 함수 부모 / 자식 관계를 형성하여 부모의 형상관리 내용(위치, 회전, 크기, 가시화 여부)이 자식에게 반영

Name	Type	Description
`parent`	U3dComponentPosition	상위 계층 대상

setPathColor(color)

컴포넌트의 이동 경로 색상을 지정하는 함수

Name	Type	Description
`color`	ColorRepresentation	색상

setPathOpacity(opacity)

컴포넌트의 이동 경로 라인 투명도를 지정하는 함수

Name	Type	Description
`opacity`	number \| string	투명도 (0 투명 ~ 1 불투명). 문자열은 숫자로 변환

setPosition(position, lookAt, fixedOverlay)

컴포넌트의 위치를 지정하는 함수

Name	Type	Default	Description
`position`	WorldPositionVector3		3D 월드 좌표
`lookAt`	Vector3 \| undefined		optional 이동 후 바라볼 위치 (월드 좌표). 주면 그 방향으로 회전합니다
`fixedOverlay`	boolean	false	optional true면 오버레이를 현재 위치에 고정하고, false면 컴포넌트와 함께 이동시킵니다

setProperties(input)

컴포넌트 속성 정보를 설정하는 함수

Name	Type	Description
`input`	string \| UnknownRecord	속성 객체, 또는 JSON 문자열 (파싱해서 적용)

setRenderOrder(renderOrder)

모델의 렌더 순서를 설정합니다. 값이 클수록 나중에 그려져 같은 위치의 다른 객체 위에 보입니다.

Name	Type	Description
`renderOrder`	number	렌더 순서 (기본 0)

setRotation(rotation)

컴포넌트의 회전값을 지정하는 함수

Name	Type	Description
`rotation`	RadianEulerLike	회전값(radian)

setRotationRelative(rotation)

컴포넌트 회전 시 절대 축이 아니라 현재 컴포넌트의 회전 값 기준으로 회전시키는 함수

Name	Type	Description
`rotation`	DegreeEulerLike	회전각

setRotationX(degree)

컴포넌트의 x축 회전값을 지정하는 함수

Name	Type	Description
`degree`	Degree	x축 회전값 (degree)

setRotationY(degree)

컴포넌트의 y축 회전값을 지정하는 함수

Name	Type	Description
`degree`	Degree	y축 회전값 (degree)

setRotationZ(degree)

컴포넌트의 z축 회전값을 지정하는 함수

Name	Type	Description
`degree`	Degree	z축 회전값 (degree)

setScale(scalar)

컴포넌트의 크기를 지정하는 함수

Name	Type	Description
`scalar`	number \| string \| Vector3Like	스칼라 값 혹은 {x,y,z} 값

setSpeed(speed)

애니메이션 시 컴포넌트의 이동 속도를 지정하는 함수

Name	Type	Description
`speed`	number	이동 속도 (km/h). 1500을 넘으면 무시됩니다. 주행 중이면 다음 프레임부터 반영됩니다

setStartAnimationFunc(func)

애니메이션 시작 시 호출할 사용자 함수 설정 메서드입니다.

Name	Type	Description
`func`	function	사용사 함수 (호출시 입력되는 파라메터: fnc( U3dComponentPosition ) )

setStartFnc()

Deprecated

2.2.1.10.180.d 부터 setStartAnimationFunc 으로 변경되었습니다.

setUpdateAnimationFunc(func)

컴포넌트 주행/비행 애니메이션 업데이트 시 호출 할 사용자 함수 설정 메서드입니다.

Name	Type	Description
`func`	function	사용사 함수 (호출시 입력되는 파라메터: fnc(현재 위치, 현재 방향위치, 현재 회전, 이동거리, 총 이동거리) )

setUpdateFnc()

Deprecated

2.2.1.10.180.d 부터 setUpdateAnimationFunc 으로 변경되었습니다.

setUpdateFunc(func)

LOD 모드가 'custom'일 때 매 프레임 호출할 사용자 콜백을 설정하는 함수. 콜백이 반환한 LOD_Info의 가시화·색상·투명도·텍스처 제외 값이 컴포넌트에 적용됩니다.

Name	Type	Description
`func`	LOD_UpdateFunc	`(component, properties, cameraDistance(m), cameraDistanceSq) => LOD_Info` 형태의 콜백

settingOverlay(position)

컴포넌트의 오버레이들의 위치를 설정합니다.

Name	Type	Description
`position`	WorldPositionVector3	설정 위치 좌표 (월드 좌표)

show()DeferredObject.<unknown>|undefined

컴포넌트 가시화(show) 함수

Returns:

Type	Description
DeferredObject.<unknown> \| undefined	숨김 상태를 표시한 경우 true로 resolve하며 이미 표시 중이면 undefined

showCumulativeRoute()

누적 경로(궤적)를 켜는(show) 함수

showLabel()

컴포넌트 라벨 POI을 화면에 보여주는(Show) 메서드입니다.

startAction(key, fadeDuration, speed)

컴포넌트 모델 자체 애니메이션 클립(modelClip)을 동작시키는 함수

Name	Type	Default	Description
`key`	string		애니메이션 클립 식별 ID
`fadeDuration`	number	0.005	optional 재생 시작 전환에 걸리는 시간 (초)
`speed`	number		optional 재생 배율. 1이 원래 속도이며 생략하면 현재 속도를 유지합니다

Example

const clips = component.getAnimationClips();
const keys = Object.keys(clips);
for(let key of keys) {
    component.startAction(key);
}

startAllAnimation(fadeDuration)

Name	Type	Default	Description
`fadeDuration`	number	0.005	optional

Deprecated

startMixer 메서드를 사용하세요

startMixer()

컴포넌트의 내장 애니메이션 클립을 모두 동작시키는 함수

stopAction(key, fadeDuration)

컴포넌트 모델 자체 애니메이션 클립(modelClip)을 정지하는 함수

Name	Type	Default	Description
`key`	string		애니메이션 클립 식별 ID
`fadeDuration`	number	0.005	optional 정지 전환에 걸리는 시간 (초)

Example

const clips = component.getAnimationClips();
const keys = Object.keys(clips);
for(let key of keys) {
    component.stopAction(key);
}

stopAllAnimation(fadeDuration)

Name	Type	Default	Description
`fadeDuration`	number	0.005	optional

Deprecated

stopMixer로 메서드를 사용하세요

stopMixer()

컴포넌트의 내장 애니메이션 클립을 모두 정지하는 함수

update(camPos, isIdle, curTime)

매 프레임 호출되어 카메라 거리를 갱신하고 LOD 모드에 따라 가시화·스타일을 조정하는 함수. 보통 레이어가 호출합니다.

Name	Type	Description
`camPos`	Vector3	카메라 위치 (월드 좌표)
`isIdle`	boolean	카메라가 멈춰 있는지 여부. true면 LOD 계산을 생략합니다
`curTime`	number	optional 현재 시각 (ms). 믹서 FPS 조절에 사용

updateAction(key, speed, fadeDuration)

지정한 모델 애니메이션 클립을 재생하면서 재생 속도를 갱신하는 함수

Name	Type	Default	Description
`key`	string		실행하려는 애니메이션 클립 식별 ID (`getAnimationClips`의 키)
`speed`	number		optional 애니메이션 재생 배율. 1이 원래 속도이며 생략하면 현재 속도를 유지합니다
`fadeDuration`	number	0.005	optional 재생 전환에 걸리는 시간 (초)

Example

let component = componentLayer.getComponentByName('uam_01_1');
     let key = Object.keys(component.getAnimationList())[0];
     let animationInterval = setInterval(function (){
             selected.updateAnimation(key, 1);
         },10)

updateAnimation(key, speed, fadeDuration)

지정한 모델 애니메이션 클립을 재생하면서 재생 속도를 갱신하는 함수. updateAction과 같습니다.

Name	Type	Default	Description
`key`	string		실행하려는 애니메이션 클립 식별 ID (`getAnimationClips`의 키)
`speed`	number		optional 애니메이션 재생 배율. 1이 원래 속도이며 생략하면 현재 속도를 유지합니다
`fadeDuration`	number	0.005	optional 재생 전환에 걸리는 시간 (초)

Example

let component = componentLayer.getComponentByName('uam_01_1');
     let key = Object.keys(component.getAnimationList())[0];
     let animationInterval = setInterval(function (){
             selected.updateAnimation(key, 1);
         },10)

updateAnimationCameraTrace()

현재 isTrace 값을 모든 주행 애니메이션 컨트롤러에 전달해 카메라 추적 상태를 동기화합니다. setCameraTrace가 내부적으로 호출합니다.

updateCameraDistance(camPos)number

카메라와 컴포넌트 사이 거리를 다시 계산해 내부 캐시를 갱신하는 함수

Name	Type	Description
`camPos`	Vector3 \| undefined	카메라 위치 (월드 좌표). 없으면 거리를 무한대로 처리

Returns:

Type	Description
number	카메라 거리의 제곱 (m²)

updateCameraTrace(pathPosition, delayCount, count)Object

카메라 추적 중 매 프레임 카메라 위치·시선을 컴포넌트에 맞춰 갱신합니다. 주행 애니메이션이 내부적으로 호출합니다.

Name	Type	Description
`pathPosition`	Vector3	컴포넌트의 현재 위치 (월드 좌표)
`delayCount`	number	3인칭 회전 시점에서 회전을 지연시키는 프레임 수
`count`	number	현재까지 경과한 프레임 수

Returns:

Type	Description
Object	다음 프레임에 넘길 갱신된 delayCount·count

updateChildrenMatrix()

하위 계층 ( setChild ) 으로 등록된 대상들의 matrix를 반영해주는 함수

updateLabel()

컴포넌트 라벨 POI를 컴포넌트의 이름으로 갱신하는 메서드입니다.

updateMatrix()

부모가 있으면 부모 기준으로 자신의 변환 행렬을 다시 계산합니다. 부모의 위치·회전·크기를 바꾼 뒤 호출하면 자식이 따라갑니다.

Type Definitions

Box3WithCenterBox3 CPBox3CenterExt

중심 캐시가 붙은 Box3

ComponentChildObject3DObject3D ComponentChildExt InstancedComponent

컴포넌트 하위 3D 오브젝트 (Object3D + parent/setParent 확장)

ComponentParamobject

Properties:

Name Type Argument Description

name

string

컴포넌트 이름

object

string

컴포넌트 원본 3D 에셋 이름

geoPosition

GeoPositionVector3

컴포넌트 위경도 좌표

position

WorldPositionVector3

컴포넌트 월드 좌표 (EPSG:3857, m)

scale

Vector3Like

컴포넌트 크기 값

rotation

Euler | Object

컴포넌트 회전 값

visible

boolean

컴포넌트 가시화 여부

labelVisible

boolean

컴포넌트 라벨 가시화 여부

properties

U3dComponentPosition.types~UnknownRecord

컴포넌트 속성 정보

instanced

boolean

컴포넌트 메시 타입 (인스턴스 메시인지 아닌지)

overlay

Array.<U3dComponentPosition.types~OverlayObject>

컴포넌트에 등록된 오버레이 객체 리스트

lights

Array.<object>

컴포넌트에 등록된 조명의 getParam 결과 목록 (deprecated 기능)

style

object

컴포넌트에 설정된 스타일 정보

Properties

Name	Type	Argument	Default	Description
`color`	ColorRepresentation	<optional>		색상.
`opacity`	number	<optional>		투명도.
`brightness`	number	<optional>	1	밝기 배율. 0 이상이며 1은 원래 밝기입니다.
`contrast`	number	<optional>	1	대비 배율. 0 이상이며 1은 원래 대비입니다.
`depthTest`	boolean	<optional>		깊이 테스트 활성 여부. `false`면 다른 객체에 가려져도 항상 보입니다.
`depthWrite`	boolean	<optional>		깊이 버퍼 쓰기 여부. `false`면 다른 객체의 깊이에 영향을 주지 않습니다.
`renderOrder`	number	<optional>		렌더링 순서. 값이 클수록 나중에 그려져 앞에 표시됩니다.

parent

U3dComponentPosition.types~UnknownRecord

상위 계층 컴포넌트 정보

children

Array.<U3dComponentPosition.types~UnknownRecord>

하위 계층 컴포넌트 목록

movepointlist

Array.<GeoPosition>

컴포넌트 이동 좌표.

CumulativeInfoobject

DB & 누적 이력용 포맷

Properties:

Name	Type	Argument	Description
`world`	WorldPosition		월드 좌표
`geographic`	GeoPosition		위경도 좌표
`speed`	number		해당 지점의 속도 (km/h)
`sectionIndex`	number		지점이 속한 경로 구간 index (0부터)
`cumulativeDist`	number		시작점부터의 누적 이동 거리 (m)
`isPassed`	boolean	<optional>	컴포넌트가 이미 통과한 지점이면 true
`section`	number	<optional>	이전 지점부터 이 지점까지의 구간 거리 (m)
`time`	number	<optional>	시작부터 이 지점까지의 경과 시간 (ms)

CumulativePropertyobject

누적 경로 표시 및 도착 콜백 상태 속성

Properties:

Name	Type	Description
`lastPass`	number	마지막 통과 인덱스
`passCallback`	U3dComponentPosition.types~PassCallback \| null	통과 콜백
`precision`	number \| undefined	좌표 정밀도
`lastInfo`	U3dComponentPosition.types~CumulativeInfo \| undefined	초기 경로의 마지막 누적 정보
`initTime`	number	초기화 시각
`moveBaseDist`	number	이동 기준 누적 거리
`startPosition`	WorldPosition \| undefined	이동 시작 월드 좌표

ExtendedObject3DUMesh U3dComponentInstancedPosition ExtendedObject3DExt

setChild로 컴포넌트 아래에 붙일 수 있는 3D 오브젝트. UMesh 또는 instanced 컴포넌트에 show/hide 확장이 붙은 형태

GooglePositionWithCallbackGooglePosition GooglePositionCallbackExt

GooglePosition 타입의 callback 확장 타입

InstancedComponentU3dComponentInstancedPosition

같은 모델을 한 번에 여러 개 그리는 instanced 방식 컴포넌트. getInstancedId로 인스턴스 index를 얻을 수 있습니다.

LOD_Infoobject

LOD 업데이트 결과 정보

Properties:

Name	Type	Argument	Description
`visible`	boolean	<optional>	가시화 여부
`color`	ColorRepresentation	<optional>	색상
`opacity`	number	<optional>	투명도
`exceptTexture`	boolean	<optional>	텍스처 제외 여부

LOD_UpdateFunc()

LOD 모드가 'custom'일 때 매 프레임 호출되는 사용자 콜백. 컴포넌트, 속성 정보(getProperties), 카메라 거리(m), 카메라 거리 제곱을 받아 적용할 가시화·색상·투명도·텍스처 제외 값을 LOD_Info로 반환합니다.

LightLikeUSpotLight LightLikeExt

컴포넌트에 연결되는 조명 객체 (deprecated 기능인 getLights/setLights가 다루는 타입)

MoveSmoothlyOptobject

moveSmoothly 주행 옵션

Properties:

Name	Type	Argument	Default	Description
`opt.position`	GeoPosition	<optional>		목표 위경도 좌표. x는 경도(°), y는 위도(°), z는 고도(m)
`opt.rotation`	DegreeEulerLike	<optional>		이동을 예약할 때 적용할 회전각(°)
`opt.axis`	'absolute' \| 'relative'	<optional>	'absolute'	회전 기준. `'absolute'`는 절대 회전, `'relative'`는 현재 회전에 대한 상대 회전
`opt.durationMs`	number \| null	<optional>		목표 위치까지 보간 이동할 시간(ms). 0이면 다음 프레임에 목표 위치에 도착합니다. 양수이면 해당 시간 안에 도착을 보장하기 위해 이동 속도를 가변적으로 보간합니다. 생략하거나 null이면 이동 거리와 설정 속도로 소요 시간을 자동 계산하여 등속 이동합니다. 음수나 유한하지 않은 값이면 해당 목표를 등록하지 않습니다.

MutableMaterialMaterial MutableMaterialExt

변경 가능한 재질 확장 타입

OverlayObjectU3dOverlay OverlayExt

컴포넌트에 붙일 수 있는 오버레이(HTML 등 화면 요소). setOverlay/getOverlay가 다루는 타입

PassCallback()

moveSmoothly로 이동 중 저장된 지점을 통과할 때마다 호출되는 콜백

PassCallbackPayloadobject

moveSmoothly의 통과 콜백(PassCallback)에 전달되는 정보

Properties:

Name	Type	Description
`name`	string	컴포넌트 이름
`key`	number	몇 번째 통과인지 (1부터 증가)
`distance`	number	통과 시점까지의 누적 이동 거리 (m)
`time`	number	통과 시점까지의 누적 이동 시간 (ms). 애니메이션이 값을 주지 않으면 현재 시각(`Date.now()`)
`speed`	number	통과 시점의 속도 (km/h)

PathGeometryLikeU3dPathGeometry PathGeometryExt

경로 지오메트리 확장 타입 (curve/_pathOption 접근용)

PickableObject3DObject3D PickableObject3DExt

픽킹 가능한 3D 오브젝트 확장 타입

PoiLikeU3dPOI Object3D

라벨/POI 최소 스펙

Properties:

Name	Type	Description
`zOffset`	number	라벨이 모델 위로 떠 있는 높이 (m)
`setPosition`	function	라벨 위치를 월드 좌표로 이동

PredictedPositionobject

predictFuturePositions가 반환하는 예측 지점 한 건

Properties:

Name	Type	Description
`point`	WorldPositionVector3	예측된 월드 좌표 (EPSG:3857, m)
`time`	number	호출 시점부터 해당 지점 도착까지의 예상 경과 시간 (ms, 0 이상 정수). 평균 속도가 0이면 `Infinity`

RotatableGroupObject3D RotatableGroupExt

컴포넌트 루트 객체에서 사용하는 회전 확장 타입

SmoothAniContextU3dComponentPosition.types~UnknownRecord SmoothAniContextExt

moveSmoothly 내부 애니메이션이 프레임 사이에 공유하는 상태 (회전 사용 여부, 지연·경과 프레임 수, 대상 오브젝트 등)

U3dComponentAnimationInfoobject

조회된 애니메이션 정보

Properties:

Name	Type	Argument	Description
`animationId`	string		조회된 애니메이션 ID
`startAnimationId`	string \| undefined		시작 애니메이션 ID
`isRunning`	boolean		현재 실행 여부
`isPaused`	boolean		현재 일시정지 여부
`rate`	number		현재 진행률(0~1)
`speed`	number		현재 속도(km/h)
`speedMs`	number		현재 속도(m/s)
`distance`	number		현재 애니메이션 총 거리
`duration`	number		현재 애니메이션 목표 시간(ms)
`fixedSpeed`	string		`'등속'`(speed 고정) 또는 `'변속'`(duration에 맞춰 속도 보정)
`accumulatedDistance`	number		외부에 노출되는 누적 거리
`accumulatedTime`	number		외부에 노출되는 누적 시간(ms)
`waypointQueueSize`	number	<optional>	대기 중인 waypoint 개수

U3dComponentPositionArriveDataobject

컴포넌트가 이동 목표 지점에 도착했을 때 arrive 이벤트로 전달되는 이동 요약

Properties:

Name	Type	Argument	Description
`dist`	number	<optional>	도착까지의 누적 이동 거리 (m)
`time`	number	<optional>	도착까지의 누적 이동 시간 (ms)
`speed`	number	<optional>	도착 시점의 속도 (km/h)

U3dComponentPositionArriveEventobject

컴포넌트 도착(arrive) 이벤트 객체

Properties:

Name	Type	Argument	Description
`data`	U3dComponentPosition~U3dComponentPositionArriveData	<optional>	이동 요약 정보

U3dComponentPositionCOobject

U3dComponentPosition 생성자 옵션. componentlayer와 position은 필수이며 나머지는 생략 시 아래 기본값을 사용합니다.
좌표는 월드 좌표(EPSG:3857, m), 각도는 별도 표기가 없으면 도(°), 속도는 km/h입니다.

Properties:

Name	Type	Argument	Default	Description
`name`	string	<optional>		컴포넌트 이름. 생략 시 `loadedModel` 이름 또는 GUID
`id`	string	<optional>		컴포넌트 고유 ID. 생략 시 GUID
`type`	string	<optional>	'component'	컴포넌트 종류.
`object`	Object3D	<optional>		화면에 그릴 3D 모델 리소스. 없으면 위치만 있는 빈 컴포넌트가 됩니다
`objectOpacity`	number	<optional>	1	모델 리소스 기본 투명도 (0 투명 ~ 1 불투명)
`position`	Vector3			컴포넌트 위치 (월드 좌표 EPSG:3857, m)
`updateFunc`	U3dComponentPosition.types~LOD_UpdateFunc	<optional>		LOD 모드가 `'custom'`일 때 매 프레임 호출되는 콜백. 반환한 `LOD_Info`가 컴포넌트에 적용됩니다
`componentlayer`	U3dMultipleComponentLayer			컴포넌트가 출력될 컴포넌트 레이어. 해제된 레이어면 생성이 중단됩니다
`bbox`	Box3 \| Array.<number> \| null	<optional>		컴포넌트 경계영역(BoundingBox) 초기값. 없으면 모델에서 계산
`rotation`	Euler \| Object	<optional>		초기 회전. `Euler`는 라디안 그대로, `{x, y, z}` 객체는 도(°)로 해석하여 변환
`scale`	Vector3Like	<optional>		초기 크기 배율 `{x, y, z}`. 1이 원본 크기
`properties`	U3dComponentPosition.types~UnknownRecord	<optional>		사용자 정의 속성 정보 (getProperties로 조회)
`loadedModel`	string	<optional>		로드한 모델 리소스 이름. `name` 생략 시 이름으로 사용
`ext`	string	<optional>		모델 파일 확장자. `'jpg'`면 항상 카메라를 향하는 이미지 컴포넌트로 취급
`drawarg`	UDrawArg	<optional>		앱·씬·카메라 접근용 렌더 컨텍스트. 생략 시 레이어 값 사용
`loop`	string \| number	<optional>	THREE.LoopRepeat	모델 자체 애니메이션 재생 방식. `THREE.LoopRepeat`(반복) / `THREE.LoopOnce`(한 번) / `THREE.LoopPingPong`(왕복)
`mixers`	Array.<AnimationMixer>	<optional>		모델 자체 애니메이션(클립) 믹서 목록
`mixerAutoFps`	boolean	<optional>	true	카메라 거리에 따라 클립 갱신 빈도를 자동으로 낮출지 여부
`mixerDistanceFpsLevels`	Array.<U3dComponentPosition.types~UnknownRecord>	<optional>		거리 구간별 클립 갱신 FPS 설정
`drawpath`	boolean	<optional>	false	주행 경로 라인을 화면에 표시할지 여부
`drawRealPath`	boolean	<optional>	false	실제 이동 경로 메시를 표시할지 여부
`drawPolygon`	Object3D \| U3dComponentPosition.types~UnknownRecord	<optional>		`'crowd'` 타입이 돌아다닐 폴리곤 영역
`typepath`	string	<optional>	'cube'	경로 표시 타입. 현재 `'cube'`만 지원
`pathColor`	ColorRepresentation	<optional>	'rgb(255,255,255)'	경로 라인 색상
`pathOpacity`	number	<optional>	1	경로 라인 투명도 (0~1)
`pathopacity`	number	<optional>		`pathOpacity`의 구버전 이름. 둘 다 있으면 `pathOpacity` 우선
`updateDistance`	number	<optional>	100	주행 중 `updateAnimationFunc` 콜백을 호출하는 이동 간격 (m)
`updateAngle`	number	<optional>	90	주행 중 방향 갱신을 판단하는 기준 각도 (°)
`usetruthpath`	boolean	<optional>	false	입력 좌표를 곡선 보정 없이 그대로 경로로 사용할지 여부
`repeat`	boolean	<optional>	false	주행 애니메이션이 끝나면 처음부터 반복할지 여부
`addstartend`	boolean	<optional>	false	입력 좌표를 경로의 시작/끝점으로 자동 추가할지 여부
`image`	string	<optional>		경로 라인에 입힐 텍스처 이미지 URL
`speed`	number	<optional>	700	주행 이동 속도 (km/h)
`topviewdistance`	number	<optional>	1000	카메라를 TopView(위에서 따라가기)로 추적할 때 모델과 카메라 사이 거리 (m)
`curvetension`	number	<optional>	0.01	경로 곡선 장력 (0~1). 작을수록 완만한 곡선
`pathwidth`	number	<optional>	185	경로 메시 폭 (m)
`pathedge`	boolean	<optional>	true	경로 메시 외곽선 표시 여부
`pathHeight`	number	<optional>	30	경로 메시 높이 (m)
`buffer`	number	<optional>		경로 버퍼 거리 (m)
`layerScale`	Vector3	<optional>		레이어가 모델에 적용한 기본 스케일. 계층 구조 계산에 사용
`layerRotation`	Euler	<optional>		레이어가 모델에 적용한 기본 회전. `rotation`이 없을 때 초기 회전으로 사용
`scene`	Scene	<optional>		컴포넌트를 그릴 씬. 생략 시 레이어의 씬
`lightList`	Array.<U3dComponentPosition.types~UnknownRecord>	<optional>		컴포넌트에 연결할 조명 목록 (deprecated 기능)
`viewList`	Array.<U3dComponentPosition.types~UnknownRecord>	<optional>		컴포넌트에 연결할 뷰 목록 (deprecated 기능)
`collisiondistance`	number	<optional>	10	주행 중 충돌로 판정할 거리 (m)
`collisionFunction`	function	<optional>		충돌 감지 시 호출되는 콜백. 충돌한 컴포넌트가 전달됩니다
`startFnc`	function	<optional>		`startAnimationFunc`의 구버전 이름 (사용 시 안내 메시지 출력)
`updateFnc`	function	<optional>		`updateAnimationFunc`의 구버전 이름 (사용 시 안내 메시지 출력)
`endFnc`	function	<optional>		`endAnimationFunc`의 구버전 이름 (사용 시 안내 메시지 출력)
`startAnimationFunc`	function	<optional>		주행 애니메이션 시작 시 호출되는 콜백. 컴포넌트가 전달됩니다
`updateAnimationFunc`	function	<optional>		주행 중 `updateDistance`마다 호출되는 콜백. `(현재 위치, 방향 위치, 회전, 이동 거리, 총 이동 거리)`가 전달됩니다
`endAnimationFunc`	function	<optional>		주행 애니메이션 종료 시 호출되는 콜백. 컴포넌트가 전달됩니다
`setInstanced`	boolean	<optional>	false	같은 모델을 한 번에 여러 개 그리는 instanced 메시로 생성할지 여부
`hovering`	boolean	<optional>	true	경로 주행 시작·종료 시 호버링(수직 상승·하강) 애니메이션을 사용할지 여부
`useOriginRoute`	boolean	<optional>	false	입력 경로를 상대 좌표로 보정하지 않고 원본 좌표 그대로 사용할지 여부
`precision`	number	<optional>		누적 경로 좌표를 기록할 때 반올림할 소수 자릿수. 생략 시 반올림하지 않음
`drawCumulativePath`	boolean	<optional>	false	주행 중 이동한 궤적(누적 경로)을 화면에 그릴지 여부
`pathStyle`	U3dCumulativePath_StyleOpt	<optional>	{}	누적 경로 스타일 (선 타입, 색상 그라데이션, 좌표 보정 등)
`LODMode`	'none' \| 'auto' \| 'custom'	<optional>	'none'	카메라 거리 기반 자동 조정 방식. `'auto'`는 `maxVisibleDistance` 밖이면 숨김, `'custom'`은 `updateFunc` 결과 적용
`maxVisibleDistance`	number	<optional>	1000	`'auto'` LOD에서 컴포넌트를 표시할 카메라 최대 거리 (m)

UnknownRecordRecord.<string, unknown>

키-값 형태의 일반 속성 객체