업데이트 버전: 2.2.1.13.183.f
업데이트 내용:
U3dLodModelLayer 기능 추가 및 안정화 개선 안내
1. U3dLodModelLayer 기능 추가
U3dLodModelLayer 생성 시 typeLodTable 속성을 설정하여 해당 내용을 추가로 적용할 수 있습니다.
설정 방법은 아래의 [ 레이어 생성 설정 예시 ]를 참고해 주세요.
1.1 텍스처 평균 색상 적용 기능 ( textureToSampleColor : boolean )
가장 먼 거리에서 표시되는 LOD 모델에 원본 텍스처를 그대로 적용하는 대신, 텍스처의 평균 색상을 계산하여 단색 재질로 표현하는 기능이 추가되었습니다.
원거리 모델에서는 텍스처의 세부적인 무늬를 구분하기 어렵기 때문에, 평균 색상을 적용하면 원본 모델과 유사한 색상을 유지하면서도 텍스처 사용에 따른 렌더링 부하를 줄일 수 있습니다.
true : 가장 먼 거리의 LOD 모델에 텍스처 평균 색상을 적용합니다.false : 기존과 같이 텍스처를 적용합니다.- 옵션을 설정하지 않은 경우 기본값은
true입니다.
- 해당 기능은 가장 먼 거리의 LOD 모델에만 적용됩니다.
1.2 모델별 Material Type 설정 기능 ( materialType : string )
각 모델에 적용할 Material 종류를 선택할 수 있도록 materialType 옵션이 추가되었습니다.
지원되는 Material Type은 다음과 같습니다.
GeOnDT.model.U3dLodModelLayer.MATERIAL_TYPE.BASIC : 'basic'
GeOnDT.model.U3dLodModelLayer.MATERIAL_TYPE.LAMBERT : 'lambert'
GeOnDT.model.U3dLodModelLayer.MATERIAL_TYPE.STANDARD : 'standard'
GeOnDT.model.U3dLodModelLayer.MATERIAL_TYPE.PHYSICAL : 'physical'
| 설정값 |
특징 |
성능 |
표현 품질 |
basic |
조명의 영향을 받지 않는 단순 재질 |
가장 높음 |
낮음 |
lambert |
기본적인 조명과 음영을 표현 |
높음 |
보통 |
standard |
금속성 및 거칠기 기반의 재질 표현 |
보통 |
높음 |
physical |
보다 정교한 물리 기반 재질 표현 |
낮음 |
가장 높음 |
basic → lambert → standard → physical 순서로 재질 표현 품질이 향상되지만, 렌더링에 필요한 연산량도 함께 증가합니다.
별도의 값을 설정하지 않은 경우에는 기본적으로 lambert가 적용됩니다.
대량의 모델을 표시하거나 렌더링 성능이 중요한 환경에서는 basic 또는 lambert 사용을 권장합니다.
재질의 품질과 사실적인 표현이 중요한 경우에는 standard 또는 physical을 사용할 수 있습니다.
1.3 원거리 LOD Geometry 압축 기능 ( compressionRatio : number )
가장 먼 거리에서 표시되는 LOD 모델의 Polygon 수를 줄일 수 있도록 compressionRatio 옵션이 추가되었습니다.
- 설정 범위:
0 ~ 1
- 값이 높을수록 제거되는 Polygon 수가 증가합니다.
- 가장 먼 거리의 LOD 모델에만 적용됩니다.
- 옵션을 설정하지 않으면 Geometry 압축을 진행하지 않습니다.
원거리에서는 모델의 세부 형태를 확인하기 어렵기 때문에, Geometry를 단순화하면 화면상 형태를 유지하면서도 정점 및 Polygon 처리량을 줄일 수 있습니다.
다만 압축 비율을 지나치게 높게 설정하면 모델의 외형이 크게 변형되거나 일부 형태가 손실될 수 있으므로, 데이터 특성에 맞게 값을 조정하여 사용하는 것을 권장합니다.
2. 레이어 생성 설정 예시
- U3dLodModelLayer 생성 옵션 중 [ 'typeLodTable' ] 속성값 설정시 아래를 참고하여 설정하면 됩니다.
위 설정에서는 카메라와 모델 사이의 거리에 따라 다음과 같이 LOD 모델이 전환됩니다.
| 거리 |
적용 모델 |
추가 최적화 적용 여부 |
| 50 |
ABID_M_base |
적용되지 않음 |
| 400 |
ABID_M_middle |
적용되지 않음 |
| 20,000 |
ABID_M_low |
평균 색상 및 Geometry 압축 적용 |
materialType, textureToSampleColor, compressionRatio는 모델 유형마다 서로 다른 값으로 지정할 수 있습니다.
3. U3dLodModelLayer 안정화 개선
clearAllInstances를 이용해 기존 InstancedMesh를 초기화한 후 다시 생성하는 과정에서, 일부 인스턴스의 초기화 처리가 누락되어 모델이 정상적으로 재생성되지 않을 수 있는 현상이 개선되었습니다.
이번 수정에서는 초기화 과정에서 필요한 인스턴스 및 내부 상태 정보가 빠짐없이 정리되도록 보완하였습니다.
이에 따라 다음과 같은 사항이 개선되었습니다.
clearAllInstances 호출 시 일부 초기화 처리가 누락되는 현상 개선- InstancedMesh 초기화 이후 일부 모델이 재생성되지 않는 현상 개선
- 반복적인 초기화 및 재생성 과정의 안정성 향상
| 