공지

제목2.2.1.7.178.a 버전 업데이트 안내2025-07-16 15:51
카테고리GeOnDT for JS
작성자
첨부파일dist.zip (12.18MB)

업데이트 버전: 2.2.1.7.178.a

 

업데이트 내용:

[기능 추가 및 수정]
1. 지형의 스커트(타일간 이격 보정) 연산 성능이 향상되었습니다.
 지하모드시 고도 레이어의 출력성능이 향상되었습니다.

 

2. 고도 데이터를 다운로드 중 네트워크상 오류가 발생하였을때, 상위 고도를 재 사용하여 지형의 빈부분없이 출력 될 수있도록 하는 예외처리가 추가되었습니다.

 

3. 간혈적으로 지형 업데이트가 비정상적으로 실행되는 오류가 수정되었습니다.

 

4. 적용 three.js 의 버전이 업데이트 되었습니다. (R178)
 

5.일조량 분석 시 일조량 결과를 표현할때 그라데이션 또는 3D 큐브로 표현할지의 여부를 설정하는 옵션이 추가되었습니다.

 사용 방법은 analySunAmount 함수의 drawOpt 파라미터에 type 옵션을 "color" 또는 "cube"로 지정하면 됩니다. 기본값은 "color" 입니다

 

 

 결과 표시 타입이 "color"인 경우 사용자 범례는 아래와 같이 setUserStyle 함수 파라미터로 추가하여 설정 가능합니다. 
 파라미터는 key - value 형태의 Object 고 key는 범위의 최소값 (Min) 으로 지정합니다.

 

결과 표시 타입이 "cube"인 경우 기존 안내된 것 처럼 styleFun에 직접 함수를 작성해 color 값을 반환하시면 됩니다. 

 

 분석 결과를 완전히 초기화 하는 API는 app.endAnalySunAmount() 또는 analy.clear() 를 사용합니다. 

 

 개별의 분석 결과를 초기화 하는 API는 app.removeSunAmount(name) 또는 analy. remove SunAmountByName ( name ) 를 사용합니다. 

 

6. U2dDxfLayer에 styleFunction 속성이 추가되었습니다.

해당 기능을 통해 개별 객체에 스타일을 개별적으로 지정할 수 있으며, 레이어 생성 시 다음과 같이 스타일 지정 함수를 설정할 수 있습니다.

또는 setStyleFunction(function) 을 통해서 레이어 생성 후에 설정  할 수 있습니다.

  • styleFunction(Feature, Type)

    • Feature: 대상 정보를 기반으로 생성된 feature 객체

    • Type: 해당 feature의 타입 정보 

    • 반환값: OpenLayers Style 객체

    * U2dDxfLayer로 생성된 feature는 OpenLayers 스타일 형식을 따라야 하므로, styleFunction 내에서 ol.style.Style 객체를 반환해야 합니다.

 

 이를 통해 도면 객체별로 개별 스타일 설정 및 다양한 시각화를 적용할 수 있습니다.

 

스타일 함수 지정 예시 )

 

 스타일 적용 후 형상 )

 

7. U3dModelDxfLayer 에 styleFunction 속성이 추가되었습니다.

 해당 기능을 통해 개별 객체에 스타일을 개별적으로 지정할 수 있으며, 레이어 생성 시 다음과 같이 스타일 지정 함수를 설정할 수 있습니다.

 또는 setStyleFunction(function) 을 통해서 레이어 생성 후에 설정 할 수 있습니다.

  • styleFunction(entity, mesh)

    • entity : 객체 생성시 사용된 정보 ( 타입, 레이어 이름 포함된 정보 )

    • mesh : 해당 entity의 타입 정보로 생성된 3D 객체 

 해당 기능을 통해서 Mesh의 대한 스타일 설정 이 외의 가시화, 위치 설정도 개별적으로 적용 할수 있습니다.

 * 라인두께에 대한 설정은 현재 지원되지 않습니다.

 

 

 * U2dDxfLayer / U3dModelDxfLayer 의 반영된 내용은 예제 https://3d.geon.kr/doc/tutorial-official/localDxf.html 에서 자세히 확인 할 수 있습니다.

 

8. GESpreadObject 에 Grid Mesh 생성 기능이 추가 되었습니다. AnalyParticle 의 createGridMesh를 사용하여 분석모드 실행 없이 바로 생성 가능 합니다.

 GridMesh 객체 추가로 인한 생성된 API 설명

  • createGridMesh(option) : Grid Mesh 생성 함수
    • option : 오염확산 분석 모드 실행 정보 객체 (* grid data : 오염도 수치 정보 필요 )
  • showGridMesh(val, name, idx) : Grid Mesh 가시화 설정 함수
    • val : 가시화 여부
    • name [선택옵션] : 대상 이름
    • idx [선택옵션] : 대상 데이터 설정시 순서 번호
  • getGridMeshDataAtPosition(x, y, createMesh) : x, y (3D World) 좌표를 입력 받아 해당 위치에 grid Mesh의 정보를 반환하는 함수
    • x : 3D World X 좌표
    • y : 3D World Y 좌표
    • createMesh : 해당 하는 위치 영역을 나타내는 객체 생성 여부 ( Highlight 객체 )
  • getHighlightedFaces() : Highlight 객체를 담고 있는 그룹 반환
  • setVisibleHighlightedFaces(visible) : Highlight 객체를 담고 있는 그룹 가시화 설정 함수
    • visible :  가시화 여부
  • getHighlightedFacesAtIndex(idx) : Highlight 객체를 담고 있는 그룹 중에 해당하는 idx 객체 반환
    • idx : 해당 하는 데이터 순서의 번호 
  • removeAllGridMeshHighlight() : 생성된 Highlight 객체 전체 삭제 
  • removeGridMeshHighlight(idx) : 해당하는 idx의 Highlight 객체 삭제
    • idx : 해당 하는 데이터 순서의 번호 
  • createRangeHelper(mesh, result, position, option) : getGridMeshDataAtPosition의 결과를 바탕으로 특정 영역을 시각화하는 함수
    • mesh : 조회 된 Grid Mesh
    • result : 조회 결과 값 (getGridMeshDataAtPosition 실행 리턴 객체)
    • position : 해당 영역내의 위치 값, 해당 위치에 데이터 값 및 위치를 알려주는 객체 생성
    • option : 영역에 대한 색상 및 투명도,  입력한 position 위치에 생성된 객체의 스타일 설정
  • getRangeHelper() : createRangeHelper로 생성된 영역 객체 반환 함수
  • setVisibleRangeHelper(visible) : createRangeHelper로 생성된 영역 객체 가시화 설정 함수
  • removeRangeHelper() : createRangeHelper로 생성된 영역 객체 제거 함수
    • visible : 가시화 여부

UAnalyParticle.createGridMesh(option) 호출하여 생성된 형상 ) 

 

 UAnalyParticle.getGridMeshDataAtPosition(), createRangeHelper()를 호출 하여 생성된 형상 ) 

 - 해당 영역에서의 좌표 정보 [ 데이터 최대값 , 최소값, 클릭한 지점에 데이터 수치값, 조회 한 데이터 위치의 위경도 좌표 값 ]

 

 *해당 예시의 내용은 https://3d.geon.kr/doc/tutorial-official/addonSpreadObject.html 에서 자세히 확인 하실수 있습니다.

 

9. 카메라의 상태 저장 및 불러오기 기능이 추가 되었습니다. 

  • U3dApp.saveCameraState() : 카메라의 상태 저장 및 정보 반환
  • U3dApp.loadCameraState(cameraState, duration) : 카메라 상태 불러오기 및 위치 이동, 카메라 회전
    • cameraState [선택옵션] : 기존에 저장한 카메라 상태 정보, 미 입력시 저장된 상태 정보 사용
    • duration [선택옵션] : 불러온 카메라 상태의 위치 이동 및 회전까지의 소요 시간, 미 입력시 3000ms

10 .UAnalyClipping 분석 모드에서 영역별 클리핑시에 U3F(2.2v) 건물 대상에 대한 필터링의 정확도가 향상되었습니다.