GeOnDT for JS API

Class: U3dVectorTileLayer

U3dVectorTileLayer

~extends U3dModelTilesLayer.js~U3dModelTilesLayer
3D VectorTile 레이어 클래스

new U3dVectorTileLayer(opt)

Name	Type	Description
`opt`	U3dVectorTileLayerCO

Tutorials:

Tutorial: https://3d.geon.kr/doc/tutorial-official/vectorTile.html

Example

var modellayer = new Union3D.model.U3dVectorTileLayer({
    name: name,
    useproxy: true,
    baseurl: "https://skymaps.co.kr/map/tileset/magok_sim_25_draco/tileset.json",
    ext: '.vctr', //레이어 모델 포맷
    minlevel: 17, // 가시화 최소 레벨
    maxlevel: 19, // 가시화 최대 레벨
    apikey: "?api_key=66dd0019-905a-4d66-a0b7-eed7c418dbf0"
  });
  app.addLayer(modellayer);
  app.showLayer(name, true);

Members

g_useOriginboolean

Methods

addGroup(tile, updateId)

타일의 mesh 그룹을 scene에 추가하고 POI 가시 상태를 갱신

Name	Type	Description
`tile`	U3DTileset	추가할 타일
`updateId`	number	optional 업데이트 ID

addParserQueue(fnc, param)DeferredObject.<U3DTileset>

모델 타일 기본 클래스가 만든 requestState를 포함한 파서 파라미터를 그대로 상위 큐에 전달합니다. 따라서 VCTR 파서 선택 방식은 유지하면서도 다운로드 단계의 타일별 요청 소유권과 dispose 상태를 잃지 않습니다. VCTR 자체의 세대 판정·파싱 결과 정리 정책은 이 메서드가 아니라 _parseVCTR()의 별도 책임입니다. fnc는 상위 메서드와 같은 오버라이드 인터페이스를 유지하기 위해 받지만, VCTR 타일에서는 이 레이어 전용 _parseVCTR()로 교체하므로 사용하지 않습니다. VCTR이 아닌 타일은 별도 파싱 없이 완료된 DeferredObject를 반환하는 기존 동작을 유지합니다.

Name	Type	Description
`fnc`	function	기본 레이어와 같은 반환 계약을 따르는 파서 함수. VCTR 분기에서는 전용 파서로 교체됩니다.
`param`	ModelTileParserQueueItem	파서 파라미터

Returns:

Type	Description
DeferredObject.<U3DTileset>	비동기 처리 객체

addVisibleState(mesh)boolean

POI를 가시 상태 맵에 등록하고 중복 위치의 경우 숨김 처리

Name	Type	Description
`mesh`	U3dPOI	등록할 POI 객체

Returns:

Type	Description
boolean	등록 성공 여부

deallocateMesh(mesh)

mesh 메모리 해제 및 가시 상태 맵에서 제거

Name	Type	Description
`mesh`	Object3D	해제할 mesh

deleteMesh(mesh)

mesh 삭제 및 가시 상태 맵에서 제거

Name	Type	Description
`mesh`	Object3D	삭제할 mesh

isUpdateVCTRPoint(vctr, tile, campos)boolean

VCTR 포인트의 업데이트 가시화 여부를 판단

Name	Type	Description
`vctr`	U3dPOI	POI 객체
`tile`	U3DTileset	소속 타일 정보
`campos`	Vector3	카메라 위치

Returns:

Type	Description
boolean	업데이트(가시화) 여부

removeVisibleState(mesh)

POI를 가시 상태 맵에서 제거하고 다음 후보를 가시화

Name	Type	Description
`mesh`	U3dPOI	제거할 POI 객체

search(name)Array.<{mesh: U3dPOI, position: (Vector3|undefined)}>

이름으로 POI 검색

Name	Type	Description
`name`	string	검색할 이름 (부분 일치)

Returns:

Type	Description
Array.<{mesh: U3dPOI, position: (Vector3\|undefined)}>	검색 결과 목록

searchTiles(tile, updateId)

타일 트리를 재귀 탐색하며 가시 타일을 씬에 추가

Name	Type	Description
`tile`	U3DTileset	탐색 시작 타일
`updateId`	number	업데이트 ID

setFont(font)

label의 font family 설정

Name	Type	Description
`font`	string	font family문자열

setFontSize(size)

label의 폰트 크기 설정

Name	Type	Description
`size`	number	폰트 크기 (px)

setHeightOffset(offset)

vctr 생성시 높이 임계값

Name	Type	Description
`offset`	number	높이 임계값

update(drawArg, curTime, force)

Name	Type	Default	Description
`drawArg`	UDrawArg
`curTime`	number		현재 시간
`force`	boolean	false	optional 강제 업데이트 여부

Type Definitions

U3dVectorTileLayerCOobject

~extends U3dModelTilesLayer~U3dModelTilesLayerCO
생성자 옵션

Properties:

Name	Type	Argument	Default	Description
`baseurl`	string			Tiles 데이터 URL
`name`	string			레이어 이름
`font`	string	<optional>	'Roboto, "Noto Sans KR", Arial'	폰트 패밀리
`fontSize`	number	<optional>	17	폰트 크기
`imgUrl`	string	<optional>		label 또는 point 객체의 이미지 파일 경로 주소
`imgExt`	string	<optional>		label 또는 point 객체의 이미지 파일 확장자
`clusterRadius`	number	<optional>	50	공간 좌표를 기반으로 그룹화하기 위해 사용하는 반경 값 ( 값이 작을수록 더 세밀한 그룹화가 이루어지고, 값이 클수록 더 넓은 그룹화가 이루어집니다. )
`cacheSize`	number	<optional>		캐시 크기