GeOnDT GeOnDT for JS

Class: UAnalyHeight

UAnalyHeight

~extends UAnaly
높이 및 고도를 측정하는 클래스
사용자가 입력한 좌표의 높이를 측정하고 POI로 표출하는 기능을 제공합니다.

new UAnalyHeight(opt)

Name Type Default Description
opt UAnalyHeight~UAnalyHeightCO {} optional
Example
let analy = app.activeAnalysis('Height');
analy.active();

Members

MAX_STYLE_ENTRIESnumber

setUserStyle()로 설정할 수 있는 최대 고도 스타일 항목 수

Methods

active()

고도 분석 기능 활성 함수
클릭 이벤트를 활성화 해, 사용자가 클릭한 위치의 높이/고도를 측정하고 POI로 표출한다.

addExceptObject(object)boolean

고도 후처리 제외 목록에 대상 하나를 추가한다.

Name Type Description
object Object3D | U3dComponentPosition

제외할 대상
Returns:
Type Description
boolean 추가 성공 여부

clear()

고도 분석 기능 초기화 함수
POI로 표출된 높이/고도 분석 결과를 초기화한다.

clearExceptObjects()void

고도 후처리 제외 목록을 모두 해제한다.

Returns:
Type Description
void

deactive()

고도 분석 기능 비활성 함수
클릭 이벤트를 제거한다.

drawHeight(val)void

높이 색상 가시화 여부를 설정한다.

Name Type Description
val boolean

활성화 여부
Deprecated
  • setHeightVisible() 사용을 권장한다.
    Returns:
    Type Description
    void

    getExceptObjects()Array.<(Object3D|U3dComponentPosition)>

    현재 고도 후처리 제외 목록의 복사본을 반환한다. 반환 배열을 수정해도 실제 목록은 바뀌지 않는다.

    Returns:
    Type Description
    Array.<(Object3D|U3dComponentPosition)> 제외 대상 배열

    getUserStyle()Record.<string, string>|undefined

    현재 설정된 사용자 스타일의 복사본을 반환한다. 반환 객체를 수정해도 실제 스타일은 변경되지 않으며, 변경하려면 setUserStyle()을 호출해야 한다.

    Returns:
    Type Description
    Record.<string, string> | undefined 사용자 스타일 복사본

    isHeightVisible()boolean

    현재 Height pass에 높이 색상 가시화가 적용되어 있는지 반환한다. active()/isActive()가 나타내는 클릭 측정 모드와는 별개의 상태다.

    Returns:
    Type Description
    boolean 높이 색상 가시화 여부

    removeExceptObject(object)boolean

    고도 후처리 제외 목록에서 대상 하나를 제거한다.

    Name Type Description
    object Object3D | U3dComponentPosition

    제외를 해제할 대상
    Returns:
    Type Description
    boolean 목록에 있어 제거된 경우 true

    setExceptObjects(objects)boolean

    고도 색상 범례와 등고선 후처리에서 제외할 대상 목록을 설정한다. 제외된 대상에는 범례 색상과 등고선이 적용되지 않아 본연의 색상으로 표시된다. Object3D(mesh·그룹 등)를 전달하면 렌더 시점의 하위 객체 전체가 함께 제외되고, 컴포넌트 레이어의 컴포넌트 포지션을 전달하면 그 컴포넌트만 제외된다 — 일반 메쉬 타입은 자신이 복제해 소유한 형상만, 인스턴스 타입은 공유 InstancedMesh 형상 중 해당 인스턴스만 제외되므로 같은 형상의 다른 컴포넌트는 영향받지 않는다. 기존 제외 목록은 전달한 목록으로 교체되고 빈 배열을 전달하면 모두 해제된다.

    Name Type Description
    objects Object3D | U3dComponentPosition | Array.<(Object3D|U3dComponentPosition)>

    제외할 대상 또는 대상 배열
    Returns:
    Type Description
    boolean 설정 성공 여부
    Examples
    let analy = app.activeAnalysis('Height');
analy.setExceptObjects([mesh]);
analy.setHeightVisible(true);
    // 컴포넌트 포지션 단위 제외: 목록에 넣은 컴포넌트만 본연의 색으로 남는다.
const comps = ['drone-1', 'drone-2'].map((name) => layer.getComponentByName(name));
analy.setExceptObjects(comps);

    setHeightVisible(visible)boolean

    높이 색상 가시화 여부를 설정한다. 클릭 위치의 높이를 측정하는 active()/deactive() 상태와는 별개다.

    Name Type Description
    visible boolean

    가시화 여부
    Returns:
    Type Description
    boolean 설정 성공 여부

    setUserStyle(style)boolean

    사용자 스타일을 설정한다. mode는 "band" 또는 "mix"만 사용할 수 있고 숫자 형태의 키는 최대 UAnalyHeight.MAX_STYLE_ENTRIES개까지 사용할 수 있다. 전달받은 객체는 복사하여 저장하므로 이후 원본 객체를 수정해도 적용된 스타일은 바뀌지 않는다.

    Name Type Description
    style Record.<string, string>
    Returns:
    Type Description
    boolean 스타일 설정 성공 여부

    Type Definitions

    UAnalyHeightCOobject

    ~extends UAnaly~UAnalyCO
    생성자 옵션

    Properties:
    Name Type Argument Description
    name string <optional>

    분석 타입