DitapViewer

응용 프로그램을 개발하기 위한 기본 위젯. 이 위젯은 모든 표준 Ditap 위젯을 하나의 재사용 가능한 패키지로 구성.
언제든지 다양한 응용 프로그램에 유용한 기능을 추가하는 Mixin을 사용하여 확장 가능.
A base widget for building applications. It composites all of the standard Ditap widgets into one reusable package.
The widget can always be extended by using mixins, which add functionality useful for a variety of applications.

new Ditap.DitapViewer(container, props)

Name Type Description
container Element | string 뷰어를 넣을 DOM 요소 또는 요소 id.
The DOM element or ID that will contain the widget.
props DitapViewer.ConstructorOptions optional 초기화 옵션을 설명하는 객체. DiTAP 위젯은 지정한 것만 생성됨.
Object describing initialization options. Only the DiTAP widgets given here are created.
Examples:
// 위젯 활성화 (지정하지 않은 DiTAP 위젯은 생성되지 않음)
const viewer = new Ditap.DitapViewer("ditapContainer", {
  // 편집, 분석, 측정 도구 활성화
  // 1. 활성화 - 전체 활성화(true) 또는 부분 활성화(활성화 시킬 기능만 true)
  // 2. 비활성화 - false 또는 전달 안함
  editingTools: {
    select: {
      // 선택 기능 옵션 설정
      // 1. hoverColor - 3D Tile, Model 객체에 마우스를 이동할 경우 변경되는 색상
      // 2. selectedColor - 3D Tile, Model 객체를 선택할 경우 변경되는 색상
      hoverColor: Ditap.Color.fromCssColorString("#BDBDBD"),
      selectedColor: Ditap.Color.fromCssColorString("#9DCFFF"),
      property: {
        // 속성 기능 옵션 설정
        // 1. type - "popup" or "panel" 속성 타입 지정
        // 2. container - type이 "panel"일 때 패널 컨테이너 id(string) 또는 Element
        type: "panel",
        container: "ditapPanel",
      },
      // 선택한 객체의 편집 기능
      remove: true,
      move: true,
      rotate: true,
      scale: true,
      clipping: true,
    },
    createTools: {
      point: true,
      linestring: true,
      polygon: true,
    },
    upload: true,
  },
  analysisTools: {
    slope: true,
    crossSection: true,
    visibility: true,
    view: true,
    solar: true,
    sunshine: true,
  },
  measurementTools: {
    altitude: true,
    angle: true,
    straight: true,
    ground: true,
    plane: true,
    vertical: true,
    horizontal: true,
    area: true,
    volume: true,
  },
  // 처음화면
  // 1. 활성화 - 기본 위치로 이동(true) 또는 초기 위치 지정(Cartesian3)
  // 2. 비활성화 - false 또는 전달 안함
  homeButton: true,
  compass: true, // 나침반(true/false)
  dimensionMode: true, // 2D/3D 전환(true/false)
  capture: true, // 캡처(true/false)
  print: true, // 인쇄(true/false)
  navigationHelpButton: true, // 도움말 버튼(true/false)
  fullscreenButton: true, // 전체 화면(true/false)
  baseLayerPicker: true, // 배경 지도(true/false). 지정하지 않으면 배경지도 없이 시작
});
// 고도제한·침수 분석은 3D Tiles 속성 이름을 지정
const viewer = new Ditap.DitapViewer("ditapContainer", {
  baseLayerPicker: true,
  analysisTools: {
    limitation: {
      latitude: "LATITUDE",
      longitude: "LONGITUDE",
      absoluteAltitude: "ABSOLUTEALTITUDE",
    },
    flood: {
      latitude: "LATITUDE",
      longitude: "LONGITUDE",
    },
  },
});

Extends

Members

allowDataSourcesToSuspendAnimation : boolean

Gets or sets whether or not data sources can temporarily pause animation in order to avoid showing an incomplete picture to the user. For example, if asynchronous primitives are being processed in the background, the clock will not advance until the geometry is ready.
Inherited From:

readonly animation : *

시계 위젯(DitapAnimationWidget). 시계를 사용하지 않으면 undefined.
Gets the clock (animation) widget (DitapAnimationWidget), or undefined if the clock is not used.

readonly baseLayerPicker : BaseLayerPicker

Gets the BaseLayerPicker.
Inherited From:

readonly bottomContainer : Element

Gets the DOM element for the area at the bottom of the window containing the CreditDisplay and potentially other things.
Inherited From:

readonly camera : Camera

Gets the camera.
Inherited From:

readonly canvas : HTMLCanvasElement

Gets the canvas.
Inherited From:

readonly capture : DitapCaptureButton

DitapCapture 조회.
Gets the DitapCapture.

readonly cesiumWidget : CesiumWidget

Gets the CesiumWidget.
Inherited From:

readonly clock : Clock

Gets the clock.
Inherited From:

clockTrackedDataSource : DataSource

Gets or sets the data source to track with the viewer's clock.
Inherited From:

readonly clockViewModel : ClockViewModel

Gets the clock view model.
Inherited From:

readonly compass : DitapCompass

DitapCompass 조회.
Gets the DitapCompass.

readonly container : Element

Gets the parent container.
Inherited From:

creditDisplay : CreditDisplay

Manages the list of credits to display on screen and in the lightbox.
Inherited From:

readonly dataSourceDisplay : DataSourceDisplay

Gets the display used for DataSource visualization.
Inherited From:

readonly dataSources : DataSourceCollection

Gets the set of DataSource instances to be visualized.
Inherited From:

readonly dimensionMode : DitapDimensionModeButton

DitapDimensionMode 조회.
Gets the DitapDimensionMode.

readonly ellipsoid : Ellipsoid

Gets the default ellipsoid for the scene.
Inherited From:
Default Value: Ellipsoid.default

readonly entities : EntityCollection

Gets the collection of entities not tied to a particular data source. This is a shortcut to dataSourceDisplay.defaultDataSource.entities.
Inherited From:

readonly fullscreenButton : DitapFullscreenButton

DitapFullscreenButton 조회.
Gets the DitapFullscreenButton.

readonly geocoder : DitapGeocoder

DitapGeocoder 조회.
Gets the DitapGeocoder.

readonly homeButton : DitapHomeButton

DitapHomeButton 조회.
Gets the DitapHomeButton.

readonly imageryLayers : ImageryLayerCollection

Gets the collection of image layers that will be rendered on the globe.
Inherited From:

readonly infoBox : InfoBox

Gets the info box.
Inherited From:

readonly mobileBtnContainer : Element

모바일 툴바의 버튼 목록 요소.
The button list element of the mobile toolbar.
DitapNavigationHelpButton 조회.
Gets the DitapNavigationHelpButton.

readonly postProcessStages : PostProcessStageCollection

Gets the post-process stages.
Inherited From:

readonly projectionPicker : ProjectionPicker

Gets the ProjectionPicker.
Inherited From:

resolutionScale : number

Gets or sets a scaling factor for rendering resolution. Values less than 1.0 can improve performance on less powerful devices while values greater than 1.0 will render at a higher resolution and then scale down, resulting in improved visual fidelity. For example, if the widget is laid out at a size of 640x480, setting this value to 0.5 will cause the scene to be rendered at 320x240 and then scaled up while setting it to 2.0 will cause the scene to be rendered at 1280x960 and then scaled down.
Inherited From:
Default Value: 1.0

readonly scene : Scene

Gets the scene.
Inherited From:

readonly sceneModePicker : SceneModePicker

Gets the SceneModePicker.
Inherited From:

readonly screenSpaceEventHandler : ScreenSpaceEventHandler

Gets the screen space event handler.
Inherited From:

selectedEntity : Entity|undefined

Gets or sets the object instance for which to display a selection indicator. If a user interactively picks a Cesium3DTilesFeature instance, then this property will contain a transient Entity instance with a property named "feature" that is the instance that was picked.
Inherited From:

readonly selectedEntityChanged : Event

Gets the event that is raised when the selected entity changes.
Inherited From:

readonly selectionIndicator : SelectionIndicator

Gets the selection indicator.
Inherited From:

readonly shadowMap : ShadowMap

Get the scene's shadow map
Inherited From:

shadows : boolean

Determines if shadows are cast by light sources.
Inherited From:

readonly tabletBtnContainer : Element

태블릿 툴바 요소.
The tablet toolbar element.

targetFrameRate : number

Gets or sets the target frame rate of the widget when useDefaultRenderLoop is true. If undefined, the browser's requestAnimationFrame implementation determines the frame rate. If defined, this value must be greater than 0. A value higher than the underlying requestAnimationFrame implementation will have no effect.
Inherited From:

terrainProvider : TerrainProvider

The terrain provider providing surface geometry for the globe.
Inherited From:

terrainShadows : ShadowMode

Determines if the terrain casts or shadows from light sources.
Inherited From:

readonly timeline : Timeline

Gets the Timeline widget.
Inherited From:

trackedEntity : Entity|undefined

Gets or sets the Entity instance currently being tracked by the camera.
Inherited From:

readonly trackedEntityChanged : Event

Gets the event that is raised when the tracked entity changes.
Inherited From:

useBrowserRecommendedResolution : boolean

Boolean flag indicating if the browser's recommended resolution is used. If true, the browser's device pixel ratio is ignored and 1.0 is used instead, effectively rendering based on CSS pixels instead of device pixels. This can improve performance on less powerful devices that have high pixel density. When false, rendering will be in device pixels. Viewer#resolutionScale will still take effect whether this flag is true or false.
Inherited From:
Default Value: true

useDefaultRenderLoop : boolean

Gets or sets whether or not this widget should control the render loop. If true the widget will use requestAnimationFrame to perform rendering and resizing of the widget, as well as drive the simulation clock. If set to false, you must manually call the resize, render methods as part of a custom render loop. If an error occurs during rendering, Scene's renderError event will be raised and this property will be set to false. It must be set back to true to continue rendering after the error.
Inherited From:

readonly vrButton : VRButton

Gets the VRButton.
Inherited From:

readonly weather : DitapWeather

DitapWeather 조회.
Gets the DitapWeather.

Methods

addController(controller)

Adds a controller— an implementation of the Controller interface used to handle input events, camera animations, and other interactions— to the viewer's scene.
Name Type Description
controller Controller An implementation of the Controller interface.
Inherited From:
Example:
viewer.scene.screenSpaceCameraController.enableInputs = false;
viewer.scene.screenSpaceCameraController.enableCollisionDetection = false;

const tiltOrbitController = new Ditap.ScreenSpaceTiltOrbitCameraController();
viewer.addController(tiltOrbitController);

checkPropertyOptions(property) → object

check the property type.
Name Type Description
property object object of property.
Returns:
Verified property type.

checkSelectOptions(options) → object

check the object of select.
Name Type Description
options object object of select options.
Returns:
Verified select options.

createDefaultImageryProviderViewModels() → Array.<ProviderViewModel>

베이스 레이어에 추가할 Imagery Provider 배열 조회.
Gets the Array of Imagery Provider to be added to the base layer.
Returns:
조회된 providerViewModel 배열.
Array of providerViewModel

createDefaultTerrainProviderViewModels() → Array.<ProviderViewModel>

기본 레이어에 추가할 Terrain Provider의 배열 조회.
Gets the Array of Terrain Provider to be added to the base layer.
Returns:
조회된 providerViewModel 배열.
Array of providerViewModel

destroy()

위젯 파괴. 영구적으로 제거하는 경우 호출.
Destroys the widget. Should be called if permanently removing the widget from layout.

extend(mixin, options)

Extends the base viewer functionality with the provided mixin. A mixin may add additional properties, functions, or other behavior to the provided viewer instance.
Name Type Description
mixin Viewer.ViewerMixin The Viewer mixin to add to this instance.
options object optional The options object to be passed to the mixin function.
Inherited From:
See:

flyTo(target, options) → Promise.<boolean>

Flies the camera to the provided entity, entities, or data source. If the data source is still in the process of loading or the visualization is otherwise still loading, this method waits for the data to be ready before performing the flight.

The offset is heading/pitch/range in the local east-north-up reference frame centered at the center of the bounding sphere. The heading and the pitch angles are defined in the local east-north-up reference frame. The heading is the angle from y axis and increasing towards the x axis. Pitch is the rotation from the xy-plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. The range is the distance from the center. If the range is zero, a range will be computed such that the whole bounding sphere is visible.

In 2D, there must be a top down view. The camera will be placed above the target looking down. The height above the target will be the range. The heading will be determined from the offset. If the heading cannot be determined from the offset, the heading will be north.

Name Type Description
target Entity | Array.<Entity> | EntityCollection | DataSource | ImageryLayer | Cesium3DTileset | TimeDynamicPointCloud | Promise.<(Entity|Array.<Entity>|EntityCollection|DataSource|ImageryLayer|Cesium3DTileset|TimeDynamicPointCloud|VoxelPrimitive|BufferPrimitiveCollection.<BufferPrimitive>)> The entity, array of entities, entity collection, data source, Cesium3DTileset, point cloud, or imagery layer to view. You can also pass a promise that resolves to one of the previously mentioned types.
options object optional Object with the following properties:
Name Type Default Description
duration number 3.0 optional The duration of the flight in seconds.
maximumHeight number optional The maximum height at the peak of the flight.
offset HeadingPitchRange optional The offset from the target in the local east-north-up reference frame centered at the target.
Returns:
A Promise that resolves to true if the flight was successful or false if the target is not currently visualized in the scene or the flight was cancelled. //TODO: Cleanup entity mentions
Inherited From:

forceResize()

This forces the widget to re-think its layout, including widget sizes and credit placement.
Inherited From:

isDestroyed() → boolean

Returns:
true if the object has been destroyed, false otherwise.
Inherited From:

offAllInterations(callback)

뷰어에서 선언된 모든 인터렉션 종료.
Destroy the running Interaction.
Name Type Description
callback function 이벤트 제거 후 실행 할 콜백함수.
Callback function to be executed after removing the event.

removeAllAnalysis()

뷰어에 생성된 모든 분석 엔티티 파괴.
Destroying all analysis entities created on the viewer.

removeAllGeometric()

뷰어에 생성된 모든 도형 엔티티 파괴.
Destroying all Geometric entities created on the viewer.

removeAllMeasurement()

뷰어에 생성된 모든 측정 엔티티 파괴.
Destroying all measurement entities created on the viewer.

removeController(controller)

Removes a controller— an implementation of the Controller interface used to handle input events, camera animations, and other interactions— from the viewer's scene.
Name Type Description
controller Controller An implementation of the Controller interface.
Inherited From:
Example:
viewer.removeController(tiltOrbitController);

removeStorageEntity(storage)

해당 객체 스토리지 제거.
Remove the storage of the corresponding object.
Name Type Description
storage Array.<object> 제거 할 스토리지.
Storage to be removed.

render()

Renders the scene. This function is called automatically unless useDefaultRenderLoop is set to false;
Inherited From:

resize()

Resizes the widget to match the container size. This function is called automatically as needed unless useDefaultRenderLoop is set to false.
Inherited From:

zoomTo(target, offset) → Promise.<boolean>

Asynchronously sets the camera to view the provided entity, entities, or data source. If the data source is still in the process of loading or the visualization is otherwise still loading, this method waits for the data to be ready before performing the zoom.

The offset is heading/pitch/range in the local east-north-up reference frame centered at the center of the bounding sphere. The heading and the pitch angles are defined in the local east-north-up reference frame. The heading is the angle from y axis and increasing towards the x axis. Pitch is the rotation from the xy-plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. The range is the distance from the center. If the range is zero, a range will be computed such that the whole bounding sphere is visible.

In 2D, there must be a top down view. The camera will be placed above the target looking down. The height above the target will be the range. The heading will be determined from the offset. If the heading cannot be determined from the offset, the heading will be north.

Name Type Description
target Entity | Array.<Entity> | EntityCollection | DataSource | ImageryLayer | Cesium3DTileset | TimeDynamicPointCloud | Promise.<(Entity|Array.<Entity>|EntityCollection|DataSource|ImageryLayer|Cesium3DTileset|TimeDynamicPointCloud|VoxelPrimitive|BufferPrimitiveCollection.<BufferPrimitive>)> The entity, array of entities, entity collection, data source, Cesium3DTileset, point cloud, or imagery layer to view. You can also pass a promise that resolves to one of the previously mentioned types.
offset HeadingPitchRange optional The offset from the center of the entity in the local east-north-up reference frame.
Returns:
A Promise that resolves to true if the zoom was successful or false if the target is not currently visualized in the scene or the zoom was cancelled.
Inherited From:

Type Definitions

Ditap.DitapViewer.ConstructorOptions

Viewer 생성자의 초기화 옵션.
Initialization options for the Viewer constructor DiTAP 위젯은 모두 기본으로 꺼져 있으며, 아래 옵션을 지정해야 생성됩니다. 기본으로 켜지는 것은 시계(animation)와 타임라인(timeline)뿐입니다.
All DiTAP widgets are off by default and are created only when the options below are given. Only the clock (animation) and the timeline are on by default.
Properties:
Name Type Attributes Default Description
editingTools boolean | object <optional>
 편집 도구. true이면 전체, 객체이면 지정한 도구만 생성.
Editing tools. true creates all of them, an object creates only the given tools.
Properties
Name Type Attributes Description
createTools boolean | object <optional>
 점·선·면 생성 도구. true이면 전체.
Point, linestring and polygon creation tools. true creates all of them.
Properties
Name Type Attributes Description
point boolean <optional>
 true로 설정 시 점 생성 도구 생성.
If set to true, the point creation tool is created.
linestring boolean <optional>
 true로 설정 시 선 생성 도구 생성.
If set to true, the linestring creation tool is created.
polygon boolean <optional>
 true로 설정 시 면 생성 도구 생성.
If set to true, the polygon creation tool is created.
select boolean | object <optional>
 객체 선택 도구. 선택한 객체의 이동·회전·크기·삭제·절단·속성 기능은 이 객체 안에서 지정.
Object selection tool. Move, rotate, scale, remove, clipping and property features for the selected object are set inside this object.
Properties
Name Type Attributes Default Description
hoverColor Color <optional>
 Color.fromCssColorString("#BDBDBD") 3D Tiles·모델에 마우스를 올렸을 때 색상.
Color of a 3D Tiles feature or model under the mouse.
selectedColor Color <optional>
 Color.fromCssColorString("#9DCFFF") 3D Tiles·모델을 선택했을 때 색상.
Color of a selected 3D Tiles feature or model.
move boolean <optional>
 true로 설정 시 선택 객체 이동 기능 사용.
If set to true, the selected object can be moved.
rotate boolean <optional>
 true로 설정 시 선택 객체 회전 기능 사용.
If set to true, the selected object can be rotated.
scale boolean <optional>
 true로 설정 시 선택 객체 크기 조절 기능 사용.
If set to true, the selected object can be scaled.
remove boolean <optional>
 true로 설정 시 선택 객체 삭제 기능 사용.
If set to true, the selected object can be removed.
clipping boolean <optional>
 true로 설정 시 선택 객체 절단 기능 사용.
If set to true, the selected object can be clipped.
property object <optional>
 속성 표시 방식.
How properties are shown.
Properties
Name Type Attributes Default Description
type string <optional>
 "popup" "popup" 또는 "panel".
"popup" or "panel".
container Element | string <optional>
 type이 "panel"일 때 패널을 넣을 요소 또는 id. 없으면 id가 "ditapPanel"인 요소.
Element or id that holds the panel when type is "panel". Defaults to the element with id "ditapPanel".
propertyCallback function <optional>
 선택한 객체를 받아 속성값을 비동기로 돌려주는 함수. 현재 type이 "panel"일 때만 전달됨.
Function that receives the selected object and returns its properties asynchronously. Currently passed on only when type is "panel".
upload boolean <optional>
 true로 설정 시 3D 모델 업로드 도구 생성.
If set to true, the 3D model upload tool is created.
analysisTools boolean | object <optional>
 분석 도구. true이면 전체(고도제한은 analysisTools.limitation을 줄 때만 포함), 객체이면 지정한 도구만 생성.
Analysis tools. true creates all of them (altitude limitation only when analysisTools.limitation is given), an object creates only the given tools.
Properties
Name Type Attributes Description
slope boolean <optional>
 true로 설정 시 경사도 분석.
If set to true, slope analysis is created.
crossSection boolean <optional>
 true로 설정 시 횡단면 분석.
If set to true, cross-section analysis is created.
solar boolean <optional>
 true로 설정 시 일조권 분석.
If set to true, solar analysis is created.
view boolean <optional>
 true로 설정 시 조망권 분석.
If set to true, view analysis is created.
visibility boolean <optional>
 true로 설정 시 가시권 분석.
If set to true, visibility analysis is created.
sunshine boolean <optional>
 true로 설정 시 일조량 분석.
If set to true, sunshine analysis is created.
limitation object <optional>
 고도제한 분석. 3D Tiles 속성 이름을 지정.
Altitude limitation analysis. Names of the 3D Tiles feature properties.
Properties
Name Type Attributes Description
latitude string 위도 속성 이름.
Name of the latitude property.
longitude string 경도 속성 이름.
Name of the longitude property.
absoluteAltitude string <optional>
 절대 고도 속성 이름. absoluteAltitude 또는 buildingHeight 중 하나 필요.
Name of the absolute altitude property. absoluteAltitude or buildingHeight is required.
buildingHeight string <optional>
 건물 높이 속성 이름.
Name of the building height property.
flood object <optional>
 침수 시뮬레이션. true가 아니라 위경도 속성 이름을 가진 객체를 지정.
Flood simulation. Give an object with the latitude/longitude property names, not true.
Properties
Name Type Description
latitude string 위도 속성 이름.
Name of the latitude property.
longitude string 경도 속성 이름.
Name of the longitude property.
streetlamp boolean <optional>
 true로 설정 시 가로등 배치.
If set to true, the streetlamp tool is created.
cctv boolean <optional>
 true로 설정 시 CCTV 배치.
If set to true, the CCTV tool is created.
drone boolean <optional>
 true로 설정 시 드론 시뮬레이션.
If set to true, drone simulation is created.
excavation boolean <optional>
 true로 설정 시 지형 굴착 분석.
If set to true, terrain excavation analysis is created.
measurementTools boolean | object <optional>
 측정 도구. true이면 전체, 객체이면 지정한 도구만 생성.
Measurement tools. true creates all of them, an object creates only the given tools.
Properties
Name Type Attributes Description
altitude boolean <optional>
 true로 설정 시 고도 측정.
If set to true, altitude measurement is created.
angle boolean <optional>
 true로 설정 시 각도 측정.
If set to true, angle measurement is created.
straight boolean <optional>
 true로 설정 시 직선거리 측정.
If set to true, straight distance measurement is created.
ground boolean <optional>
 true로 설정 시 지면거리 측정.
If set to true, ground distance measurement is created.
plane boolean <optional>
 true로 설정 시 평면거리 측정.
If set to true, plane distance measurement is created.
vertical boolean <optional>
 true로 설정 시 수직거리 측정.
If set to true, vertical distance measurement is created.
horizontal boolean <optional>
 true로 설정 시 수평거리 측정.
If set to true, horizontal distance measurement is created.
area boolean <optional>
 true로 설정 시 면적 측정.
If set to true, area measurement is created.
volume boolean <optional>
 true로 설정 시 체적 측정.
If set to true, volume measurement is created.
animation boolean <optional>
 true false로 설정 시 시계 위젯은 생성되지 않음.
If set to false, the clock widget will not be created.
baseLayerPicker boolean <optional>
 false true로 설정 시 배경지도·지형 선택 위젯 생성. 지정하지 않으면 배경지도 없이 시작.
If set to true, the base layer and terrain picker is created. Without it the globe has no base imagery.
fullscreenButton boolean <optional>
 false true로 설정 시 전체화면 위젯 생성.
If set to true, the fullscreen widget is created.
vrButton boolean <optional>
 false true로 설정 시 VR 버튼 위젯 생성.
If set to true, the VRButton widget will be created.
geocoder object <optional>
 주소 검색 위젯. VWorld API 키를 지정해야 생성.
Address search widget. Created only when a VWorld API key is given.
Properties
Name Type Description
key string VWorld API 키.
VWorld API key.
homeButton boolean | Cartesian3 <optional>
 false true로 설정 시 처음화면 위젯 생성. Cartesian3를 주면 그 위치를 처음화면으로 사용.
If set to true, the home button is created. A Cartesian3 sets the home position.
weather object <optional>
 날씨 위젯. 두 키를 모두 지정해야 생성.
Weather widget. Created only when both keys are given.
Properties
Name Type Description
vworldKey string VWorld API 키.
VWorld API key.
weatherKey string 공공데이터포털(data.go.kr) API 키.
Public data portal (data.go.kr) API key.
compass boolean <optional>
 false true로 설정 시 나침반 위젯 생성.
If set to true, the compass widget is created.
dimensionMode boolean <optional>
 false true로 설정 시 2D/3D 모드 전환 위젯 생성.
If set to true, the 2D/3D mode switch widget is created.
capture boolean <optional>
 false true로 설정 시 캡처 위젯 생성.
If set to true, the capture widget is created.
print boolean <optional>
 false true로 설정 시 인쇄 위젯 생성.
If set to true, the print widget is created.
timeline boolean <optional>
 true false로 설정 시 타임라인 위젯은 생성되지 않음.
If set to false, the Timeline widget will not be created.
navigationHelpButton boolean <optional>
 false true로 설정 시 도움말 위젯 생성.
If set to true, the navigation help button is created.
navigationInstructionsInitiallyVisible boolean <optional>
 true 초기에 네비게이션 지침이 표시되어야 하는 경우 true, 사용자가 명시적으로 버튼을 클릭할 때까지 표시되지 않아야 하는 경우 false.
True if the navigation instructions should initially be visible, or false if the should not be shown until the user explicitly clicks the button.
scene3DOnly boolean <optional>
 false true인 경우 3D에서만 렌더링 됨.
When true, each geometry instance will only be rendered in 3D to save GPU memory.
shouldAnimate boolean <optional>
 false 시뮬레이션 시간을 진행시키려면 true, 그렇지 않은 경우 false
true if the clock should attempt to advance simulation time by default, false otherwise. This option takes precedence over setting Viewer#clockViewModel.
clockViewModel ClockViewModel <optional>
 new ClockViewModel(clock) 현재 시간을 제어하기 위해 사용할 시계 뷰 모델.
The clock view model to use to control current time.
selectedImageryProviderViewModel ProviderViewModel <optional>
 현재의 기본 이미지 레이어에 대한 뷰 모델. baseLayerPicker가 true로 설정된 경우에만 유효.
The view model for the current base imagery layer, if not supplied the first available base layer is used. This value is only valid if `baseLayerPicker` is set to true.
imageryProviderViewModels Array.<ProviderViewModel> <optional>
 createDefaultImageryProviderViewModels() BaseLayerPicker에서 선택 가능한 ProviderViewModels의 배열. baseLayerPicker가 true로 설정된 경우에만 유효.
The array of ProviderViewModels to be selectable from the BaseLayerPicker. This value is only valid if `baseLayerPicker` is set to true.
terrainProviderViewModels Array.<ProviderViewModel> <optional>
 createDefaultTerrainProviderViewModels() BaseLayerPicker에서 선택 가능한 지형 ProviderViewModels의 배열. baseLayerPicker가 true로 설정된 경우에만 유효. 처음에는 지형이 선택되지 않은 상태(타원체)로 시작.
The array of terrain ProviderViewModels to be selectable from the BaseLayerPicker. This value is only valid if `baseLayerPicker` is set to true. No terrain is selected at start (ellipsoid).
selectedTerrainProviderViewModel ProviderViewModel <optional>
 현재 DitapViewer는 이 값을 BaseLayerPicker에 전달하지 않아 적용되지 않음. 지형은 `viewer.terrainProvider`로 지정.
Currently not passed on to the BaseLayerPicker, so it has no effect. Set `viewer.terrainProvider` instead.
terrainProvider TerrainProvider <optional>
 new EllipsoidTerrainProvider() 사용할 terrain provider.
The terrain provider to use
options.terrain Terrain <optional>
 지형 공급자로 사용할 지형 객체. terrainProvider가 되지 않은 경우에만 지정가능.
A terrain object which handles asynchronous terrain provider. Can only specify if options.terrainProvider is undefined.
skyBox SkyBox | false <optional>
 별을 렌더링하기 위해 사용. false로 설정 시 태양, 달이 추가되지 않음.

The skybox used to render the stars. When undefined, the default stars are used. If set to false, no skyBox, Sun, or Moon will be added.
skyAtmosphere SkyAtmosphere | false <optional>
 대기(SkyAtmosphere). false로 설정 시 대기 효과 제거.
Blue sky, and the glow around the Earth's limb. Set to false to turn it off.
fullscreenElement Element | string <optional>
 document.body 전체화면 모드 요소. 기본적으로 사용.
The element or id to be placed into fullscreen mode when the full screen button is pressed.
useDefaultRenderLoop boolean <optional>
 true 렌더링 루프 제어 여부.
True if this widget should control the render loop, false otherwise.
targetFrameRate number <optional>
 기본 렌더링 루프 사용할 경우 대상 프레임 속도 지정.
The target frame rate when using the default render loop.
showRenderLoopErrors boolean <optional>
 true 렌더링 루프 오류 발생 시 오류 표시 여부.
If true, this widget will automatically display an HTML panel to the user containing the error, if a render loop error occurs.
useBrowserRecommendedResolution boolean <optional>
 true true인 경우 권장 해상도로 렌더링.
If true, render at the browser's recommended resolution and ignore window.devicePixelRatio.
automaticallyTrackDataSourceClocks boolean <optional>
 true true인 경우 새로 추가된 데이터소스의 시계 설정 자동 추적, false 인 경우 시계를 독립적으로 구성 가능.
If true, this widget will automatically track the clock settings of newly added DataSources, updating if the DataSource's clock changes. Set this to false if you want to configure the clock independently.
contextOptions ContextOptions <optional>
 Scene에 전달되는 컨텍스트 및 WebGL 생성 속성을 지정.
Context and WebGL creation properties passed to Scene.
sceneMode SceneMode <optional>
 SceneMode.SCENE3D 초기 장면 모드 설정. 기본값은 3D 장면 모드.
The initial scene mode.
mapProjection MapProjection <optional>
 new GeographicProjection() 2D 및 Columbus View 모드에서 사용할 지도 투영(Map Projection)을 설정.
The map projection to use in 2D and Columbus View modes.
globe Globe | false <optional>
 new Globe(mapProjection.ellipsoid) 장면에서 사용할 지구(Globe)를 설정.
The globe to use in the scene. If set to false, no globe will be added.
orderIndependentTranslucency boolean <optional>
 true true인 경우 독립적인 투명도 사용.
If true and the configuration supports it, use order independent translucency.
creditContainer Element | string <optional>
 CreditDisplay를 포함할 DOM 요소나 ID.
The DOM element or ID that will contain the CreditDisplay. 지정되지 않은 경우, 크레딧은 위젯 자체의 아래에 추가.
If not specified, the credits are added to the bottom of the widget itself.
creditViewport Element | string <optional>
 크레딧 팝업(credit pop-up)을 포함할 DOM 엘리먼트 또는 ID.
The DOM element or ID that will contain the credit pop up created by the CreditDisplay. 지정되지 않은 경우, 크레딧은 위젯 자체의 위에 추가. If not specified, it will appear over the widget itself.
dataSources DataSourceCollection <optional>
 new DataSourceCollection() 위젯에서 시각화하는 데이터소스의 컬렉션 설정.
The collection of data sources visualized by the widget. If this parameter is provided,
the instance is assumed to be owned by the caller and will not be destroyed when the viewer is destroyed.
shadows boolean <optional>
 false 그림자 투사 여부.
Determines if shadows are cast by light sources.
terrainShadows ShadowMode <optional>
 ShadowMode.RECEIVE_ONLY 그림자 투사 방법.
Determines if the terrain casts or receives shadows from light sources.
mapMode2D MapMode2D <optional>
 MapMode2D.INFINITE_SCROLL 2D 지도 회전여부 또는 수평 무한 스크롤 가능 여부.
Determines if the 2D map is rotatable or can be scrolled infinitely in the horizontal direction.
blurActiveElementOnCanvasFocus boolean <optional>
 true true인 경우 뷰어의 캔버스가 클릭될 때 활성 요소의 포커스 잃음, false인 경우 캔버스가 활성 요소로 설정되지 않고 위치나 엔티티 데이터를 가져오기 위해 클릭될 때 유용.
If true, the active element will blur when the viewer's canvas is clicked. Setting this to false is useful for cases when the canvas is clicked only for retrieving position or an entity data without actually meaning to set the canvas to be the active element.
requestRenderMode boolean <optional>
 false true인 경우 scene 내에서 변경 사항에 따라 필요에 경우 프레임 렌더링 발생.
If true, rendering a frame will only occur when needed as determined by changes within the scene. Enabling reduces the CPU/GPU usage of your application and uses less battery on mobile, but requires using Scene#requestRender 새 프레임을 명시적으로 렌더링하려면 render 함수 사용해야 함.
to render a new frame explicitly in this mode. This will be necessary in many cases after making changes to the scene in other parts of the API. See Improving Performance with Explicit Rendering.
maximumRenderTimeChange number <optional>
 0.0 requestRenderMode가 true로 설정된 경우 렌더 요청 전에 허용되는 최대 시뮬레이션 시간 변경을 정의.
If requestRenderMode is true, this value defines the maximum change in simulation time allowed before a render is requested. See Improving Performance with Explicit Rendering.
depthPlaneEllipsoidOffset number <optional>
 0.0 깊이 평면을 조정하여 타원체의 제로 고도 아래 렌더링 artefacts 해결.
Adjust the DepthPlane to address rendering artefacts below ellipsoid zero elevation.
msaaSamples number <optional>
 1 다중 샘플 안티앨리어싱(MSAA)의 속도 제어. 일반적으로 다중 샘플링 비율은 픽셀당 2,4 및 8샘플이다.
If provided, this value controls the rate of multisample antialiasing. Typical multisampling rates are 2, 4, and sometimes 8 samples per pixel. Higher sampling rates of MSAA may impact performance in exchange for improved visual quality. This value only applies to WebGL2 contexts that support multisample render targets.
CtrlK
core
engine
widgets
ditap