3D Scene Roaming Example

This document applies to users who have installed the FineVis Data Visualization plugin to learn plugin functions.

 Version

Function Description

3D City Scene and Custom 3D Scene components allow you to adjust the viewing angle of 3D the scene, and configure basic attributes such as the scaling distance and vertical angle.

You can add several camera viewing angles and bind a model to each viewing angle to locate the scene at the needed viewing angle rapidly. 

This document takes the custom 3D scene component as an example to introduce how to set and operate on the camera viewing angle in detail.

Before configuring the viewing angle, you need to understand how to adjust the viewing angle.

Operation Instruction

Top/Main/Side View

In the 3D scene, you can click Top View, Main View, and Side View on the top toolbar to adjust the viewing angle, as shown in the following figure.

Viewing Angle Rotation/Panning/Zooming

1. You can hold down the left mouse button and drag the mouse freely to rotate the viewing angle. In V2.2.0 and later versions, you can rotate the viewing angle by clicking the up/down/left/right keys on the keyboard.

2. You can hold down the right mouse button and drag the mouse horizontally to pan the viewing angle. In V2.2.0 and later versions, you can pan the viewing angle by clicking the W/A/S/D keys on the keyboard.

3. You can scroll the mouse wheel to zoom in/out the viewing angle.

Viewing Angle Adjustment Method

Two methods are available for you to adjust the viewing angle.

1. On the 3D Scene Editing Page

Hold down the right/left mouse button or click the keys on the keyboard to adjust the viewing angle on the 3D scene editing page. Click Back to Visualization Dashboard so that the final viewing angle can be automatically saved.

The operation is the same as that in section "Instructions."

2. On the Canvas

On the canvas, select a component and click the Adjust Viewing Angle icon in the top right corner. Then you can adjust the viewing angle within the component. You can only use the mouse to adjust the viewing angle. You cannot click keys on the keyboard to adjust the viewing angle.

After the adjustment, click the ✓ icon in the top right corner or click anywhere outside the component area to save the final viewing angle, as shown in the following figure.

Enter the 3D scene editing page to view the Viewing Angle Parameter panel displayed in the upper right corner of the scene. You can configure the viewing angle attributes under Scene > Camera.

Viewing Angle Parameter

Camera Coordinate and Viewpoint Coordinate are displayed in Viewing Angle Parameter. The parameter values change according to the changes of the viewing angle in real-time. You can click Copy or Paste to Replace to copy and paste the parameters.

For example, if you copy the current viewing angle parameters, adjust the viewing angle to a new one, and then paste the copied parameters to replace those of the new viewing angle, the viewing angle will change to the prior one, as shown in the following figure.

The Restore button is added on the viewing angle parameter panel in V3.2.0 and later versions. You can click this button to restore the viewing angle to its initial position during scene creation.

You can also press Shift and C to restore the viewing angle.

Note: 

Limited by the camera zoom and vertical angle settings, the viewing angle may not be equal to the initial viewing angle.

Scale Setting

The distance configured in Scale Setting refers to the distance between the camera and the viewpoint. You can set Closest Distance and Furthest Distance to form a scaling range from 0 to 100.

The furthest distance needs to be greater than the closest distance. The greater the difference between the two distances, the greater the scaling range, as shown in the following figure.

Vertical Angle

Vertical Angle specifies the angle between the line of sight and the ground. You can set Minimum Angle and Maximum Angle to form a range (from -90 degrees to +90 degrees) in which the line of sight can be rotated in the Y-axis direction.

The maximum angle needs to be greater than the minimum angle. The greater the difference between the two angles, the greater the rotating range in the Y-axis direction, as shown in the following figure.

Field Depth

After Enable Field Depth is selected, the blur increases with the focus distance (namely, clear scene within the focus distance and blur scene beyond the distance). You can set Focus Distance, Aperture Value, and Blur Radius.

1. Focus Distance: This parameter specifies the distance between the focused object and the camera, which can be set to Dynamic or Fixed.

Dynamic: The center object at the current viewing angle is always taken as the focused object with the focus distance being automatically calculated.

Fixed: You can set a fixed focus distance. You can also obtain the current autofocus distance with one click.

2. Aperture Value: You can control the depth of field. The smaller the aperture value, the shallower the field depth (namely, the fewer the clear area). The value ranges from 0.1 to 40.

3. Blur Radius: This parameter specifies the blur radius (namely blur degree of the scene) of the field of depth, which can be set to Low, Medium, or High.

Movement

When you select Enable Viewing Angle Change, the 3D scene can be rotated 360° automatically at the adjustable rotation speed of the viewing angle. After Enable Viewing Angle Change is selected, you can still adjust the viewing angle of the scene without being affected.

During preview in V2.4.0 and later versions, the movement pauses when you hover your cursor hovers over the moving 3D component, and continues when you stop hovering your cursor.

Note: 

In FVS V3.0.0 and later versions, the component hover control interface is added for you to enable or disable the hover effect. For details, see Enabling and Disabling the Mouse Hover Effect Through JS .

Camera Viewing Angle

Click Add Current Viewing Angle to bring up the Viewing Angle Setting panel with the current viewing angle parameters displayed by default.

1. Viewing Angle Name: You can rename the viewing angle but cannot set the name to an existing one.

2. Viewing Angle Parameter:

You can adjust the viewing angle in the left scene, or manually modify the coordinate values of the viewing angle parameters. The viewing angle of the scene and the viewing angle parameters change synchronously.

Note:

 In versions earlier than V2.2.1, the viewing angle of the scene will not change with the coordinate modified manually.

You can click Copy or Paste to Replace to copy and past the viewing angle parameters.

If you adjust the viewing angle in the left scene and exit the viewing angle setting, the new viewing angle will be maintained. If you adjust the coordinates of the viewing angle parameters on the right panel and exit the viewing angle setting, the original viewing angle will be maintained.

3. Bound Model: You can bind only one model to one viewing angle. But you can bind one viewing angle to multiple models. If you bind a model that has been bound to another viewing angle, the prior binding will be cancelled.

Note: 

In the 3D City Scene component, you can only bind custom models.

After you bind a viewing angle to a model, you can click the model to switch to the corresponding viewing angle during preview.

4. You can add multiple viewing angle. The following figure shows the list of viewing angles.

Click a viewing angle in the list to view the left scene at this viewing angle.

Click to download 3D Scene Roaming Example.fvs