The 3D Viewport is the main interaction tool with the CityEngine scene besides the Scene Editor. You can have any number of open viewports. Select Window > New Viewport from the main menu to create a viewport.
To learn more on how to navigate in 3D, transform scene objects, and work with bookmarks, see Scenes.
View modes and display settings
The 3D Viewport offers many viewing modes and display settings. These options are accessed in the top toolbar of the viewport window.
Active scenario
You can use the Scenario tool to change the active scenario for the given Viewport.
Layer type visibility
You can open the Visibility settings to determine which layer types are visible for each open viewport. Selective rendering of layers can be used, for example, for rendering shapes in one viewport and geometries in another.
Item | Function | Shortcut |
---|---|---|
Isolate Selection | Isolate the current selection, hide unselected objects. Note:Terrains and Analyses layers will still be visible even if not selected. | Press I |
Map Layers | Turns attribute map layer visibility on and off for this viewport. | Press F9 |
Graph Networks | Turns graph network visibility on and off for this viewport. | Press F10 |
Shapes | Turns shape visibility on and off for this viewport. | Press F11 |
Models | Turns model visibility on and off for this viewport. | Press F12 |
Analyses | Turns analysis visibility on and off for this viewport. |
Camera and viewport settings
You can click the View settings tool to change settings such as camera or textures. The View settings tool has the following options:
Item | Function | Shortcut |
---|---|---|
10mm fisheye lens (121° FOV) | Type of lens and FOV (field of view). | |
18mm ultra-wide lens (90° FOV) |
Type of lens and FOV (field of view). | |
24mm wide-angle lens (73° FOV) |
Type of lens and FOV (field of view). | |
35mm standard lens (54° FOV) |
Type of lens and FOV (field of view). | |
50mm standard lens (39° FOV) |
Type of lens and FOV (field of view). | |
70mm telephoto lens (28° FOV) |
Type of lens and FOV (field of view). | |
135mm telephoto lens (15° FOV) |
Type of lens and FOV (field of view). | |
Parallel projection view |
Type of lens and FOV (field of view). | Press P |
Wireframe | Renders the scene contents as the Wireframe of the face borders. Tip:To see the wireframe of terrains, select them in the Scene editor and enable the Wireframe option in the Inspector. | Press 4 |
Shaded | Renders the scene contents with colors but with no textures. Note:This also means that no opacity maps are applied and some otherwise transparent parts are rendered opaque. | Press 5 |
Textured | Renders the scene contents with colors and textures. | Press 6 |
Wireframe on Shaded/Textured | Enable or disable an overlay such as the wireframe render mode but on top of the rendered elements. | Press 7 |
Shadows | Turns shadows on or off. Note:Note that enabling shadows on large models may considerably affect rendering performance. | Press 8 |
Ambient Occlusion | Enable or disable ambient occlusion rendering (ambient occlusion). | Press 9 |
On-camera light | Switches the sun position between the specified location and straight behind the camera. | Press L |
Single-Sided Lighting |
|
|
Backface Culling | Enable or disable backface culling. With backface culling enabled, only faces facing the camera are rendered. |
|
Terrain Masking | Enable or disable masking of multiple terrains in overlapping terrain regions. | |
Information Display | Turns the information display on and off. The information display provides statistics for the current scene such as number of objects and polygon count. | Press D,D |
Axes | Switches rendering of the axis visualization in the lower left corner. Note:The coordinate system can be switched in View Coordinate System. | Press D,A |
Compass | Switches rendering of the Compass in the lower right corner. | Press D,C |
Grid | Switches rendering of the Grid at elevation 0 for reference. | Press D,G |
Bookmarks gizmos | Turns visibility on and off. Switches rendering of small cameras for the Bookmarks locations. | |
Handles | Turns handles visibility on and off. | |
View Coordinate System |
Choose a Coordinate System for the Navigation Display and the axis visualization |
|
Note:
Press D to open the shortcut table for the display of Information, Axes, Compass, and Grid.
Render modes
The Viewport can render its contents in the following modes:
Wireframe—All edges of objects are drawn as lines. There are no filled polygons so you can "look-through" the objects. The wireframe mode can be activated by selecting the Wireframe button or pressing 4. | |
Shaded—All polygons are filled with the object color. No texturing takes place. The shaded mode can be activated by selecting the Shaded button or pressing 5. | |
Textured—All polygons are filled with textures and object colors. The textured mode can be activated by selecting the Textured button or pressing 6. | |
Wireframe on Shaded/Textured—Overlay wireframe independent of the viewing mode by enabling Wireframe on Shaded/Textured in the View Settings menu or pressing 7. |
Viewport settings are stored per viewport together with your scene data. This means that when you reopen a scene, you get exactly the same viewport settings as when you were saving the scene.
Note:
Global viewport settings can be changed by selecting Edit > Preferences > General > Viewport from the main menu; see Viewport preferences.
Viewport context menu
Depending on the selection, the context menu contains different entries for different objectives.
Frame (F) | Frame the selection (or the whole scene if selection is empty). |
Select Objects in Same Layer | All objects in the same layer or layers are selected. |
Select Objects with Same Rule File | Selects all objects having assigned a rule file that is present in the source selection. |
Select Objects with Same Start Rule | Selects all objects having a start rule that is present in the source selection. |
Additionally, you can Cut, Copy, Paste or Delete in the context menu. Finally, you can also turn the full screen mode on and off for this Viewport.
Tip:
If you have a 3D mouse installed, you can change the mouse options here. These options are applied for all viewports.
Make names unique
Names of generated objects in a CityEngine scene are not automatically unique. In some cases, unique names are required. This can be achieved by clicking Edit > Make Names Unique Tool.
All selected scene objects are enumerated and renamed in ascending order. The delimiting character can be chosen.
Note:
This is a one-time operation. Once you modify your scene (add scene objects), there might be new shapes with nonunique names again.