업데이트 버전: 1.0.0.3.183.a

업데이트 내용:

1. 표면 체적 분석 기능(UAnalySurfaceVolume) 이 추가되었습니다.

사용자가 지정한 영역을 격자로 분할하고, 분석 대상 표면과 기준면을 비교하여 면적, 높이 차이, 절토량 및 성토량 등을 계산하는 'UAnalySurfaceVolume' 분석 기능이 추가되었습니다.

이번 기능에서는 분석 결과와 가시화 객체를 분리하여, 분석 완료 후 필요한 가시화 항목만 선택적으로 추가하거나 제어할 수 있습니다.

주요 기능은 다음과 같습니다.

• 분석 대상 레이어 또는 객체 개별 설정

• 고정 높이, 최저 높이, 지형, 레이어 등을 기준면으로 설정

• Polygon 영역 등록 및 격자 기반 표면 샘플링

• 절토량, 성토량, 순 체적, 면적 및 높이 차이 계산

• Boundary, Grid, Heatmap, Vertical Line 등의 개별 가시화

• 분석 영역 및 결과 저장·복원

• 분석 진행률, 완료, 오류 및 취소 이벤트 제공

1. 예제 초기 화면 ( https://3d.geon.kr/doc/tutorial-official/analysisSurfaceVolume.html )

 - 3DTiles 대상 레이어 생성 된 초기 화면입니다.

 - 표면 체적 분석 설정 패널 정보

1. 대상 및 기준면 

   분석 대상 : 레이어 또는 개별 객체등 대상 타입을 지정합니다. 

   대상 이름 : 대상의 레이어이름 또는 개별 객체의 key값을 설정합니다.

   기준면 : 비교기준이 되는 면 유형 선택

• 지형레이어 : 지형 레이어 기준
• 기준 모델 (또는 레이어)
• 영역 최저 평면
• 고정 고도 - 선택시 기준 고도 설정 가능 (m 단위 : 화면상 - 100m)

2. 분석 품질

   격자 크기 : 생성 되는 격자의 한 변 길이 (m 단위)

3. 고급 설정

   최대 격자 : 생성되는 최대 격자 갯수 (해당 수치가 넘어가면 생성되지 않습니다. )

   높이 오차 : 표면 비교시 허용 오차 (m 단위)

4. 가시화 설정

   영역 외곽선 : 영역 경계 표시

   격자 : 분석 셀 표시 

   높이 heatmap : 높이 차이를 색상으로 표시

   절토 성토 수직선 : 대상 모델의 면과 기준면의 차이 표시선

   기준면 : 기준면 표시

5. 하단 버튼 내용

   영역 그리기 : 분석 영역에 대한 클릭 이벤트 추가 및 시작

   그리기 종료 : 입력 종료

   계산 취소 : 계산 진행 중 분석 취소

   전체 초기화 : 분석 영역 / 결과 초기화

   결과 패널 열기 : 결과 확인 패널 열기 / 닫기

2. 기본 사용 방법

다음과 같은 순서로 표면 체적 분석을 실행할 수 있습니다.

 - 초기 분석 모드 설정

 - 영역 그리기 클릭 이벤트 추가

 - analy.startDraw() 호출 후 영역 그리기 ( 더블클릭으로 그리기 종료 )

 - 'drawEnd' 이벤트 : 그리기 종료 이벤트 호출로 그려진 영역에 대한 결과값 반환 받을 수 있습니다.

geoVertex : 영역의 위경도 좌표 목록 

worldVertex : 영역의 EPSG:3857 좌표 목록

projected : 영역의 수평 면적

surface : 영역의 평면 면적

 - 결과 영역을 분석 영역으로 등록 

analy.addVolumeArea(option) : 분석 영역을 추가합니다. 

id (string): 영역 ID

name (string) : 영역 이름

geoVertex (Array<Vector3>) : 위경도 좌표 목록

worldVertex (Array<Vector3>): EPSG:3857 좌표 목록

 geoVertex와 worldVertex는 선택 옵션이지만 둘 중에 하나는 입력해야합니다.


- 영역 및 분석 대상, 수평 면적 확인

 - analy.runAnalysis(id) : 표면 체적 분석 실행

id (string) : 영역 id

 - 분석 실행 및 결과 패널 확인
 

분석이 완료되면 결과는 해당 영역에 저장되며, analy.getResult(id)를 통해 다시 조회할 수 있습니다.

 - 결과 패널

3. 가시화 helper 객체 형상 출력

1 . 영역 기준면

 - 영역 기준면 출력

 - 영역 기준면 helper 생성 코드, analy.addBoundary()

 - 격자 형상 출력

 - 격자 helper 생성코드, analy.addGrid()

 - heatmap 형상 출력

 - heatmap helper 생성코드,  analy.addHeatmap()

 - 수직선 helper 형상

 - 수직선 helper 생성 코드,  analy.addVerticalLines()

상세한 적용 방법은 UAnalySurfaceVolume ( 표면 체적 분석 ) 가이드와 관련 예제 페이지를 참고하여 주시기 바랍니다.

2. TopoJSON 데이터 지원 기능이 추가되었습니다. 

U2dVectorShaderLayer에 TopoJSON 데이터를 적용할 수 있는 기능을 추가했습니다.
addGeometryAsTopojson 메서드를 사용하여 TopoJSON 데이터를 파싱하여 2D 벡터 형식으로 추가할 수 있습니다.

[메서드 설명 ]

addGeometryAsTopojson(topoJson, sourceCRS, callback)

- topoJson : 추가할 TopoJSON 데이터

- sourceCRS : 데이터의 좌표계. 미입력 시 레이어에 전역으로 설정된 좌표계를 사용합니다.

- callback : TopoJSON 데이터가 파싱되어 2D 벡터가 추가될 때마다 호출되는 콜백 함수입니다. 파라미터로 추가된 2D 벡터 객체와 해당 객체의 인덱스가 전달됩니다.

[예시] 

[관련 예제] - 2D 객체 그리기 예제 - TopoJSON 적용내용 입력 란에 TopoJSON 데이터 입력 후 적용하기 

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

3. U3dKmlModelLayer가 추가되었습니다. 

KML 파일을 읽어 포인트, 라인, 폴리곤을 3D 모델로 변환해 시각화하는 U3dKmlModelLayer를 새로 추가됬습니다.

[생성파라미터]

1. baseUrl: string - KML 파일 경로입니다. 반드시 필요합니다. 
2. kmlText?: string - KML 문자열을 직접 넣을 때 사용합니다.
3. heightField?: string -폴리곤 높이로 읽을 프로퍼티명입니다. 기본값은 'height'입니다.  styleFunction에서 지정한 height 값이 있으면 우선 적용 됩니다. 
4. styleFunction?: (properties, context) => KmlRenderStyle - 피처별 스타일 콜백입니다.

[예시]

[관련 예제] - KML Model Layer 예제

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

4. 3D Tiles 데이터를 출력하고 제어하는 U3dModelTilesLayer 의 성능이 개선되었습니다.

 - U3dModelTilesLayer의 데이터 파싱 및 객체 출력 기능이 개선 되었습니다.

5. 타입 인터페이스 정의가 개선되었습니다.

 - 타입 인터페이스 정의가 개선되어 GeOnDT.modules.d.ts 파일이 지원하는 타입 인터페이스 구성이 개선되었습니다.