Overview
This document is applicable to users who have installed the FineVis Data Visualization plugin to learn plugin functions.
Version
Report Server Version | Plugin Version | Functional Change |
---|---|---|
11.0.16 | V2.0.0 | Added the 3D Background option to the FVS page background, allowing multiple pages to share the same 3D component. |
11.0.22 | V4.1.0 | Added the Scene tab to Set Current Page Effect, allowing you to configure the current viewing angle and environment effects. For details, see section "Setting the Current Page Effect." |
Application Scenario
When creating a 3D template, you may add the same 3D component in multiple pages for smooth switchover across different viewing angles through the Smooth Transition animation.
But repeated adding of models requires repeated setting of model effects. If one of the models is modified, the rest must be synchronized, causing low production efficiency and high subsequent maintenance costs.
To avoid the above issue, you can add a 3D component into 3D Background, set effects and events for the 3D component, apply the background to multiple pages, and set the current page effect for these pages to reference the models, data, and animation effects from the background page.
In this case, you can achieve the smooth transition effect without enabling Smooth Transition.
Function Description
Function Entry
To select 3D Background as the page background for the first time, you need to click Add 3D Background to enter the 3D background setting page.
After entering the 3D Background page, you can switch canvas pages by clicking Page or 3D Background below the canvas.
You can create, copy, paste, and delete 3D background pages. If all 3D background pages are deleted, the 3D background switchover button will disappear.
Function of the 3D Background Page
Similar to pages, multiple background pages can be added. You can set Name and Background (except the 3D Background option) for background pages.
Only one FVS 3D City Scene component or FVS Custom 3D Scene component can be added to a background page. You can paste one of these two 3D components copied from a page into a background page.
A background page can be applied to multiple pages, while a page supports only one background page.
To replace the background page for a page, you can replace it under 3D Background > Apply Page Background or select other background page under Page > Background.
Replacement in 3D Background:
Replacement in Page:
Setting the Current Page Effect
You need to set the current page effect for each page separately, and the effects do not affect each other. The scene, data, and model of the 3D component can be referenced from the background page.
Before that, you need to set the 3D scene, data layer, model, and animation on the background page. For details about the 3D component functions, see FVS 3D City Scene Component and FVS Custom 3D Scene Component.

In versions earlier than V4.1.0, you can only reference the viewing angle, model, data, and animation of 3D components from the background page. The viewing angle can be adjusted within the canvas.
The following table describes each setting item.
Setting Item | Description |
---|---|
Scenario | In V4.1.0, the Scene tab is added, allowing you to configure the current viewing angle and current environment effects. Current Viewing Angle
![]() Current Environment Effect You can select the configured environment effect on the current 3D background page. The environment effect selected in the 3D background is selected here by default. |
Model | Model
Animation After setting the model animation in the 3D component on the background page, you can select the required animation deselected by default in the animation list. ![]() |
Data | After data layers are added to the 3D component on the background page, you can select the data layers (deselected by default) required for the current page in the layer list. Note: For versions earlier than V2.10.0, you can add a component linkage event. |
Notes
You can use getWidgetByName to get the 3D component name on the background page. But if components with the same name exist on the page and on the background page, the component on the page will be returned.
3D Background is not supported when Mobile Layout is enabled. The 3D background configured on PCs will not take effect after switchover to mobile terminals.