3DDB Viewer Manual

Introduction

This document describes how to use a Web-based user interface (hereinafter referred to as “3DDB Viewer”) for displaying model data registered in the 3DDB database operated and managed by the Geographical Information Science Research Team, Artificial Intelligence Research Center, Information and Human Engineering Field, National Institute of Advanced Industrial Science and Technology (AIST).

Operating Environment

We have confirmed that 3DDB Viewer works in the following environments.

Hardware/OS/Web Browser

DOS/V (CPU: Intel(R) Core(TM) i7-7700K MEM: 32GB GPU: GeForce 1080TX)
Windows 10 Pro version 1809
Chrome version 83.0.4103.61, Firefox version 78.02 (64bit),
Microsfot Edge version 83.0.478.64 (official build)(64bit)
MacBook Pro 15inch Mid 2015 (CPU: Intel(R) Core(TM) i7 MEM: 16GB)
macOS Catalina version 10.15.5
Chrome version 83.0.4103.61, Firefox version 78.02 (64bit)
MacBook Pro 13inch Mid 2014 (CPU: Intel(R) Core(TM) i7 MEM: 8GB)
macOS Mojave version 10.14.6
Chrome version 83.0.4103.61, Firefox version 78.02 (64bit)

Attention

It should work in the same level of environment as above, but it is not guaranteed to work in all environments.

Basically, the operation by the environment other than the operation check is not guaranteed at all.

Warning

We have confirmed that it does not work in the following environments.

  • Web browsers: Internet Explorer, Microsoft Edge (not the Chromium baseed), and Safari

  • Environments: Android OS, iOS, and iPadOS

How to Use

The following sections describe how to use the 3DDB Viewer.

Basic Operation

The basic operations of 3DDB Viewer are described in the following sections.

_images/3dui_initial.png

Figure 1. 3DDB Viewer (Click to enlarge)

Figure 1. shows the screen after starting the 3DDB Viewer. The 3DDB Viewer consists of the numbered areas (1) to (4) as shown in Figure 1. Each area has the following functions

(1) Model Data Search and Display Control Panel

It has functions for searching model data and displaying and downloading model data. For specific instructions on how to use this function, please refer to “Searching, Viewing and Downloading Model Data” below.

(2) Base Layer

This panel is responsible for displaying model data. The model data selected in “(1) Model data search and display control panel” is displayed here.

The operations on the base layer are as follows.

Manipulation

Base Layer Behavior

Drag left mouse button + move mouse

Move (Figure. 2. red arrow)

Shift + drag left mouse button + move mouse

translation (Figure. 2. light blue arrow)

Rotate mouse wheel

Zoom in/out

Drag the mouse wheel + move the mouse
Or
Ctrl + drag left mouse button + move mouse

Rotate (Figure. 2. green arrow)

_images/3dui_map_move.png

Figure 2. Base layer manipulation (Click to enlarge)

(3) Toolbox

It serves as a simple help for changing the base layer and model display mode (scene mode). For specific instructions on how to use it, see “Toolbox” below.

(4). Credit

This is a credit for 3DDB Viewer. It does not have any other functions.

Model data search, display and download

The following section describes how to search, display and download model data in 3DDB Viewer.

Model data display and download

When you execute a search with “Model Data Search”, the following dialog box with search results is displayed.

_images/3dui_result_list.png

Figure 7. Search results available

If the result does not exist, a message is displayed stating that the result does not exist.

_images/3dui_result_empty.png

Figure 8. No results

The following is an explanation of how the search results are displayed.

_images/3dui_result_icon.png

Figure 9. Search Results Icon (Click to enlarge)

    1. Page switching in search results

    Switch between pages of search results.

    The number of data per page is 20, and the search results / 20 page numbers are displayed here. You can switch between the search results by clicking on the displayed page number.

    1. Model data display ON/OFF

    Switches the display of model data ON and OFF.

    The state after the search (Figure 9) is the state of the display OFF.

    _images/3dui_show_model.png

    Figure 10. Example display of model data (Click to enlarge)

  1. Detailed model data information

Displays detailed information of model data.

When you click this button, the following dialog box will be opened and detailed information will be displayed.

_images/3dui_detail_panel.png

Figure 11. Detailed information

    1. Moving to the location of the model data

    Clicking on it will take you to the location of the model data.

    1. Download Model Data

    Note

    If the data is registered as non-downloadable when the model data is registered, the icon in question will be hidden.

    When you click this icon, the following dialog box will open and you can download the model data.

    _images/3dui_download_panel.png

    Figure 12. Download

    Warning

    When you download model data, you agree to abide by the license terms associated with that model data.

    _images/3dui_download_confirm.png

Control of display state

In order to display the model data, the following features are available that affect the overall display, not the individual model data.

_images/3dui_view_control.png

Figure 13. Display control (general)

    1. Footprint

    Toggles the display of the wireframe area (foot print) drawn at the location where the model exists.

    Initially, it is OFF.

    _images/3dui_footprint_off.png

    Figure 14. Footprint OFF

    When this is turned on, foot print is drawn at the point where the model exists, as shown in Figure 15.

    _images/3dui_footprint_on.png

    Figure 15. Footprint ON

    When the model is displayed, the foot print of the model is automatically turned off.

    1. Point Size

    Changes the size of points in point cloud data. There is no effect on anything other than point cloud data.

Share the display state

The 3DDB Viewer provides a function to generate a URL that allows you to recreate the display state of the model data. By sharing this URL, you can share the view of the model data.

Attention

This function works only the 3D view of scene mode.

This URL can be generated by clicking on the Share button in the Model Search and Display Control Panel.

_images/3dui_share_button.png

Figure 16. Share button

When you click the Share button, the following dialog will be displayed.

_images/3dui_share_panel.png

Figure 17. Share dialog

Clicking the “Copy to clipboard” button will copy the URL to the clipboard area. Use a text editor or other application to save the contents of the clipboard.

Toolbox

The toolbox is described below.

_images/3dui_tbox.png

Figure 18. Toolbox

From left to right: Scene mode change, base layer switching, and simple help on how to operate.

Each of these features is described below.

Scene mode change

After clicking on the icon, the icon will expand as shown in Figure 19, and you can select the desired mode.

_images/3dui_tbox_smode.png

Figure 19. Scene mode change

The icons for each mode are, from the top, 3D view, 2D view and 2.5D view (Columnbus View).

The order of display changes depending on the selected mode, so try to remember the icon and mode, not the order of display.

Base layer switching

Click the icon to expand the dialog shown in Figure 20. Select the desired base layer image and Digital Elevation Model (DEM).

_images/3dui_tbox_blpicker.png

Figure 20. Base layer switching

You can select one image from Imagery for base layer and one from Terrain for DEM.

When launching the 3DDB Viewer, “Basemap of GSI of Japan” for Imagery and “WGS84 Elipsoid” for Terrain are specified.

Simple help on how to use

When you click the icon, the dialog shown in Figure 21 will be expanded to display a simple explanatory diagram of the operation on the base layer.

_images/3dui_tbox_help.png

Figure 21. Simple help

When you click on a different location after viewing, the dialog is automatically hidden.

Other

Dialog common operations

The common operations of the dialog are described below.

_images/3dui_dialog_control.png

Figure 22. Dialog common operations

  • (1). Moving bar

    You can move the position of the dialog.

    By dragging the bar, you can move it to the desired location.

  • (2). Collapse button

    Click to collapse the dialog.

    Click again to un-collapse the dialog.

  • (3). Label

    Labeling to identify the dialog.

    It cannot be manipulated.

  • (4). Close button

    Click to close the dialog.

    Some dialogs do not have a close button.

Show help

You can refer to this manual by clicking on the Help button.

_images/3dui_help_button.png

Figure 23. Help button