> For the complete documentation index, see [llms.txt](https://egiscorp.gitbook.io/xdworld-webgl-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://egiscorp.gitbook.io/xdworld-webgl-manual/introduce/release/update_2.x.x.md). # 2.x 버전 업데이트 ## - 업데이트 내역 - ### 2.30.2 (2026/09/22) #### 1. 3D Tiles 관련 안정화 작업을 진행하였습니다. #### 2. JSFlood 부동소수점 오차 개선 * JSFlood 처리 과정에서 발생하는 부동소수점 오차를 개선하였습니다. #### 3. 레이어 순서 관련 렌더링 오류 수정 * 레이어 순서가 타입에 관계 없이 뒤섞여 렌더링되는 경우, 지형 편집과 같은 RTT 관련 기능에서 렌더링이 정상적으로 처리되지 않는 문제를 수정하였습니다. ### 2.30.1 (2026/09/14) #### 1. 파티클 투명처리 오류 수정 * 파티클 이미지의 투명 처리 추가 * 처음 하나의 입자에만 크기, 속도 등 옵션 적용되던 현상 수정 #### 2. 불꽃 효과 추가 * 불꽃축제 효과 추가 * 불꽃 가시율 분석 추가 #### 3. 시곡면 분석 예외처리 * 처음 분석 실행 후 같은 위치에 분석 실행 시 깜빡이는 현상 수정 #### 4. DataVisualizer 화면 고정 크기 모드 오류 수정 ([이슈 #614](https://github.com/EgisCorp/XDWorld/issues/614)) * 화면 고정 크기 모드 적용 시 뷰포트 사이즈에 따라 마커의 크기가 변하는 오류를 수정하였습니다. #### 5. 폴리곤 객체 Clipping Box 기능 추가 * 폴리곤 객체를 잘라서 특정 부분만 렌더링 하는 기능을 추가하였습니다. * MML\_EDIT\_CLIPPINGBOX 마우스 모드로 Clipping Box를 조작할 수 있습니다. ```javascript Module.setClippingBoxPosition(new Module.JSVector3D(longitude, latitude, altitude)); Module.XDSetMouseState(Module.MML_EDIT_CLIPPINGBOX); Module.setClippingBoxMode(0); // translate // Module.setClippingBoxMode(2); // scale var polygon = Module.createPolygon(); // ... polygon.setClipping(true); polygon.setClippingAlpha(0.3); ``` ### 2.30.0 (2026/09/07) #### 1. 그림자 효과 개선 * 경계부분이 각져보이는 현상을 개선하였습니다. * 햇빛과 수평한 면에서 깜빡거리는 현상을 개선하였습니다. #### 2. glTF 애니메이션 수정 * 애니메이션 전환 시 애니메이션이 없는 노드는 원본 변환행렬을 사용하도록 수정하였습니다. #### 3. 지형 편집 사면 RTT 영역 개선 * 지형 편집의 사면에 대한 RTT 영역이 보다 정확하게 칠해지도록 개선하였습니다. ### 2.29.4 (2026/09/02) #### 1. 수인한도분석 오류 수정 * 영역 입력 후 균일하게 격자 생성할 경우 간헐적으로 격자 깨지는 현상 및 분석 오류 수정 #### 2. 가시권 분석 가시 판정 수정 * 가시권 분석 시 메인 카메라가 아닌 분석 시야를 기준으로 가시 여부를 판정하도록 수정하였습니다. #### 3. CJSTraceTarget::setAutoRotate API 추가 * Trace Target을 설정한 객체가 카메라 뷰 방향을 따라 회전하는 기능을 해제할 수 있도록 하는 API를 추가하였습니다. ```javascript var traceTarget = Module.createTraceTarget(model.getId()); traceTarget.setAutoRotate(false); // 자동 회전 해제 ``` ### 2.29.3 (2026/08/28) #### 1. GPU 외장, 내장 판단 * True 반환 조건 * 내장 GPU 사용중이고 외장 GPU가 있을 경우 * False 반환 조건 * 외장 GPU 사용중일 경우 * GPU가 1개일 경우 * 판별이 안될 경우 * 기본적으로 True일 경우 console 창에 경고 로그 출력 * `Module.isDiscreteGPUUnused();` API 사용하여 확인 가능 * Engine Load 후 WebCode에서 메시지 창 띄우기 가능 ```javascript if (Module.gpuInfoReady) { Module.gpuInfoReady.then(function (info) { if (!info.needNotice) return; var head = (info.noticeLevel === "certain") ? "이 PC에는 외장 그래픽카드가 있지만 현재 내장 그래픽(" + info.renderer + ")으로\n지도를 렌더링하고 있습니다." : "현재 내장 그래픽(" + info.renderer + ")으로 지도를 렌더링하고 있습니다.\n외장 그래픽카드가 있다면 아래 설정으로 성능을 높일 수 있습니다."; // 메시지창 띄우기 alert(head + "\n\n" + "Windows 설정 > 시스템 > 디스플레이 > 그래픽 > 브라우저 추가 > 옵션 > '고성능'\n" + "선택 후 브라우저를 완전히 종료했다가 다시 실행해 주세요."); }); } ``` #### 2. Voxel 성능 향상 * 사용방법은 샌드박스 샘플 참고 - [Voxel](https://sandbox.egiscloud.com/code/main.do?id=effect_voxel) - [WildfireSpread](https://sandbox.egiscloud.com/code/main.do?id=analysis_wildfire_spread) - [typhoon](https://sandbox.egiscloud.com/code/main.do?id=weather_typhoon) #### 3. DataVisualizer Line 객체의 offset 설정 ([이슈 #586](https://github.com/EgisCorp/XDWorld/issues/586)) * 동일한 위치로 겹치는 라인 간 z-fight 방지를 위하여 객체 간 offset 순서 설정 #### 4. Gaussian Splater * Gaussian Splatting 기능 추가 * [Gaussian Splat](https://sandbox.egiscloud.com/code/main.do?\&id=object_gaussian_splats) #### 5. PlanerImage * 행성 이미지 적용 (달, 화성, 목성 등등) * [Planet Image](https://sandbox.egiscloud.com/code/main.do?\&id=terrain_planet_image) #### 6. 렌더링 후처리 기능 추가 * 화면에 최종적으로 표출되는 씬이미지에 후처리를 통한 효과를 추가 * JSPostProcess API 클래스 추가 * 피사계심도 (DoF, Depth of Field) / Bloom / Sharpen 효과 추가 * 주요 사용법은 [메뉴얼](https://github.com/avamk2/XDWorld_WebGL/issues/355#issue-5209387230) 및 [샌드박스 참고](https://sandbox.egiscloud.com/code/main.do?\&id=postprocess_render_effect) #### 7. 투명도 (알파블랜딩) 개편 * 기존 투명기능에서 투명객체의 정렬 문제로 표현되거나 사라지는 팝인 현상에 대한 개편 * 사용법은 [샌드박스 참고](https://sandbox.egiscloud.com/code/main.do?\&id=option_alphablend_mode) #### 8. JSFlood z-fighting 현상 개선 * 물판과 지형의 z-fighting 현상을 개선하였습니다. * 카메라 확대 시 물판이 사라지는 문제를 수정하였습니다. #### 9. Impostor Rendering * 멀리 있는 3D 건물은 실제 3D 모델을 직접 렌더링하는 대신 Impostor로 대체하여 화면에 표현합니다. 이를 통해 복잡한 건물의 버텍스를 직접 렌더링하는 비용을 줄이고 전체적인 렌더링 성능을 향상시킬 수 있습니다. * Impostor 적용 조건은 다음과 같습니다. * 카메라 시점이 지면 기준 45° 이하로 낮게 눕혀진 경우 * 해당 객체의 화면상 렌더링 크기가 64px 이하 * 객체의 정점(Vertex) 수가 100pt 이상 * 즉, 작게 보이면서 복잡한 3D 객체를 대상으로 실제 모델 대신 Impostor를 사용합니다. * 참고 : #### 10. 레이어 타입에 상관없이 순서 변경 가능 [이슈 #587](https://github.com/EgisCorp/XDWorld/issues/587) * 기존에는 사용자 레이어끼리만 순서 변경이 가능하고 서비스 레이어끼리만 순서 변경이 가능 * 레이어 타입에 상관없이 모든 레이어에 대해서 순서 변경 가능하도록 수정 #### 11. 수인한도분석 비동기 처리 [이슈 #589](https://github.com/EgisCorp/XDWorld/issues/589) * 기존에는 동기처리되어 분석 실행시 브라우저가 멈추는 현상 발생 * 비동기 처리로 변경하여 분석 실행시 브라우저 멈추는 현상 없음 #### 12. 태양광 패널 배치 오류 수정 [이슈 #590](https://github.com/EgisCorp/XDWorld/issues/590) * 기존에는 건물타입 객체에만 생성 가능 * 고스트심볼, GLTF, 3DS 등 다른 객체 타입에도 생성 가능하도록 수정 #### 13. Datavisualizer 데이터 오류 예외처리 [이슈 #594](https://github.com/EgisCorp/XDWorld/issues/594) * 기존에는 잘못된 데이터 좌표가 들어와도 수용하여 전체 객체에 영향을 미침 * 잘못된 좌표가 들어와도 인스턴스 객체 중점 방식을 보완하여 다른 객체에 영향을 못 끼치도록 수정 #### 14. 객체 외곽선 랜더링 오류 수정 [이슈 #596](https://github.com/EgisCorp/XDWorld/issues/596) * 외곽선 생성 로직 누락되어 추가 #### 15. 서버기반 경사도,경사향,고도 분석 [이슈 #600](https://github.com/EgisCorp/XDWorld/issues/600) * 기존에는 화면에 로딩된 지형레벨에 대해서만 분석 가능 * 로딩되지 않아도 분석 원하는 지형레벨에 대해서 분석 실행 * 멀리서 또는 화면에 안보이는 지역에 대해서도 분석 가능 #### 16. 지형 편집 오류 수정 ([이슈 #593](https://github.com/EgisCorp/XDWorld/issues/593), [이슈 #599](https://github.com/EgisCorp/XDWorld/issues/599)) * 서버 dem 레벨을 초과하는 지형에 대해 실시간 지형 편집 및 원복이 동작하지 않는 문제를 수정하였습니다. * 성토 시 사면이 생성되지 않는 오류를 수정하였습니다. * 바닥면이 주변 지형의 중간 높이로 설정되었을 때, 성절토가 동시에 적용될 수 있도록 개선하였습니다. ### 2.29.2 (2026/08/11) #### 1. GLTF 모델 이동 위치 정보 갱신 개선 ([이슈 #580](https://github.com/EgisCorp/XDWorld/issues/580)) * GLTF 모델을 Trace Target으로 설정하여 이동할 때 내부 Bounding Box 위치가 갱신되지 않는 문제를 수정하였습니다. * 이로 인해 model.position 및 model.getCenter()에서 실제 모델의 이동 위치가 정상적으로 반환되지 않는 문제를 수정하였습니다. #### 2. 2D 가시권 분석 결과 갱신 API 추가 ([이슈 #581](https://github.com/EgisCorp/XDWorld/issues/581)) * 레이어의 가시성 변경 후 기존 2D 가시권 분석 결과를 현재 레이어 상태를 기준으로 다시 계산할 수 있는 updateViewshed() API를 추가하였습니다. ```javascript buildingLayer.setVisible(false); // 레이어 가시성 변경 Module.getAnalysis().updateViewshed(); // 현재 레이어 상태 기준으로 가시권 재계산 ``` #### 3. 3D 가시권 생성 동작 개선 ([이슈 #584](https://github.com/EgisCorp/XDWorld/issues/584)) * `setVFCreateClickMode(true)` 사용 시 드래그 동작에서 가시권이 생성되는 문제를 수정하였습니다. * 단순 클릭 시에만 가시권이 생성되도록 동작을 개선하였습니다. ### 2.29.1 (2026/08/05) #### 1. 사용자 레이어 객체 시점 이동 기능 개선 * 사용자 레이어 객체로 시점 이동이 간헐적으로 동작하지 않는 문제를 수정하였습니다. * 사용자 레이어 객체로 시점 이동 시 바라보는 방향이 올바르게 설정되지 않는 문제를 수정하였습니다. #### 2. 면적 측정 기능 개선 * `MML_ANALYS_AREA` 마우스 모드에서 면적 측정 시 폴리곤 및 외곽선이 지형에 결합되지 않는 문제를 수정하였습니다. ### 2.29.0 (2026/08/03) #### 1. POI 텍스트 라벨링 및 아이콘 이미지 선명도 개선 #### 2. JSPolygon blob 방식 처리 추가 * JSPolygon::loadFile API에 data 속성을 통한 blob 처리 추가 ``` async function load3DSa(_url, _position) { const response = await fetch(_url); if(response.ok == false) { throw new Error( `HTTP 오류: ${response.status} ${response.statusText}` ); } const arrayBuffer = await response.arrayBuffer(); let blob = new Uint8Array(arrayBuffer); // Create polygon layer var layerList = new Module.JSLayerList(true); var layer = layerList.createLayer("POLYGON_3DS_LAYER", Module.ELT_POLYHEDRON); var polygon = Module.createPolygon("POLYGON_3DS_LOAD"); polygon.loadFile({ type : "3ds", // 3ds 포맷 명시 position : _position, data : blob, // fetch로 가져온 Uint8Array 버퍼 align : "bottom", callback : function() { // Texture 로딩이 필요하면 기존방식 추가 처리 layer.addObject(polygon, 0); } }); return polygon; } ``` ### 2.28.3 (2026/07/23) #### 1. 지구본에서 RTT 렌더링시 간헐적 희게 번지는 현상을 수정하였습니다. #### 2. POI 중첩표현시 객체 선택 및 선택 순서 오류를 수정하였습니다. #### 3. Figure 객체 이미지 회전 문제 수정 ([이슈 #573](https://github.com/EgisCorp/XDWorld/issues/573)) * Figure 객체를 스케일 UI를 통해 크기를 변경하는 경우 오버랩 된 이미지가 회전되는 문제를 수정하였습니다. #### 4. 지형 로딩 전 지형 편집 시 편집 내용 미적용 문제 수정 ([이슈 #575](https://github.com/EgisCorp/XDWorld/issues/575)) * 지형이 로딩되기 전에 편집을 진행하더라도, 지형 로딩이 완료되면 편집 내용이 정상적으로 적용되도록 수정하였습니다. ### 2.28.2 (2026/07/08) #### 1. 3DTiles의 높이값을 변경하는 API 오류를 수정하였습니다. #### 2. 3DTiles 네트워크 안정화 작업을 수행하였습니다. ### 2.28.1 (2026/07/07) #### 1. 3DTiles 안정화 작업을 수행하였습니다. ### 2.28.0 (2026/07/06) #### 1. JSPolygon getCoordinates API 기능 개선([이슈 #569](https://github.com/EgisCorp/XDWorld/issues/569)) * JSPolygon의 `move`, `moveAltitude`, `setRotate`, `setScale` API를 통해 좌표가 변경된 경우 getCoordinates로 반환되는 좌표 값이 갱신되도록 기능을 개선하였습니다. #### 2. Catmull-Rom 곡선 생성 API 추가 * 모든 입력 좌표를 지나는 부드러운 곡선을 생성할 수 있는 API가 추가되었습니다. * 기존 베지어 곡선 생성 API는 시작점과 끝점을 제외한 나머지 점들은 곡선이 지나지 않습니다. * 내비게이션 및 카메라 이동 경로 생성에 적합합니다. ```javascript var coord = [ [lon, lat, alt], [lon, lat, alt], // ... [lon, lat, alt] ]; var parameters = { coordinates : { coordinate : coord, style : "XYZ" }, alpha: 0.5, // default: 0.0 (0~1, 곡선의 안정성. 0.5일 때 가장 안정적) tension: 0.5, // default: 0.0 (0~1, 값이 클수록 직선에 가까워짐) samples: 10, // default: 20 (구간당 생성할 샘플 좌표 수) simplify: true, // default: false (근접 좌표 단순화 적용 여부) epsilon: 0.5, // default: 0.5 (simplify 적용 시 단순화 거리 임계값) union: true, // default: false (지형 결합 여부) height: 1.5 // default: 0.0 (지형 결합 시 지형으로부터의 높이) } var catmullrom = Module.getMath().convertCatmullRom(parameters); var catmullrom.position // 좌표 var catmullrom.times // 누적 거리 ``` ### 2.27.2 (2026/06/23) #### 1. JSPolygon의 loadFile에서 glb/gltf 파일 로드 시 회전/이동 기능 추가 ([이슈 #565](https://github.com/EgisCorp/XDWorld/issues/565)) * glb/gltf 파일을 로드 loadFile API를 통해 로드 한 후 JSPolygon의 move, setRotation 함수가 정상 동작하도록 기능이 추가되었습니다. #### 2. Gizmo 오류 수정 ([이슈 #563](https://github.com/EgisCorp/XDWorld/issues/563)) * 마우스 모드가 MML\_EDIT\_GIZMO가 아닌 경우에는 Gizmo가 표시되지 않도록 수정하였습니다. * setSelectObject로 객체를 선택한 경우에도 Gizmo가 정상적으로 표시되도록 수정하였습니다. #### 3. addObject 중복 키 추가 방지 ([이슈 #564](https://github.com/EgisCorp/XDWorld/issues/564)) * addObject 함수를 사용하여 같은 키의 객체를 추가하는 경우 레이어에 추가되지 않도록 수정하였습니다. #### 4. 이미지 텍스처 회전 오류 수정([이슈 #568](https://github.com/EgisCorp/XDWorld/issues/568)) * 이미지 텍스처가 회전되어 표출되는 문제를 수정하였습니다. ### 2.27.1 (2026/06/08) #### 1. skin 데이터 없는 glTF 애니메이션 지원 * skin 데이터가 포함되지 않은 glb/gltf 파일에서도 애니메이션이 정상적으로 재생되도록 수정하였습니다. #### 2. glTF 애니메이션 속도 조절 API 추가 * 기존 프레임 기반으로 동작하던 애니메이션을 시간 기반으로 동작하도록 개선하였습니다. * 애니메이션의 재생 속도를 제어할 수 있는 API를 추가하였습니다. ```javascript var gltfObject = Module.createPolygon("GLTF_OBJECT"); gltfObject.setAnimationSpeed(1.5); // default: 1.0 ``` #### 3. CJSFigure::createPlane() uv 매핑 수정 ([Issue 555](https://github.com/EgisCorp/XDWorld/issues/555)) * CJSFigure::createPlane() 함수로 생성한 객체의 텍스처가 회전된 상태로 적용되는 문제를 수정하였습니다. #### 4. glTF 다중 애니메이션 설정 API 추가 * 2개 이상의 애니메이션을 설정할 수 있는 API를 추가하였습니다. ```javascript var gltfObject = Module.createPolygon("GLTF_OBJECT"); gltfObject.setAnimationsByID([0, 1]); ``` ### 2.27.0 (2026/06/01) #### 1. voxel 인스턴싱 기능 추가 ([샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?engine=latest\&id=analysis_wildfire_spread)) * voxel 인스턴싱으로 여러개의 voxel 생성에도 성능이 유지됩니다. * Grid 데이터를 수용할 수 있도록 API를 추가하였습니다.(createGridVoxel, updateGridData) #### 2. JSFigure 지형 편집 원복 함수 추가 ([issue #555](https://github.com/EgisCorp/XDWorld/issues/555)) * JSFigure 객체별로 Figure와 겹치는 영역의 편집을 원복할 수 있는 함수를 추가하였습니다. ```javascript var fig = Module.createFigure("fig"); fig.setTexture(); fig.createOverlapRTT(true); fig.undoEditTerrain(); ``` #### 3. JSEditTerrain 지형 원복 오류 수정 ([issue #555](https://github.com/EgisCorp/XDWorld/issues/555)) * JSEditTerrain::clear(), JSEditTerrain::removeAtIndex() 함수 실행 시, 원복 대상 지형 이외의 지형에도 영향이 발생하는 문제를 수정하였습니다. * CJSFigure::createOverlapRTT() 실행 시 다른 지형의 편집이 초기화되는 문제를 수정하였습니다. #### 4. MML\_ANALYS\_DISTANCE\_STRAIGHT 오류 수정 ([issue #556](https://github.com/EgisCorp/XDWorld/issues/556)) * MML\_ANALYS\_DISTANCE\_STRAIGHT 마우스 모드에서 라인이 제대로 그려지지 않는 문제를 수정하였습니다. #### 5. gltf, glb 텍스쳐 로드 콜백 ([issue #552](https://github.com/EgisCorp/XDWorld/issues/552)) * loadFile API를 통해 로드한 gltf, glb의 텍스쳐가 로딩 완료되었을 경우 콜백 함수가 호출되도록 기능을 추가하였습니다. * 콜백 파라미터를 통해 텍스쳐 명칭(textureName) 및 전체 텍스쳐 수(textureTotalCount), 로드 된 텍스쳐 인덱스(textureIndex)를 조회하실 수 있습니다. ```javascript polygon.loadFile({ url : url, type : "glb", position : _position, callback : function(e) { console.log(e.textureName); console.log(e.textureTotalCount); console.log(e.textureIndex); } }); ``` #### 6. 타일레이어 기반 유저생성 폴리곤에 대한 그림자 렌더링 지원 ([issue #560](https://github.com/EgisCorp/XDWorld/issues/560)) * 유저생성 폴리곤 객체에서도 그림자 분석 처리가 가능하도록 수정하였습니다. #### 7. 마우스 이벤트 처리 수정 * 마우스 드래그 상태로 지도 밖에 나간 후 버튼을 해제한 후에 다시 지도로 들어올 때 버튼을 놓아도 드래그로 인식한 문제를 수정하였습니다. #### 8. 고스트심볼 Pitch, Yaw, Roll 회전 수정 * Yaw -> Pitch -> Roll 방식으로 회전축 변화에 맞게 수정하였습니다. ### 2.26.0 (2026/05/08) #### 1. 성절토 편집 렌더링 오류 수정 ([issue #557](https://github.com/EgisCorp/XDWorld/issues/557)) * 성절토 편집 후 하위 타일들의 영상을 가져오지 않는 문제를 수정하였습니다. * 새로 로드된 하위 타일에 편집 내용이 적용되도록 개선하였습니다. #### 2. 고스트 심볼 기능 업데이트 ([샌드박스 샘플](https://sandboxt.egiscloud.com/code/main.do?engine=latest_test\&id=object_ghostsymbol_rotate_pyrl)) * 심볼 모델포맷 GLB 추가 * JSGhostSymbolMap::addGhostSymbolByGLB( \_key, \_homeDir, \_fileName) * addGhostSymbolBy3DS와 동일한 파라메터 속성 (\_filename에 확장자 .glb는 제외) * 고스트심볼 객체에 Pitch, Yaw, Roll 회전을 설정 및 반환하는 기능이 추가되었습니다. * JSGhostSymbol::getPitch(), getYaw(), getRoll() 로 각각 반환 * JSGhostSymbol::setRotationPYR(\_pitch, \_yaw, \_roll)로 설정 #### 3. 3D Line of Sight 커버리지 분석 기능 추가 ([샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?engine=latest_test\&id=analysis_lineofsightl)) * 3D 방사형 LoS를 통한 가시/비가시 부분 분석 처리 * JSON 옵션에 따른 분석방법 및 시각화 처리에 대한 조절이 가능합니다. #### 4. voxel 기능 추가 ([샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?engine=latest\&id=effect_voxel)) * voxel 기능을 추가하여 3D texture로 다양한 효과를 적용 가능합니다. #### 5. datavisualizer 기능 추가 ([샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?engine=latest\&id=object_point_datavisualizer), [샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?engine=latest\&id=object_point_datavisualizer_child), [샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?engine=latest\&id=object_line_datavisualizer), [샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?engine=latest\&id=object_line_symbol_datavisualizer)) * Point, Line Type의 data 가시화 * Child, Multi로 단계별 가시화 지원 #### 6. createOverlapRTT API 수정 ([issue #555](https://github.com/EgisCorp/XDWorld/issues/555)) * Figure 객체 createOverlapRTT 시 지형이 업데이트 되지 않는 현상을 수정하였습니다. ### 2.25.1 (2026/04/13) #### 1. glb 텍스쳐 리사이즈 적용 * 허용 범위를 초과하는 텍스처가 포함된 GLB 파일에 대해, 텍스처를 최대 허용 크기 이하로 자동 리사이즈하는 처리가 추가되었습니다. * 해당 기능은 웹워커를 통해 처리되므로, **XDWorldWorker.js / XDWorldWorker.wasm** 파일 교체 부탁드립니다. #### 2. 고스트 심볼 기즈모 추가 * 고스트 심볼 객체도 기즈모를 통해 편집할 수 있도록 개선하였습니다. #### 3. 피규어 객체 오류 수정 ([issue #555](https://github.com/EgisCorp/XDWorld/issues/555)) * 알파값이 적용된 객체의 크기 조절 시 객체가 투명해지는 문제를 수정하였습니다. * JSFigure::createOverlapRTT(option) 함수의 변경 사항이 즉시 반영되도록 개선하였습니다. ### 2.25.0 (2026/04/06) #### 1. 기즈모 마우스 모드 추가 * 기즈모 UI를 통해 객체를 편집할 수 있는 마우스 모드가 추가되었습니다. [(샌드박스 샘플)](https://sandbox.egiscloud.com/code/main.do?id=object_gizmo) ```javascript Module.XDSetMouseState(Module.MML_EDIT_GIZMO); Module.setGizmoMode(0); // Translate (default) Module.setGizmoMode(1); // Rotate ``` ### 2.24.1 (2026/03/13) #### 1. JSSolarManager API 추가 * 판넬의 옵션을 레이어 전체로 변경하는 API 추가 ```javascript var dModuleWidth = 1.48; var dModuleHeight = 1.0; var dModuleThick = 0.1; var dModuleAngle = 45.0; var solar = Module.GetSolarManager(); // updateModuleOptionByLayer("레이어 명칭", 판넬 가로 크기, 판넬 세로 크기, 판넬 두께, 판넬 각도); solar .updateModuleOptionByLayer(dModuleWidth, dModuleHeight, dModuleThick, dModuleAngle); ``` ### 2.24.0 (2026/03/09) #### 1. JSPipe `setRadius` API 추가 * 파이프의 반경을 변경하는 API가 추가되었습니다. ```javascript var pipe = Module.createPipe("MY_PIPE"); // pipe.create(...); pipe.setRadius(10.0); ``` #### 2. Module.getDataVisualizer API 생성 시 오류 수정 * Module.getDataVisualizer를 통해 객체 생성 중 회전 각도가 잘못 적용되는 현상을 수정하였습니다. ([이슈 #547](https://github.com/EgisCorp/XDWorld/issues/547)) #### 3. JSPolygon 좌표 순서에 따른 컬링 오류 수정 * setCoordinates(), setPartCoordinates() 함수에서 좌표의 순서가 반대로 들어온 경우에도 정상적으로 컬링이 되도록 수정하였습니다. #### 4. 객체 선택 효과 변경 * 기존 빨간색 반투명 효과를 홀로그램 효과로 변경하였습니다. ### 2.23.0 (2026/02/02) #### 1. JSPolygon `loadFile` projectioncode 타입 변경 * projectioncode : "EPSG:5186" * 기존 숫자코드는 가독성이 떨어져 EPSG 코드를 입력할 수 있도록 변경하였습니다. #### 2. 오브젝트레이어 POI 원근 스타일 설정 추가 * JSLayerList::createObjectLayer로 생성한 레이어 한정 * JSLayer : setLayerStyle({object}) 추가 * POI가 카메라와 표출 거리에 따른 크기 및 투명도 설정 ``` let option = { "poi" : { "scaleable" : { // 거리별 가변 크기 적용 "activate" : true, // 동작 설정 "range" : { "min" : 1000, // 최소 구간 (보다 가까우면 원본 POI 표현) "max" : 3000 // 최대 구간 (보다 멀면 최소 픽셀 POI 표현) }, "minPixel" : { // 아이콘 최소 픽셀 크기 설정 (아이콘 크기에서 x,y중 작은쪽 크기가 최소 크기보다 작으면 해당 크기로 고정) "x" : 4, "y" : 16 }, "tiltRange" : { // 각도에 따른 크기 왜곡 추가 "activate" : true, // 왜곡 사용 "minAngle" : 60, // 최소 왜곡 각도 (이하 각도에서는 기존 배율적용) "maxAngle" : 80 // 최대 왜곡 각도 (이상 각도에서는 원본 크기로 표현) } }, "fadeable" : { // 거리별 투명도 적용 "activate" : true, // 동작 설정 "range" : { "min" : 3000, // 최소 구간 (보다 가까우면 불투명) "max" : 5000 // 최대 구간 (보다 멀면 최소 알파값 적용) }, "minAlpha" : 0.2, // 최소 투명도값 1>minAlpha>0 ( 이보다 더 투명해지지 않음 ) "tiltRange" : { // 각도에 따른 투명도 왜곡 추가 "activate" : true, // 왜곡 사용 "minAngle" : 60, // 최소 왜곡 각도 (이하 각도에서는 기존 배율적용) "maxAngle" : 80 // 최대 왜곡 각도 (이상 각도에서는 원본 크기로 표현) } } } }; ``` #### 기본형태 image #### 크기 가변형태 image #### 투명도 가변형태 image #### 혼합사용 형태 image #### 각도 왜곡 미적용 (Tilt와 관계 없이 거리별 크기 적용) image #### 각도 왜곡 적용 (지정된 Tilt각 이상에서는 원본 크기로 적용 왜곡) image #### 3. JSPoint POI 자동 높이 조절 기능 property 추가 ```javascript var point = Module.createPoint("POI"); point.autoHeight = true; ``` ### 2.22.0 (2026/01/12) #### 1. 시곡면 분석 정확도 향상 * [시곡면 분석](https://sandbox.egiscloud.com/code/main.do?id=analysis_building_height_regulation) 정확도 향상 및 0\~360도 범위 확장
image #### 2. 1인칭 카메라 비디오 텍스쳐 기능 지원 중단 * 기존 1인칭 카메라 비디오 텍스쳐 기능은 2025년까지 지원합니다. * JSCamera 클래스의 삭제 API ---------> JSVideoObject 클래스의 대체 API * setVideoInfo ---------> createVideo * clearVideo -----------> clearTexture * JSCamera 클래스의 삭제 property ---------> JSVideoObject 클래스의 대체 property * videoStreaming ---------------> videoStreaming * videoFar -----------------------> far * videoFovX ---------------------> fovX * videoFovY ---------------------> fovY * videoAlpha --------------------> alpha * videoAxisX --------------------> axisX * videoAxisY --------------------> axisY * videoZoom --------------------> zoom * videoFarPlane -----------------> background * videoResolution ---------------> resolution * videoObjectMapping ---------> objectMapping * videoIsplayer ------------------> isPlayer * 비디오 객체 [비디오 객체](https://sandbox.egiscloud.com/code/main.do?id=object_video), [전광판](https://sandbox.egiscloud.com/code/main.do?id=object_ledboard), [RTT 비디오](https://sandbox.egiscloud.com/code/main.do?id=object_polygon_rtt_video_image_texture)를 참고하시기 바랍니다. #### 3. 건물 레이어 limit boundary 옵션 추가 * 건물 레이어 boundaryLimit에 mode: "exclude" 옵션을 추가해 경계 내부를 제외하고 외부 오브젝트만 로드할 수 있도록 개선했습니다. * 아래와 같이 설정하는 경우 바운더리 외 건물이 로드됩니다. ```javascript const boundary = [ [126.93005255915998, 37.529214172573376], [126.94102835336719, 37.52029412432422], [126.93891529125652, 37.51798498831805], [126.92841620055285, 37.516978366894115], [126.92514862234246, 37.51770012779483], [126.91756299430655, 37.521708873949606], ]; Module.getTileLayerList().createXDServerLayer({ ... boundaryLimit: { mode: "exclude", rings: boundary } }); ``` * 아래와 같이 설정하는 경우 바운더리 내부 건물만 로드됩니다. (기존 방식과 동일) ```javascript const boundary = [ [126.93005255915998, 37.529214172573376], [126.94102835336719, 37.52029412432422], [126.93891529125652, 37.51798498831805], [126.92841620055285, 37.516978366894115], [126.92514862234246, 37.51770012779483], [126.91756299430655, 37.521708873949606], ]; Module.getTileLayerList().createXDServerLayer({ ... boundaryLimit: { mode: "include", rings: boundary } }); ``` * exclude/include 옵션이 없는 경우 include 타입으로 자동 지정되어 바운더리 내부 건물만 로드됩니다. #### 4. 엔진 상태 체크 옵션 추가 ```javascript Module.initialize({ . . . ping: enginePing }); function enginePing(e) { console.log(e); } ``` #### 5. 수평 이동 위치 반환 API 추가 * 전후좌우 방향으로 특정 거리만큼 수평 이동한 좌표를 반환하는 API가 추가되었습니다. ```javascript var camera = Module.getViewCamera(); camera.getPanMoveLocation(moveType, distance); // moveType : 0(front), 1(back), 2(left), 3(right) ``` #### 6. 1인칭 카메라 모드 높이 설정 API 추가 * 1인칭 카메라 모드에서 카메라의 높이를 설정하는 API가 추가되었습니다. ```javascript var camera = Module.getViewCamera(); camera.setPersonHeight(1.5); ``` #### 7. 플레이어 모드 천장 설정 API 추가 * 플레이어 모드에서 천장 고도를 설정하여 점프 시 천장에 부딪히도록 하는 API가 추가되었습니다. ```javascript var camera = Module.getViewCamera(); camera.setCeiling() // 천장 설정 해제 camera.setCeiling(10.0); // 천장 고도 설정 ``` ### 2.21.0 (2025/12/01) #### 1. 카메라 타겟 좌표 반환 API 추가 * 카메라 이동 애니메이션이 적용된 상태에서 카메라의 최종 목적지 좌표를 반환하는 API가 추가되었습니다. ```javascript var pos = Module.getViewCamera().getTargetLocation(); ``` #### 2. 카메라 플레이어 모드 추가 * 1인칭 카메라에 플레이어 모드(물리 기반)가 추가되었습니다. * 이 모드에서는 점프 및 중력 낙하 효과가 자연스럽게 적용됩니다. ```javascript var camera = Module.getViewCamera(); camera.setPlayerMode(true); // 플레이어 모드 활성화 camera.setPlayerMode(false); // 플레이어 모드 비활성화 ``` #### 3. 카메라 점프 기능 API 추가 * 플레이어 모드에서 카메라가 점프 동작을 수행할 수 있는 API가 추가되었습니다. * 점프 세기(jumpForce), 중력(gravity), 시간 간격(timeStep)을 조절할 수 있습니다. * [샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?id=camera_jump_outdoor) ```javascript var camera = Module.getViewCamera(); camera.setJumpForce(30.0); // 기본값 10.0 camera.setGravity(9.8); // 기본값 9.8 camera.setTimeStep(0.06); // 기본값 0.05 camera.jump(); ``` #### 4. 카메라 지면 감지 API 추가 * 1인칭 카메라가 현재 지면에 닿아 있는지 여부를 확인할 수 있는 API가 추가되었습니다. * isGround()가 true일 때만 점프 기능이 동작합니다. ```javascript var camera = Module.getViewCamera(); camera.isGround(); ``` #### 5. 착지 고도 설정 API 추가 * 플레이어 모드에서 카메라의 착지 고도를 직접 지정할 수 있는 기능이 추가되었습니다. * 특정 고도를 수동으로 설정하거나, 현재 위치의 지형 고도를 자동으로 적용할 수 있습니다. ```javascript var camera = Module.getViewCamera(); camera.setLandingElevation(50.0); // 특정 고도를 착지 고도로 설정 camera.setLandingElevationToTerrain(); // 지형 고도를 착지 고도로 설정 ``` #### 6. 카메라 범위 외 레이어 피킹 API 추가 * 기존에는 카메라 시야 영역 내 객체만 피킹이 가능했지만, 시야 영역에 관계없이 피킹이 가능한 API가 추가되었습니다. ```javascript let buildingLayer = Module.getTileLayerList().nameAtLayer("facility_build"); pickPosition = buildingLayer.getPickInfoAtView(_from, _to); // 기존: 카메라 영역 내부만 피킹 pickPosition = buildingLayer.getPickInfo(_from, _to); // 추가: 카메라 영역 상관 없이 피킹 ``` #### 7. 영역 내부의 건물 오브젝트 아이디 반환 API 추가 * 영역 내부의 건물 오브젝트 아이디를 반환하는 API가 추가되었습니다. ```javascript var boundary = [ [126.93790903169547, 37.522875202560655, 0.0], [126.92841620055285, 37.516978366894115, 0.0], [126.91894402430914, 37.52022975707285, 0.0] ] // 고도값 유무 상관 없음 var objects = Module.getTileLayerList().nameAtLayer("facility_build").getObjectsInBoundary(boundary); console.log(objects.id); ``` #### 8. 3DTiles 요청 및 렌더링 최적화 * 3DTiles 요청시 SSE 기준 요청으로 변경 * 요청 순서 최적화 * 요청 수 관리로 브라우저 안정화 #### 9. 모바일 서비스 안정화 * 일부 기기에서 POI 객체 선택시 오류 수정 #### 10. 선택된 객체 리스트 반환 * [선택된 객체 리스트 반환](https://sandbox.egiscloud.com/code/main.do?engine=latest_test\&id=object_select_info) #### 11. 빌보드 객체 지형 아래 랜더링 오류 수정 * 빌보드 객체가 지형 아래로 내려가거나 걸칠경우 랜더링 되지 않는 현상 수정 ### 2.20.1 (2025/11/11) #### 1. JSFlowPolygon 인덱스 기반 생성 기능 추가 * JSFlowPolygon 생성 시 버텍스 및 삼각분할 된 인덱스 기반으로 생성할 수 있도록 API 기능이 추가되었습니다. ```javascript var polygon = Module.createFlowPolygon("FLOW_POLYGON"); ... var result = polygon.create({ vertex: geometry, // Polygon shape index : indices, // Triangulated index normaltexture: GLOBAL_FLOW_NOISE_TEXTURE, // River flow noise texture }); ``` ### 2.20.0 (2025/11/03) #### 1. 성능 개선 및 내부 안정화 작업을 수행하였습니다. ### 2.19.0 (2025/10/13) #### 1. 오버레이 기능 오류 수정 [(이슈 #513)](https://github.com/EgisCorp/XDWorld/issues/513) * 간헐적으로 검은색 이미지가 오버레이 되는 현상이 수정되었습니다. * 이미지 오버레이 투명값 옵션이 추가되었습니다. ```javascript polygon.setOverlayObject({ style : "polygon", coordinate : vertex, alpha : 0.6, // 추가된 옵션 image : _image }); ``` * 건물 심플모드에 오버레이 적용되지 않는 현상 수정 * 건물 외곽선 렌더링을 원하지 않을 경우 : Module.SetSimpleModeLineRender(false); image #### 2. 라인객체 GLOW 효과 개선 * 기존 GLOW 효과를 개선하였습니다. image #### 3. JSPolygon 편집 API 추가 * 이동, 회전, 스케일 * [샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?id=object_polygon_edit) ```javascript let polygon = Module.createPolygon("POLYGON"); // 이동 polygon.move(longitude, latitude, alttitude); // 회전 polygon.setRotation(x, y, z); // 스케일 polygon.setScale(x, y, z); ``` #### 4. JSObject3D 축의 끝점 좌표 반환 API 추가 * 회전, 스케일 시 축을 생성하여 직관적으로 확인할 수 있도록 축의 끝점 좌표를 반환하는 API가 추가되었습니다. * 중심과 끝점으로 라인을 생성합니다. * [샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?id=object_polygon_edit) ```javascript // axis (x: 0, y: 1, z: 2) let endpoint = getAxisEndpoint(axis, length); ``` #### 5. 카메라 이동 오류 수정 [(이슈 #514)](https://github.com/EgisCorp/XDWorld/issues/514) * 카메라 이동 후 간헐적으로 카메라 방향이 틀어지는 현상이 있어 수정되었습니다. #### 6. 심플모드 건물에서 Hsv 옵션 [(이슈 #512)](https://github.com/EgisCorp/XDWorld/issues/512) * 건물 레이어가 심플모드인 경우에도 Hsv 옵션이 정상 동작하도록 수정되었습니다. #### 7. 타일 레이어의 폴리곤 기반 요청 영역 지정 * JSLayer의 setLimitBoundary API가 기존 사각 영역을 포함하여 폴리곤 영역도 수용하도록 변경되었습니다. * 건물의 중점이 폴리곤 영역에 포함되면 데이터를 로드합니다. * createXDServerLayer API에 boundaryLimit 옵션으로도 설정할 수 있습니다. ```javascript Module.getTileLayerList().createXDServerLayer({ url : "https://xdworld.server.url", servername : "XDServer", name : "layer_name", type : 9, minLevel : 0, maxLevel : 15, boundaryLimit : [ [126.93005255915998, 37.529214172573376, 0.0], [126.94102835336719, 37.52029412432422, 0.0], [126.93891529125652, 37.51798498831805, 0.0], [126.92841620055285, 37.516978366894115, 0.0], [126.92514862234246, 37.51770012779483, 0.0], [126.91756299430655, 37.521708873949606, 0.0], ] }); ``` #### 8. 지형 이미지 음영 마스킹 기능 추가 * 경위도 최소, 최대 좌표로 지정한 영역 외 지형 이미지를 음영처리하는 옵션 API가 추가되었습니다. ```javascript Module.getTerrain().setImageMask({ active : true, range : { min : [126.917562, 37.516978], max : [126.941028, 37.529214], }, color : {a : 200, r : 0, g : 0, b : 0} }); ``` #### 9. 지형 내장 이미지 사용 여부 설정 API 추가 * 엔진 내 내장된 0레벨 지구본 이미지 사용 여부를 설정하는 옵션이 Module.initialize API에 추가되었습니다. * true로 설정하는 경우 내장된 이미지를 사용하며, false로 설정하는 경우 지정한 이미지 서버로 0레벨 이미지를 요청합니다. * 디폴트 값은 true 입니다. ```javascript Module.initialize({ container: document.getElementById("map"), terrain : { dem : { url : "...", name : "dem", servername : "XDServer", }, image : { url : "...", name : "tile", servername : "XDServer", useBuiltInZeroImage : false // false로 설정 시 지정한 서버로부터 0레벨 이미지 수신 }, }, .... } ``` ### 2.18.0 (2025/09/01) #### 1. 오브젝트 선택 시 외곽선 렌더링 * JSReal3D, JSGhostSymbol, JSPolygon 오브젝트 선택 시 아래 이미지와 같이 외곽선이 함께 출력됩니다. Image * JSOption의 setRenderSelectSilhouette API를 활용하여 외곽선을 끄고 켤 수 있습니다. ```javascript Module.getOption().setRenderSelectSilhouette(true); // on Module.getOption().setRenderSelectSilhouette(false); // off ``` #### 2. DEM 단독 렌더링 * 지형 영상 없이 DEM 단독으로 렌더링이 가능하도록 개선되었습니다. #### 3. 화면 중심 기반 마우스 틸트, 회전 옵션 [(이슈 509)](https://github.com/EgisCorp/XDWorld/issues/509) * 마우스로 화면 틸트, 회전 시 화면 중앙점을 중심으로 움직이도록 옵션이 추가되었습니다. ```javascript Module.getControl().setMouseClickCenterMode(true); ``` ### 2.17.1 (2025/08/21) #### 1. 이미지 기반 오버레이 기능 구현 [(이슈 502)](https://github.com/EgisCorp/XDWorld/issues/502) * 기존 색상으로만 표현되던 오버레이 기능을 이미지 기반으로도 적용할 수 있도록 기능이 업데이트 되었습니다. ```javascript var polygon = Module.createOverlayObject("POLYGON"); var color = new Module.JSColor(255, 255, 0); polygon.setOverlayObject({ style : "polygon", coordinate : vertex, color : color, image : { width : img.width, height : img.height, data : ctx.getImageData(0, 0, img.width, img.height).data, } }); ``` #### 2. 수인한도분석 결과값 추가 * 각 격자에 시간대별 일조량 추가 ```javascript [결과값] 0 : { analysisList: { 0 : {sunrise: true, time: 10}, // sunrise(일조인지 아닌지), time(일조 시간, 입력한 분석텀) 1 : {sunrise: true, time: 10}, . . . }, color: { A : 120, R : 166, G : 166, B : 166 }, continuevalue: 50, id: 'grid_0', isanalysis: true, position : { alt: 3.981043982319534, lat: 35.1712107372302, lon: 129.13061351968938 }, totalvalue : 500 } . . . ``` #### 3. 하드웨어 가속 옵션 삭제 * 하드웨어 가속 옵션 UI 삭제 및 console 경고 안내 #### 4. AABB 추가 * ECEF 좌표계에서의 AABB 좌표를 반환하는 기능이 추가되었습니다. ```javascript var box = _polygon.getBoundary(); // AABB Coordinates to Spherical Coordinates // bottom(4), top(4) var boxArray = box.getBox(); const corners = { bottom: [ [boxArray.get(0).longitude, boxArray.get(0).latitude, boxArray.get(0).altitude], [boxArray.get(1).longitude, boxArray.get(1).latitude, boxArray.get(1).altitude], [boxArray.get(2).longitude, boxArray.get(2).latitude, boxArray.get(2).altitude], [boxArray.get(3).longitude, boxArray.get(3).latitude, boxArray.get(3).altitude], ], top: [ [boxArray.get(4).longitude, boxArray.get(4).latitude, boxArray.get(4).altitude], [boxArray.get(5).longitude, boxArray.get(5).latitude, boxArray.get(5).altitude], [boxArray.get(6).longitude, boxArray.get(6).latitude, boxArray.get(6).altitude], [boxArray.get(7).longitude, boxArray.get(7).latitude, boxArray.get(7).altitude], ] }; ``` ### 2.17.0 (2025/08/11) #### 1. Figure 객체 편집 UI 제어 API 추가 * scaleLock, rotateLock, moveLock ```javascript let fig = Module.createFigure("figs"); // 크기 UI 삭제 fig.scaleUI = false; // 회전 UI 삭제 fig.rotateUI = false; // 이동 UI 삭제 fig.moveUI = false; ``` #### 2. 하드웨어 가속 옵션 안내 * Chrome 브라우저가 아닐 경우 Chrome 브라우저 권장 안내 image * Chrome 브라우저의 "하드웨어 가속" or "그래픽 가속" 을 사용하지 않을 경우 안내 image #### 3. Indicator 기능 개선 * 타겟이 카메라 뒤에 있는 경우 Indicator가 정상적으로 계산되지 않는 현상을 수정하였습니다. ### 2.16.1 (2025/07/15) #### 1. 고용량 3DS 로딩 최적화 기능이 추가되었습니다. ```javascript var polygon = Module.createPolygon("POLYGON_3DS_LOAD"); polygon.loadFile({ url : _strURL, align : "center", position : pos, rotate : fAngle, rebuild : true, discardVertexData : true, // 추가 : 좌표 GPU 업데이트 후 삭제 compressObject : false, // 추가 : Import 후 압축 vertex 압축 안함. }); ``` #### 2. 건물 높이 기준 횡단면 선분 추출 기능 추가 * 지정한 건물의 높이기준 외곽선분 추출 기능이 추가되었습니다. * object JSReal3D::getFloorSliceEdge(double \_height) * 반환값 예시 ```{ { "header": { // 데이터 바운더리 최소, 최대 경위도 "minLon": 126.927487351387, "minLat": 37.52418520251252, "maxLon": 126.92795509699533, "maxLat": 37.52453873807533, // 설정한 단면 분석 높이 "cutHeight": 12.5, // 설정한 건물의 중심점 "location": { "lon": 126.92774196141701, "lat": 37.52434050186833, "alt": 39.250494956970215 }, // 건물의 최소, 최대 높이 (해발고도) "elevation": { "min": 12.125300407409668, "max": 66.37568950653076 } }, // 단면 선분 정보 [A점(경도,위도,높이)B점(경도,위도,높이)] [...] "edge": [ [ 126.9277111803299, 37.52448908205179, 22.275913742370903, 126.927487351387, 37.52435413856168, 22.275933586061 ], [ 126.9277111803299, 37.52448908206028, 22.27591446880251, 126.92779354446381, 37.524538738067506, 22.27593025751412 ], [ ... ] ] } ``` ### 2.16.0 (2025/07/07) #### 1. Camera 이동 관련 API 오류 수정 * [카메라 이동](https://sandbox.egiscloud.com/code/main.do?id=camera_set_viewrect) * 카메라 이동시 설정된 위치가 아닌 다른 위치로 이동되는 오류가 있어 수정되었습니다. #### 2. POI ahead 옵션 오류 수정 * [Object ahead](https://sandbox.egiscloud.com/code/main.do?id=object_ahead) * POI ahead 옵션이 동작하지 않아 수정되었습니다. #### 3. Tile Layer 요청 제한 기능 개선 * [Request Limit](https://sandbox.egiscloud.com/code/main.do?id=layer_request_boundary) * 모든 객체가 load 된 이후에 요청 제한 기능이 실행되어 즉각적으로 반영되도록 기능 개선하였습니다. #### 4. JSPolygon.createTMCoordPlane API 오류 수정 * 특정 유형 데이터에서 격자 밀림현상이 수정되었습니다. ### 2.15.1 (2025/06/25) #### 1. 바람 효과 표현중 2D 표현이 되지 않는 오류 수정 * [관련 샌드박스](https://sandbox.egiscloud.com/code/main.do?id=effect_wind) 에서 Wind 2D 생성되지 않는 오류 수정 ### 2.15.0 (2025/06/02) #### 1. 거리 측정 기능 오류 수정 * 거리측정 데이터 삭제 후 재측정 시 라인이 생성되지 않는 현상을 수정하였습니다. ### 2.14.2 (2025/05/27) #### 1. 고스트심볼에 조망보기, 가시권분석3D 개선 * 고스트심볼에서 조망보기, 가시권분석(3D) 성능을 향상하였습니다. #### 2. 카메라 이동 오류 수정 ([issue #495](https://github.com/EgisCorp/XDWorld/issues/495)) * 같은 위치로 이동할 경우 오류가 발생하여 예외처리를 추가하였습니다. #### 3. 객체가 지형 밑인지 위인지 사용자가 설정하는 함수 * 객체가 지형 위, 아래인지에 따라서 투명값 렌더링 순서에 영향이 있어 애매한 객체는 사용자가 직접 지정 가능합니다.(ex : 지하도) * JSPolygon::setUnderground(boolean \_bUnderground) : 지형 위 아래 설정 * JSPolygon::getUnderground() : 지정 상태 반환 ```javascript var LayerList = new Module.JSLayerList(true); var layer = LayerList.nameAtLayer("Layer"); if(layer!=null) { var pObject = layer.keyAtObject("Object"); if(pObject==null) return; pObject.setUnderground(true); } ``` #### 4. 거리측정 기능 개선 * 거리 측정 시 라인 지형결합 on/off 설정 API 추가하였습니다. * void setMeasureDistancePointUnionTerrain(bool \_set); * 이후에 입력되는 라인의 지형결합 적용 여부를 설정할 수 있습니다. * Class : JSOption * Parameter * \_set : 지형결합 적용 여부(true/false) * 예시 ```javascript Module.getOption().setMeasureDistancePointUnionTerrain(false); ``` #### 5. POI에 가까이 다가가는 경우 사라지는 현상 개선 * JSLayer의 minDistance 값보다 큰 거리에서 POI가 사라지는 현상을 수정하였습니다. ### 2.14.1 (2025/05/19) #### 1. JSLayer에 setAlpha API의 동작 방식 변경 * 기존 Object의 속성을 일괄적 조회후 수정 방식에서 실시간 적용 방식으로 변경 * 슬라이드 방식으로 투명도 처리 가능 #### 2. JSEditTerrain 개별 삭제 기능 추가 ([issue #492](https://github.com/EgisCorp/XDWorld/issues/492)) * 성절토 List index로 삭제할 수 있는 기능 추가 #### 3. 좌표변환 추가 ([issue #494](https://github.com/EgisCorp/XDWorld/issues/494)) * 기존 WMS의 지원 좌표계는 5개(4326, 5174, 5179, 5180, 5186) * EPSG:3765 좌표변환 추가 * 다른 EPSG 좌표계 지원할 수 있도록 추가 #### 4. moveLonLatBoundarybyJson API 오류 수정 ([issue #495](https://github.com/EgisCorp/XDWorld/issues/495)) * 이동 후 똑같은 위치로 다시 이동시 오류 발생하여 예외처리 #### 5. 이미지 오버레이 기능 오류 수정 ([issue #496](https://github.com/EgisCorp/XDWorld/issues/496)) * 이미지 오버레이시 지형 결합되지 않는 오류 수정 ### 2.14.0 (2025/05/12) #### 1. JSCamera의 moveOvalDist 이동 기준 해제 ([issue #488](https://github.com/EgisCorp/XDWorld/issues/488)) * API 실행 시 이동 여부 기준 100m를 해제하였습니다. #### 2. 경사향 가시화 결과 갱신 오류 수정 ([issue #488](https://github.com/EgisCorp/XDWorld/issues/490)) * 경사향 가시화 결과가 갱신되지 않는 현상을 수정하였습니다. #### 3. 태풍 위험반경 표시 오류 수정 * RTT 기반 태풍 위험반경이 표시되지 않는 현상을 수정하였습니다. #### 4. JSHTMLObject 스테레오뷰 오류 수정 ([issue #491](https://github.com/EgisCorp/XDWorld/issues/491)) * JSHTMLObject 스테레오뷰 실행시 위치 오류를 수정하였습니다. ### 2.13.0 (2025/04/07) #### 1. 터파기 가시화 오브젝트 추가() ```` * 기존 JSColorPipe 뿐만 아니라 JSFlowPolygon, JSPolygon, JSReal3d(건물) 오브젝트도 원형 터파기 영역에 보이도록 기능을 추가하였습니다. * 보이고자 하는 JSLayer의 setViewInTransparency API를 통해 보이기 여부를 설정할 수 있습니다. * 기본 값은 보이지 않음(false) 이며, JSColorPipe 객체는 예외적으로 보임 상태를 유지합니다. * void setViewInTransparency(bool _set) * Class : JSLayer * Parameter * _set(bool) : 보이기 여부(true 보임 / false 보이지 않음) ``` javascript layer.setViewInTransparency(true); ``` * bool getViewInTransparency(); * Class : JSLayer * Return * 보임 설정 여부(bool) ``` javascript var visible = layer.getViewInTransparency(); ``` ```` #### 2. JSPolygon의 Union mode 오류 수정 () ``` - JSPolygon에 Union mode 설정 후 RTT 적용이 되지 않는 점을 수정하였습니다. ``` #### 3. 라인 효과 추가 및 정리 ```` - 라인 타입에 따른 옵션 및 매개변수 구조를 보다 사용하기 쉽도록 수정하였습니다. - 변경 사항 - type: 기존 숫자로 입력하는 방식에서 Module.BLING (type: NORMAL, OUTLINE, GLOW, ARROW, DASH, FIRE, BLING, WARNING)등의 상수로 정의하도록 변경되었습니다. - animation, loopcount 속성을 추가하여 가시화 효과(type)에 따라 애니메이션 효과가 적용되도록 변경되었습니다. - 라인 크기를 고정시키는 옵션을 추가하였습니다. ```javascript [기존방식] let data = { coordinates: coordinates, type: 0, // Solid line creation union: false, // Terrain union status depth: true, // Object overlap status color: new Module.JSColor(255, 255, 0, 0), // ARGB width: 1, // Line width }; [변경된 방식] let data = { coordinates: coordinates, type: Module.BLING, // Solid line creation union: false, // Terrain union status depth: true, // Object overlap status color: new Module.JSColor(255, 255, 0, 0), // ARGB width: 1, // Line width animation: true, // Animation sizefix: true, // size fixed loopcount: 1 // Animation loop count }; ``` ```` #### 4. POI 가시화 오류 수정 ``` - 카메라 영역을 벗어날 경우, POI가 화면에서 사라지는 오류를 수정하였습니다. - 이제부터 영역을 벗어나면 POI 높이를 조절하여 화면 내부에서 볼 수 있도록 변경됩니다. ``` #### 5. 빌보드 회전 타입 추가 ```` * 아래 이미지와 같이 지면과 수평한 빌보드의 회전 타입이 추가되었습니다. ![Image](https://github.com/user-attachments/assets/4002a632-4efe-4ba7-8bec-9382c1402d48) * JSBillboard의 setRotationMode API를 통해 mode 2번을 선택하시면 적용하실 수 있습니다. ``` javascript billboard.setRotationMode(2); ``` ```` #### 6. 마우스 조작 이벤트 버튼 설정 기능 추가 ```` * 마우스 버튼을 통해 지도 조작(이동, 회전, 줌) 동작에 사용할 버튼을 설정할 수 있도록 하는 기능이 추가되었습니다. * `setMouseControlEvent`를 통해 조작 타입별 버튼을 설정할 수 있으며, `getMouseControlEvent`로 현재 설정된 버튼 값을 조회할 수 있습니다. * 조작 타입은 `"translate"`, `"rotate"`, `"zoom"` 중 하나이며, 버튼 값은 0(좌클릭), 1(휠클릭), 2(우클릭) 중 하나입니다. * `bool setMouseControlEvent(string type, int button)` * Class : JSControl * Parameter * `type` (string) : 조작 타입 ("translate", "rotate", "zoom") * `button` (int) : 마우스 버튼 값 (0: 좌클릭, 1: 휠클릭, 2: 우클릭) * Return * 설정 성공 여부 (bool) ```javascript JSControl.setMouseControlEvent("rotate", 2); // 회전을 우클릭으로 설정 ``` * `int getMouseControlEvent(string type)` * Class : JSControl * Parameter * `type` (string) : 조작 타입 ("translate", "rotate", "zoom") * Return * 해당 타입의 현재 마우스 버튼 값 (int) ```javascript var zoomButton = JSControl.getMouseControlEvent("zoom"); ``` ```` ### 2.12.3 (2025/03/17) * XDServer의 POI 레이어 서비스에서 데이터 처리중 발생하는 오류를 수정하였습니다. * 이슈 : ### 2.12.2 (2025/03/12) * JSOption::setMaxRequestQueueSize() API 추가 * 데이터 요청 큐의 크기(기본값은 5)를 조절하는 setMaxRequestQueueSize()가 추가되었습니다. ```javascript Module.getOption().setMaxRequestQueueSize(20); ``` * 매개변수: 변경할 요청 큐의 크기(number) * 3D 서비스 모델 요청시 처리 성능이 향상되었습니다. ### 2.12.1 (2025/03/11) * 이미지 레이어가 가시화되지 않는 오류를 수정하였습니다. ### 2.12.0 (2025/03/10) #### 1. POI 선택시 Text 위치 오류 수정 ``` - POI 선택시 setTextMargin 이 Text 에 적용되지 않는 오류를 수정하였습니다. ``` #### 2. 화면분할(Streo View) 모드에서 좌우 객체를 인식할 수 있도록 기능을 수정하였습니다. #### 3. Text 형태의 POI 선택 인식 및 선택 효과 추가 ``` - 기존 POI처럼 Text도 선택과 선택 색상(picking color) 적용이 가능하도록 수정하였습니다. ``` #### 4. 3DTiles B3DM 선택 오류를 수정하였습니다. #### 5. `AutoMove` 모드에서 카메라 회전 옵션 `lock orientation` 추가 ```` - `AutoMove` 모드에서 카메라를 자유롭게 회전시킬 수 있도록, `lock orientation` 옵션이 추가되었습니다. - 활성화(기본값): 카메라가 항상 다음 경로의 위치를 바라봅니다. - 비활성화: 카메라를 1인칭 시점에서 회전시킬 수 있습니다(오른쪽 마우스 버튼 사용). - 사용 방법 ```Javascript // AutoMove 설정 Module.getViewCamera().setAnimationSpeed(1); Module.getViewCamera().startAutoMove(); Module.XDRenderData(); // 비활성화 함으로써, 카메라 자유롭게 이동 가능 Module.getViewCamera().setLockOrientationAutoMove(false); ``` - 자세한 사용 방법은 [샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?id=camera_move_path_visualize)을 확인해주시기 바랍니다. ```` #### 6. 서비스 레이어 범위 제한 옵션 `boundaryLimit` 추가 ```` - 서비스 레이어에서 오브젝트를 요청할 때, 요청하는 범위를 경도/위도로 제한할 수 있도록 `boundaryLimit` 옵션이 추가되었습니다. - 활성화: 기존 방식에서, 미리 지정해 놓은 범위에 포함되는 오브젝트만 호출합니다. - 활성화한 이후에도, `JSLayer::setLimitBoundary()` API를 사용하여 범위를 제한하여야 합니다. - 비활성화(기본값): 기존 방식과 동일하게 오브젝트를 호출합니다. - 사용 방법 ```Javascript // 샌드박스에서 제공하는 let layer = Module.getTileLayerList().createXDServerLayer({ url : "https://xdworld.vworld.kr", servername : "XDServer3d", name : "facility_build", type : 9, minLevel : 0, maxLevel : 15 }); // Json 형태의 매개변수로 범위 지정 layer.setLimitBoundary({ boundary: { min: [129.125, 35.161], // Lower left max: [129.141, 35.168] // Upper right } }); layer.boundaryLimit = true; // 옵션 활성화 ``` - 자세한 사용 방법은 [샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?id=layer_request_boundary)을 확인해주시기 바랍니다. ```` ### 2.11.2 (2025/02/24) * 3DTiles B3DM 피킹이 제대로 되지 않던 오류를 수정하였습니다. ### 2.11.1 (2025/02/17) * 다울지도 네트워크 요청시 발생하는 오류가 수정되었습니다. ### 2.11.0 (2025/02/10) #### 1. `3DTiles` 높이 오프셋 옵션 추가 ```` - `import3DTiles()`에 높이 오프셋(단위 m)를 설정할 수 있는 옵션 `offsetZ`가 추가되었습니다. - 자세한 사용법은 아래 예시를 확인해주시기 바랍니다. ```javascript var pLayerList = new Module.JSLayerList(true); if(pLayerList==null) return; var pLayer = pLayerList.nameAtLayer("Layer3DTiles"); if(pLayer==null) { pLayer = pLayerList.createLayer("Layer3DTiles", Module.ELT_3DTILES); } pLayer.import3DTiles({ url : _strURL, autoMove : true, offsetZ : _fOffsetZ, // 높이 오프셋. 단위 m }); ``` ```` #### 2. 성절토 바닥/옆면 타일링 텍스쳐 설정 API 추가 ```` * 성절토 바닥 텍스쳐 설정 시 텍스쳐 반복 출력(타일링)이 가능하도록 API가 추가되었습니다. * API 설정 시 1.0보다 큰 값을 n값을 입력하면 설정한 텍스쳐가 n번 반복 출력됩니다. * API 호출 이후 생성되는 성절토 객체에 해당 값이 적용됩니다. * 성절토 바닥면 텍스쳐 설정 * bool setBottomTextureTilingScale(float u, float v) * class : JSEditTerrain * parameter * u : 가로 반복 u 좌표 * v : 세로 반복 v 좌표 * 성절토 옆면 텍스쳐 설정 * bool setSlopeTextureTilingScale(float u, float v) * class : JSEditTerrain * parameter * u : 가로 반복 u 좌표 * v : 세로 반복 v 좌표 ``` javascript Module.getEditTerrain().setBottomTextureTilingScale(10.0, 10.0); Module.getEditTerrain().setSlopeTextureTilingScale(10.0, 10.0); ``` ```` #### 3. 비디오 객체 오류 수정 ``` * 초기화 시 계속적으로 Hls 네트워크 요청하는 오류가 수정되었습니다. * 뒷배경 on/off 기능이 추가되었습니다. [비디오 객체](https://sandbox.egiscloud.com/code/main.do?id=object_video_placement) ``` #### 4. `JSLayer::setObjectVisibleWithBoundary()` API 추가 * 매개변수로 전달한 좌표를 벗어날 경우, 오브젝트를 그리지 않도록 설정하는 함수를 추가하였습니다. * 함수 정보 * boolean setObjectVisibleWithBoundary(number minLon, number maxLon, number minLat, number maxLat) * class : JSLayer * parameter * minLon: 최소 경도 * maxLon: 최대 경도 * minLat : 최소 위도 * maxLat : 최대 위도 ```javascript // 레이어 및 오브젝트 생성 sampleLayer.setObjectVisibleWithBoundary(129.5, 130, 35.16, 35.19); ``` ### 2.10.2 (2025/01/21) #### 1. `3DTiles` 포맷 처리 기능 안정화 * `3DTiles` 파일 처리 속도를 개선하였습니다. * 로딩한 모델이 깜박이는 오류를 수정하였습니다. #### 2. 성절토 바닥 타일링 텍스처 설정 API 추가 * 성절토 바닥 텍스쳐 설정 시 텍스쳐 반복 출력(타일링)이 가능하도록 API가 추가되었습니다. * API 설정 시 1.0보다 큰 값을 n값을 입력하면 설정한 텍스쳐가 n번 반복 출력됩니다. * API 호출 이후 생성되는 성절토 객체에 해당 값이 적용됩니다. * bool setBottomTextureTilingScale(float u, float v) * class : JSEditTerrain * parameter * u : 가로 반복 u 좌표 * v : 세로 반복 v 좌표 `javascript Module.getEditTerrain().setBottomTextureTilingScale(10.0, 10.0);` #### 3. `JSPolygon` 텍스처 오류 수정 * `JSpolygon` 객체에 반투명한 텍스처가 제대로 적용되지 않는 오류를 수정하였습니다. ### 2.10.1 (2025/01/03) #### 1. `createTMCoordPlane()` 기능 개선 ```` - `createTMCoordPlane()` API의 매개변수 정의 방식이 수정되었습니다. 자세한 사항은 아래 문서를 확인하여 주시기 바랍니다. - 변경된 양식 ```Javascript JSPolygon.createTMCoordPlane({ llcorner : { coordCode : [좌표계코드, 필수], x : [좌하단 X 좌표, 필수], y : [좌하단 Y 좌표, 필수] }, grid : { col : [그리드 가로 총수, 필수], row : [그리드 세로 총수, 필수], cellSize : [그리드 셀의 가로 세로 크기, 필수], ratioMode : [New 배율모드 사용 여부 0 - 기존 gab방식, 1 - 배율모드사용, 선택], xSplit : [ New 가로 분할 배율, ratioMode 1일때 필수], ySplit : [ New 세로 분할 배율, ratioMode 1일때 필수] } }); ``` - 사용 예시 ```Javascript polygon.createTMCoordPlane({ llcorner : { coordCode : 20, x : 216701.99445382116 , y : 220328.8122727003 }, grid : { col : 644, row : 585, cellSize : 10, ratioMode : 1, xSplit : 10, ySplit : 10 } }); ``` ```` ### 2.10.0 (2024/12/27) #### 1. `Stereo View` 모드의 로컬 레이어 오류 수정 * `Stereo View` 모드에서 로컬 레이어를 사용할 경우, POI가 왼쪽 화면에만 그려지는 오류를 수정하였습니다. ### 2.9.2 (2024/12/16) #### 1. `Real3D` 텍스처 요청 개수 제한 API 추가 * `Real3D`에서 최대 텍스처 요청 개수를 제한할 수 있도록, `JSOption::setMaxRequestTextureQueueSize()` API가 추가되었습니다. | Name | Type | Description | | -------------- | ------ | ------------------------ | | maxTextureSize | number | 텍스처를 요청하는 최대 개수(1\~20개). | ```javascript Module.getOption().setMaxRequestTextureQueueSize(20); // 20개의 텍스쳐 요청 ``` #### 2. `Real3D` 텍스처 레벨 고정 API 추가 * `Real3D`에서 요청하는 텍스처 레벨을 고정할 수 있도록, `JSMap::fixedTextureLevel()` API가 추가되었습니다. | Name | Type | Description | | ----- | ------ | ------------------ | | level | number | 텍스처 요청하는 레벨(0\~5). | ```javascript Module.getMap().fixedTextureLevel(0); // 고정레벨 지정 ``` ### 2.9.1 (2024/12/06) #### 1. glTF 모델의 회전 및 크기 조절 기능 추가 * glTF 모델을 유연하게 사용할 수 있도록, 회전과 크기 조절 기능이 추가되었습니다. * 회전의 경우 XYZ축을 기준으로 회전 각도를 조절할 수 있습니다. ```javascript var polygon = Module.createGLTF("GLTF_Object"); polygon.loadFile({ url: url, type: "glb", position: pos, rotate: [0, 90, 0], // XYZ 축 방향 회적 각도(Degree) scale: [1.0, 10.0, 1.0], // XYZ축 방향 스케일 변경. (1.0= 원래 크기) rebuild: true, }); ``` #### 2. split view 하이브리드 가시화 기능 추가 * 하이브리드 모드가 `split view`에서도 정상적으로 보일 수 있도록 기능을 추가하였습니다. #### 3. stereo view/split view 모드 오브젝트 렌더링 오류 수정 * `stereo view/split view` 모드에서, 반투명한 상태의 오브젝트 출력이 제대로 되지 않는 오류를 수정하였습니다. #### 4. JSPolygon::setHeightByType() API 추가 * `type`에 따라 평면 폴리곤의 윗면을 생성하는 API를 추가하였습니다. | Name | Type | Description | | ---------------- | ------ | ---------------------------------------------------------------------------------------------- | | heightOrAltitude | number |

버텍스에 적용할 높이 혹은 고도.

0일 경우: 높이로 사용.

1일 경우: 고도로 사용.

| | type | number |

윗면 생성 방식 설정.

0일 경우: 각 밑면 버텍스에서 height만큼 높인 윗면 생성.

1일 경우: 균일한 고도의 평평한 윗면 생성.

| ```javascript var polygon = Module.createPolygon("POLYGON"); var vertex = new Module.JSVec3Array(); var part = new Module.Collection(); for (var i = 0; i < _vertex.length; i++) { for (var j = 0; j < _vertex[i].length; j++) { vertex.push(_vertex[i][j]); } part.add(_vertex[i].length); } polygon.setPartCoordinates(vertex, part); // Set as a polyhedron polygon with height // type == 0 //polygon.setHeightByType(80, 0); // type == 1 polygon.setHeightByType(120, 1); //... ``` ### 2.9.0 (2024/11/29) #### 1. Inspector 기능 항목 추가 * 기존 `Inspector` 기능에서, 지형 데이터(dem/image)를 요청하는 대기열의 크기를 확인할 수 있도록 수정하였습니다. * 자세한 사용법은 [샌드박스 샘플](https://sandbox.egiscloud.com/code/main.do?id=option_inspector)을 참고해주시기 바랍니다. ### 2.8.4\_hotfix (2024/11/22) #### 1. 깜박임 오류 수정 * 특정한 상황에서, 지도가 제대로 그려지지 않고 깜박이는 오류를 수정하였습니다. #### 2. 건물 simple mode 옵션 추가 * 그라데이션 모드(아래에서부터 위로 점점 밝아지는 음영 효과)가 추가 되었습니다. * Light 방향을 조절할 수 있는 옵션이 추가되었습니다. #### 3. HTMLObject의 element 속성 추가 * `HTMLObject.element` 프로퍼티가 추가되었습니다. * 자세한 사용법은 [메뉴얼](https://egiscorp.gitbook.io/xdworld-webgl-manual/introduce-1/object/jshtmlobject#properties)을 참고해주시기 바랍니다. ### 2.8.3\_hotfix (2024/11/15) #### 1. JSPolygon.setWaterEffect() 오류 수정 * `JSPolygon`에서 setWaterEffect()를 호출시, 검은 배경이 나타나는 오류를 수정하였습니다. ### 2.8.2\_hotfix (2024/11/08) #### 1. glTF 애니메이션 오류 수정 * 특정 glTF 모델의 애니메이션이 정상적으로 재생되지 않는 오류를 해결하였습니다. #### 2. `JSLayer`에 `object_ahead` 속성 추가 * 레이어 차원에서 `object_ahead` 옵션을 관리할 수 있도록, `JSLayer`의 속성이 추가되었습니다. * 사용법 1. 먼저 해당 옵션을 사용하기 위해, `JSOption.object_ahead` 를 `true`로 설정하여야 합니다. 2. `JSOption`와 `JSLayer`의 `object_ahead` 가 모두 `true`일 경우, 해당 레이어에 속한 3d point 오브젝트에 옵션이 적용됩니다. * `JSOption`의 `object_ahead` 가 `true`여도 `JSLayer` 의 `object_ahead` 가 `false`이면 옵션이 적용되지 않습니다. * `object_ahead` 란? * (카메라 기준)지형 및 시설물(건물)이 3d point 오브젝트보다 가까이 있을 경우, 오브젝트가 가려지도록 하는 옵션 * 자세한 사용법은 [링크](https://sandbox.egiscloud.com/code/main.do?id=object_ahead)를 참고해주시기 바랍니다. * 주의 사항 * `JSLayer.object_ahead` 속성은 `ELT_3DPOINT` 레이어에만 적용됩니다. 다른 속성의 레이어에서는 `JSOption.object_ahead`을 사용해주시기 바랍니다. ### 2.8.1\_hotfix (2024/11/01) #### 1. JSTraceTarget의 glTF 애니메이션 포맷 지원 * JSTraceTarget에서 애니메이션이 포함된 glTF 포맷을 지원하도록 기능이 확장되었습니다. #### 2. Real3DPack의 객체 버전 확장 적용 * Real3DPack 레이어가 다양한 버전의 객체를 사용할 수 있도록 기능이 확장되었습니다. ### 2.8.0 (2024/10/25) #### 1. 지형과 알파 값이 있는 객체 간의 렌더링 순서 정리 * 지형과 알파(투명) 값이 존재하는 객체들과의 가시화가 어색하지 않도록, 렌더링 순서를 변경하였습니다. #### 2. 파이프 색상 변경 오류 수정 * 간소화 상태에서 파이프 색상 변경 시 색상 값이 정상적으로 적용되지 않는 현상을 수정하였습니다. #### 3. 외부 폰트 기반 POI Text 이미지 생성시 발생하는 오류 수정 * Text 이미지 생성이 정상적으로 작동되지 않는 현상을 수정하였습니다. #### 4. 소형 시설물의 LOD Texture 미적용 오류 수정 * 카메라 거리에 따른 시설물 LOD 변경 기능이 동작되지 않는 현상을 수정하였습니다. #### 5. JSPolygon::createVerticalGrid() API 추가 * 수직 평면 그리드 객체를 생성하는 API가 추가되었습니다. * 파라미터: 레이어명, 좌하단, 우상단, 새로 개수, 가로 개수 * 자세한 사용법은 [링크](https://sandbox.egiscloud.com/code/main.do?id=object_vertical_grid)를 참고해주시기 바랍니다. #### 6. JSFigure::getRectInfo() API 추가 * 생성된 `Figure` 객체에서 4개의 꼭지점을 반환합니다. * 자세한 사용법은 [링크](https://sandbox.egiscloud.com/code/main.do?id=object_figure_coordinate)를 참고해주시기 바랍니다. ### 2.6.1 (2024/09/03) #### 1. 배경지도 오류 수정 * 0레벨 로딩시 텍스쳐 깨지는 현상 발생하여 수정하였습니다. ### 2.6.0 (2024/08/30) #### 1. 지형 쉐이더 컴파일 오류 처리 기능 추가 * 지형 쉐이더를 컴파일할 경우, 디바이스별로 쉐이더 컴파일 조건이 다르므로 실패하는 경우가 있습니다. * 이를 방지하기 위해, 컴파일 실패시 조건 수정후 다시 컴파일하는 기능이 추가되었습니다. #### 2. 멀티뷰(화면 분할) 모드 오류 수정 * `멀티뷰 모드`에서 지형이 깜박이던 현상을 수정했습니다. #### 3. 멀티뷰(화면 분할) 모드 레이어 가시화 기능 추가 * `멀티뷰 모드`에서, `RTT/하이브리드` 레이어의 가시화를 제어할 수 있는 기능이 추가되었습니다. #### 4. POI 가시화 개선 * POI 레벨 범위(시작, 끝)에 따른 가시화 구조를 수정하였습니다. * `ETLT_USER_LAYER`를 통해 생성한 POI에 대한 `object_ahead` 옵션 설정에 따른 가시화 기능을 수정하였습니다. #### 5. Base Map 기능에서, Bing Map(전체)/OSM(Terrain) 항목 서비스 종료 * Base Map에서, Bing Map과 Open Street Map(terrain)에 대한 서비스를 종료하였습니다. * 자세한 사항은 [링크](https://sandbox.egiscloud.com/code/main.do?id=layer_basemap)를 참고해주시기 바랍니다. ### 2.5.1 (2024/08/09) #### 1. JSHTMLObject 이동 기능 추가 * JSHTMLObject 내부 변수 "position"을 통해 현재 위치와, 변경 위치 설정하는 변수가 추가되었습니다. ```javascript // Get let position = htmlObject.position; // Set let position = new Module.JSVector3D(lon, lat, alt); htmlObject.position = position; ``` * 입력, 출력은 경위도 값이 기준입니다. #### 2. POI 가시범위 API 기능 개선 확장 * JSPoint에 개선된 가시범위 설정 API가 추가되었습니다. ```javascript // 가시 범위 설정 예시 poi.setRange({ enable: true, // 가시 범위 사용 여부 setVisibleRange의 bEnable 파라메터와 동일 min: 1.0, // 가시 범위 최소 범위 setVisibleRange의 dMin 파라메터와 동일 max: 1000.0, // 가시 범위 최대 범위 setVisibleRange의 dMax 파라메터와 동일 textMin: 1.0, // 가시 범위 텍스트 최소 범위 min 과 같거나 커야함 textMax: 300.0, // 가시 범위 텍스트 최대 범위 max 과 같거나 작아야함 }); ``` * 기존 POI 객체 표현범위 설정 (Icon 기준)에서 Text에 대한 추가 표현 범위를 설정합니다. #### 3. JSPipe 흐름 화살표 기능 개선 * 평면 형태의 화살표를 3차원 입체 구조로 개선하였습니다. * 일부 지역에서 화살표 생성 시 방향이 올바르게 정렬되지 않는 현상을 수정하였습니다. * 파이프 지점 높낮이에 따라 화살표의 틸트 각도가 함께 적용되도록 수정하였습니다. #### 4. face 데이터로 JSPolygon을 생성하는 'JSPolygon.createWithFaces()' API 추가 * 사용자가 정의한 face 데이터를 기반으로 JSPolygon을 생성하는 기능이 추가되었습니다. * 사용자는 형식에 맞춘 JSON 데이터를 파라메터로 전달함으로써, JSPolygon을 생성할 수 있습니다. * 자세한 사용법은 샌드박스 [링크](https://sandbox.egiscloud.com/code/main.do?id=object_faces_to_polygon)를 참고하시기 바랍니다. ```javascript let parameter = { upVector: /*업벡터 좌표축*/, cullMode: /*버텍스 정의 방향*/, position: /*모델 중심 위치*/, moveOffset: /*위치 오프셋(세부 조정)*/, faceInfo: [ { vertex: /*버텍스 위치*/, matrix: /*변환(4x4 행렬)*/, indexVertex: /*버텍스 인덱스*/, indexUV: /*텍스처 좌표 인덱스*/, uv: /*실제 텍스처 좌표*/, normal: /*노멀 벡터*/, color: /*색상*/ } ] } polygon.createWithFaces(parameter); ``` ### 2.5.0 (2024/7/26) #### 1. 웹 워커 기능 개선 * 기능 개선 및 파일 용량을 감소하여 기능 개선하였습니다. #### 2. 도로 시설물 생성 기능 개선 * 도로 시설물 중 교량의 교각이 일정 높이 이하인 부분은 생성이 되지 않도록 예외처리 단계가 추가되었습니다. #### 3. 빌보드 수직선 옵션 추가 * 빌보드 중심을 기준으로, 지면까지의 수직선을 생성 및 수정하는 API가 추가되었습니다. ```javascript parameter = { visible: true, // 가시화 여부(기본값: false) width: 10.0, // 수직선 두께(기본값: 1.0) color: JSColor(255, 15, 100, 200), // 수직선 색상(기본값: JSColor(255, 255, 255, 255)) altitude: 30.0, // 수직선 끝점 고도(기본값: 0) }; billboard.setVerticalLine(parameter); ``` * 성공적으로 생성/수정하였을 경우 true를 반환합니다. * API의 자세한 사용법은 샌드박스 [링크](https://sandbox.egiscloud.com/code/main.do?id=object_billboard_line)를 확인해주시기 바랍니다. #### 4. 지형의 0레벨 지구본 위성영상 자체 포함 * 0레벨에 대한 지구본 위성영상을 자체 포함하도록 적용 되었습니다. * 지도 서버에 연결이 정상적이 않아도 지구본은 기본적으로 구성됩니다. * 0 레벨 요청을 실패하여 반복적 네트워크 요청을 처리하지 않습니다. * 엔진의 파일용량이 소폭 증가합니다. ### 2.4.0 (2024/6/28) #### 1. 화면 분할 시 잔상이 남는 현상 수정 * 지형 투명도 조절과 함께 화면 분할 기능 사용 시 분할 화면에 잔상이 남는 현상을 수정하였습니다. * 화면 분할 기능 사용 시 레이어 배치 방향이 반대로 보이는 점을 확인하여 수정하였습니다. #### 2. Camera Quake의 진동 오류 수정 * Camera Quake(카메라 흔들림)기능에서, 진동 주기가 초단위로 적용되는 오류를 수정하였습니다. #### 3. JSFlowPolygon 객체 색상 설정 오류 수정 * create API 실행 전 color 속성 설정 시 값이 정상적으로 반영되지 않는 현상을 수정하였습니다. #### 4. 전광판, 비디오 객체 기능 개선 * 사용자 편의성을 위해 객체 생성 이후의 기능들 엔진 내부에 삽입 및 속도개선되었습니다. * 기존 비디오 텍스쳐 관련 기능은 2024년까지 지원합니다. * 새로운 사용법은 [비디오텍스쳐](https://sandbox.egiscloud.com/code/main.do?id=object_video)를 참고하시기 바랍니다. #### 5. WMS 로딩 방식 선택 * 사용자의 통신 환경과 WMS 및 하이브리드 상태에 따라 선택 가능하도록 API가 추가되었습니다. ```javascript // Default : 0 //Module.getOption().setHybridRenderType(0); // 기존과 동일 Module.getOption().setHybridRenderType(1); // 변경된 순서에 따라 바로 반영 ``` #### 6. 장해물 판별 기능 추가 * 카메라와 JSPoint, JSHTMLObject 객체 사이에 장해물(지형, 시설물) 존재 시 가시화 유무를 설정하는 변수를 추가 하였습니다. ```javascript Module.getOption().object_ahead = 0; 기존 방식(장해물 미판정) Module.getOption().object_ahead = 1; 장해물에 따른 가시화 설정 ``` #### 7. 카메라 좌/우 이동 API 추가 * 카메라 이동 함수 moveLeftRight가 추가되었습니다. * 지정한 값 만큼 카메라가 좌/우 방향으로 이동합니다. ```javascript Module.getViewCamera().moveLeftRight(0.01); Module.getViewCamera().moveLeftRight(-0.01); ``` #### 8. 레이어 화면 분할 렌더링 기능 오류 수정 * 화면 분할 기능 사용 시 좌/우 방향이 반대로 적용되는 현상을 수정하였습니다. * 화면 분할 후 특정 화면에서 화면의 잔상이 남는 현상을 수정하였습니다 [이슈 #401](https://github.com/EgisCorp/XDWorld/issues/401) ### 2.3.1 (2024/5/31) #### 1. (중요)glTF 최적화(WebWorker) * glTF 포맷과 관련하여, WebWorker가 업데이트 되었습니다. * 업데이트된 WebWorker 빌드 파일의 사용을 권장합니다. #### 2. JSColorGrid3D 오브젝트 속성 반환 함수 추가 * JSColorGrid3D 오브젝트의 속성 반환 함수가 추가되었습니다. * \[getCellBox] 인덱스에 해당하는 셀의 박스 좌표 정보를 반환합니다. * 박스 좌표는 상단/하단, 좌/우, 위/아래로 구분되는 좌표 8개를 반환합니다. * 반환 되는 박스의 좌표 속성 값의 순서는 아래와 같습니다. * 0 : upLeftTop * 1 : upRightTop * 2 : upRightBottom * 3 : upLeftBottom * 4 : downLeftTop * 5 : downRightTop * 6 : downRightBottom * 7 : downLeftBottom ```javascript var cellBox = grid.getCellBox(20, 12); ``` * \[getCellHeight] 인덱스에 해당하는 셀의 높이 값을 반환합니다. ```javascript var height = grid.getCellHeight(20, 12); ``` * \[getCellWidthCount] 그리드의 가로 셀 수를 반환합니다. ```javascript var widthCellCount = grid.getCellWidthCount(); ``` * \[getCellHeightCount] 그리드의 세로 셀 수를 반환합니다. ```javascript var heightCellCount = grid.getCellHeightCount(); ``` ### 2.3.0 (2024/5/24) #### 1. JSColorGrid 오브젝트 반환 기능 추가 * JSLayer의 오브젝트 반환 시 JSColorGrid 오브젝트도 반환 가능하도록 기능을 추가하였습니다. #### 2. 수인한도분석 진행률 반환 기능 추가 * CJSAnalysisGridShadow::prograss 분석 진행률을 반환하는 callback 함수를 추가하였습니다. #### 3. 수인한도분석 배척격자 오류 수정 * 배척격자가 그림자를 생성하거나, 선택이 되지 않는 오류가 수정되었습니다. #### 4. JSPolygon으로 고스트 심볼 생성하는 기능 추가 * 고스트 심볼을 생성할 때 외부에서 모델 파일을 입력해주는 대신, 미리 생성한 JSPolygon으로 정의가 가능하도록 `JSGhostSymbolMap.insert()`에 `polygon`인자를 추가하였습니다. * 자세한 사용법은 [샌드박스 - Ghostsymbol(Polygon)](https://sandbox.egiscloud.com/code/main.do?id=object_polygon_to_ghost_symbol)을 참고해주시기 바랍니다. ### 2.2.2 (2024/5/3) #### 1. WMS 오류 해결 * WMS 기능을 사용할 때, 깜박거리는 현상이 수정되었습니다.